La API de Places es compatible con las APIs de Autocomplete y Query Autocomplete existentes. Si conoces estas APIs, Autocomplete (nuevo) realiza los siguientes cambios:
- Autocomplete (nuevo) usa solicitudes HTTP POST. Pasa parámetros en el cuerpo de la solicitud o en los encabezados como parte de una solicitud HTTP POST. En cambio, con las APIs existentes, debes pasar parámetros de URL mediante una solicitud HTTP GET.
- Autocomplete (nuevo) admite 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 las APIs existentes de Autocomplete y Query Autocomplete que se renombraron o modificaron para Autocomplete (nuevo), o los 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 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
En el siguiente ejemplo de solicitud GET, se usa Place Autocomplete existente. En este ejemplo, solicitas una respuesta JSON que contiene información sobre lugares llamados "Amoeba" que son del tipo establishment y pasas 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 pasas todos los parámetros en el cuerpo de la solicitud JSON o en los encabezados como parte de la solicitud POST. En este ejemplo, también se usa una máscara de campo para que la respuesta solo incluya el nombre visible y la 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