Motionworks Viewcast provides media metrics including Circulation, Opportunity to See (OTS) and Likelyhood to See (LTS) impressions for exposed audiences that are visiting assigned places or traveling along paths assigned to the media. All assigned paths and places are measured and aggregated to report deduplicated audience exposure and impression profiles.

For details on viewshed creation, traffic measurement, and how circulation is converted to Opportunity to See metrics, see Viewcast Methodology.

Versions

Each Viewcast Profiles release combines a place-based traffic feed (sourced from Placecast by Date) with a roadside traffic feed, measured over a fixed forecast window — the range of months whose measured traffic is aggregated into the published Circulation, OTS, and LTS metrics. Two versions are currently published. The placebased_version and roadside_version fields on every record identify the exact feeds used to build it.

The two versions share identical viewshed geometry and face assignments; they differ only in the underlying place-based feed and the forecast window. The forecast window of a record is also reported directly in its period_start and period_end fields. History reported in the history and by_year fields extends further back than the forecast window (see Historical Summary).

Data Dimensions

• Frequency: Published monthly. Data products are incremented one month after the end of each month, within 6 weeks of the close of a month.
• Geographic coverage: Summarizes traffic in any viewshed area within the United States.
• Date availability: Historical data available back to 2019 with monthly and annual aggregations.
• Latency: Data are released within 6 weeks of month close. For example, January 2025 will be incremented no later than March 15, 2025.

Schema

Market Structure

Geographic market information for the viewshed.

{
  "co_geoid": "06037",
  "co_name": "Los Angeles County",
  "st_name": "California",
  "cbsa_geoid": "31080",
  "cbsa_name": "Los Angeles-Long Beach-Anaheim, CA",
  "cbsa_type": "Metropolitan",
  "dma_geoid": "803",
  "dma_name": "Los Angeles, CA",
  "postal_code": "90210"
}

• co_geoid: County GEOID

• co_name: County name

• st_name: State name

• cbsa_geoid: Core Based Statistical Area GEOID

• cbsa_name: Core Based Statistical Area name

• cbsa_type: CBSA type (Metropolitan/Micropolitan)

• dma_geoid: Designated Market Area GEOID

• dma_name: Designated Market Area name

• postal_code: Postal code/ZIP code

  Geopath Structure

Geopath inventory metrics matched to this viewshed. When a face has a corresponding Geopath record, these fields provide the industry-reported metrics for direct comparison.

{
  "face_id": 31003420,
  "spot_id": 41003420,
  "face_traffic": 45231,
  "face_circ": 31661,
  "spot_circ": 31661,
  "spot_ots": 31661,
  "spot_lts": 28495,
  "encoded_media_type": "20",
  "spot_count": 3
}

• face_id: Geopath face identifier
• spot_id: Geopath spot identifier
• face_traffic: Geopath-reported weekly face traffic
• face_circ: Geopath-reported weekly face circulation
• spot_circ: Geopath-reported weekly spot circulation
• spot_ots: Geopath-reported spot Opportunity to See
• spot_lts: Geopath-reported spot Likelihood to See
• encoded_media_type: Encoded classification type, media type, and digital capability (see Encoded Media Type Reference)
• spot_count: Number of distinct Geopath spots on this face

Encoded Media Type Reference

The encoded_media_type field encodes the Geopath classification type, media type, and digital capability into a single string identifier.

Special Classification Codes

Non-roadside classifications use fixed codes:

Roadside Codes

Roadside classifications combine the media type ID with a digital suffix:

Last digit: 1 = digital, 0 = static.

Sentinel Values

• NULL -- No Geopath match (face not in Geopath inventory)
• '' (empty string) -- Cluster-level aggregate in tiles (no individual encoding)

Viewshed Corrections

Some roadside faces are submitted with an orientation or size whose viewshed does not reach any drivable road. Left uncorrected, such a face has no road on which to measure a path and would report zero traffic. To prevent this, Motionworks automatically applies the smallest adjustment that lets the viewshed reach a road — a new orientation, an enlarged face, or both — so that a path can be built and measured.

When a face is corrected, the face_orientation, face_height, and face_width reported in this feed reflect the corrected values. The values as originally submitted are preserved on the source viewshed record and are not lost. Faces where no adjustment can reach a drivable road are left exactly as submitted and are reported with a No Valid Paths assignment status.

Assignment Status Values

Percent Circulation

