Cómo migrar a Text Search (nuevo)

Desarrolladores del Espacio Económico Europeo (EEE)

Introducción

La API de Places (heredada) admite Text Search (heredada). Si conoces la versión heredada de Text Search, la nueva versión de Text Search incluye los siguientes cambios:

  • Text Search (nuevo) usa solicitudes HTTP POST. Pasa parámetros en el cuerpo de la solicitud o en los encabezados como parte de una solicitud POST de HTTP. En cambio, con Text Search (heredado), pasas parámetros de URL con una solicitud HTTP GET.
  • Se requiere el enmascaramiento de campo. Debes especificar qué campos quieres que se muestren en la respuesta. No hay una lista predeterminada de campos que se devuelven. Si omites esta lista, los métodos devuelven un error. Para obtener más información, consulta FieldMask.
  • Text Search (nuevo) admite claves de API y tokens de OAuth como mecanismo de autenticación.
  • Solo se admite JSON como formato de respuesta en Text Search (nuevo).

  • Text Search (heredado) te permite especificar coordenadas de latitud y longitud en la cadena de consulta. Por ejemplo: query=37.4239,-122.0925. Esa opción no es compatible con Text Search (nuevo).

    Usa la geocodificación inversa para buscar coordenadas y devolver una dirección, o Nearby Search (nueva) para encontrar lugares alrededor de una ubicación determinada.

  • El formato de respuesta JSON para Text Search (nuevo) cambió con respecto al formato de las APIs heredadas. Para obtener más detalles, consulta Migra la respuesta de la API de Places.

En la siguiente tabla, se enumeran los parámetros de Text Search (heredada) que se cambiaron de nombre o se modificaron para Text Search (nueva), o bien los parámetros que ya no se admiten.

Parámetro actual Parámetro nuevo Notas
evOptions Es un parámetro nuevo.
language languageCode
location locationBias
maxprice/minprice priceLevels
opennow openNow
pagetoken pageToken
query textQuery Es obligatorio en todas las solicitudes.
radius locationBias Especifica el radio cuando definas un locationBias.
region regionCode
type includedType Solo toma un valor.
strictTypeFiltering Es un parámetro nuevo.

Ejemplo de solicitud

En el siguiente ejemplo de solicitud GET, se usa Text Search (heredado). En este ejemplo, solicitas una respuesta JSON que contenga información sobre "Spicy Vegetarian Food in Sydney, Australia" y pasas todos los parámetros como parámetros de URL:

curl -L -X GET \
'https://maps.googleapis.com/maps/api/place/textsearch/json?query=Spicy%20Vegetarian%20Food%20in%20Sydney%20Australia&key=API_KEY

Con Text Search (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 '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \
'https://places.googleapis.com/v1/places:searchText'