A API Places aceita as Place Details atuais. Se você conhece a API Places atual, a nova versão do Place Details faz as seguintes mudanças:
- O mascaramento de campo é obrigatório. É necessário especificar quais campos você quer retornar na resposta. Não há uma lista padrão de campos retornados. Se você omitir essa 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 tokens OAuth como mecanismo de autenticação.
- Somente JSON é aceito como formato de resposta no novo Place Details.
- O formato de resposta JSON para a API Place Details (nova) mudou do formato das APIs atuais. Se quiser mais detalhes, consulte Migrar a resposta da API Places.
A tabela a seguir lista os parâmetros no Place Details atuais que foram renomeados ou modificados para o novo Place Details ou aqueles que não são mais compatíveis.
| Parâmetro atual | Novo parâmetro | Observações |
|---|---|---|
place_id |
places/PLACE_ID |
A string places/PLACE_ID também é chamada de nome do recurso do local. 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 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 o Place Details atual. Neste exemplo, você solicita uma resposta JSON com informações sobre um ID de lugar e transmite todos os parâmetros como parâmetros de URL. Este exemplo também usa fields para que a resposta inclua apenas o nome de exibição e o 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 transmite todos os parâmetros nos cabeçalhos e parâmetros de URL como parte da solicitação. Este exemplo também usa uma máscara de campo para que a resposta inclua apenas o nome de exibição e o endereço 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 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 de lugar autônomo está no campo id da resposta.