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 habitual en URLs; todos los parámetros se separan con el signo et (&). 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 tener codificación URL. Haz una conversión direcciones, como "Ayuntamiento, Nueva York, NY" a "City+Hall,Nueva+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 la fotografía más cercana a la ubicación en un radio de 50 metros. Como las imágenes de Street View se actualizan periódicamente, y las fotografías pueden desde posiciones ligeramente diferentes en cada ocasión, es posible que tu location puede ajustarse a una panorámica diferente cuando se actualizan las imágenes.

o:

  • pano es un ID de panorámica específico. El ID de las panorámicas puede cambiar con el tiempo, por lo que no conserves este ID. En cambio, guarda la dirección de la ubicación coordenadas de latitud y longitud para que puedas actualizar el ID de la panorámica. Para consulta Actualizar los IDs de panorámica borrados.

Y también:

  • size especifica el tamaño de salida de la imagen en píxeles. El tamaño se especifica de la siguiente manera: {width}x{height}: Por ejemplo, size=600x400 devuelve 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 la Consola de Google Cloud, y garantiza que Google pueda comunicarse contigo respecto de la aplicación, si fuera necesario. Para obtener más información, consulta Obtén una clave y una firma.

Actualizar los IDs de panorama borrados

Si intentas recuperar un ID de panorámica y obtienes ZERO_RESULTS o sin valor, el ID de panorámica se ha eliminado y es necesario actualizarlo.

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

  2. Si detectas que ha cambiado un ID de panorámica, utiliza la ubicación original. dirección o las coordenadas de latitud y longitud para volver a buscar la más cercana panorámicas a esa ubicación y obtendrás un nuevo ID de panorámica.

Parámetros opcionales

  • signature (recomendado) es una firma digital que se utiliza. para verificar que cualquier sitio que genere solicitudes con tu clave de API esté autorizado para hacerlo. Las solicitudes que no incluyan una firma digital podrían fallar. Para obtener más información, consulta Obtén una clave y una firma.

    Nota: Para los antiguos clientes del plan Premium de Google Maps Platform, la tecnología digital firma obligatoria. Obtén más información sobre de autenticación para Clientes del plan Premium.

  • heading indica la orientación según la brújula la cámara. Los valores aceptados van de 0 a 360 (ambos valores indican el norte, 90 el este y 180 Sur). Si no especificas un encabezado, se asigna un valor calculada que dirija la cámara hacia la imagen location, desde el punto en el que se encontró la fotografía más cercana tomadas.
  • fov (la configuración predeterminada es 90) determina el campo visual horizontal de la imagen expresado en grados con un valor máximo permitido de 120. Cuando se trabaja con un viewport de tamaño fijo, como con una imagen de Street View de una establecer el tamaño; el campo visual en esencia representa el zoom, con números más pequeños lo que indica un mayor nivel de zoom.


    Captura de pantalla de un campo visual amplio que muestra el cielorraso, 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 de una foto de Street View dentro de un acuario.
    (Izquierda: fov=120; derecha: fov=20)

  • pitch (la configuración predeterminada es 0) especifica el ángulo superior o inferior de la cámara en relación con la imagen de Street View vehículo. Generalmente, pero no siempre, es plano horizontal. Valores positivos inclina la cámara hacia arriba (en el que 90 grados indican que el extremo está en línea recta hacia arriba). valores negativos apuntan hacia abajo en el ángulo de la cámara (en el que -90 indica directamente hacia abajo).
  • radius (la configuración predeterminada es 50) establece un radio, especificado en metros, en el que se debe buscar un panorama. se centra en la latitud y longitud determinadas. Los valores válidos no son negativos en números enteros.
  • return_error_code indica si la API debe mostrar un código de error cuando no se encuentra ninguna imagen (404 NO ENCONTRADO), o en respuesta a una solicitud no válida (400 BAD REQUEST). Los valores válidos son true y false Si se configura como true, aparecerá un mensaje de error. en lugar de la imagen genérica gris. Esto elimina la necesidad de haz otra llamada para verificar la disponibilidad de la imagen.
  • source (la configuración predeterminada 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. Para 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. Además, ten en cuenta que la búsqueda solo devuelve panorámicas donde sea posible determinar si están en espacios cerrados o al aire libre. Por ejemplo: Las fotos esféricas no se muestran porque se desconoce si se encuentran en interiores o al aire libre.

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 desde un mirador al nivel de la calle en la que se muestran vías de ferrocarril electrificadas.

No hay imágenes disponibles

Para las ubicaciones donde las imágenes de Street View no están disponibles, la API de Street View Static devuelve una imagen genérica en color gris con el texto “Lo sentimos, 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 un texto que dice "Lo sentimos, no tenemos imágenes aquí".
Figura: imagen genérica que se muestra cuando no hay imágenes disponibles para el ubicación especificada.

Mostrar solo imágenes válidas

Para evitar que se muestre la imagen genérica y asegurarse de que su página web muestra 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 muestre un error 404 NOT FOUND (No encontrado) en lugar de la imagen genérica gris, si no hay ninguna imagen disponible para el ubicación especificada.
  • Solicita metadatos de imágenes de Street View. para determinar si hay imágenes disponibles para la ubicación especificada antes para enviar una solicitud.