Migrar para o Autocomplete (novo)

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

Se o endereço de faturamento estiver localizado no Espaço Econômico Europeu, a partir de 8 de julho de 2025, os Termos de Serviço da Plataforma Google Maps para o EEE serão aplicáveis ao uso dos serviços. A funcionalidade varia de acordo com a região. Saiba mais.

Introdução

A API Places é compatível com as APIs Place Autocomplete (legada) e Query Autocomplete (legada). Se você já conhece essas APIs, o Autocomplete (novo) faz as seguintes mudanças:

• O Autocomplete (novo) usa solicitações HTTP POST. Transmita parâmetros em no corpo da solicitação ou nos cabeçalhos como parte de uma solicitação HTTP POST. Por outro lado, com as APIs legadas, você transmite parâmetros de URL usando uma solicitação HTTP GET.
• O Autocomplete (novo) aceita chaves de API e tokens OAuth como mecanismo de autenticação.
• Somente o JSON é aceito como formato de resposta no Autocomplete (novo).

A tabela a seguir lista os parâmetros do Place Autocomplete (legado) e do Query Autocomplete (legado) que foram renomeados ou modificados para o Autocomplete (novo) ou que não são mais aceitos.

Parâmetro atual	Novo parâmetro	Observações
components	includedRegionCodes
language	languageCode
location	locationBias
ipbias		Se você omitir locationBias e locationRestriction, a API usará a polarização de IP por padrão.
offset	inputOffset
radius	locationBias ou locationRestriction
region	regionCode
stricbounds	locationRestriction
sessiontoken	sessionToken
types	includedPrimaryTypes

Exemplo de solicitação

O exemplo de solicitação GET a seguir usa o Place Autocomplete (legado). Neste exemplo, você solicita uma resposta JSON que contém informações sobre lugares chamados "Amoeba" do tipo establishment e transmite todos os parâmetros como parâmetros de URL:

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=amoeba&types=establishment&location=37.76999%2C-122.44696&radius=500&key=YOUR_API_KEY'

Com o Autocomplete (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.

As máscaras de campo não são obrigatórias para solicitações do Autocomplete (novo), mas podem ser usadas para filtrar resultados específicos na resposta. Por exemplo, a solicitação a seguir usa uma máscara de campo para que a resposta inclua apenas o suggestions.placePrediction.text da sugestão:

curl -X POST -d '{
  "input": "Amoeba",
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 37.76999,
        "longitude": -122.44696
      },
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: suggestions.placePrediction.text' \
https://places.googleapis.com/v1/places:autocomplete

Para saber mais sobre como usar máscaras de campo, consulte Detalhes do lugar (novo).