A API Places suporta a Nearby Search. Se você estiver familiarizado com a Nearby Search existente, a nova versão da Nearby Search faz as seguintes alterações:
- A nova Nearby Search usa solicitações POST HTTP. Transmitir parâmetros no corpo da solicitação ou em cabeçalhos como parte de um POST HTTP solicitação. Em contraste, com a Nearby Search existente, você transmite os parâmetros de URL usando uma solicitação HTTP GET.
- O mascaramento de campo é obrigatório. Você precisa especificar quais campos quer retornar na resposta. Não há uma lista padrão de campos retornados. Se você omitir nessa lista, os métodos retornarão um erro. Para mais informações, consulte FieldMask.
- A nova Pesquisa de local próximo é compatível com Chaves de API e OAuth como mecanismo de autenticação.
- Somente JSON é aceito como formato de resposta no novo Nearby Search.
- Todas as solicitações que incluem uma consulta de texto agora devem usar Text Search (novo) porque o Nearby Search (novo) não é compatível com a entrada de texto.
- O formato de resposta JSON para o Nearby Search (novo) O formato das APIs atuais foi alterado. Para mais detalhes, consulte Migre a resposta da API Places.
A tabela a seguir lista os parâmetros no sistema Nearby Search que foram renomeados ou modificados para novo Nearby Search ou parâmetros que não são mais suporte.
| Parâmetro atual | Novo parâmetro | Observações |
|---|---|---|
keyword |
Incompatível. Usar Text Search (novo) como alternativa. | |
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 existente aceita apenas um valor. |
Exemplo de solicitação
O exemplo de solicitação GET a seguir usa
Nearby Search. Neste exemplo, você solicita um arquivo JSON
resposta contendo informações sobre locais do tipo restaurant e transmitir todos
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 transmitir todos os parâmetros no corpo da solicitação JSON ou nos cabeçalhos como parte do POST solicitação. Este exemplo também usa uma máscara de campo para que a resposta inclua apenas o nome de exibição e 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