Viewcast™ Viewshed Library

The Motionworks Viewshed Library provides a comprehensive reference for media inventory viewsheds - both Place-based and Roadside advertising displays - that have travel paths measured in Pathcast™ by Date.

What is a Viewshed?

A viewshed, also known as a "display exposure zone", is the geographical area that includes all points from which an advertisement may be seen by traffic or pedestrians. Each viewshed is precisely calculated using geometric modeling that considers:

  • Display characteristics: Size, elevation, and orientation
  • Environmental context: Place type, area type (urbanicity), and visual obstructions
  • Traffic patterns: Direction and mode of all traffic flows
  • Viewing geometry: Effective size within field of view and maximum noting distance

The viewshed methodology applies consistently across all media formats - from roadside billboards to place-based digital displays - ensuring accurate opportunity-to-see (OTS) calculations for both vehicular and pedestrian audiences. For comprehensive methodology details, see Viewcast Methodology.

Viewsheds and Path Measurement

Each viewshed serves as the foundation for traffic measurement by defining where movement paths are generated and measured. The Viewshed Library contains the geographic boundaries within which Pathcast™ by Date provides traffic volume data.

Viewsheds are calculated using rigorous geometric principles that ensure accurate visibility zones rather than arbitrary circular radii. This scientific approach provides the spatial framework for measuring traffic exposure across both traditional roadside inventory and modern place-based media networks.

Schema

NameDescriptionTypeExample
viewshed_idMotionworks identifier for the viewshed. In the Places Library, Viewsheds are referred to as Faces.string166000341715
audit_status_idMotionworks audit status ID for this Place Face.int12
lonLongitude of the display.float-87.206318
latLatitude of the display.float30.480777
orientationCardinal direction of the display expressed in degrees from north.float180.0
height_inHeight (inches) of the display.float168.0
width_inWidth (inches) of the display.float576.0
client_display_idClient-facing display identifier for the face.stringDSP-NYC-001
digitalTrue if the display shows digital media.boolfalse
modifiedThe date this record was last modified.datetime2023-12-20 02:23:43
max_noting_ftMaximum noting distance — the furthest distance from which the face can reasonably be seen, in feet.float812.0
construction_type_nameConstruction type of the display (Freestanding, Interior Wall, Furniture, Exterior Wall, Bus Exterior, Rooftop, etc.).stringFreestanding
media_type_nameMedia type based on the width and height of the face (Display, Panel, Junior Poster, Poster, Bulletin, Mural).stringBulletin
illumination_type_nameIllumination characterization of the face (Illuminated, Non-Illuminated, Backlit).stringIlluminated
frame_rotatingTrue if the frame physically rotates between multiple ad copy positions.boolfalse
frame_full_motionTrue if the frame supports full-motion video creative.booltrue
frame_partial_motionTrue if the frame supports partial-motion (animated but not full-video) creative.booltrue
frame_interactiveTrue if the frame supports interactive creative (e.g., touch, mobile-tethered).boolfalse
frame_audioTrue if the frame supports audio.boolfalse
spotsAd-rotation spot definitions for digital faces (NULL for static faces). Each spot carries spot_id, spot_length, share_of_voice, and capability flags for audio / full-motion / partial-motion / interactive.JSONSee Spots Structure
geographyThe viewshed polygon. Expressed as Well-known text (WKT).geographyPOLYGON((-87.206318 30.480777, -87.2063943564203 30.4807769999778, …))