Fotos del lugar

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.
Seleccionar plataforma: Android iOS JavaScript Servicio web

El servicio de Fotos de lugares, que forma parte de la API de Places, es una API de solo lectura que te permite agregar contenido fotográfico de alta calidad a tu aplicación. El servicio de Fotos de lugares te brinda acceso a las millones de fotos almacenadas en la base de datos de Places. Cuando obtienes información sobre sitios mediante una solicitud a Place Details, se mostrarán referencias de fotos para el contenido fotográfico relevante. Las solicitudes de Find Place, Nearby Search y Text Search también muestran una referencia de una foto por lugar, cuando es relevante. 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 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. Al igual que en las URL, todos los parámetros se separan con el carácter de unión (&). A continuación, se proporciona una lista de los parámetros y sus posibles valores.

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.

Optional parameters

  • 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. Both the maxheight and maxwidth properties accept an integer between 1 and 1600.

  • 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.

Generated from the OpenAPI specification. Edit Report bug

Referencias de fotos

Todas las solicitudes al servicio de Fotos de sitios deben incluir un photoreference, que se muestra en respuesta a una solicitud de Find Place, Nearby Search, Text Search o Place Details. La respuesta a estas solicitudes contendrá un campo photos[] si el lugar tiene contenido fotográfico relacionado.

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

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

Cada elemento photo contendrá los siguientes campos:

  • photo_reference: Es una string 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[]: Contiene las atribuciones requeridas. Este campo siempre estará presente, pero puede estar vacío.

Las fotos que muestra el servicio de fotos provienen de una variedad de ubicaciones, incluidos los propietarios de empresas y las fotos que aportan los usuarios. En la mayoría de los casos, estas fotos se pueden usar sin atribución o tendrán la atribución requerida incluida como parte de la imagen. Sin embargo, si el elemento photo que se muestra incluye un valor en el campo html_attributions, debes incluir la atribución adicional en tu aplicación en cualquier lugar en el que muestres la imagen.

A continuación, se muestra un ejemplo de un arreglo photos[].

...
"photos" : [
   {
      "html_attributions" : [],
      "height" : 853,
      "width" : 1280,
      "photo_reference" : "CnRvAAAAwMpdHeWlXl-lH0vp7lez4znKPIWSWvgvZFISdKx45AwJVP1Qp37YOrH7sqHMJ8C-vBDC546decipPHchJhHZL94RcTUfPa1jWzo-rSHaTlbNtjh-N68RkcToUCuY9v2HNpo5mziqkir37WU8FJEqVBIQ4k938TI3e7bf8xq-uwDZcxoUbO_ZJzPxremiQurAYzCTwRhE_V0"
   }
...

Ejemplo de foto de lugar

A continuación, se muestra una solicitud de ejemplo. Esta solicitud muestra la imagen a la que se hace referencia y cambia su tamaño para que tenga, como máximo, 400 píxeles de ancho.

https://maps.googleapis.com/maps/api/place/photo
  ?maxwidth=400
  &photo_reference=Aap_uEA7vb0DDYVJWEaX3O-AtYp77AaswQKSGtDaimt3gt7QCNpdjp1BkdM6acJ96xTec3tsV_ZJNL_JP-lqsVxydG3nh739RE_hepOOL05tfJh2_ranjMadb3VoBYFvF0ma6S24qZ6QJUuV6sSRrhCskSBP5C1myCzsebztMfGvm7ij3gZT
  &key=YOUR_API_KEY

Respuesta de fotos de sitios

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

Si tu solicitud supera tu cuota disponible, el servidor mostrará un estado HTTP 403 y mostrará la siguiente imagen para indicar que se superó la cuota:

Imagen de cuota superada

Si el servidor no puede comprender tu solicitud, muestra un estado HTTP 400, que indica una solicitud no válida. Los motivos más comunes de una solicitud no válida son los siguientes:

  • La referencia de foto enviada no se especificó correctamente.
  • La solicitud no incluía los parámetros maxwidth ni maxheight.
  • El valor de los parámetros maxwidth o maxheight se estableció en null.