A API Places suporta a Preenchimento automático e as APIs Query Autocomplete. 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. Transmitir parâmetros no corpo da solicitação ou em cabeçalhos como parte de uma solicitação POST HTTP. Por outro lado, com as APIs existentes, você transmite parâmetros de URL usando uma propriedade solicitação GET HTTP.
- O Autocomplete (novo) oferece suporte às duas chaves de API e os 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 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 , o
A API usa 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. Este exemplo também usa uma máscara de campo para que a resposta inclua apenas o nome de exibição e 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