Campos de dados de lugares

Selecione a plataforma: Android iOS JavaScript Web Service

Os campos de dados do Place definem os tipos de dados a serem retornados ao solicitar o Place Details. Nesta página, listamos todos os campos de dados de lugar e explicamos como eles são aceitos para cada API/SDK. A compatibilidade com campos de lugar varia de acordo com a plataforma e/ou o recurso.

Para mais informações sobre como as solicitações de dados de lugar são faturadas, consulte Uso e faturamento.

A tabela a seguir lista todos os valores de campo de dados de lugar compatíveis por camada de preços e plataforma.

Basic Data

Campo API Places API Places Library, Maps JavaScript SDK do Places para Android SDK do Places para iOS
Componentes de endereço address_components address_components Place.Field.ADDRESS_COMPONENTS GMSPlaceFieldAddressComponents
Endereço adr_address adr_address --- ---
Status comercial business_status business_status Place.Field.BUSINESS_STATUS GMSPlaceFieldBusinessStatus
Endereço formatado formatted_address formatted_address Place.Field.ADDRESS GMSPlaceFieldFormattedAddress
Janela de visualização geometry/viewport geometry.viewport Place.Field.VIEWPORT GMSPlaceFieldViewport
Local geometry/location geometry.location Place.Field.LAT_LNG GMSPlaceFieldCoordinate
Ícone icon icon --- ---
URI base da máscara de ícones icon_mask_base_uri icon_mask_base_uri Place.Field.ICON_URL GMSPlaceFieldIconImageURL
Cor de segundo plano do ícone icon_background_color icon_background_color Place.Field.ICON_BACKGROUND_COLOR GMSPlaceFieldIconBackgroundColor
Nome name name Place.Field.NAME GMSPlaceFieldName
Permanentemente fechado (descontinuado) permanently_closed permanently_closed --- ---
Foto photos photos Place.Field.PHOTO_METADATAS GMSPlaceFieldPhotos
ID do lugar place_id place_id Place.Field.ID GMSPlaceFieldPlaceID
Plus Code plus_code plus_code Place.Field.PLUS_CODE GMSPlaceFieldPlusCode
Tipo type type Place.Field.TYPES GMSPlaceFieldTypes
URL url url --- ---
Deslocamento de UTC utc_offset utc_offset_minutes Place.Field.UTC_OFFSET GMSPlaceFieldUTCOffsetMinutes
Vizinhança vicinity vicinity --- ---
Entrada com acessibilidade wheelchair_accessible_entrance --- --- GMSPlaceFieldWheelchairAccessibleEntrance

Campos de dados do contato

Campo API Places API Places Library, Maps JavaScript SDK do Places para Android SDK do Places para iOS
Número de telefone formatted_phone_number formatted_phone_number --- ---
Número de telefone internacional international_phone_number international_phone_number Place.Field.PHONE_NUMBER GMSPlaceFieldPhoneNumber
Horário de funcionamento opening_hours opening_hours Place.Field.OPENING_HOURS GMSPlaceFieldOpeningHours
Horário de funcionamento atual current_opening_hours --- --- ---
Horário de funcionamento secundário secondary_opening_hours --- --- ---
Site website website Place.Field.WEBSITE_URI GMSPlaceFieldWebsite

Campos de dados de ambiente

Campo API Places API Places Library, Maps JavaScript SDK do Places para Android SDK do Places para iOS
Drive-thru curbside_pickup --- Place.Field.CURBSIDE_PICKUP GMSPlaceFieldCurbsidePickup
Entrega delivery --- Place.Field.DELIVERY GMSPlaceFieldDelivery
Refeição no local dine_in --- Place.Field.DINE_IN GMSPlaceFieldDineIn
Resumo editorial editorial_summary --- --- ---
Nível de preço price_level price_level Place.Field.PRICE_LEVEL GMSPlaceFieldPriceLevel
Avaliação rating rating Place.Field.RATING GMSPlaceFieldRating
Aceita reservas reservable --- --- GMSPlaceFieldReservable
Avaliações reviews reviews --- ---
Serve cerveja serves_beer --- --- GMSPlaceFieldServesBeer
Serve café da manhã serves_breakfast --- --- GMSPlaceFieldServesBreakfast
Serve brunch serves_brunch --- --- GMSPlaceFieldServesBrunch
Serve jantar serves_dinner --- --- GMSPlaceFieldServesDinner
Serve almoço serves_lunch --- --- GMSPlaceFieldServesLunch
Serve comida vegetariana serves_vegetarian_food --- --- GMSPlaceFieldServesVegetarianFood
Serve vinho serves_wine --- --- GMSPlaceFieldServesWine
Para viagem takeout --- Place.Field.TAKEOUT GMSPlaceFieldTakeout
Total de avaliações de usuários user_ratings_total user_ratings_total Place.Field.USER_RATINGS_TOTAL GMSPlaceFieldUserRatingsTotal

Suporte a campos da biblioteca Places e da API Maps JavaScript

As solicitações do Find Place, Nearby Search e Text Search retornam um subconjunto dos campos retornados por solicitações do Place Details. Esses métodos NÃO retornam os seguintes campos:

  • address_component
  • adr_address
  • formatted_phone_number
  • international_phone_number
  • opening_hours: não é retornado para nenhum Place Search. Para o Nearby Search e o Text Search, use o parâmetro de solicitação openNow.
  • reviews
  • takeout
  • type
  • url
  • utc_offset_minutes
  • vicinity
  • website

Para retornar um ou mais desses campos de dados de um lugar, faça uma solicitação do Place Details, transmita um ID de lugar e especifique quais campos serão retornados.