Street View Static API

Antes de comenzar: antes de comenzar a utilizar la API estática de Street View, necesita un proyecto con una cuenta de facturación y la API estática de Street View habilitada. Para obtener más información, consulte Introducción a Google Maps Platform.

La API estática de Street View te permite incrustar una vista panorámica o una miniatura de Street View estática (no interactiva) en tu página web, sin el uso de JavaScript. La ventana gráfica se define con parámetros de URL enviados a través de una solicitud HTTP estándar y se devuelve como una imagen estática.

https://maps.googleapis.com/maps/api/streetview?size=400x400&location=47.5763831,-122.4211769
&fov=80&heading=70&pitch=0
&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Antes de que empieces

Este documento está dirigido a desarrolladores de sitios web y dispositivos móviles que deseen incluir imágenes panorámicas estáticas de la API de Street View Static dentro de una página web o aplicación móvil. Proporciona una introducción al uso de la API y material de referencia sobre los parámetros disponibles.

Antes de comenzar a desarrollar con la API estática de Street View, revise los requisitos de autenticación (necesita una clave de API) y el uso de la API y la información de facturación (debe habilitar la facturación en su proyecto).

Parámetros de URL

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 mediante parámetros de solicitud. Como es estándar en las URL, todos los parámetros se separan mediante el carácter comercial (&). Los parámetros permitidos y sus posibles valores se enumeran a continuación.

Parámetros requeridos

Cualquiera:

  • location puede ser una cadena de texto (como Chagrin Falls, OH) o un valor lat/lng (40.457375,-80.009353). La API estática de Street View se ajustará al panorama fotografiado más cercano a esta ubicación. Cuando se proporciona 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 se proporciona una latitud / longitud, la API busca en un radio de 50 metros una fotografía más cercana a esta ubicación. 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 location se muestre un panorama diferente cuando se actualicen las imágenes.

O:

  • pano es un ID de panorama específico. Generalmente son estables.

Así como también:

  • size especifica el tamaño de salida de la imagen en píxeles. El tamaño se especifica como : por ejemplo, devuelve una imagen de 600 píxeles de ancho y 400 de alto.{width}x{height}size=600x400
  • key le permite monitorear el uso de la API de su aplicación en Google Cloud Console y garantiza que Google pueda comunicarse con usted acerca de su aplicación si es necesario. Para obtener más información, consulte Obtener una clave y una firma.

Nota: Los clientes del Plan Premium de las API de Google Maps pueden usar una clave API y una firma digital, o una identificación de cliente y una firma digital válidas, en sus solicitudes de Street View. Obtenga más información sobre los parámetros de autenticación para los clientes del Plan Premium.

Parámetros opcionales

  • signature( recomendado ) es una firma digital que se utiliza para verificar que cualquier sitio que genere solicitudes utilizando su clave de API esté autorizado para hacerlo. Las solicitudes que no incluyen una firma digital pueden fallar. Para obtener más información, consulte Obtener una clave y una firma .

    Nota: para los clientes del Plan Premium de las API de Google Maps , se requiere la firma digital . Obtenga más información sobre los parámetros de autenticación para los clientes del Plan Premium .

  • headingindica el rumbo de la brújula de la cámara. Los valores aceptados son de 0a 360 (ambos valores indican Norte, con 90indicación Este y 180Sur). Si no se especifica ningún rumbo, se calculará un valor que dirija la cámara hacia el especificado location, 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. El campo de visión se expresa en grados, con un valor máximo permitido de 120. Cuando se trata de una ventana gráfica 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, y los números más pequeños indican un mayor nivel de zoom.


    Amplio campo de visión del acuario Acuario Campo de visión estrecho
    (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. Esto es a menudo, pero no siempre, horizontal plano. Los valores positivos inclinan la cámara hacia arriba (con 90grados que indican hacia arriba); los valores negativos inclinan la cámara hacia abajo (con la -90indicación hacia abajo).
  • radius(el valor predeterminado es 50 ) establece un radio, especificado en metros, en el que buscar un panorama, centrado en la latitud y longitud dadas. Los valores válidos son números enteros no negativos.
  • source(el valor predeterminado es default ) limita las búsquedas de Street View a fuentes seleccionadas. Los valores válidos son:
    • default utiliza 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 interior no se incluyen en los resultados de búsqueda. Tenga en cuenta que es posible que no existan panorámicas exteriores para la ubicación especificada. También tenga en cuenta que la búsqueda solo devuelve panoramas donde es posible determinar si están en interiores o exteriores. Por ejemplo, las PhotoSpheres no se devuelven porque se desconoce si están en interiores o exteriores.

A continuación se muestra 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

Vías del tren

No hay imágenes disponibles

Para las ubicaciones donde las imágenes de Street View no están disponibles, la API estática de Street View muestra una imagen genérica gris con el texto "Lo sentimos, no tenemos imágenes aquí".

Imagen genérica que se muestra cuando no hay imágenes disponibles para la ubicación especificadaFigura: Imagen genérica que se muestra cuando no hay imágenes disponibles para la ubicación especificada.

Metadatos de imagen

Para evitar mostrar la imagen genérica, puede determinar si hay imágenes disponibles para la ubicación especificada, así como otros datos sobre la imagen, solicitando metadatos de imagen de Street View .

Más información

Para obtener más información sobre el uso de la API estática de Street View u otros productos de la API de Google Maps, asegúrese de consultar la página de asistencia de la API de Google Maps .