All countries support the core schema, and then each country has additional schema items.
| Field Name | Type | Mode | Description | Example |
|---|---|---|---|---|
point |
GEOGRAPHY |
NULLABLE |
The location of the place as a Point geography type object. | POINT(-122.08532 37.42205) |
id |
STRING |
NULLABLE |
The unique place id. See Place IDs. | ChIJj61dQgK6j4AR4GeTYWZsKWw |
types |
STRING |
REPEATED |
A set of type tags for the place. For example, "restaurant" and "cafe". For the complete list of possible values, see Place Types. | restaurant,point_of_interest,establishment |
primary_type |
STRING |
NULLABLE |
The primary type of the place. For example, "restaurant", "cafe", "airport", etc. A place can only have a single primary type. For the complete list of possible values, see Place Types. | restaurant |
country_code |
STRING |
NULLABLE |
The country code in the Unicode CLDR format. | US |
location |
RECORD |
NULLABLE |
The position of the place. | |
location.latitude |
FLOAT |
NULLABLE |
The latitude in degrees. Ranges from -90.0 to 90.0. | 37.42205 |
location.longitude |
FLOAT |
NULLABLE |
The longitude in degrees. Ranges from -180.0 to 180.0. | -122.08532 |
rating |
FLOAT |
NULLABLE |
A rating between 1.0 and 5.0, based on user reviews of the place. | 4.5 |
user_rating_count |
INTEGER |
NULLABLE |
The total number of reviews for the place. | 100 |
price_level |
STRING |
NULLABLE |
Price level of the place. Possible values are "PRICE_LEVEL_FREE", "PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE", "PRICE_LEVEL_EXPENSIVE", and "PRICE_LEVEL_VERY_EXPENSIVE". | PRICE_LEVEL_MODERATE |
business_status |
STRING |
NULLABLE |
The business status for the place. Possible values are "OPERATIONAL", "CLOSED_TEMPORARILY", and "CLOSED_PERMANENTLY". | OPERATIONAL |
takeout |
BOOLEAN |
NULLABLE |
Place supports takeout. | true |
delivery |
BOOLEAN |
NULLABLE |
Place supports delivery. | true |
dine_in |
BOOLEAN |
NULLABLE |
Place supports indoor or outdoor seating options. | true |
curbside_pickup |
BOOLEAN |
NULLABLE |
Place supports curbside pickup. | true |
reservable |
BOOLEAN |
NULLABLE |
Place supports reservations. | true |
serves_breakfast |
BOOLEAN |
NULLABLE |
Place serves breakfast. | true |
serves_lunch |
BOOLEAN |
NULLABLE |
Place serves lunch. | true |
serves_dinner |
BOOLEAN |
NULLABLE |
Place serves dinner. | true |
serves_beer |
BOOLEAN |
NULLABLE |
Place serves beer. | true |
serves_wine |
BOOLEAN |
NULLABLE |
Place serves wine. | true |
serves_brunch |
BOOLEAN |
NULLABLE |
Place serves brunch. | true |
serves_vegetarian_food |
BOOLEAN |
NULLABLE |
Place serves vegetarian food. | true |
outdoor_seating |
BOOLEAN |
NULLABLE |
Place provides outdoor seating. | true |
live_music |
BOOLEAN |
NULLABLE |
Place provides live music. | true |
menu_for_children |
BOOLEAN |
NULLABLE |
Place has a children's menu. | true |
serves_cocktails |
BOOLEAN |
NULLABLE |
Place serves cocktails. | true |
serves_dessert |
BOOLEAN |
NULLABLE |
Place serves dessert. | true |
serves_coffee |
BOOLEAN |
NULLABLE |
Place serves coffee. | true |
good_for_children |
BOOLEAN |
NULLABLE |
Place is good for children. | true |
allows_dogs |
BOOLEAN |
NULLABLE |
Place allows dogs. | true |
restroom |
BOOLEAN |
NULLABLE |
Place has a restroom. | true |
good_for_groups |
BOOLEAN |
NULLABLE |
Place accommodates groups. | true |
good_for_watching_sports |
BOOLEAN |
NULLABLE |
Place is suitable for watching sports. | true |
accepts_credit_cards |
BOOLEAN |
NULLABLE |
Place accepts credit cards as payment. | true |
accepts_debit_cards |
BOOLEAN |
NULLABLE |
Place accepts debit cards as payment. | true |
accepts_cash_only |
BOOLEAN |
NULLABLE |
Place accepts cash only as payment. Places with this attribute may still accept other payment methods. | true |
accepts_nfc |
BOOLEAN |
NULLABLE |
Place accepts NFC payments. | true |
free_parking_lot |
BOOLEAN |
NULLABLE |
Place offers free parking lots. | true |
paid_parking_lot |
BOOLEAN |
NULLABLE |
Place offers paid parking lots. | true |
free_street_parking |
BOOLEAN |
NULLABLE |
Place offers free street parking. | true |
paid_street_parking |
BOOLEAN |
NULLABLE |
Place offers paid street parking. | true |
valet_parking |
BOOLEAN |
NULLABLE |
Place offers valet parking. | true |
free_garage_parking |
BOOLEAN |
NULLABLE |
Place offers free garage parking. | true |
paid_garage_parking |
BOOLEAN |
NULLABLE |
Place offers paid garage parking. | true |
wheelchair_accessible_parking |
BOOLEAN |
NULLABLE |
Place offers wheelchair accessible parking. | true |
wheelchair_accessible_entrance |
BOOLEAN |
NULLABLE |
Place has a wheelchair accessible entrance. | true |
wheelchair_accessible_restroom |
BOOLEAN |
NULLABLE |
Place has a wheelchair accessible restroom. | true |
wheelchair_accessible_seating |
BOOLEAN |
NULLABLE |
Place has wheelchair accessible seating. | true |
regular_opening_hours |
RECORD |
NULLABLE |
The regular hours of operation. See the opening hours reference. | |
regular_opening_hours_happy_hour |
RECORD |
NULLABLE |
The regular hours of operation for the secondary hours type "HAPPY_HOUR". See the opening hours reference. | |
regular_opening_hours_drive_through |
RECORD |
NULLABLE |
The regular hours of operation for the secondary hours type "DRIVE_THROUGH". See the opening hours reference. | |
regular_opening_hours_delivery |
RECORD |
NULLABLE |
The regular hours of operation for the secondary hours type "DELIVERY". See the opening hours reference. | |
regular_opening_hours_takeout |
RECORD |
NULLABLE |
The regular hours of operation for the secondary hours type "TAKEOUT". See the opening hours reference. | |
regular_opening_hours_kitchen |
RECORD |
NULLABLE |
The regular hours of operation for the secondary hours type "KITCHEN". See the opening hours reference. | |
regular_opening_hours_breakfast |
RECORD |
NULLABLE |
The regular hours of operation for the secondary hours type "BREAKFAST". See the opening hours reference. | |
regular_opening_hours_lunch |
RECORD |
NULLABLE |
The regular hours of operation for the secondary hours type "LUNCH". See the opening hours reference. | |
regular_opening_hours_dinner |
RECORD |
NULLABLE |
The regular hours of operation for the secondary hours type "DINNER". See the opening hours reference. | |
regular_opening_hours_brunch |
RECORD |
NULLABLE |
The regular hours of operation for the secondary hours type "BRUNCH". See the opening hours reference. | |
regular_opening_hours_pickup |
RECORD |
NULLABLE |
The regular hours of operation for the secondary hours type "PICKUP". See the opening hours reference. | |
regular_opening_hours_access |
RECORD |
NULLABLE |
The regular hours of operation for the secondary hours type "ACCESS". See the opening hours reference. | |
regular_opening_hours_senior_hours |
RECORD |
NULLABLE |
The regular hours of operation for the secondary hours type "SENIOR_HOURS". See the opening hours reference. | |
regular_opening_hours_online_service_hours |
RECORD |
NULLABLE |
The regular hours of operation for the secondary hours type "ONLINE_SERVICE_HOURS". See the opening hours reference. | |
ev_charge_options |
RECORD |
NULLABLE |
Information about the EV Charge Station hosted at the place. Terminology follows https://afdc.energy.gov/fuels/electricity_infrastructure.html. One port could charge one car at a time. One port has one or more connectors. One station has one or more ports. | |
ev_charge_options.connector_count |
INTEGER |
NULLABLE |
Number of connectors at this station. However, because some ports can have multiple connectors but only be able to charge one car at a time (e.g.) the number of connectors may be greater than the total number of cars which can charge simultaneously. | 3 |
ev_charge_options.connector_aggregation |
RECORD |
REPEATED |
A list of EV charging connector aggregations that contain connectors of the same type and same charge rate. | |
ev_charge_options.connector_aggregation.type |
STRING |
NULLABLE |
The connector type of this aggregation. See EVConnectorType for the list of possible connector types. | EV_CONNECTOR_TYPE_J1772 |
ev_charge_options.connector_aggregation.max_charge_rate_kw |
FLOAT |
NULLABLE |
The static max charging rate in kw of each connector in the aggregation. | 16.0 |
ev_charge_options.connector_aggregation.count |
INTEGER |
NULLABLE |
Number of connectors in this aggregation. | 3 |
brand_ids |
STRING |
REPEATED |
The unique identifiers for brands. | 13992718219781496405 |
Opening hours reference
The regular hours of operation for a given opening hours type. Hours are
separated by the day of the week. For periods that extend past midnight, the end
time is truncated to 23:59:59.999999 and the following day contains an
interval starting at 00:00:00.000000. For example, if a place is open on
Fridays from 8 AM to 12 PM and then from 8 PM to 2 AM, the periods for friday
would be: [{start_time: "08:00:00", end_time: "12:00:00"}, {start_time:
"20:00:00", end_time: "23:59:59.999999"}].
To query for places open on Friday at 5 pm you could run the following query:
SELECT WITH AGGREGATION_THRESHOLD COUNT(*) AS count FROM `PROJECT_NAME.places_insights___us___sample.places_sample` WHERE EXISTS(SELECT * FROM UNNEST(regular_opening_hours.friday) WHERE '17:00:00' BETWEEN start_time AND end_time)
The full schema for opening hours fields is as follows:
| Field Name | Type | Mode | Description | Example |
|---|---|---|---|---|
monday |
RECORD |
REPEATED |
The list of periods on Monday during which the place is open. | |
monday.start_time |
TIME |
NULLABLE |
Start of the period. | 08:00:00 |
monday.end_time |
TIME |
NULLABLE |
End of the period. | 18:00:00 |
tuesday |
RECORD |
REPEATED |
The list of periods on Tuesday during which the place is open. | |
tuesday.start_time |
TIME |
NULLABLE |
Start of the period. | 08:00:00 |
tuesday.end_time |
TIME |
NULLABLE |
End of the period. | 18:00:00 |
wednesday |
RECORD |
REPEATED |
The list of periods on Wednesday during which the place is open. | |
wednesday.start_time |
TIME |
NULLABLE |
Start of the period. | 08:00:00 |
wednesday.end_time |
TIME |
NULLABLE |
End of the period. | 18:00:00 |
thursday |
RECORD |
REPEATED |
The list of periods on Thursday during which the place is open. | |
thursday.start_time |
TIME |
NULLABLE |
Start of the period. | 08:00:00 |
thursday.end_time |
TIME |
NULLABLE |
End of the period. | 18:00:00 |
friday |
RECORD |
REPEATED |
The list of periods on Friday during which the place is open. | |
friday.start_time |
TIME |
NULLABLE |
Start of the period. | 08:00:00 |
friday.end_time |
TIME |
NULLABLE |
End of the period. | 18:00:00 |
saturday |
RECORD |
REPEATED |
The list of periods on Saturday during which the place is open. | |
saturday.start_time |
TIME |
NULLABLE |
Start of the period. | 08:00:00 |
saturday.end_time |
TIME |
NULLABLE |
End of the period. | 18:00:00 |
sunday |
RECORD |
REPEATED |
The list of periods on Sunday during which the place is open. | |
sunday.start_time |
TIME |
NULLABLE |
Start of the period. | 08:00:00 |
sunday.end_time |
TIME |
NULLABLE |
End of the period. | 18:00:00 |