Introducción
La API de Places admite Place Details (heredado). Si conoces la API de Places (Legacy), Place Details (nuevo) realiza los siguientes cambios:
- Se requiere el enmascaramiento de campos. Debes especificar qué campos deseas que se muestren en la respuesta. No hay una lista predeterminada de campos devueltos. Si omites esta lista, los métodos mostrarán un error. Para obtener más información, consulta FieldMask.
- Place Details (nuevo) admite tanto claves de API como tokens de OAuth como mecanismo de autenticación.
- Solo se admite JSON como formato de respuesta en Place Details (nuevo).
- El formato de respuesta JSON de la API de Places (nuevo) cambió respecto del 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 Place Details (Legacy) que se cambiaron de nombre o se modificaron para Place Details (New), 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 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 incluye 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 Place Details (Legacy). En este ejemplo, solicitas una respuesta JSON que contiene información sobre un ID de lugar y pasas todos los parámetros como parámetros de URL. En este ejemplo, también se usa fields para que la respuesta solo incluya 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 de URL y los encabezados 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 nombre del recurso de lugar. En la respuesta de una solicitud de Place Details (nuevo), Nearby Search (nuevo) y Text Search (nuevo), esta cadena se incluye en el campo name de la respuesta. El ID de lugar independiente se encuentra en el campo id de la respuesta.