Introdução
A API Places é compatível com a Nearby Search (legada). Se você já conhece a Nearby Search (legada), a Nearby Search (nova) faz as seguintes mudanças:
- A Nearby Search (nova) usa solicitações HTTP POST. Transmita parâmetros no corpo da solicitação ou nos cabeçalhos como parte de uma solicitação HTTP POST request. Por outro lado, com a Nearby Search (legada), você transmite parâmetros de URL usando uma solicitação HTTP GET.
- 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.
- A Nearby Search (nova) é compatível com chaves de API e OAuth como mecanismo de autenticação.
- Apenas o JSON é aceito como formato de resposta na Nearby Search (nova).
- Todas as solicitações que incluem uma consulta de texto agora precisam usar Text Search (nova) porque a Nearby Search (nova) não aceita entrada de texto.
- O formato de resposta JSON da Nearby Search (nova) 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 da Nearby Search (legada) que foram renomeados ou modificados para a Nearby Search (nova) ou que não são mais aceitos.
| Parâmetro atual | Novo parâmetro | Observações |
|---|---|---|
keyword |
Indisponível. Use Text Search (nova) instead. | |
language |
languageCode |
|
location |
locationRestriction |
Obrigatório. |
maxprice/minprice |
|
Indisponível. |
maxResultCount |
Novo parâmetro. | |
opennow |
|
Indisponível. |
pagetoken |
Indisponível. | |
radius |
|
Use locationRestriction agora. |
rankby |
rankPreference |
|
regionCode |
Novo parâmetro. | |
type |
includedTypesexcludedTypesincludedPrimaryTypesexcludedPrimaryTypes
|
Os novos parâmetros também aceitam vários valores de tipo. A API legada aceita apenas um valor. |
Exemplo de solicitação
O exemplo de solicitação GET a seguir usa a Nearby Search (legada). Neste exemplo, você solicita uma resposta JSON que contém informações sobre lugares do tipo restaurant e transmite todos os parâmetros como parâmetros de URL:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=37.7937%2C-122.3965&radius=500&type=restaurant&key=API_KEY'
Com a Nearby Search (nova), você faz uma solicitação POST e transmite todos os parâmetros no corpo da solicitação JSON ou nos cabeçalhos como parte da solicitação POST. 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 POST -d '{
"includedTypes": ["restaurant"],
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965},
"radius": 500.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName,places.formattedAddress" \
https://places.googleapis.com/v1/places:searchNearby