La API de Places admite la API de Text Search Si conoces la configuración Text Search, el 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
- El enmascaramiento de campo es obligatorio. Debes especificar qué campos quieres que se devuelvan en la respuesta. No hay una lista predeterminada de los campos que se muestran. Si omites esta lista, los métodos devuelven un error. Para obtener más información, consulta FieldMask.
- La nueva Búsqueda de texto es compatible con ambas claves de API y tokens de OAuth como mecanismo de autenticación.
- Solo se admite JSON como formato de respuesta en el nuevo 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 Migra la respuesta de la API de Places.
En la siguiente tabla, se enumeran los parámetros de la Text Search que hayan sido renombrados o modificados para el nueva Text Search o parámetros que ya no son no es compatible.
| Parámetro actual | Parámetro nuevo | Notas |
|---|---|---|
evOptions |
Parámetro nuevo. | |
language |
languageCode |
|
location |
locationBias |
|
maxprice/minprice |
priceLevels |
|
opennow |
openNow |
|
pagetoken |
No compatible. | |
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
El siguiente ejemplo de solicitud GET usa el Text Search. En este ejemplo, solicitas un archivo JSON respuesta con información sobre “Comida vegetariana picante en Sídney, Australia” y pasar 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 (nueva), puedes hacer una solicitud POST y Pasar todos los parámetros en el cuerpo de la solicitud JSON o en los encabezados como parte de la solicitud POST para cada solicitud. 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'