Google Street View Image API

Introducción

Google Street View Image API te permite insertar una imagen panorámica estática de Street View (no interactiva) o una miniatura en tu página web sin usar JavaScript. El viewport se define con parámetros de dirección URL enviados a través de una solicitud HTTP estándar, y se devuelve como una imagen estática.

Es probable que no haya muestras disponibles en tu región.

https://maps.googleapis.com/maps/api/streetview?size=400x400&location=40.720032,-73.988354
&fov=90&heading=235&pitch=10
&key=YOUR_API_KEY

Parámetros de dirección URL

Una solicitud de imagen de Street View es una dirección URL de HTTP como la siguiente:

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

La imagen se especifica usando parámetros de solicitud. Como es norma en las direcciones 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

Ya sea:

• location puede ser una cadena de texto (como Chagrin Falls, OH) o un valor de latitud/longitud (40.457375,-80.009353). Google Street View Image API se ajustará a la panorámica capturada más cerca de esa ubicación. Cuando se proporciona una string con 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 y longitud, la API busca en un radio de 50 metros la fotografía más cercana a esa ubicación. Debido a que las imágenes de Street View se actualizan de manera periódica, y a que las fotografías pueden tomarse desde posiciones ligeramente diferentes en cada ocasión, es posible que tu location se integre a otra panorámica cuando se actualicen las imágenes.

O bien:

• pano es un ID de panorama 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 devuelve una imagen de 600 píxeles de ancho y 400 de alto.
• key te permite controlar el uso de la API por parte de tu aplicación en Google API Console, habilita el acceso a una cuota diaria gratuita y garantiza que Google pueda comunicarse contigo respecto de tu aplicación, si es necesario. Para acceder a más información, consulta Obtener una clave y una firma.

  Nota: Los clientes de Google Maps APIs Premium Plan pueden usar una clave de API y una firma digital, o una firma digital y un ID de cliente válidos, en tus solicitudes de Street View. Obtén más información sobre parámetros de autenticación para clientes del Premium Plan.

  Los clientes con una licencia anterior de Google Maps APIs for Work deben incluir parámetros client y signature válidos con sus solicitudes, en lugar de una key. Para obtener más información, consulta la sección ID de cliente y firmas de la página 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. Nota: Si habilitas la facturación, se requiere la firma digital. Si excedes el límite diario gratuito de cargas de mapa, se facturará el resto de los mapas que cargues durante el día. Las cargas de mapa facturables en las que no se incluya la firma digital fallarán. Para acceder a más información, consulta Obtener una clave y una firma.

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

• 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 el sur). Si no se especifica una orientación, se calculará un valor que oriente la cámara hacia la location especificada desde el punto en el que se tomó la fotografía más cercana.
• fov (valor predeterminado de 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. Al manipular un viewport de tamaño fijo, al igual que con una imagen de Street View de un tamaño determinado, el campo de visión representa el zoom, en el que los números más bajos indican un mayor nivel de zoom.

  
  
  (Izquierda: fov=120; derecha: fov=20)

  Es probable que no haya muestras disponibles en tu región.

• pitch (valor predeterminado de 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 orientan la cámara en un ángulo ascendente (donde 90 grados indican el extremo superior); mientras los valores negativos la orientarán en un ángulo descendente (donde -90 indica el extremo inferior).

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

Es probable que no haya muestras disponibles en tu región.

No hay imágenes disponibles

Para los sitios sin imágenes de Street View disponibles, la Google Street View Image API muestra una imagen genérica en color gris con el texto “Sorry, we have no imagery here”.

Figura: Imagen genérica que se muestra cuando no hay imágenes disponibles para el sitio especificado.

Es probable que no haya muestras disponibles en tu región.

Si deseas evitar esta situación, puedes determinar si hay imágenes disponibles para el lugar especificado y otros datos sobre la imagen, solicitando metadatos de la imagen de Street View.

Más información

Para obtener más información acerca del uso de Google Street View Image API, u otros productos de Google Maps API, asegúrate de consultar la página de soporte de la Maps API.