A API Places suporta a Place Details. Se você já conhece a API Places, a nova versão do Place Details faz as seguintes alterações:
- O mascaramento de campo é obrigatório. Você precisa especificar quais campos quer retornar na resposta. Não há uma lista padrão de campos retornados. Se você omitir nessa lista, os métodos retornarão um erro. Para mais informações, consulte FieldMask.
- O novo Place Details é compatível com Chaves de API e OAuth como mecanismo de autenticação.
- Somente JSON é aceito como formato de resposta no novo Place Details.
- O formato de resposta JSON para o Place Details (novo) O formato das APIs atuais foi alterado. Para mais detalhes, consulte Migre a resposta da API Places.
A tabela a seguir lista os parâmetros no sistema Place Details que foram renomeados ou modificados para o novo Place Details ou parâmetros que não são mais suporte.
| Parâmetro atual | Novo parâmetro | Observações |
|---|---|---|
place_id |
places/PLACE_ID |
A string places/PLACE_ID também é chamada de
Insira o nome do recurso. Na resposta de um Place Details (novo),
Nearby Search (novo) e Text Search (novo)
solicitação, essa string está contida no campo name da resposta.
O ID de lugar autônomo está contido no campo id da resposta. |
language |
languageCode |
|
region |
regionCode |
Exemplo de solicitação
O exemplo de solicitação GET a seguir usa
Place Details. Neste exemplo, você solicita um arquivo JSON
contendo informações sobre um ID de lugar e transmitir todos os parâmetros como URL
parâmetros. Este exemplo também usa fields, então a resposta inclui apenas o
nome de exibição e endereço formatado do lugar:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJj61dQgK6j4AR4GeTYWZsKWw&fields=name%2Cformatted_address&key=API_KEY'
Com o Place Details (novo), você faz uma solicitação GET e transmitir todos os parâmetros nos parâmetros de URL e cabeçalhos como parte da solicitação. Isso O exemplo também usa uma máscara de campo para que a resposta inclua apenas o nome de exibição e formatado do lugar:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: displayName,formattedAddress" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
A string places/PLACE_ID também é chamada de local.
nome do recurso. Na resposta de uma solicitação
(novo), Nearby Search (novo) e
solicitação Text Search (novo), esta string está contida em
o campo name da resposta. O ID de lugar autônomo está contido no
id da resposta.