Migrar para o Autocomplete (novo)

Introdução

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

• O Autocomplete (New) 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 as APIs legadas, você transmite parâmetros de URL usando uma solicitação HTTP GET.
• O recurso de preenchimento automático (novo) é compatível com chaves de API e tokens OAuth como mecanismo de autenticação.
• Somente JSON é aceito como formato de resposta no Autocompletar (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 parâmetros 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 tendência 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 (New), você faz uma solicitação POST e transmite todos os parâmetros no corpo da solicitação JSON ou em 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).