La API de Places admite la API de Place Photo. Si conoces la Place Photos existente, el nueva versión de Place Photos realiza los siguientes cambios:
- El nuevo servicio Place Photos requiere que pasa el nombre de recurso de la foto, que incluye el ID de lugar en la en lugar de solo la foto de referencia. Para obtener más información, consulta Cambia las referencias de las fotos.
- El nuevo servicio de Place Photos admite tanto Claves de API y OAuth tokens como el mecanismo de autenticación.
En la siguiente tabla, se enumeran los parámetros de la Place Photo que se renombra o modifica para el nueva Place Photos o parámetros que ya no son no es compatible.
| 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 Place Photos existente admitía una foto máxima de 1,600 por 1,600 píxeles. Place Photo (nuevo) admite tamaños de hasta 4800 por 4800 píxeles.
Cambiar a referencias de fotos
La nueva herramienta Place Photo La API requiere que pases el nombre del recurso de la foto solicitada, que Incluye un ID de lugar y la referencia de 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
todas 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 del 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. Esta siempre está presente, pero puede estar vacío.
Con la API existente, solo tienes que pasar la photo reference en la formulario:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
La versión existente de Find Place
Nearby Search, Text Search y
Todos los Place Details muestran un array photos[] en el
respuesta que admite este formato. Cada elemento photo en el archivo
contiene los siguientes campos:
photo_reference: Es una cadena que se usa para identificar la foto cuando buscas realizar una solicitud de foto.height: Es la altura máxima de la imagen.width: Es el ancho máximo de la imagen.html_attributions[]: Todas las atribuciones requeridas. Esta siempre está presente, pero puede estar vacío.