Introdução
A API Places é compatível com a Pesquisa por proximidade (legada). Se você conhece o Nearby Search (legado), o Nearby Search (novo) faz as seguintes mudanças:
- A Pesquisa por proximidade (nova) usa solicitações HTTP POST. Transmita parâmetros no corpo da solicitação ou em cabeçalhos como parte de uma solicitação HTTP POST. Já com o Nearby Search (legado), você transmite parâmetros de URL usando uma solicitação GET HTTP.
- O uso de máscara de campo é obrigatório. Você precisa especificar quais campos 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 Nearby Search (novo) é compatível com API keys e tokens OAuth como mecanismo de autenticação.
- Somente JSON é aceito como formato de resposta na Nearby Search (New).
- Todas as solicitações que incluem uma consulta de texto agora precisam usar a Pesquisa de texto (nova) porque a Pesquisa nas proximidades (nova) não aceita entrada de texto.
- O formato de resposta JSON da Pesquisa por proximidade (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 Pesquisa por proximidade (legada) que foram renomeados ou modificados para a Pesquisa por proximidade (nova) ou que não são mais compatíveis.
| Parâmetro atual | Novo parâmetro | Observações |
|---|---|---|
keyword |
Incompatível. Use a Text Search (nova) em vez disso. | |
language |
languageCode |
|
location |
locationRestriction |
Obrigatório. |
maxprice/minprice |
|
Incompatível. |
maxResultCount |
Novo parâmetro. | |
opennow |
|
Incompatível. |
pagetoken |
Incompatível. | |
radius |
|
Use o 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 o Nearby Search (legado). Neste exemplo, você solicita uma resposta JSON com 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 o Nearby Search (novo), 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