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. 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 formato de resposta no recurso Preenchimento automático (novo).
A tabela a seguir lista parâmetros nas APIs Autocomplete e Autocomplete de consulta que foram renomeadas ou modificadas para 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. Neste exemplo, você solicita uma resposta JSON contendo 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 de lugares (novo).