Esta página foi traduzida pela API Cloud Translation.

Detalhes do lugar (novo)

Selecione a plataforma: Android iOS JavaScript Web Service

Desenvolvedores do Espaço Econômico Europeu (EEE)

Introdução

Depois de ter um ID de lugar, você pode solicitar mais detalhes sobre um estabelecimento ou ponto de interesse específico iniciando uma solicitação de Place Details (New). Uma solicitação de Place Details (New) retorna informações mais abrangentes sobre o lugar indicado, como endereço completo, número de telefone, classificação e avaliações dos usuários.

Há muitas maneiras de conseguir um ID de lugar. Você pode usar:

Com o APIs Explorer, você pode fazer solicitações em tempo real para se familiarizar com a API e as opções dela:

Faça um teste

Solicitações do Place Details (novo)

Uma solicitação de Place Details (New) é uma solicitação HTTP GET no formato:

https://places.googleapis.com/v1/places/PLACE_ID

Transmita todos os parâmetros como parâmetros de URL ou em cabeçalhos como parte da solicitação GET. Exemplo:

https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY

Ou em um comando curl:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Respostas do Place Details (novo)

O Place Details (New) retorna um objeto JSON como resposta. Na resposta:

A resposta é representada por um objeto Place. O objeto Place contém informações detalhadas sobre o lugar.
A FieldMask transmitida na solicitação especifica a lista de campos retornados no objeto Place.

O objeto JSON completo tem este formato:

{
  "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "displayName": {
    "text": "Trinidad"
  }
  ...
}

Parâmetros obrigatórios

FieldMask

Especifique a lista de campos a serem retornados na resposta criando uma máscara de campo de resposta. Transmita a máscara de campo de resposta para o método usando o parâmetro de URL $fields ou fields, ou usando o cabeçalho HTTP X-Goog-FieldMask. Não há uma lista padrão de campos retornados na resposta. Se você omitir a máscara de campo, o método vai retornar um erro.

A máscara de campo é uma boa prática de design para garantir que você não solicite dados desnecessários, o que ajuda a evitar tempo de processamento e cobranças desnecessárias.

Especifique uma lista separada por vírgulas de tipos de dados de lugar a serem retornados. Por exemplo, para recuperar o nome de exibição e o endereço do lugar.
```
X-Goog-FieldMask: displayName,formattedAddress
```
Observação : não é permitido usar espaços em nenhum lugar da lista de campos.

Use * para recuperar todos os campos.
```
X-Goog-FieldMask: *
```
O caractere curinga "*" seleciona todos os campos. No entanto, embora esse curinga seja adequado para uso no desenvolvimento, o Google desencoraja o uso da máscara de campo de resposta curinga (*) na produção devido à grande quantidade de dados que podem ser retornados.

Mais orientações sobre o uso de iconMaskBaseUri e iconBackgroundColor podem ser encontradas na seção Ícones de lugares.

Especifique um ou mais dos seguintes campos:
- Os campos a seguir acionam a SKU Place Details Essentials IDs Only:
  
  attributions
  id
  name^*
  photos
  
  ^* O campo name contém o nome do recurso do lugar no formato: places/PLACE_ID. Para receber o nome de texto do lugar, solicite o campo displayName na SKU Pro.
- Os campos a seguir acionam a SKU Place Details Essentials:
  
  addressComponents
  addressDescriptor^*
  adrFormatAddress
  formattedAddress
  location
  plusCode
  postalAddress
  shortFormattedAddress
  types
  viewport
  
  ^* Os descritores de endereço estão disponíveis para clientes na Índia e são experimentais em outros lugares.
- Os seguintes campos acionam a SKU Place Details Pro:
  
  accessibilityOptions
  businessStatus
  containingPlaces
  displayName
  googleMapsLinks
  googleMapsUri
  iconBackgroundColor
  iconMaskBaseUri
  primaryType
  primaryTypeDisplayName
  pureServiceAreaBusiness
  subDestinations
  utcOffsetMinutes
- Os seguintes campos acionam a SKU do Place Details Enterprise:
  
  currentOpeningHours
  currentSecondaryOpeningHours
  internationalPhoneNumber
  nationalPhoneNumber
  priceLevel
  priceRange
  rating
  regularOpeningHours
  regularSecondaryOpeningHours
  userRatingCount
  websiteUri
