Migrar para o Autocomplete (novo)

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

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 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).