Migrar para o Nearby Search (novo)

Introdução

A API Places é compatível com a Pesquisa nas proximidades (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 por proximidade (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