Migrar para o Autocomplete (novo)

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

Introdução

A API Places oferece suporte às APIs Place Autocomplete (legado) e Query Autocomplete (legado). Se você já conhece essas APIs, o Autocomplete (Novo) faz as seguintes mudanças:

  • O preenchimento automático (novo) usa solicitações POST HTTP. Transmita parâmetros no corpo da solicitação ou em cabeçalhos como parte de uma solicitação HTTP POST. Por outro lado, nas APIs legadas, você transmite parâmetros de URL usando uma solicitação HTTP GET.
  • O preenchimento automático (novo) oferece suporte a chaves de API e tokens OAuth como mecanismo de autenticação.
  • Somente JSON é aceito como um formato de resposta no recurso Preenchimento automático (novo).

A tabela a seguir lista parâmetros no Place Autocomplete (legado) e no Autocomplete de consulta (legado) que foram renomeados ou modificados para o Autocomplete (novo) ou parâmetros que não têm mais suporte.

Parâmetro atual Novo parâmetro Observações
components includedRegionCodes
language languageCode
location locationBias
ipbias Se você omitir locationBias e locationRestriction, a API vai 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 com informações sobre lugares chamados "Amoeba" que são 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 preenchimento automático (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 necessárias para solicitações de preenchimento automático (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 o uso de máscaras de campo, consulte Detalhes do lugar (novo).