Migrar para o Autocomplete (novo)

A API Places é compatível com as APIs Autocomplete e Query Autocomplete atuais. Se você já conhece essas APIs, o recurso de preenchimento automático (novo) faz as seguintes mudanças:

  • O Autocomplete (novo) usa solicitações HTTP POST. Transmita parâmetros no corpo da solicitação ou nos cabeçalhos como parte de uma solicitação POST HTTP. Por outro lado, com as APIs atuais, 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.
  • No Autocomplete (novo), apenas JSON é aceito como formato de resposta.

A tabela a seguir lista os parâmetros das APIs Autocomplete e Query Autocomplete existentes que foram renomeadas ou modificadas para Autocomplete (novo) ou parâmetros que não são mais compatíveis.

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 atual. 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 Autocomplete New, você faz uma solicitação POST e passa todos os parâmetros no corpo da solicitação JSON ou nos cabeçalhos como parte dela. 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 '{
  "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" \
https://places.googleapis.com/v1/places:autocomplete