La API de Places admite la API de Place Details. Si conoces la API de Places existente, nueva versión de Place Details realiza los siguientes cambios:
- 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.
- El nuevo Place Details admite tanto Claves de API y OAuth tokens como el mecanismo de autenticación.
- Solo se admite JSON como formato de respuesta en el nuevo Place Details.
- El formato de respuesta JSON para Place Details (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 Place Details que ha sido renombrado o modificado para el nuevo Place Details o los parámetros que ya no son no es compatible.
| Parámetro actual | Parámetro nuevo | Notas |
|---|---|---|
place_id |
places/PLACE_ID |
La cadena places/PLACE_ID también se denomina
colocar el nombre del recurso. En la respuesta de una solicitud de Place Details (nuevo),
Nearby Search (nueva) y Text Search (nueva)
solicitud, 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
El siguiente ejemplo de solicitud GET usa el
Place Details. En este ejemplo, solicitas un archivo JSON
respuesta que contiene información sobre un ID de lugar y pasa todos los parámetros como URL
parámetros. En este ejemplo, también se usa fields para que la respuesta solo incluya el
nombre visible y 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), puedes realizar una solicitud GET y pasar todos los parámetros en los encabezados y parámetros de URL como parte de la solicitud. Esta El ejemplo también 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 llama lugar
nombre de recurso. En la respuesta de una solicitud
(Nuevo), Nearby Search (nuevo) y
Solicitud de Text Search (nueva), esta cadena está incluida en
el campo name de la respuesta El id. de sitio independiente se encuentra en el
id de la respuesta.