Migrar para o Nearby Search (novo)

Desenvolvedores do Espaço Econômico Europeu (EEE)

Introdução

A API Places é compatível com a Pesquisa por proximidade (legado). Se você já conhece a Pesquisa por proximidade (legado), a Pesquisa por proximidade (nova) faz as seguintes mudanças:

  • A Pesquisa por proximidade (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 Pesquisa por proximidade (legado), 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 Pesquisa por proximidade (nova) aceita chaves de API e OAuth como mecanismo de autenticação.
  • Apenas o JSON é aceito como formato de resposta na Pesquisa por proximidade (nova).
  • Todas as solicitações que incluem uma consulta de texto agora precisam usar Pesquisa de texto (nova) porque a Pesquisa por proximidade (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 (legado) que foram renomeados ou modificados para a Pesquisa por proximidade (nova) ou que não são mais aceitos.

Parâmetro atual Novo parâmetro Observações
keyword Incompatível. Use Pesquisa de texto (nova) instead.
language languageCode
location locationRestriction Obrigatório.
maxprice/minprice Incompatível.
maxResultCount Novo parâmetro.
opennow Incompatível.
pagetoken Indisponível.
radius Use locationRestriction agora.
rankby rankPreference
regionCode Novo parâmetro.
type includedTypes
excludedTypes
includedPrimaryTypes
excludedPrimaryTypes 		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 Pesquisa por proximidade (legado). 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 Pesquisa por proximidade (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