La API de Places admite la foto de Place existente. Si conoces la Foto de Place existente, la nueva versión de Foto de Place realiza los siguientes cambios:
- El nuevo servicio de fotos de lugares requiere que pases el nombre del recurso de la foto, que incluye el ID del 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 a referencias de fotos.
- El nuevo servicio de Place Photos admite claves de API y tokens de OAuth como mecanismo de autenticación.
En la siguiente tabla, se indican los parámetros de la Foto de Place existente cuyos nombres se cambiaron o se modificaron para la nueva Foto de Place, 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. |
Aumento del tamaño de las fotos
La Place Photo existente admitía un tamaño máximo de 1,600 x 1,600 píxeles. La foto de Place (nueva) admite tamaños de hasta 4,800 x 4,800 píxeles.
Cambio a referencias de fotos
La nueva API de Place Photo requiere que pases el nombre del recurso de la foto solicitada, que incluye un ID de Place y la referencia de la foto, en el siguiente formato:
https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY
Las nuevas versiones 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[]: Todas las atribuciones requeridas. Este campo siempre está presente, pero puede estar vacío.
Con la API existente, solo debes 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 funciones existentes Find Place, Nearby Search, Text Search y Place Details muestran un array photos[] en la respuesta que admite este formato. Cada elemento photo de la respuesta existente contiene los siguientes campos:
photo_reference: Es una cadena que se usa para identificar la foto cuando realizas una solicitud de fotos.height: Es la altura máxima de la imagen.width: Es el ancho máximo de la imagen.html_attributions[]: Todas las atribuciones requeridas. Este campo siempre está presente, pero puede estar vacío.