La Place Photo (nueva) es una API de solo lectura que permite agregar contenido fotográfico en tu aplicación. El servicio de Place Photos ofrece accederás a las millones de fotos almacenadas en la base de datos de Places.
Cuando obtienes información sobre lugares mediante una solicitud de Place Details, Nearby Search o Text Search, también puedes solicitar recursos fotográficos para el contenido fotográfico correspondiente. Con el servicio de Fotos, puedes acceder a las fotos de referencia y cambiar el tamaño de la imagen al tamaño óptimo para tu y mantener la integridad de su aplicación.
El Explorador de APIs te permite realizar solicitudes en tiempo real para que puedas familiarizarte con la API y el Opciones de API:
PruébaloSolicitudes de fotos de sitios
Una solicitud de Place Photo es una solicitud HTTP GET a una URL en el siguiente formato:https://places.googleapis.com/v1/NAME/media?key=API_KEY&PARAMETERS
Cuando se requieren los siguientes parámetros:
- NAME contiene el nombre del recurso de la foto.
- API_KEY contiene la clave de API.
- PARAMETERS contiene el parámetro
maxHeightPx
, el parámetromaxWidthPx
o ambos.
A continuación, se describe la lista completa de los parámetros obligatorios y opcionales.
Parámetros obligatorios
Nombre de la foto
Un identificador de cadenas que identifica de forma exclusiva una foto. Los nombres de las fotos se devuelven de un
Place Details (nuevo), Nearby Search (nuevo)
o Text Search (nueva)
en la propiedad name
de cada elemento del array photos[]
.
Para ver un ejemplo, consulta Obtén un nombre de foto.
maxHeightPx y maxWidthPx
Especifica la altura y el ancho máximos deseados, en píxeles, de la imagen. Si la imagen es más pequeña que los valores especificados, se devolverá la imagen original. Si la imagen es más grande en dimensión, se ajustará para que coincida con la más pequeña de las dos, restringida a su original relación de aspecto. Las propiedades maxheight y maxwidth aceptan un número entero entre 1 y 4,800.
Debes especificar maxHeightPx
, maxWidthPx
o ambos.
Parámetros opcionales
skipHttpRedirect
Si es false
(predeterminado), realiza un redireccionamiento HTTP a la imagen para mostrarla.
Si es true
, omite el redireccionamiento y muestra una respuesta JSON que contiene los detalles de la imagen.
Por ejemplo:
{ "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/photos/Aaw_FcKly0DEv3EWmDJyHiEqXIP5mowOc99lN1GzBun6KHH52AZ5fFA/media", "photoUri": "https://lh3.googleusercontent.com/a-/AD_cFT-b=s100-p-k-no-mo" }
Esta opción se ignora para solicitudes que no son HTTP.
Obtén un nombre de foto
Todas las solicitudes al servicio de Place Photos deben incluir un
el nombre del recurso de foto, que se muestra en la respuesta a una búsqueda de Nearby Search, Text Search o
solicitud de Place Details. La respuesta a estas solicitudes contiene un array photos[]
si la
lugar tiene contenido fotográfico relacionado.
Cada elemento de photo[]
contiene los siguientes campos:
name
: Es una cadena que contiene el nombre del recurso de la foto cuando realizas lo siguiente: realizar una solicitud de foto. Esta cadena tiene el siguiente formato:places/PLACE_ID/photos/PHOTO_RESOURCE
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.
Las fotos que devuelve el servicio Photos provienen de diversas ubicaciones.
incluidas las fotos aportadas por los propietarios de la empresa y los usuarios. En la mayoría de los casos, estos
las fotos se pueden utilizar sin atribución o tendrán la atribución requerida
se incluye como parte de la imagen. Sin embargo, si el elemento photo
que se muestra
incluye un valor en el campo authorAttributions
, debes incluir el
atribución adicional en tu aplicación en cualquier lugar en el que muestres la imagen.
En el siguiente ejemplo, se muestra una solicitud de Place Details que incluye photos
en
la máscara de campo para que la respuesta incluya el array photos[]
en la respuesta:
curl -X GET \ -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,photos" \ https://places.googleapis.com/v1/places/ChIJ2fzCmcW7j4AR2JzfXBBoh6EA continuación, se muestra un ejemplo de un array de
photos[]
en la respuesta.
... "photos" : [ { "name": "places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E/photos/AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1", "widthPx": 6000, "heightPx": 4000, "authorAttributions": [ { "displayName": "John Smith", "uri": "//maps.google.com/maps/contrib/101563", "photoUri": "//lh3.googleusercontent.com/a-/AD_cFT-b=s100-p-k-no-mo" } ] }, ...
Cómo solicitar una foto de un lugar
En la solicitud de ejemplo que aparece a continuación, se muestra una imagen con su recurso name
y se le cambia el tamaño para
que tenga, como máximo, 400 píxeles de alto y de ancho:
https://places.googleapis.com/v1/places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E/photos/AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1/media?maxHeightPx=400&maxWidthPx=400&key=API_KEY
La respuesta de una solicitud de Place Photos exitosa es una imagen. El tipo de imagen depende del tipo de foto enviada originalmente.
Si tu solicitud excede la cuota disponible, el servidor muestra HTTP 403 y muestra la siguiente imagen para indicar que la cuota se ha se superó:
![Imagen que indica que se superó la cuota](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/documentation/maps-static/images/quota.png?authuser=8&hl=es)
Si el servidor no puede comprender tu solicitud, muestra HTTP 400. estado, que indica una solicitud no válida. Los motivos más comunes de un solicitud no válida incluyen:
- El nombre de la foto enviada no se especificó correctamente.
- La solicitud no incluyó
maxHeightPx
nimaxWidthPx
. parámetro. - Se estableció el valor de
maxHeightPx
o del parámetromaxWidthtPx
anull
. name
ya venció. Siname
vence, haz una a Place Details (nuevo), Nearby Search (nuevo) o Text Search (nueva) para obtener un nuevo elementoname
.
Pruébalo
El Explorador de APIs te permite realizar solicitudes de muestra para que puedes familiarizarte con la API y sus opciones.
Para realizar una solicitud, haz lo siguiente:
- Selecciona el ícono de la API,
, en el lado derecho de la página.
- Establece el parámetro
name
de la siguiente manera:places/PLACE_ID/photos/PHOTO_RESOURCE/media
- Configura
skipHttpRedirect
comotrue
para que la solicitud muestre un JSON. respuesta. De forma predeterminada, la solicitud devuelve la imagen, que el Explorador de APIs. - Selecciona el botón Ejecutar. En la ventana emergente, elige la cuenta a la que deseas acceder. usar para realizar la solicitud.
En el panel Explorador de APIs, selecciona el ícono de expansión,
, para expandir la ventana del Explorador de API