La API de Places admite la API de Autocompletar y las APIs de Query Autocomplete. Si conoces estas APIs, Autocomplete (nuevo) realiza los siguientes cambios:
- Autocomplete (nuevo) usa solicitudes HTTP POST. Pasa parámetros en en el cuerpo de la solicitud o en los encabezados como parte de una solicitud HTTP POST. En cambio, con las APIs existentes, pasas parámetros de URL con un una solicitud HTTP GET.
- Autocomplete (nuevo) admite ambas claves de API y tokens de OAuth como mecanismo de autenticación.
- Solo se admite JSON como formato de respuesta en Autocomplete (nuevo).
En la siguiente tabla, se enumeran los parámetros de la APIs de Autocomplete y Query Autocomplete que se renombraron o modificaron para Autocomplete (nuevo), o bien parámetros que ya no se admiten.
| Parámetro actual | Parámetro nuevo | Notas |
|---|---|---|
components |
includedRegionCodes |
|
language |
languageCode |
|
location |
locationBias |
|
ipbias |
Si omites locationBias y locationRestriction, la
La API usa la personalización de IP de forma predeterminada. |
|
offset |
inputOffset |
|
radius |
locationBias o locationRestriction |
|
region |
regionCode |
|
stricbounds |
locationRestriction |
|
sessiontoken |
sessionToken |
|
types |
includedPrimaryTypes |
Ejemplo de solicitud
El siguiente ejemplo de solicitud GET usa el
Place Autocomplete. En este ejemplo, solicitas un archivo JSON
respuesta que contiene información sobre lugares llamada "Ameba" que son del tipo
establishment y pasa todos los 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'
Con Autocomplete (nuevo), realizas una solicitud POST y pasar todos los parámetros en el cuerpo de la solicitud JSON o en los encabezados como parte de la solicitud POST para cada solicitud. En este ejemplo, también se usa una máscara de campo para que la respuesta solo incluya el nombre visible y dirección con formato del 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