Campos de dados de lugar

Selecione a plataforma: Android iOS JavaScript Serviço da Web

Os campos de dados de lugar definem os tipos de dados de lugar 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 do Place Details são faturadas, consulte Uso e faturamento.

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

Basic Data

Field API Places API Places Library, Maps JavaScript SDK do Places para Android SDK do Places para iOS
Componente "Endereço" address_component address_component Place.Field.ADDRESS_COMPONENTS GMSPlaceFieldAddressComponents
Endereço adr_address adr_address --- ---
Status da empresa 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 do máscara de ícones icon_mask_base_uri icon_mask_base_uri Place.Field.ICON_URL GMSPlaceFieldIconImageURL
Cor do plano de fundo 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 UTC utc_offset utc_offset_minutes Place.Field.UTC_OFFSET GMSPlaceFieldUTCOffsetMinutes
Vizinhança vicinity vicinity --- ---

Campos de dados do contato

Field 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ários opening_hours opening_hours Place.Field.OPENING_HOURS GMSPlaceFieldOpeningHours
Site website website Place.Field.WEBSITE_URI GMSPlaceFieldWebsite

Campos de dados do ambiente

Field API Places API Places Library, Maps JavaScript SDK do Places para Android SDK do Places para iOS
Drive-thru curbside_pickup --- --- ---
Exibição delivery --- --- ---
Refeição no local dine_in --- --- ---
Nível de preço: price_level price_level Place.Field.PRICE_LEVEL GMSPlaceFieldPriceLevel
Avaliação rating rating Place.Field.RATING GMSPlaceFieldRating
Avaliações reviews reviews --- ---
Para viagem takeout --- --- ---
Total de classificações do usuário user_ratings_total user_ratings_total Place.Field.USER_RATINGS_TOTAL GMSPlaceFieldUserRatingsTotal

Suporte a campos da biblioteca do Places e da API Maps JavaScript

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

  • address_component
  • adr_address
  • formatted_phone_number
  • international_phone_number
  • opening_hours
  • reviews
  • type
  • url
  • utc_offset_minutes
  • vicinity
  • website

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