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 | Example | Description |
|---|---|---|---|
| observation_start_date | DATE | 2025-01-01 | The start date of the observation period. |
| observation_end_date | DATE | 2025-01-31 | The end date of the observation period. |
| location_id | STRING | zzy-23j@627-s8n-8y9 | Unique identifier of the location (SafeGraph Placekey or Custom Location ID). |
| related_location_id | STRING | 222-222@5z8-3pn-eh5 | 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. |
| flow_direction | STRING | inflow | 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". |
| total_journey_fraction | FLOAT | 0.167 | 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. |
| daytime_journey_fraction | FLOAT | 0.167 | 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. |
| evening_journey_fraction | FLOAT | 0.12 | 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. |
| weekday_journey_fraction | FLOAT | 0.02 | 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. |
| weekend_journey_fraction | FLOAT | 0.167 | 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. |
| immediate_journey_fraction | FLOAT | 0.167 | 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. |
| extended_journey_fraction | FLOAT | 0.167 | 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. |
| avg_journey_duration_minutes | FLOAT | 5.234 | 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. |
| avg_journey_distance_meters | FLOAT | 5000.234 | The average distance travelled (in meters) from location_id to related_location_id, based on all journeys observed between these two locations. |
| confidence_score | FLOAT | 0.937 | 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. |