Solicitud y respuesta de Street View

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

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

La imagen se especifica usando parámetros de solicitud. Como es norma en las URL, todos los parámetros se separan con el carácter de Y comercial (&). 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 string de texto (como Chagrin Falls, OH) o un valor de latitud y longitud (40.457375,-80.009353) y debe estar codificada en la URL, por lo que las direcciones como “City Hall, New York, NY” deben convertirse en “City+Hall,New+York,NY”, antes de que se firme la solicitud. La API de Street View Static se ajustará a la panorámica capturada más cerca de esa ubicación. Cuando se proporciona una string de texto de la dirección, la API puede usar una ubicación diferente de la cámara para mostrar mejor la ubicación especificada. Cuando se proporciona una latitud y longitud, la API busca un radio de 50 metros en una fotografía más cercana a esa ubicación. Debido a que las imágenes de Street View se actualizan periódicamente y las fotografías pueden tomarse desde posiciones ligeramente diferentes en cada ocasión, es posible que tu location tome una foto diferente cuando se actualicen las imágenes.

o:

  • pano es un ID de panorámica específico. Generalmente son estables.

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 por parte de tu aplicación en Google Cloud Console y garantiza que Google pueda comunicarse contigo si es necesario. Para obtener más información, consulta Cómo obtener una clave y una firma.

Parámetros opcionales

  • signature (recomendado) es una firma digital que se usa para verificar que los sitios que generen solicitudes con tu clave de API estén autorizados para hacerlo. Es posible que fallen las solicitudes que no incluyan una firma digital. Para obtener más información, consulta Cómo obtener una clave y una firma.

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

  • heading: Indica la orientación de la cámara según la brújula. Los valores aceptados van de 0 a 360 (ambos valores indican el norte, 90 indica el este y 180 sur). Si no se especifica una orientación, se calculará un valor que dirija la cámara hacia el objeto location especificado desde el momento en que se tomó la fotografía más cercana.
  • fov (el valor predeterminado es 90) determina el campo visual horizontal de la imagen. El campo visual se expresa en grados, con un valor máximo permitido de 120. Cuando se trata de una ventana de visualización de tamaño fijo, al igual que con una imagen de Street View de un tamaño determinado, el campo visual en esencia representa el zoom, y los números más pequeños indican un mayor nivel de zoom.


    Captura de pantalla de un campo visual amplio que muestra el cielorraso, las paredes, el piso y la ventana del tanque dentro de un acuario. Captura de pantalla de un campo visual de cerca, que muestra un acercamiento de una foto de Street View dentro de un acuario.
    (izquierda: fov=120; derecha: fov=20)

  • pitch (predeterminado 0): Especifica el ángulo superior o inferior de la cámara respecto del vehículo de Street View. Generalmente, pero no siempre, es plano horizontal. Los valores positivos inclinan la cámara hacia arriba (con 90 grados hacia arriba en ángulo recto); los valores negativos inclinan la cámara hacia abajo (y -90 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 no negativos.
  • return_error_code indica si la API debe mostrar un código de error cuando no se encuentra ninguna 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 configura en true, se muestra un mensaje de error en lugar de la imagen gris genérica. De esta manera, no es necesario 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 para 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 interiores 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. También ten en cuenta que la búsqueda solo muestra panorámicas donde es posible determinar si son interiores o exteriores. Por ejemplo, no se muestran PhotoSphere porque se desconoce si son 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 a nivel de la calle en la que se muestran vías del ferrocarril eléctricas.

No hay imágenes disponibles

Para las ubicaciones en las que las imágenes de Street View no están disponibles, la API de Street View Static muestra una imagen genérica en color gris con el texto "Perdón, no tenemos imágenes aquí", como se muestra en este ejemplo:

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 texto como “Lo sentimos, no tenemos imágenes aquí”.
Figura: Se muestra una imagen genérica cuando no hay imágenes disponibles para la ubicación especificada.

Mostrar solo imágenes válidas

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

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