A API Places oferece suporte a 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. É preciso 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.
- Os novos detalhes do lugar são compatíveis com chaves de API e tokens OAuth como mecanismo de autenticação.
- Somente o JSON é aceito como formato de resposta nos novos detalhes do lugar.
- O formato da resposta JSON da API Place Details (New) mudou em relação ao formato das APIs atuais. Para mais detalhes, consulte Migrar a resposta da API Places.
A tabela a seguir lista os parâmetros nos "Detalhes do lugar" atuais que foram renomeados ou modificados para os novos "Detalhes do lugar" 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 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á contido no campo id da resposta. |
language |
languageCode |
|
region |
regionCode |
Exemplo de solicitação
O exemplo de solicitação GET a seguir usa os detalhes do lugar. 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. Esse 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 Places Details (New), você faz uma solicitação GET e transmite todos os parâmetros nos parâmetros e cabeçalhos de URL como parte da solicitação. Esse 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 do lugar independente está contido no campo id da resposta.