Esta página foi traduzida pela API Cloud Translation.

Migrar para o Autocomplete (novo)

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

O preenchimento automático (novo) 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. Em contraste, com as APIs atuais, 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 nas APIs Autocompletar e Autocompletar de consulta que foram renomeadas ou modificadas para Autocompletar (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 preenchimento automático de lugares. Neste exemplo, você solicita uma resposta JSON com informações sobre lugares chamados "Amoeba", que são do tipo establishment e transmitem 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 de lugares (novo).