Day-of-week and hourly traffic distribution, plus demographic segment breakdowns following a standardized format.

Day/Hour Distribution

Contains a 'day' array with 7 records (Monday-Sunday), each with a daily percentage and 24-hour breakdown.

{
  "day": [
    {
      "id": "mo",
      "description": "Monday",
      "value": 0.1273,
      "hourly": [
        0.0215, 0.0148, 0.0083, 0.0053, 0.0037, 0.0044,
        0.0069, 0.0127, 0.0261, 0.0401, 0.0448, 0.0582,
        0.0679, 0.0735, 0.0764, 0.0809, 0.0902, 0.1017,
        0.0763, 0.0608, 0.0448, 0.0336, 0.0274, 0.0196
      ]
    },
    {
      "id": "tu",
      "description": "Tuesday",
      "value": 0.1429,
      "hourly": [...]
    }
  ]
}

• id: Two-letter day identifier (mo, tu, we, th, fr, sa, su)
• description: Full day name
• value: Daily circulation percentage (all 7 days sum to 1.0)
• hourly: Array of exactly 24 hourly percentages (sum to 1.0 within each day)

Demographic Segments

Contains demographic segment breakdowns within segment.basic_demographics.

{
  "segment": {
    "basic_demographics": [
      {
        "category": "age_plus",
        "segments": [
          {
            "id": "age_00plus",
            "description": "All Persons",
            "value": 1.0,
            "index": 1.0
          },
          {
            "id": "age_18plus",
            "description": "Population, Age 18+",
            "value": 0.7862,
            "index": 0.9796
          }
        ]
      },
      {
        "category": "prizm",
        "segments": [...]
      }
    ]
  }
}

• category: Demographic category (e.g., age_plus, prizm)
• segments: Array of segment values
  • id: Segment identifier
  • description: Human-readable segment description
  • value: Segment percentage value
  • index: Index against population benchmark

Historical Summary

Historical data with standardized metrics organized by year and month periods. Provides longitudinal view of traffic and circulation patterns.

{
  "year": [
    {
      "id": "2024",
      "period_start": "2024-01-01",
      "traffic": 91552.0,
      "face_circ": 64086.0,
      "spot_circ": 64086.0,
      "spot_ots": 64086.0,
      "dwell": 45.0,
      "period_days": 365
    },
    {
      "id": "2023",
      "period_start": "2023-01-01",
      "traffic": 89234.0,
      "face_circ": 62463.0,
      "spot_circ": 62463.0,
      "spot_ots": 62463.0,
      "dwell": 47.0,
      "period_days": 365
    }
  ],
  "month": [
    {
      "id": "2024-04",
      "period_start": "2024-04-01",
      "traffic": 24432,
      "face_circ": 49075,
      "spot_circ": 49075,
      "spot_ots": 49075,
      "dwell": 8,
      "period_days": 30
    }
  ]
}

Detailed Traffic Summaries

The following fields provide granular traffic breakdowns including separate vehicle and pedestrian counts, weighted speed measurements, and daytype classifications not available in the history and percent_circ fields.

by_year

Annual summary of vehicle and pedestrian volumes and speeds within the viewshed.

[
  {
    "year": 2024,
    "avg_daily_veh_traffic": 1250.5,
    "avg_daily_ped_traffic": 320.2,
    "wtd_duration": 45.0,
    "wtd_speed": 35.5,
    "period_days": 366,
    "ots_total": 485000.0
  }
]

by_week

Weekly summary of vehicle and pedestrian volumes and speeds within the viewshed.

[
  {
    "week": "2024-W15",
    "avg_daily_veh_traffic": 1180.3,
    "avg_daily_ped_traffic": 298.7,
    "wtd_duration": 42.0,
    "wtd_speed": 36.2,
    "period_days": 7,
    "ots_total": 9250.0
  }
]

by_day_hour

Daily and hourly traffic distribution.

[
  {
    "day_of_week": 1,
    "daytype": 1,
    "daily_pct": 0.1429,
    "hourly_pct": [0.021, 0.015, 0.008, ...]
  }
]

• day_of_week: 1 = Monday, 2 = Tuesday, ... 7 = Sunday
• daytype: 1 = Mon-Thu, 2 = Fri, 3 = Sat, 4 = Sun
• daily_pct: Percentage of weekly traffic on this day
• hourly_pct: Array of 24 hourly percentages