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 (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 a Pesquisa nas proximidades (legada), você transmite parâmetros de URL usando uma solicitação HTTP GET.
  • O mascaramento 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.
  • A pesquisa por proximidade (nova) é compatível com chaves de API e tokens OAuth como mecanismo de autenticação.
  • Apenas JSON é aceito como formato de resposta na Pesquisa nas proximidades (nova).
  • 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 Pesquisa de texto (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 mesmo.
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 (legada). 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 (New), 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