Migra a Autocomplete (nuevo)

Introducción

La API de Places admite las APIs de Place Autocomplete (heredada) y Query Autocomplete (heredada). 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 heredadas, pasas parámetros de URL con una solicitud HTTP GET.
• La función Autocomplete (nueva) admite tanto claves de API como 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 Place Autocomplete (heredado) y Query Autocomplete (heredado) que se cambiaron o modificaron para Autocomplete (nuevo), o bien 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 usará la adaptació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 (legado). En este ejemplo, solicitas una respuesta JSON que contiene información sobre lugares llamados "Amoeba" que son de 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.

Las máscaras de campo no son obligatorias para las solicitudes de Autocomplete (nuevo), 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 Place Details (nuevo).