La API de Places admite los Place Details existentes. Si estás familiarizado con la API de Places existente, la versión nueva de Place Details realiza los siguientes cambios:
- 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.
- El nuevo Place Details admite tanto claves de API como tokens OAuth como mecanismo de autenticación.
- Solo se admite JSON como formato de respuesta en el nuevo Place Details.
- El formato de respuesta JSON de la API de Place Details (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 los Place Details existentes que cambiaron de nombre o modificados para la nueva versión de Place Details, o bien los parámetros que ya no se admiten.
| Parámetro actual | Parámetro nuevo | Notas |
|---|---|---|
place_id |
places/PLACE_ID |
La cadena places/PLACE_ID también se denomina el nombre del recurso del lugar. En la respuesta de una solicitud de Place Details (nuevo), Nearby Search (nuevo) y Text Search (nuevo), esta cadena se encuentra en el campo name de la respuesta.
El ID de lugar independiente se encuentra en el campo id de la respuesta. |
language |
languageCode |
|
region |
regionCode |
Ejemplo de solicitud
En el siguiente ejemplo de solicitud GET, se usa la información de Place Details existente. En este ejemplo, se solicita una respuesta JSON que contiene información sobre un ID de lugar y se pasan todos los parámetros como parámetros de URL. En este ejemplo, también se usa fields, por lo que la respuesta solo incluye el nombre visible y la dirección con formato del lugar:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJj61dQgK6j4AR4GeTYWZsKWw&fields=name%2Cformatted_address&key=API_KEY'
Con Place Details (nuevo), realizas una solicitud GET y pasas todos los parámetros en los parámetros y encabezados de URL como parte de la solicitud. 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 GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: displayName,formattedAddress" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
La cadena places/PLACE_ID también se denomina el nombre del recurso del lugar. En la respuesta de una solicitud de Place Details (nuevo), Nearby Search (nuevo) y Text Search (nuevo), esta cadena se encuentra en el campo name de la respuesta. El ID de lugar independiente se encuentra en el campo id de la respuesta.