Data Dictionary
Effective Date: January 1, 2026
This documentation site is meant to provide a glossary of defined terms with descriptions and data dictionaries across all products and services offered by CityData. You will find below the data schema and attribute descriptions for our major datasets. Please send your questions, feedback, and comments to your assigned Customer Success Manager or to the Business team: business@citydata.ai
Place Visits Data
The Place Visits data provides the anonymized and aggregated visits to places and geofences of interest.
| CSV Column | Data Attribute |
|---|---|
| 1 |
year
year for the ISO week
|
| 2 |
date
exact date for visit and movement inference
|
| 3 |
place_name
place name or fence name or park name for the analysis
|
| 4 |
functions
industry classification functions for the places or polygons
|
| 5 |
area
area of the place or geofence in square meters or acres
|
| 6 |
visits
total unique visits to the place, polygon, census area, or geofence for the duration of the analysis, this includes repeat visits
|
| 7 |
avg_repeat_visits
average repeat visits per device to the place or fence
|
| 8 |
pid
internal citydata identifier for the place, polygon, census area, or geofence
|
| 9 |
avg_dwell_min
average dwell time in minutes inferred for visits within the place or fence
|
| 10 |
up_to_1_h
percentage of visits with dwell time less than 1 hour
|
| 11 |
1_h_to_2_h
percentage of visits with dwell time between 1 to 2 hours
|
| 12 |
2_h_to_4_h
percentage of visits with dwell time between 2 to 4 hours
|
| 13 |
more_than_4_h
percentage of visits with dwell time greater than 4 hours
|
| 14 |
hour_00
percentage of visits detected during hour 00
|
| 15 |
hour_01
percentage of visits detected during hour 01
|
| 16 |
hour_02
percentage of visits detected during hour 02
|
| 17 |
hour_03
percentage of visits detected during hour 03
|
| 18 |
hour_04
percentage of visits detected during hour 04
|
| 19 |
hour_05
percentage of visits detected during hour 05
|
| 20 |
hour_06
percentage of visits detected during hour 06
|
| 21 |
hour_07
percentage of visits detected during hour 07
|
| 22 |
hour_08
percentage of visits detected during hour 08
|
| 23 |
hour_09
percentage of visits detected during hour 09
|
| 24 |
hour_10
percentage of visits detected during hour 10
|
| 25 |
hour_11
percentage of visits detected during hour 11
|
| 26 |
hour_12
percentage of visits detected during hour 12
|
| 27 |
hour_13
percentage of visits detected during hour 13
|
| 28 |
hour_14
percentage of visits detected during hour 14
|
| 29 |
hour_15
percentage of visits detected during hour 15
|
| 30 |
hour_16
percentage of visits detected during hour 16
|
| 31 |
hour_17
percentage of visits detected during hour 17
|
| 32 |
hour_18
percentage of visits detected during hour 18
|
| 33 |
hour_19
percentage of visits detected during hour 19
|
| 34 |
hour_20
percentage of visits detected during hour 20
|
| 35 |
hour_21
percentage of visits detected during hour 21
|
| 36 |
hour_22
percentage of visits detected during hour 22
|
| 37 |
hour_23
percentage of visits detected during hour 23
|
Category Visits Data
The Category Visits data provides the anonymized and aggregated visits to business categories based on the NAICS taxonomy.
| CSV Column | Data Attribute |
|---|---|
| 1 |
date
date of analysis
|
| 2 |
place_id
internal citydata identifier for the place, polygon, census area, or geofence
|
| 3 |
place_type
industry classification functions for the places or polygons
|
| 4 |
name
place name or fence name or park name for the analysis
|
| 5 |
population
census population of the place or polygon
|
| 6 |
day_total_visits
total unique visits to the place, polygon, census area, or geofence for the duration of the analysis
|
| 7 |
hour_00
number of visits detected during hour 00
|
| 8 |
hour_01
number of visits detected during hour 01
|
| 9 |
hour_02
number of visits detected during hour 02
|
| 10 |
hour_03
number of visits detected during hour 03
|
| 11 |
hour_04
number of visits detected during hour 04
|
| 12 |
hour_05
number of visits detected during hour 05
|
| 13 |
hour_06
number of visits detected during hour 06
|
| 14 |
hour_07
number of visits detected during hour 07
|
| 15 |
hour_08
number of visits detected during hour 08
|
| 16 |
hour_09
number of visits detected during hour 09
|
| 17 |
hour_10
number of visits detected during hour 10
|
| 18 |
hour_11
number of visits detected during hour 11
|
| 19 |
hour_12
number of visits detected during hour 12
|
| 20 |
hour_13
number of visits detected during hour 13
|
| 21 |
hour_14
number of visits detected during hour 14
|
| 22 |
hour_15
number of visits detected during hour 15
|
| 23 |
hour_16
number of visits detected during hour 16
|
| 24 |
hour_17
number of visits detected during hour 17
|
| 25 |
hour_18
number of visits detected during hour 18
|
| 26 |
hour_19
number of visits detected during hour 19
|
| 27 |
hour_20
number of visits detected during hour 20
|
| 28 |
hour_21
number of visits detected during hour 21
|
| 29 |
hour_22
number of visits detected during hour 22
|
| 30 |
hour_23
number of visits detected during hour 23
|
| 31 |
home_furnishings_stores
number of visits to the NAICS-based category
|
| 32 |
specialty_food_stores
number of visits to the NAICS-based category
|
| 33 |
beer_wine_and_liquor_stores
number of visits to the NAICS-based category
|
| 34 |
health_and_personal_care_stores
number of visits to the NAICS-based category
|
| 35 |
clothing_stores
number of visits to the NAICS-based category
|
| 36 |
shoe_stores
number of visits to the NAICS-based category
|
| 37 |
office_supplies_stationery_and_gift_stores
number of visits to the NAICS-based category
|
| 38 |
other_miscellaneous_store_retailers
number of visits to the NAICS-based category
|
| 39 |
specialized_freight_trucking
number of visits to the NAICS-based category
|
| 40 |
taxi_and_limousine_service
number of visits to the NAICS-based category
|
| 41 |
museums_historical_sites_and_similar_institutions
number of visits to the NAICS-based category
|
| 42 |
traveler_accommodation
number of visits to the NAICS-based category
|
| 43 |
restaurants_and_other_eating_places
number of visits to the NAICS-based category
|
| 44 |
automotive_parts_accessories_and_tire_stores
number of visits to the NAICS-based category
|
| 45 |
jewelry_luggage_and_leather_goods_stores
number of visits to the NAICS-based category
|
| 46 |
personal_and_household_goods_repair_and_maintenance
number of visits to the NAICS-based category
|
| 47 |
nonresidential_building_construction
number of visits to the NAICS-based category
|
| 48 |
electronics_and_appliance_stores
number of visits to the NAICS-based category
|
| 49 |
couriers_and_express_delivery_services
number of visits to the NAICS-based category
|
| 50 |
machinery_equipment_and_supplies_merchant_wholesalers
number of visits to the NAICS-based category
|
| 51 |
furniture_stores
number of visits to the NAICS-based category
|
| 52 |
rail_transportation
number of visits to the NAICS-based category
|
| 53 |
newspaper_periodical_book_and_directory_publishers
number of visits to the NAICS-based category
|
| 54 |
promoters_of_performing_arts_sports_and_similar_events
number of visits to the NAICS-based category
|
| 55 |
miscellaneous_durable_goods_merchant_wholesalers
number of visits to the NAICS-based category
|
| 56 |
general_merchandise_stores_including_warehouse_clubs_and_supercenters
number of visits to the NAICS-based category
|
| 57 |
wired_and_wireless_telecommunications_carriers
number of visits to the NAICS-based category
|
| 58 |
arts_entertainment_and_recreation
number of visits to the NAICS-based category
|
| 59 |
sporting_goods_hobby_and_musical_instrument_stores
number of visits to the NAICS-based category
|
| 60 |
motion_picture_and_video_industries
number of visits to the NAICS-based category
|
| 61 |
commercial_and_industrial_machinery_and_equipment_rental_and_leasing
number of visits to the NAICS-based category
|
| 62 |
automotive_repair_and_maintenance
number of visits to the NAICS-based category
|
| 63 |
special_food_services
number of visits to the NAICS-based category
|
| 64 |
radio_and_television_broadcasting
number of visits to the NAICS-based category
|
| 65 |
electronic_shopping_and_mail_order_houses
number of visits to the NAICS-based category
|
| 66 |
automotive_equipment_rental_and_leasing
number of visits to the NAICS-based category
|
| 67 |
specialized_design_services
number of visits to the NAICS-based category
|
| 68 |
spectator_sports
number of visits to the NAICS-based category
|
| 69 |
lessors_of_real_estate
number of visits to the NAICS-based category
|
| 70 |
retail_trade
number of visits to the NAICS-based category
|
| 71 |
other_motor_vehicle_dealers
number of visits to the NAICS-based category
|
| 72 |
transit_and_ground_passenger_transportation
number of visits to the NAICS-based category
|
| 73 |
travel_arrangement_and_reservation_services
number of visits to the NAICS-based category
|
| 74 |
real_estate
number of visits to the NAICS-based category
|
| 75 |
scheduled_air_transportation
number of visits to the NAICS-based category
|
| 76 |
employment_services
number of visits to the NAICS-based category
|
| 77 |
warehousing_and_storage
number of visits to the NAICS-based category
|
| 78 |
other_information_services
number of visits to the NAICS-based category
|
| 79 |
support_activities_for_road_transportation
number of visits to the NAICS-based category
|
| 80 |
electronic_and_precision_equipment_repair_and_maintenance
number of visits to the NAICS-based category
|
| 81 |
lawn_and_garden_equipment_and_supplies_stores
number of visits to the NAICS-based category
|
| 82 |
software_publishers
number of visits to the NAICS-based category
|
| 83 |
clothing_and_clothing_accessories_stores
number of visits to the NAICS-based category
|
| 84 |
urban_transit_systems
number of visits to the NAICS-based category
|
| 85 |
household_appliances_and_electrical_and_electronic_goods_merchant_wholesalers
number of visits to the NAICS-based category
|
| 86 |
independent_artists_writers_and_performers
number of visits to the NAICS-based category
|
| 87 |
consumer_goods_rental
number of visits to the NAICS-based category
|
| 88 |
freight_transportation_arrangement
number of visits to the NAICS-based category
|
| 89 |
cable_and_other_subscription_programming
number of visits to the NAICS-based category
|
| 90 |
repair_and_maintenance
number of visits to the NAICS-based category
|
| 91 |
scenic_and_sightseeing_transportation_land
number of visits to the NAICS-based category
|
| 92 |
insurance_carriers
number of visits to the NAICS-based category
|
| 93 |
construction_of_buildings
number of visits to the NAICS-based category
|
| 94 |
chemical_and_allied_products_merchant_wholesalers
number of visits to the NAICS-based category
|
| 95 |
support_activities_for_agriculture_and_forestry
number of visits to the NAICS-based category
|
| 96 |
agriculture_forestry_fishing_and_hunting
number of visits to the NAICS-based category
|
| 97 |
interurban_and_rural_bus_transportation
number of visits to the NAICS-based category
|
| 98 |
telecommunications
number of visits to the NAICS-based category
|
| 99 |
other_services_except_public_administration
number of visits to the NAICS-based category
|
| 100 |
general_freight_trucking
number of visits to the NAICS-based category
|
CBG Visits Data
The CBG Visits data provides the anonymized and aggregated visits to census block groups or equivalent administrative shapes.
| CSV Column | Data Attribute |
|---|---|
| 1 |
date
date of analysis
|
| 2 |
place_id
internal citydata identifier for the place, polygon, census area, or geofence
|
| 3 |
place_type
industry classification functions for the places or polygons
|
| 4 |
name
place name or fence name or park name for the analysis
|
| 5 |
population
census population of the place or polygon
|
| 6 |
hour_00_visits
number of visits detected during hour 00
|
| 7 |
hour_01_visits
number of visits detected during hour 01
|
| 8 |
hour_02_visits
number of visits detected during hour 02
|
| 9 |
hour_03_visits
number of visits detected during hour 03
|
| 10 |
hour_04_visits
number of visits detected during hour 04
|
| 11 |
hour_05_visits
number of visits detected during hour 05
|
| 12 |
hour_06_visits
number of visits detected during hour 06
|
| 13 |
hour_07_visits
number of visits detected during hour 07
|
| 14 |
hour_08_visits
number of visits detected during hour 08
|
| 15 |
hour_09_visits
number of visits detected during hour 09
|
| 16 |
hour_10_visits
number of visits detected during hour 10
|
| 17 |
hour_11_visits
number of visits detected during hour 11
|
| 18 |
hour_12_visits
number of visits detected during hour 12
|
| 19 |
hour_13_visits
number of visits detected during hour 13
|
| 20 |
hour_14_visits
number of visits detected during hour 14
|
| 21 |
hour_15_visits
number of visits detected during hour 15
|
| 22 |
hour_16_visits
number of visits detected during hour 16
|
| 23 |
hour_17_visits
number of visits detected during hour 17
|
| 24 |
hour_18_visits
number of visits detected during hour 18
|
| 25 |
hour_19_visits
number of visits detected during hour 19
|
| 26 |
hour_20_visits
number of visits detected during hour 20
|
| 27 |
hour_21_visits
number of visits detected during hour 21
|
| 28 |
hour_22_visits
number of visits detected during hour 22
|
| 29 |
hour_23_visits
number of visits detected during hour 23
|
| 30 |
day_total_visits
total unique visits to the place, polygon, census area, or geofence for the duration of the analysis
|
CBG Movement Data
The CBG Movement data provides the movement patterns or visitor origins across the administrative or geospatial grid.
| CSV Column | Data Attribute |
|---|---|
| 1 |
year
year for the ISO week
|
| 2 |
month
month for the ISO week
|
| 3 |
place_name
place name or fence name or park name for the analysis
|
| 4 |
block_name
census block name
|
| 5 |
percentage
percentage device per block
|
| 6 |
distance
distance between place to census block (us is miles and non-us is km)
|
OD Movement Data
The OD Movement data provides the trip origins and destinations for movement across the administrative or geospatial grid.
| CSV Column | Data Attribute |
|---|---|
| 1 |
device_id
hashed anonymized unique device identifier
|
| 2 |
origin_geoid
geohash id of the origin grid cell
|
| 3 |
destination_geoid
geohash id of the destination grid cell
|
| 4 |
end_timestamp
end timestamp / local time
|
| 5 |
start_timestamp
start timestamp / local time
|
| 6 |
origin_lat
origin latitude with 5 digit decimal precision
|
| 7 |
origin_long
origin longitude with 5 digit decimal precision
|
| 8 |
destination_lat
destination latitude with 5 digit decimal precision
|
| 9 |
destination_lon
destination longitude with 5 digit decimal precision
|
| 10 |
trip_distance
inferred distance travelled in meters
|
| 11 |
trip_duration
inferred duration of the trip in seconds
|
| 12 |
trip_speed
inferred speed of the trip in meters per second
|
| 13 |
hour_of_day
hour of day of trip start (0-23)
|
| 14 |
time_period
day part of trip start (morning, afternoon, evening, night)
|
| 15 |
day_of_week
day of week of trip start (mon, tue, wed, thu, fri, sat, sun)
|
| 16 |
year
iso year of trip start
|
| 17 |
iso_week
iso week of the trip
|
| 18 |
iso_week_start_date
iso week, start date
|
| 19 |
iso_week_end_date
iso week, end date
|
| 20 |
travel_mode
mode of travel (walking, driving, cycling, etc)
|
Trip Routes Data
The Trip Routes data provides the trip trajectories or routes for the movement along road segments with mode, speed, distance, and travel time.
| CSV Column | Data Attribute |
|---|---|
| 1 |
device_id
hashed anonymized unique device identifier
|
| 2 |
origin_geoid
geohash id of the origin grid cell
|
| 3 |
destination_geoid
geohash id of the destination grid cell
|
| 4 |
end_timestamp
end timestamp / local time
|
| 5 |
start_timestamp
start timestamp / local time
|
| 6 |
origin_lat
origin latitude with 5 digit decimal precision
|
| 7 |
origin_long
origin longitude with 5 digit decimal precision
|
| 8 |
destination_lat
destination latitude with 5 digit decimal precision
|
| 9 |
destination_lon
destination longitude with 5 digit decimal precision
|
| 10 |
trip_distance
inferred distance travelled in meters
|
| 11 |
trip_duration
inferred duration of the trip in seconds
|
| 12 |
trip_speed
inferred speed of the trip in meters per second
|
| 13 |
hour_of_day
hour of day of trip start (0-23)
|
| 14 |
time_period
day part of trip start (morning, afternoon, evening, night)
|
| 15 |
day_of_week
day of week of trip start (mon, tue, wed, thu, fri, sat, sun)
|
| 16 |
year
iso year of trip start
|
| 17 |
iso_week
iso week of the trip
|
| 18 |
iso_week_start_date
iso week, start date
|
| 19 |
iso_week_end_date
iso week, end date
|
| 20 |
travel_mode
mode of travel (walking, driving, cycling, etc)
|
| 21 |
trip_event
trip or segment events (start, route, end, start-end)
|
| 22 |
trip_id
trip id
|
| 23 |
osm_way_id
OpenStreetMap way id
|
| 24 |
osm_way_version
OpenStreetMap way version
|
Traffic Volumes Data
The Traffic Volumes data provides the aggregated traffic counts for each road segment with average speed and modality.
| CSV Column | Data Attribute |
|---|---|
| 1 |
timestamp
timestamp of the event by the hour in the format of yyyy-MM-dd-HH
|
| 2 |
osm_way_id
unique identifier of the road segment extracted from OSM
|
| 3 |
driving_count
count of driving trips on the OSM way for that hour
|
| 4 |
walking_count
count of walking trips on the OSM way for that hour
|
| 5 |
cycling_count
count of cycling trips on the OSM way for that hour
|
| 6 |
driving_avg_speed
average driving speed in meters per second
|
| 7 |
walking_avg_speed
average walking speed in meters per second
|
| 8 |
cycling_avg_speed
average cycling speed in meters per second
|