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 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, com as APIs existentes, você transmite os parâmetros de URL usando um objeto solicitação GET HTTP.
O Autocomplete (novo) oferece suporte às duas chaves de API e os 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 os parâmetros no sistema As APIs Autocomplete e Query Autocomplete 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 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 Place Autocomplete. Neste exemplo, você solicita um arquivo JSON resposta contendo informações sobre lugares chamados "Amebas" que são do tipo establishment e transmita 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 Autocomplete (novo), você faz uma solicitação POST e transmitir todos os parâmetros no corpo da solicitação JSON ou nos cabeçalhos como parte do POST solicitação.

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, o seguinte 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 dos lugares (novo).