- Os campos a seguir acionam a SKU Place Details Enterprise + Atmosphere:
  
  allowsDogs
  curbsidePickup
  delivery
  dineIn
  editorialSummary
  evChargeAmenitySummary
  evChargeOptions
  fuelOptions
  generativeSummary
  goodForChildren
  goodForGroups
  goodForWatchingSports
  liveMusic
  menuForChildren
  neighborhoodSummary
  parkingOptions
  paymentOptions
  outdoorSeating
  reservable
  restroom
  reviews
  reviewSummary
  routingSummaries^*
  servesBeer
  servesBreakfast
  servesBrunch
  servesCocktails
  servesCoffee
  servesDessert
  servesDinner
  servesLunch
  servesVegetarianFood
  servesWine
  takeout
  
  ^* Apenas pesquisa de texto e pesquisa por proximidade
placeId

Um identificador textual que identifica um lugar de forma exclusiva, retornado de uma Pesquisa de texto (novo) ou Pesquisa por proximidade (novo). Para mais informações sobre IDs de lugar, consulte a visão geral de IDs de lugar.

A string places/PLACE_ID também é chamada de nome do recurso do lugar. Na resposta de uma solicitação de Place Details (novo), Nearby Search (novo) e Text Search (novo), essa string está contida no campo name da resposta. O ID do lugar independente está no campo id da resposta.

Observação : em Detalhes do lugar (legado), o campo name da resposta continha o nome legível do lugar. Na nova API, esse campo agora é chamado de displayName.

Parâmetros opcionais

languageCode

O idioma em que os resultados serão retornados.
- Consulte a lista de idiomas compatíveis. O Google atualiza os idiomas com frequência, então esta lista pode não estar completa.
- Se languageCode não for fornecido, a API usará en como padrão. Se você especificar um código de idioma inválido, a API vai retornar um erro INVALID_ARGUMENT.
- A API faz o possível para fornecer um endereço legível para o usuário e os moradores locais. Para isso, ele retorna endereços em português, transliterados para um script legível pelo usuário, se necessário, observando o idioma preferido. Todos os outros endereços são retornados no idioma preferido. Todos os componentes de endereço são retornados no mesmo idioma, que é escolhido no primeiro componente.
- Se um nome não estiver disponível no idioma preferido, a API usará a correspondência mais próxima.
- O idioma preferido tem uma pequena influência no conjunto de resultados que a API escolhe retornar e na ordem em que eles são retornados. O geocodificador interpreta abreviações de maneira diferente dependendo do idioma, como as abreviações de tipos de rua ou sinônimos que podem ser válidos em um idioma, mas não em outro.
regionCode

O código da região usado para formatar a resposta, especificado como um valor de código CLDR de dois caracteres. Não há valor padrão.

Se o nome do país do campo formattedAddress na resposta corresponder ao regionCode, o código do país será omitido de formattedAddress. Esse parâmetro não tem efeito em adrFormatAddress, que sempre inclui o nome do país, ou em shortFormattedAddress, que nunca inclui.

A maioria dos códigos CLDR é idêntica aos códigos ISO 3166-1, com algumas exceções notáveis. Por exemplo, o ccTLD do Reino Unido é "uk" (.co.uk), enquanto o código ISO 3166-1 é "gb" (tecnicamente para a entidade "Reino Unido da Grã-Bretanha e Irlanda do Norte"). O parâmetro pode afetar os resultados com base na legislação aplicável.
sessionToken

Os tokens de sessão são strings geradas pelo usuário que rastreiam chamadas do Autocomplete (New) como "sessões". O Autocomplete (novo) usa tokens de sessão para agrupar as fases de consulta e seleção de local de uma pesquisa de preenchimento automático do usuário em uma sessão discreta para fins de faturamento. Os tokens de sessão são transmitidos para chamadas de Place Details (novo) que seguem chamadas de Autocomplete (novo). Para mais informações, consulte Tokens de sessão.

Exemplo de Place Details (novo)

O exemplo a seguir solicita os detalhes de um lugar por placeId:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

O cabeçalho X-Goog-FieldMask especifica que a resposta contém os seguintes campos de dados: id,displayName. A resposta fica assim:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

Adicione mais tipos de dados à máscara de campo para retornar informações adicionais. Por exemplo, adicione formattedAddress,plusCode para incluir o endereço e o Plus Code na resposta:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

A resposta agora está no formato:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
  "plusCode": {
    "globalCode": "849VCWC7+RW",
    "compoundCode": "CWC7+RW Mountain View, CA, USA"
  },
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

Receber descritores de endereço

Os descritores de endereço fornecem informações relacionais sobre a localização de um lugar, incluindo pontos de referência próximos e áreas que o contêm.

Observação:os descritores de endereço estão disponíveis para clientes na Índia e são experimentais em outros lugares. As solicitações da API Places que usam apenas addressDescriptor na máscara de campo serão faturadas com a SKU: Place Details Essentials da API Places.

