La API de Places admite las APIs existentes de Autocomplete y Query Autocomplete. 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, pasas los parámetros de URL con una solicitud HTTP GET.
- La función Autocomplete (nueva) 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 cambiaron de nombre o se modificaron para Autocomplete (nuevo), o bien los parámetros que ya no son compatibles.
| Parámetro actual | Parámetro nuevo | Notas |
|---|---|---|
components |
includedRegionCodes |
|
language |
languageCode |
|
location |
locationBias |
|
ipbias |
Si omites locationBias y locationRestriction, la API usa el sesgo 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 el Place Autocomplete existente. En este ejemplo, solicitas una respuesta JSON que contenga información sobre lugares llamados "Amoeba" que sean del tipo establishment y pases 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.
Las máscaras de campo no son obligatorias para las solicitudes de Autocomplete (nuevas), pero se pueden usar para filtrar resultados específicos en la respuesta. Por ejemplo, la siguiente solicitud usa una máscara de campo para que la respuesta solo incluya el suggestions.placePrediction.text de la sugerencia:
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 obtener más información sobre el uso de máscaras de campo, consulta Detalles de lugares (nuevo).