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 ColumnData 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 ColumnData 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 ColumnData 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 ColumnData 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 ColumnData 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 ColumnData 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 ColumnData 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