Place Photos (heredado)

Desarrolladores del Espacio Económico Europeo (EEE)

Place Photos (heredada), 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. Place Photos (heredada) te brinda acceso a millones de fotos almacenadas en la base de datos de Places. Si obtienes información sobre lugares mediante una solicitud de Place Details, se devolverán referencias de fotos para el contenido fotográfico correspondiente. Las solicitudes de Find Place (heredada), Nearby Search (heredada) y Text Search (heredada) también muestran una única referencia fotográfica por lugar, cuando corresponde. El servicio Place Photos (heredada) te brinda acceso a las fotos de referencia y te permite cambiar el tamaño de la imagen al más adecuado para tu aplicación.

Solicitudes de Place Photos (heredada)

Una solicitud de Place Photos (heredada) es una URL HTTP con el siguiente formato:

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

Ciertos parámetros son obligatorios para iniciar una solicitud de búsqueda. Tal como es práctica estándar para las URLs, todos los parámetros se separan usando el signo et (&). A continuación, se enumeran los parámetros y sus valores posibles.

Parámetros obligatorios

  • photo_reference

    Un identificador de cadena que identifica una foto de forma exclusiva. Las referencias de fotos se muestran a partir de una solicitud de Place Search o Place Details.

  • maxheight o maxwidth

    maxheight especifica la altura máxima preferida de la imagen en píxeles. Si la imagen es más pequeña que los valores especificados, se mostrará la imagen original. Si la imagen es más grande en cualquiera de las dimensiones, se ajustará para que coincida con la más pequeña de las dos dimensiones, restringida a su relación de aspecto original.

    maxwidth especifica el ancho máximo preferido de la imagen en píxeles. Si la imagen es más pequeña que los valores especificados, se mostrará la imagen original. Si la imagen es más grande en cualquiera de las dimensiones, se ajustará para que coincida con la más pequeña de las dos dimensiones, restringida a su relación de aspecto original.

    Las propiedades maxheight y maxwidth aceptan un número entero entre 1 y 1600.

    Debes especificar maxheight, maxwidth o ambos.

Referencias de fotos

Todas las solicitudes a Place Photos (heredada) deben incluir una photo_reference, que se muestra en la respuesta a una solicitud de Find Place (heredada), Nearby Search (heredada), Text Search (heredada) o Place Details (heredada). 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 de Find Place (heredada), Nearby Search (heredada) o Text Search (heredada) muestra, como máximo, un elemento photo en el array.
  • Una solicitud de Place Details (heredada) 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 realizas una solicitud de Place Photos (heredada).
  • height: Es la altura máxima de la imagen.
  • width: Es el ancho máximo de la imagen.
  • html_attributions[]: Contiene las atribuciones obligatorias. Este campo siempre estará presente, pero puede estar vacío.

Las fotos que muestra Place Photos (heredada) provienen de una variedad de fuentes, incluidas las fotos proporcionadas por los propietarios de las empresas y los aportes de los usuarios. En la mayoría de los casos, estas fotos se pueden utilizar sin atribución; de lo contrario, incluirán la atribución requerida como parte de la imagen. Sin embargo, si el elemento photo que se muestra incluye un valor en el campo html_attributions, deberás incluir la atribución adicional en tu aplicación en cualquier lugar donde muestres la imagen.

En el siguiente ejemplo, se muestra una solicitud de Place Details (heredada):

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 Photos (heredada)

A continuación, se muestra una solicitud de ejemplo. Esta solicitud muestra la imagen a la que se hace referencia y la redimensiona para que tenga un ancho máximo de 400 píxeles.

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

Respuesta de Place Photos (heredada)

La respuesta de una solicitud exitosa de Place Photos (heredada) es una imagen. El tipo de imagen depende del tipo de foto enviada originalmente.

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

Imagen de cuota superada

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