Campos de dados de lugares

Os campos de dados sobre lugares definem os tipos de dados a serem retornados ao solicitar detalhes do lugar (legado). 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 detalhes de lugar (legado) 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 (legada) API Places Library, Maps JavaScript SDK do Places para Android (legado) SDK do Places para iOS (legado)
Componentes de endereço address_components address_components 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.FORMATTED_ADDRESS GMSPlaceFieldFormattedAddress
Janela de visualização geometry/viewport geometry.viewport Place.Field.VIEWPORT GMSPlaceFieldViewport
Local geometry/location geometry.location Place.Field.LOCATION GMSPlaceFieldCoordinate
Ícone icon icon --- ---
URI base da máscara de ícones icon_mask_base_uri icon_mask_base_uri Place.Field.ICON_MASK_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.DISPLAY_NAME GMSPlaceFieldName
Permanentemente fechado (descontinuado) permanently_closed permanently_closed --- ---
Foto photos photos Place.Field.PHOTO_METADATAS GMSPlaceFieldPhotos
ID de 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 --- Place.Field.ACCESSIBILITY_OPTIONS GMSPlaceFieldWheelchairAccessibleEntrance

Campos de dados do contato

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

Campos de dados de ambiente

Campo API Places (legada) API Places Library, Maps JavaScript SDK do Places para Android (legado) SDK do Places para iOS (legado)
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 --- Place.Field.EDITORIAL_SUMMARY GMSPlaceFieldEditorialSummary
Nível de preço price_level price_level Place.Field.PRICE_LEVEL GMSPlaceFieldPriceLevel
Classificação rating rating Place.Field.RATING GMSPlaceFieldRating
Aceita reservas reservable --- Place.Field.RESERVABLE GMSPlaceFieldReservable
Avaliações reviews reviews Place.Field.REVIEWS ---
Serve cerveja serves_beer --- Place.Field.SERVES_BEER GMSPlaceFieldServesBeer
Serve café da manhã serves_breakfast --- Place.Field.SERVES_BREAKFAST GMSPlaceFieldServesBreakfast
Serve brunch serves_brunch --- Place.Field.SERVES_BRUNCH GMSPlaceFieldServesBrunch
Serve jantar serves_dinner --- Place.Field.SERVES_DINNER GMSPlaceFieldServesDinner
Serve almoço serves_lunch --- Place.Field.SERVES_LUNCH GMSPlaceFieldServesLunch
Serve comida vegetariana serves_vegetarian_food --- Place.Field.SERVES_VEGETARIAN_FOOD GMSPlaceFieldServesVegetarianFood
Serve vinho serves_wine --- Place.Field.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_COUNT GMSPlaceFieldUserRatingsTotal

Suporte a campos da biblioteca Places e da API Maps JavaScript

As solicitações do Find Place (legado), Nearby Search (legado) e Text Search (legado) retornam um subconjunto dos campos retornados por solicitações do Place Details (legado). 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 (legado) e o Text Search (legado), 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 (legado), transmita um ID de lugar e especifique quais campos serão retornados.