La API de Places admite la función Nearby Search existente. Si estás familiarizado con Nearby Search existente, la nueva versión de Nearby Search realiza los siguientes cambios:
- La nueva búsqueda de Nearby usa solicitudes HTTP POST. Pasa parámetros en el cuerpo de la solicitud o en los encabezados como parte de una solicitud HTTP POST. Por el contrario, con la búsqueda de Nearby existente, debes pasar los parámetros de URL mediante una solicitud HTTP GET.
- El enmascaramiento de campo es obligatorio. Debes especificar qué campos quieres que se muestren en la respuesta. No existe una lista predeterminada de los 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 versión de Nearby Search admite claves de API y tokens OAuth como mecanismo de autenticación.
- Solo se admite JSON como formato de respuesta en el nuevo Nearby Search.
- Todas las solicitudes que incluyen una consulta de texto ahora deben usar Text Search (nuevo) porque Nearby Search (nuevo) no admite entradas de texto.
- El formato de respuesta JSON de la API de Nearby Search (nuevo) cambió del formato de las APIs existentes. Si deseas 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 Nearby Search existente a los que se les cambió el nombre o los que se modificaron para la nueva función de Nearby Search, o bien los parámetros que ya no se admiten.
| Parámetro actual | Parámetro nuevo | Notas |
|---|---|---|
keyword |
No compatible. En su lugar, usa Text Search (nuevo). | |
language |
languageCode |
|
location |
locationRestriction |
Obligatorio. |
maxprice/minprice |
|
No compatible. |
maxResultCount |
Parámetro nuevo. | |
opennow |
|
No compatible. |
pagetoken |
No compatible. | |
radius |
|
Usa locationRestriction ahora. |
rankby |
rankPreference |
|
regionCode |
Parámetro nuevo. | |
type |
includedTypesexcludedTypesincludedPrimaryTypesexcludedPrimaryTypes
|
Los parámetros nuevos también aceptan múltiples valores de tipo. La API existente solo acepta un valor. |
Ejemplo de solicitud
En la siguiente solicitud GET de ejemplo, se usa la búsqueda de Nearby existente. En este ejemplo, se solicita una respuesta JSON que contiene información sobre los lugares de tipo restaurant y se pasan todos los parámetros como parámetros de URL:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=37.7937%2C-122.3965&radius=500&type=restaurant&key=API_KEY'
Con Nearby 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 '{
"includedTypes": ["restaurant"],
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965},
"radius": 500.0
}
}
}' \
-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:searchNearby