Cómo migrar a Text Search (nuevo)

La API de Places admite la API de Text Search Si conoces la Text Search existente, la nueva versión de Text Search realiza los siguientes cambios:

  • La nueva Búsqueda de texto usa solicitudes HTTP POST. Aprobado en el cuerpo de la solicitud o en los encabezados como parte de una solicitud HTTP POST. Por el contrario, con Text Search, pasas Parámetros de URL mediante una solicitud HTTP GET
  • Se requiere el enmascaramiento de campos. Debes especificar qué campos deseas que se muestren en la respuesta. No hay una lista predeterminada de campos que se muestran. Si omites esta lista, los métodos mostrarán un error. Para obtener más información, consulta FieldMask.
  • La nueva Búsqueda de texto admite claves de API y tokens de OAuth como mecanismo de autenticación.
  • Solo se admite JSON como formato de respuesta en la nueva Text Search.
  • Text Search existente te permite especificar la latitud y la longitud coordenadas en la cadena de consulta. Por ejemplo: query=37.4239,-122.0925. Esa opción no se admite en la nueva Búsqueda de texto.

    Usa Geocodificación inversa para buscar en las coordenadas y devolver una dirección, o Nearby Search (nuevo) para encontrar lugares alrededor de una ubicación determinada.

  • El formato de respuesta JSON para Text Search (nuevo) El formato de la API cambió. Para obtener más detalles, consulta Cómo migrar la respuesta de la API de Places.

En la siguiente tabla, se enumeran los parámetros de Text Search existentes que cambiaron de nombre o se modificaron para la nueva Text Search, o bien los parámetros que ya no son compatibles.

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

Ejemplo de solicitud

En la siguiente solicitud GET de ejemplo, se usa la búsqueda de texto existente. En este ejemplo, solicitas una respuesta JSON que contenga información sobre "Comida vegetariana picante en 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 la Búsqueda de texto (nueva), 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 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'