{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://raw.githubusercontent.com/api-evangelist/replica/refs/heads/main/json-schema/replica-commercial-freight.json", "title": "Commercial Freight Trips", "description": "One row of Replica's \"Commercial Freight Trips\" dataset. Derived from the published schema table at https://documentation.replicahq.com/docs/commercial-freight.", "x-source": "https://documentation.replicahq.com/docs/commercial-freight", "x-generated": "2026-08-02", "x-method": "derived", "x-status": "active", "type": "object", "properties": { "activity_id": { "type": [ "string", "null" ], "description": "A randomly assigned unique identifier defined for each trip. A trip is defined as travel between two locations with a discrete purpose at the origin and destination. Some intermediate stops with short dwell time may be captured within a single trip. Criteria for this dwell time may vary. Examples of trips: \u2022 Home > Work, \u2022 Work > Gym, \u2022 Shop > Eat, \u2022 Home > Starbucks drive-thru > Work", "examples": [ "15323941267251300000" ] }, "person_id": { "type": [ "string", "null" ], "description": "A randomly assigned unique identifier for each person modeled within the synthetic population.", "examples": [ "4339817784218880000" ] }, "household_id": { "type": [ "string", "null" ], "description": "A randomly assigned unique identifier for each household modeled within the synthetic population.", "examples": [ "14408018579505000000" ] }, "mode": { "type": [ "string", "null" ], "description": "The primary transportation mode used for the trip. A trip is often made up of multiple travel modes, such as a journey to work that includes a walk to a rail station followed by a subway ride. In this case two modes were used by the traveler during their trip, walking and public transit. Only the primary mode of travel across a set of trip segments is included. The primary mode is determined using the following ranking: 1) Public transit, 2) Driving (private auto)/Auto passenger/Taxi/TNC, 3) Biking, 4) Walking. This table is limited to the following: \u2022 COMMERCIAL: Trips made by medium and heavy trucks", "examples": [ "COMMERCIAL" ] }, "travel_purpose": { "type": [ "string", "null" ], "description": "All values in this table are: \u2022 COMMERCIAL: Trips by medium and heavy trucks for deliveries and other commercial purposes", "examples": [ "COMMERCIAL" ] }, "tour_type": { "type": [ "string", "null" ], "description": "Indicates what type of tour included this trip. Tours are travel events that start at one location and return to that same location. All values in this table are: \u2022 OTHER_HOME_BASED: Tours that started and ended at home, excluding commutes e.g. Home > Shop > Eat > Home", "examples": [ "OTHER_HOME_BASED" ] }, "previous_activity_type": { "type": [ "string", "null" ], "description": "The activity assigned to a synthetic person prior to starting travel. All values in this table are: \u2022 COMMERCIAL: Trips by medium and heavy trucks for deliveries and other commercial purposes", "examples": [ "COMMERCIAL" ] }, "timezone": { "type": [ "string", "null" ], "description": "Timezone of the trip\u2019s start location, using standard tz naming conventions.", "examples": [ "America/Los_Angeles" ] }, "start_time": { "type": [ "string", "null" ], "description": "Date and 24-hour time of trip start, reported as yyyy-mm-dd hh:mm:ss timezone.", "examples": [ "2019-01-10 06:08:00 America/Los_Angeles" ] }, "start_local_hour": { "type": [ "integer", "null" ], "description": "Hour of day that the trip started, reported in the local time zone in 24-hour time format. Values in this field range between 0 and 23.", "examples": [ "12" ] }, "end_time": { "type": [ "string", "null" ], "description": "Date and 24-hour time of trip end, reported as yyyy-mm-dd hh:mm:ss timezone.", "examples": [ "2019-01-10 07:11:04 America/Los_Angeles" ] }, "end_local_hour": { "type": [ "integer", "null" ], "description": "Hour of day that the trip ended, reported in the local time zone in 24-hour time format. Values in this field range between 0 and 23.", "examples": [ "14" ] }, "duration_minutes": { "type": [ "integer", "null" ], "description": "Duration of trip in minutes, calculated as the difference between the trip start_time and end_time.", "examples": [ "63" ] }, "distance_miles": { "type": [ "number", "null" ], "description": "Distance in miles measured along the trip route.", "examples": [ "10.79997335" ] }, "transit_route_ids": { "type": [ "string", "null" ], "description": "NULL for this table" }, "network_link_ids": { "type": [ "string", "null" ], "description": "Unique ID assigned to the link (road segment) that the trip is associated with.", "examples": [ "10541610554341416382" ] }, "vehicle_type": { "type": [ "string", "null" ], "description": "The vehicle type assigned to the vehicle of the synthetic trip. Valid values are: \u2022 MEDIUM_COMMERCIAL: Medium-duty commercial vehicles (14,000 - 26,000 lbs) \u2022 HEAVY _ COMMERCIAL: Heavy-duty commercial vehicles (>26,00 lbs) Note: If values are NULL, this means that this data is not available for the region yet but we hope to have it soon.", "examples": [ "MEDIUM_COMMERCIAL" ] }, "vehicle_fuel_technology": { "type": [ "string", "null" ], "description": "The fuel technology assigned to the vehicle of the synthetic trip. Valid values are: \u2022 ICE \u2022 BEV \u2022 FCV \u2022 PHEV \u2022 UNKNOWN_FUEL_TECHNOLOGY Note: If values are NULL, this means that this data is not available for the region yet but we hope to have it soon.", "examples": [ "ICE" ] }, "origin_bgrp": { "type": [ "string", "null" ], "description": "The US Census Bureau-assigned FIPS code of the block group from which the trip originated.", "examples": [ "410510010004" ] }, "origin_bgrp_lat": { "type": [ "number", "null" ], "description": "Latitude of the geometric centroid for the origin block group, reported in decimal degrees, WGS 84.", "examples": [ "45.492294" ] }, "origin_bgrp_lng": { "type": [ "number", "null" ], "description": "Longitude of the geometric centroid for the origin block group, reported in decimal degrees, WGS 84.", "examples": [ "-122.65334" ] }, "destination_bgrp": { "type": [ "string", "null" ], "description": "US Census Bureau-assigned FIPS of the block group in which the trip ended.", "examples": [ "410510079001" ] }, "destination_bgrp_lat": { "type": [ "number", "null" ], "description": "Latitude of the geometric centroid for the destination block group, reported in decimal degrees, WGS 84.", "examples": [ "45.557407" ] }, "destination_bgrp_lng": { "type": [ "number", "null" ], "description": "Longitude of the geometric centroid for the destination block group, reported in decimal degrees, WGS 84.", "examples": [ "-122.54931" ] }, "origin_land_use_l1": { "type": [ "string", "null" ], "description": "The primary land use category of the trip origin. Valid values are: \u2022 residential \u2022 commercial \u2022 mixed_use \u2022 industrial \u2022 civic_institutional \u2022 transportation_utilities \u2022 open space \u2022 agriculture \u2022 other \u2022 unknown", "examples": [ "residential" ] }, "origin_land_use_l2": { "type": [ "string", "null" ], "description": "The secondary land use category of the trip origin. Valid values are: \u2022 single_family \u2022 multi_family \u2022 office \u2022 retail \u2022 non_retail_attraction \u2022 education \u2022 healthcare \u2022 military \u2022 civic_institutional \u2022 \u200b\u200btransportation_utilities \u2022 open_space \u2022 agriculture \u2022 other \u2022 unknown", "examples": [ "single_family" ] }, "destination_land_use_l1": { "type": [ "string", "null" ], "description": "The primary land use category of the trip destination. Valid values are: \u2022 residential \u2022 commercial \u2022 mixed_use \u2022 industrial \u2022 civic_institutional \u2022 transportation_utilities \u2022 open space \u2022 agriculture \u2022 other \u2022 unknown", "examples": [ "commercial" ] }, "destination_land_use_l2": { "type": [ "string", "null" ], "description": "The secondary land use category of the trip destination. Valid values are: \u2022 single_family \u2022 multi_family \u2022 office \u2022 retail \u2022 non_retail_attraction \u2022 education \u2022 healthcare \u2022 military \u2022 civic_institutional \u2022 \u200b\u200btransportation_utilities \u2022 open_space \u2022 agriculture \u2022 other \u2022 unknown", "examples": [ "non_retail_attraction" ] }, "origin_building_use_l1": { "type": [ "string", "null" ], "description": "The primary building use category of the trip origin. Valid values are: \u2022 residential \u2022 commercial \u2022 industrial \u2022 civic_institutional \u2022 transportation_utilities \u2022 open space \u2022 agriculture \u2022 other \u2022 unknown", "examples": [ "residential" ] }, "origin_building_use_l2": { "type": [ "string", "null" ], "description": "The secondary building use category of the trip origin. Valid values are: \u2022 single_family \u2022 multi_family \u2022 office \u2022 retail \u2022 non_retail_attraction \u2022 education \u2022 healthcare \u2022 military \u2022 civic_institutional \u2022 \u200b\u200btransportation_utilities \u2022 open_space \u2022 agriculture \u2022 other \u2022 unknown", "examples": [ "single_family" ] }, "destination_building_use_l1": { "type": [ "string", "null" ], "description": "The primary building use category of the trip destination. Valid values are: \u2022 residential \u2022 commercial \u2022 industrial \u2022 civic_institutional \u2022 transportation_utilities \u2022 open space \u2022 agriculture \u2022 other \u2022 unknown", "examples": [ "commercial" ] }, "destination_building_use_l2": { "type": [ "string", "null" ], "description": "The secondary building use category of the trip destination. Valid values are: \u2022 single_family \u2022 multi_family \u2022 office \u2022 retail \u2022 non_retail_attraction \u2022 education \u2022 healthcare \u2022 military \u2022 civic_institutional \u2022 \u200b\u200btransportation_utilities \u2022 open_space \u2022 agriculture \u2022 other \u2022 unknown", "examples": [ "non_retail_attraction" ] }, "trip_type": { "type": [ "string", "null" ], "description": "Indicates whether or not the trip started or ended inside or outside of the core model region. Valid values are: \u2022 II: core > core region \u2022 IE: core > donut region \u2022 EI: donut region > core region \u2022 EE: donut region > donut region", "examples": [ "II" ] } }, "additionalProperties": true }