Core schema reference

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
Design a Mobile Site
View Site in Mobile | Classic
Share by: