A API Places é compatível com os Place Details. Se você já conhece a API Places, a nova versão do Place Details faz as seguintes mudanças:
- O mascaramento de campo é obrigatório. Especifique quais campos você quer retornar na resposta. Não há 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 aceita as chaves de API e os tokens do OAuth como mecanismo de autenticação.
- No novo Place Details, só há suporte para JSON como formato de resposta.
- O formato de resposta JSON da API Place Details (nova) foi alterado do formato das APIs atuais. Para mais detalhes, consulte Migrar a resposta da API Places.
A tabela a seguir lista os parâmetros no Place Details que foram renomeados ou modificados no novo Place Details ou 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 lugar. Na resposta de uma solicitação de Place Details (New), Nearby Search (New) e Text Search (New), 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 existentes. Neste exemplo, você solicita uma resposta JSON que contém informações sobre um ID de lugar e transmite todos os parâmetros como parâmetros de URL. Este exemplo também usa fields, então a resposta inclui 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 (New), você faz uma solicitação GET e transmite todos os parâmetros em parâmetros de URL e cabeçalhos 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 local:
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 (New), Nearby Search (New) e Text Search (New), essa string está contida no campo name da resposta. O ID de lugar independente está no campo id da resposta.