Introdução
A API Places é compatível com o Place Details (legado). Se você já conhece a API Places (legado), o Place Details (novo) faz as seguintes mudanças:
- O mascaramento de campo é obrigatório. É necessário especificar quais campos você quer que sejam retornados na resposta. Não há uma lista padrão de campos retornados. Se você omitir essa lista, os métodos vão retornar um erro. Para mais informações, consulte FieldMask.
- O Place Details (novo) aceita chaves de API e OAuth como mecanismo de autenticação.
- Apenas o JSON é aceito como formato de resposta no Place Details (novo).
- O formato de resposta JSON da API Places (novo) mudou em relação ao formato das APIs legadas. Para mais detalhes, consulte Migrar a resposta da API Places.
A tabela a seguir lista os parâmetros do Place Details (legado) que foram renomeados ou modificados para o Place Details (novo) ou que não são mais aceitos.
| 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 do 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á 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 (legado). 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, 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 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 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 do 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á contido no campo id da resposta.