Place Photos

Selecciona la plataforma: Android iOS JavaScript Servicio web

El servicio Place Photo, que forma parte de la API de Places, es una solicitud que te permite agregar contenido fotográfico de alta calidad a tu y mantener la integridad de su aplicación. El servicio de Place Photos te brinda acceso a las millones de fotos almacenados en la base de datos de Places. Cuando obtienes información sobre lugares usando una función Place Solicitud de detalles: se devolverán referencias fotográficas para la fotografía relevante. contenido. Las solicitudes de Find Place, Nearby Search y Text Search también muestran una sola foto. referencia por lugar, cuando corresponda. Con el servicio de Fotos, al que puedes acceder 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.

Solicitudes de fotos de sitios

Una solicitud de fotos de sitios es una HTTP URL como la siguiente:

https://maps.googleapis.com/maps/api/place/photo?parameters

Ciertos parámetros son obligatorios para iniciar una solicitud de búsqueda. Como es estándar En las URLs, todos los parámetros se separan con el signo et (&). El de parámetros y sus posibles valores, a continuación.

Required parameters

  • photo_reference

    A string identifier that uniquely identifies a photo. Photo references are returned from either a Place Search or Place Details request.

  • maxheight or maxwidth

    maxheight specifies the maximum desired height, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.

    maxwidth specifies the maximum desired width, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.

    Both the maxheight and maxwidth properties accept an integer between 1 and 1600.

    You must specify either maxheight, or maxwidth, or both.

Referencias a las fotos

Todas las solicitudes al servicio Place Photos deben incluir un photo_reference. se muestran en la respuesta a Find Place, Nearby Search, Text Search o Place Details para cada solicitud. La respuesta a estas solicitudes contendrá un campo photos[] si la lugar tiene contenido fotográfico relacionado.

Nota: La cantidad de fotos que se muestran varía según la solicitud.

  • Una solicitud de Find Place, Nearby Search o Text Search muestra, como máximo, un elemento photo. en el array.
  • Una solicitud a Place Details muestra hasta diez elementos photo.

Cada elemento photo contiene los siguientes campos:

  • photo_reference: Es una cadena que se usa para identificar la foto cuando 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[]: Contiene las atribuciones requeridas. Esta campo siempre estará 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 html_attributions, 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:

curl "https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJcUElzOzMQQwRLuV30nMUEUM&key=YOUR_API_KEY"

A continuación, se muestra un ejemplo del array photos[] en la respuesta.

...
"photos" : [
   {
      "html_attributions" : [],
      "height" : 853,
      "width" : 1280,
      "photo_reference" : "ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q"
   }
...

Ejemplo de Place Photo

A continuación, se muestra una solicitud de ejemplo. Esta solicitud devolverá la referencia cambiando el tamaño de la imagen para que tenga, como máximo, 400 píxeles de ancho.

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q&key=YOUR_API_KEY

Respuesta de Place Photo

La respuesta de una solicitud de fotos de sitios exitosa es una imagen. El tipo de la imagen dependerá del tipo de foto enviada originalmente.

Si tu solicitud excede la cuota disponible, el servidor devolverá un HTTP 403 y muestra la siguiente imagen para indicar que la cuota se ha se superó:

Imagen que indica que se superó la cuota

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:

  • No se especificó correctamente la referencia de foto enviada.
  • La solicitud no incluyó maxwidth ni maxheight. parámetros.
  • Se estableció el valor de los parámetros maxwidth o maxheight a null.
  • photo_reference ya venció. Si photo_reference vence, haz una a Place Details. Find Place, Búsqueda de Nearby, o Text Search para obtener el valor photo_reference actualizado.