Visitor Journey
Visitor Journey Monthly Dataset for Places
Visitor Journey provides monthly aggregated insights into how visitors move to and from a location. It captures inflow and outflow patterns, offering a breakdown of different journey types. The dataset also includes estimated travel time, distance, and confidence score for journeys.
Visitor Journey Schema
| Field name | Type | Description | Example |
|---|---|---|---|
| observation_start_date | string (yyyy-mm-dd) | The start date of the observation period | 2025-01-01 |
| observation_end_date | string (yyyy-mm-dd) | The end date of the observation period. | 2025-01-31 |
| location_id | string | Unique identifier of the location (SafeGraph Placekey or Custom Location ID). | zzy-23j@627-s8n-8y9 |
| related_location_id | string | Unique identifier of the location in relation to the location_id (where we measure the fraction of flow (inflow/outflow) to/from). This will either be a SafeGraph Placekey or have the value H for Home or W for Work locations. | 222-222@5z8-3pn-eh5 |
| flow_direction | string | Dimension describing if the journey is a inflow (from related_location_id to location_id) or outflow (from location_id to related_location_id). Allowed values "inflow" or "outflow". | inflow |
| total_journey_fraction | float | The proportion of total journeys from or to a specific related_location_id, relative to all total journeys involving the same location_id, within the same date range and flow dimension type. | 0.167 |
| daytime_journey_fraction | float | The proportion of journeys between 07:00-16:59 from or to a specific related_location_id, relative to all daytime journeys (07:00-16:59) involving the same location_id, within the same date range and flow dimension type. | 0.167 |
| evening_journey_fraction | float | The proportion of journeys between 17:00-06:59 from or to a specific related_location_id, relative to all evening journeys (17:00-06:59) involving the same location_id, within the same date range and flow dimension type. | 0.12 |
| weekday_journey_fraction | float | The proportion of journeys between Monday to Friday from or to a specific related_location_id, relative to all weekday journeys (Monday to Friday) involving the same location_id, within the same date range and flow dimension type. | 0.02 |
| weekend_journey_fraction | float | The proportion of journeys on Saturdays and Sundays from or to a specific related_location_id, relative to all weekend journeys (Saturdays and Sundays) involving the same location_id, within the same date range and flow dimension type. | 0.167 |
| immediate_journey_fraction | float | The proportion of journeys within 0-59 (inclusive) min duration from or to a specific related_location_id, relative to all immediate journeys (0-59min) involving the same location_id, within same date range, and flow dimension type. | 0.167 |
| extended_journey_fraction | float | The proportion of journeys within 1-7 hrs/60-420 minutes duration from or to a specific related_location_id relative to all extended journeys (1-7 hrs) involving the same location_id, within same date range, and flow dimension type. | 0.167 |
| avg_journey_duration_minutes | float | The average time taken (in minutes) to travel from location_id to related_location_id, calculated based on all journeys observed between these two locations. | 5.234 |
| avg_journey_distance_meters | float | The average distance travelled (in meters) from location_id to related_location_id, based on all journeys observed between these two locations. | 5000.234 |
| confidence_score | float | A calculated measure of data quality for total journey inflow or outflow. It reflects the confidence in the precision of the area of interest (location_id) and its related areas (related_location_id), as well as the statistical strength of the observed relationships and data scale. The score ranges from 0 to 1. | 0.937 |