La API de Places admite la función Place Photo existente. Si estás familiarizado con la Place Photos existente, la versión nueva de Place Photos realiza los siguientes cambios:
- El nuevo servicio de Place Photos requiere que pases el nombre de recurso de la foto, que incluye el ID de lugar en la URL de la solicitud, en lugar de solo la referencia de la foto. Para obtener más información, consulta Cómo cambiar las referencias de las fotos.
- El nuevo servicio de Place Photos admite tanto claves de API como tokens de OAuth como mecanismo de autenticación.
En la siguiente tabla, se enumeran los parámetros de la Place Photos existente a los que se les cambió el nombre o los que se modificaron para la nueva función, o bien los parámetros que ya no se admiten.
| Parámetro actual | Parámetro nuevo | Notas |
|---|---|---|
maxheight |
maxHeightPx |
Debes especificar maxHeightPx, maxWidthPx o ambos. |
maxwidth |
maxWidthPx |
Debes especificar maxHeightPx, maxWidthPx o ambos. |
Tamaño de la foto aumentado
La foto de Place Photos existente admitía un tamaño máximo de 1,600 por 1,600 píxeles. Place Photos (nuevo) admite tamaños de hasta 4800 por 4800 píxeles.
Cambio en las referencias de las fotos
La nueva API de Place Photos requiere que pases el nombre del recurso de la foto solicitada, que incluye un ID de lugar y la referencia de foto, de la siguiente forma:
https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY
Las versiones nuevas de Nearby Search, Text Search y Place Details muestran un array photos[] en la respuesta que admite este formato. Cada elemento de photos[] en la respuesta nueva contiene los siguientes campos:
name: Es una cadena que contiene el nombre del recurso de la foto. Esta cadena tiene el siguiente formato:places/PLACE_ID/photos/PHOTO_REFERENCE
heightPx: Es la altura máxima de la imagen en píxeles.widthPx: Es el ancho máximo de la imagen en píxeles.authorAttributions[]: Cualquier atribución requerida. Este campo siempre está presente, pero puede estar vacío.
Con la API existente, solo tienes que pasar la referencia de la foto, en el siguiente formato:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
Las propiedades existentes de Find Place, Nearby Search, Text Search y Place Details muestran un array photos[] en la respuesta que admite este formato. Cada elemento photo en la respuesta existente contiene los siguientes campos:
photo_reference: Es una cadena que se usa para identificar la foto cuando realizas una solicitud de foto.height: Es la altura máxima de la imagen.width: Es el ancho máximo de la imagen.html_attributions[]: Cualquier atribución requerida. Este campo siempre está presente, pero puede estar vacío.