Introducción
La API de Places admite Place Photos (heredado). Si conoces Place Photos (heredado), Place Photos (nuevo) realiza los siguientes cambios:
- Place Photos (nuevo) requiere que pases el nombre del 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 Cambio en las referencias de fotos.
- Place Photos (nuevo) admite claves de API y tokens de OAuth como mecanismo de autenticación.
En la siguiente tabla, se enumeran los parámetros de Place Photos (heredado) que se cambiaron de nombre o se modificaron para Place Photos (nuevo), 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. |
Mayor tamaño de las fotos
Place Photos (heredada) admitía un tamaño máximo de foto de 1600 por 1600 píxeles. Place Photos (nuevo) admite tamaños de hasta 4,800 por 4,800 píxeles.
Cambiar a referencias de fotos
La API de Place Photos (nueva) requiere que pases el nombre del recurso de la foto solicitada, que incluye un ID de lugar y la referencia de la foto, con el siguiente formato:
https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY
Nearby Search (nuevo),
Text Search (nuevo) y
Place Details (nuevo)
devuelven 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 obligatoria. Este campo siempre está presente, pero puede estar vacío.
Con la API heredada, solo tienes que pasar la referencia de la foto, con el siguiente formato:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
Find Place (heredado),
Nearby Search (heredado),
Text Search (heredado) y
Place Details (heredado) devuelven un array photos[] en
la respuesta que admite este formato. Cada elemento photo de la respuesta
heredada 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 obligatoria. Este campo siempre está presente, pero puede estar vacío.