Solicitud y respuesta de Street View

Una solicitud de imagen de Street View es una URL HTTP con el siguiente formato:

https://maps.googleapis.com/maps/api/streetview?parameters

La imagen se especifica usando parámetros de solicitud. Tal como es práctica estándar para las URLs, todos los parámetros se separan con el signo &. A continuación, se proporciona una lista de los parámetros permitidos y sus posibles valores.

Parámetros obligatorios

Realiza una de las siguientes acciones:

  • location puede ser una cadena de texto (como Chagrin Falls, OH) o un par de coordenadas de latitud y longitud (40.457375,-80.009353), y debe estar codificada como URL. Por lo tanto, convierte direcciones como "City Hall, New York, NY" en "City+Hall,New+York,NY" antes de enviar la solicitud. La API de Street View Static se ajusta a la fotografía panorámica más cercana a la ubicación. Cuando proporcionas una cadena de texto de dirección, la API puede usar una ubicación de cámara diferente para mostrar mejor la ubicación especificada. Cuando proporcionas coordenadas de latitud y longitud, la API busca una fotografía más cercana a la ubicación en un radio de 50 metros. Debido a que las imágenes de Street View se actualizan periódicamente y las fotografías se pueden tomar desde posiciones ligeramente diferentes cada vez, es posible que tu location se ajuste a un panorama diferente cuando se actualicen las imágenes.

o:

  • pano es un ID de panorama específico. Los panoramas pueden cambiar de ID con el tiempo, por lo que no debes conservar este ID. En su lugar, guarda la dirección de la ubicación o las coordenadas de latitud y longitud para que puedas actualizar el ID de la panorámica. Para obtener más detalles, consulta Cómo actualizar los IDs de panoramas borrados.

Y también:

  • size especifica el tamaño de salida de la imagen en píxeles. El tamaño se especifica como {width}x{height}. Por ejemplo, size=600x400 muestra una imagen de 600 píxeles de ancho y 400 de alto.
  • key te permite supervisar el uso de la API de tu aplicación en la consola de Google Cloud y garantiza que Google pueda comunicarse contigo en relación con tu aplicación si es necesario. Para obtener más información, consulta Obtén una clave y una firma.

Actualiza los IDs de panorámicas borrados

Si intentas recuperar un ID de panorama y obtienes ZERO_RESULTS o ningún valor, significa que se borró el ID de panorama y se debe actualizar.

  1. Guarda la dirección de la ubicación o las coordenadas de latitud y longitud que usaste para obtener un ID de panorama para que puedas actualizarlo cuando sea necesario.

  2. Cuando detectes que cambió el ID de una panorámica, usa la dirección de la ubicación original o las coordenadas de latitud y longitud para volver a buscar las panorámicas más cercanas a esa ubicación y obtener un nuevo ID de panorámica.

Parámetros opcionales

  • signature (recomendado) es una firma digital que se usa para verificar que cualquier sitio que genere solicitudes con tu clave de API esté autorizado para hacerlo. Es posible que las solicitudes que no incluyan una firma digital fallen. Para obtener más información, consulta Obtén una clave y una firma.

    Nota: Para los clientes anteriores del plan premium de Google Maps Platform, la firma digital es obligatoria. Obtén más información sobre los parámetros de autenticación para los clientes del plan Premium.

  • heading indica el rumbo de la brújula de la cámara. Los valores aceptados son de 0 a 360 (ambos valores indican el norte, 90 indica el este y 180 el sur). Si no especificas un encabezado, se calcula un valor que dirige la cámara hacia el location especificado, desde el punto en el que se tomó la fotografía más cercana.
  • fov (el valor predeterminado es 90) determina el campo de visión horizontal de la imagen expresado en grados, con un valor máximo permitido de 120. Cuando se trata de un viewport de tamaño fijo, como con una imagen de Street View de un tamaño determinado, el campo de visión en esencia representa el zoom, con números más pequeños que indican un nivel de zoom más alto.


    Captura de pantalla de un campo de visión amplio que muestra el techo, las paredes, el piso y la ventana de un tanque dentro de un acuario. Captura de pantalla de un campo visual de primer plano que muestra los detalles ampliados de una foto de Street View dentro de un acuario.
    (izquierda: fov=120; derecha: fov=20)

  • pitch (el valor predeterminado es 0) especifica el ángulo hacia arriba o hacia abajo de la cámara en relación con el vehículo de Street View. Generalmente, pero no siempre, es plano horizontal. Los valores positivos inclinan la cámara hacia arriba (con 90 grados que indican hacia arriba); los valores negativos inclinan la cámara hacia abajo (con -90 que indica hacia abajo).
  • radius (el valor predeterminado es 50) establece un radio, especificado en metros, en el que se debe buscar una panorámica, centrada en la latitud y longitud determinadas. Los valores válidos son números enteros que no son negativos.
  • return_error_code indica si la API debe mostrar un código de error cuando no se encuentra una imagen (404 NOT FOUND) o en respuesta a una solicitud no válida (400 BAD REQUEST). Los valores válidos son true y false. Si se establece en true, se muestra un mensaje de error en lugar de la imagen genérica en gris. Esto elimina la necesidad de realizar una llamada independiente para verificar la disponibilidad de la imagen.
  • source (el valor predeterminado es default) limita las búsquedas de Street View a las fuentes seleccionadas. Los valores válidos son los siguientes:
    • default usa las fuentes predeterminadas de Street View; las búsquedas no se limitan a fuentes específicas.
    • outdoor limita las búsquedas a las colecciones al aire libre. Las colecciones de interior no se incluyen en los resultados de la búsqueda. Ten en cuenta que es posible que no existan panorámicas al aire libre para la ubicación especificada. Ten en cuenta también que la búsqueda solo muestra panorámicas en las que es posible determinar si están en interiores o al aire libre. Por ejemplo, no se muestran las fotos panorámicas porque no se sabe si se tomaron en interiores o exteriores.

Esta es una solicitud de ejemplo.

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=46.414382,10.013988&heading=151.78&pitch=-0.76&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
Captura de pantalla de una foto de punto de vista a nivel de la calle que muestra vías férreas electrificadas.

No hay imágenes disponibles

En el caso de las ubicaciones donde no hay imágenes de Street View disponibles, la API de Street View Static muestra una imagen genérica gris con el texto "Lo sentimos, no tenemos imágenes aquí", como se muestra en este ejemplo:

Una captura de pantalla de la imagen genérica que se muestra cuando no hay imágenes disponibles para la ubicación especificada. El fondo es marrón claro y muestra el texto "Lo sentimos. No tenemos imágenes en este lugar".
Figura: Imagen genérica que se muestra cuando no hay imágenes disponibles para la ubicación especificada.

Mostrar solo imágenes válidas

Para evitar mostrar la imagen genérica y asegurarte de que tu página web muestre solo imágenes válidas de la API de Street View Static, sigue estas sugerencias:

  • Establece el parámetro return_error_code en true. Esto hace que la API de Street View Static devuelva un error 404 NOT FOUND en lugar de la imagen genérica en gris, si no hay ninguna imagen disponible para la ubicación especificada.
  • Solicita metadatos de imágenes de Street View para determinar si hay imágenes disponibles para la ubicación especificada antes de enviar una solicitud.