O exemplo a seguir mostra uma solicitação de detalhes do lugar (novo) para uma loja de departamentos em um shopping de San José. Neste exemplo, você inclui addressDescriptors na máscara de campo:

  curl -X GET https://places.googleapis.com/v1/places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4 \
  -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
  -H "X-Goog-FieldMask: name,displayName,addressDescriptor"

A resposta inclui o lugar especificado na solicitação, uma lista de pontos de referência próximos e a distância deles até o lugar, além de uma lista de áreas e a relação de contenção delas com o lugar:

  {
    "name": "places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4",
    "displayName": {
      "text": "Macy's",
      "languageCode": "en"
    },
    "addressDescriptor": {
      "landmarks": [
        {
          "name": "places/ChIJVVVVUB7Lj4ARXyb4HFVDV8s",
          "placeId": "ChIJVVVVUB7Lj4ARXyb4HFVDV8s",
          "displayName": {
            "text": "Westfield Valley Fair",
            "languageCode": "en"
          },
          "types": [
            "clothing_store",
            "department_store",
            "establishment",
            "food",
            "movie_theater",
            "point_of_interest",
            "restaurant",
            "shoe_store",
            "shopping_mall",
            "store"
          ],
          "spatialRelationship": "WITHIN",
          "straightLineDistanceMeters": 220.29175
        },
        {
          "name": "places/ChIJ62_oCR7Lj4AR_MGWkSPotD4",
          "placeId": "ChIJ62_oCR7Lj4AR_MGWkSPotD4",
          "displayName": {
            "text": "Nordstrom",
            "languageCode": "en"
          },
          "types": [
            "clothing_store",
            "department_store",
            "establishment",
            "point_of_interest",
            "shoe_store",
            "store"
          ],
          "straightLineDistanceMeters": 329.45178
        },
        {
          "name": "places/ChIJmx1c5x7Lj4ARJXJy_CU_JbE",
          "placeId": "ChIJmx1c5x7Lj4ARJXJy_CU_JbE",
          "displayName": {
            "text": "Monroe Parking Garage",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "parking",
            "point_of_interest"
          ],
          "straightLineDistanceMeters": 227.05153
        },
        {
          "name": "places/ChIJxcwBziHLj4ARUQLAvtzkRCM",
          "placeId": "ChIJxcwBziHLj4ARUQLAvtzkRCM",
          "displayName": {
            "text": "Studios Inn by Daiwa Living California Inc.",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "lodging",
            "point_of_interest",
            "real_estate_agency"
          ],
          "straightLineDistanceMeters": 299.9955
        },
        {
          "name": "places/ChIJWWIlNx7Lj4ARpe1E0ob-_GI",
          "placeId": "ChIJWWIlNx7Lj4ARpe1E0ob-_GI",
          "displayName": {
            "text": "Din Tai Fung",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "food",
            "point_of_interest",
            "restaurant"
          ],
          "straightLineDistanceMeters": 157.70943
        }
      ],
      "areas": [
        {
          "name": "places/ChIJb3F-EB7Lj4ARnHApQ_Hu1gI",
          "placeId": "ChIJb3F-EB7Lj4ARnHApQ_Hu1gI",
          "displayName": {
            "text": "Westfield Valley Fair",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        },
        {
          "name": "places/ChIJXYuykB_Lj4AR1Ot8nU5q26Q",
          "placeId": "ChIJXYuykB_Lj4AR1Ot8nU5q26Q",
          "displayName": {
            "text": "Valley Fair",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        },
        {
          "name": "places/ChIJtYoUX2DLj4ARKoKOb1G0CpM",
          "placeId": "ChIJtYoUX2DLj4ARKoKOb1G0CpM",
          "displayName": {
            "text": "Central San Jose",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        }
      ]
    }
  }

Confira!

Com o APIs Explorer, você pode fazer solicitações de amostra para se familiarizar com a API e as opções dela.

Selecione o ícone da API api no lado direito da página.
Se quiser, edite os parâmetros da solicitação.
Selecione o botão Executar. Na caixa de diálogo, escolha a conta que você quer usar para fazer a solicitação.
No painel do APIs Explorer, selecione o ícone de tela cheia fullscreen para expandir a janela do APIs Explorer.

Detalhes do lugar (novo) Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Introdução

Solicitações do Place Details (novo)

Respostas do Place Details (novo)

Parâmetros obrigatórios

FieldMask

placeId

Parâmetros opcionais

languageCode

regionCode

sessionToken

Exemplo de Place Details (novo)

Receber descritores de endereço

Confira!

Detalhes do lugar (novo)