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 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 (comoChagrin Falls, OH
) o un par de coordenadas de latitud y longitud (40.457375,-80.009353
), y debe estar codificado en formato URL. Por lo tanto, convierte las 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 la 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 a que las fotografías pueden tomarse desde posiciones ligeramente diferentes en cada ocasión, es posible que tulocation
se ajuste a una panorámica diferente cuando se actualicen las imágenes.
o:
pano
es un ID de panorámica específico. Es posible que el ID de las panorámicas cambie con el tiempo, por lo que te recomendamos que no conserves este ID. En su lugar, guarda la dirección de la ubicación o las coordenadas de latitud y longitud para poder actualizar el ID de la panorámica. Para obtener más información, consulta Cómo actualizar los IDs de panorámicas 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 por parte de tu aplicación en Google Cloud Console y garantiza que Google pueda comunicarse contigo acerca de tu aplicación si es 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 un valor ZERO_RESULTS
o ningún valor, significa que el ID de panorámica se borró y debe actualizarse.
Guarda la dirección de la ubicación o las coordenadas de latitud y longitud que usaste para obtener un ID de panorámica para que puedas actualizarla cuando sea necesario.
Cuando detectes que un ID de panorámica cambió, usa la dirección de ubicación original o las coordenadas de latitud y longitud para buscar nuevamente las panorámicas más cercanas a esa ubicación y obtener un ID de panorámica nuevo.
Parámetros opcionales
signature
(recomendado) es una firma digital que se usa para verificar que los sitios que generan solicitudes con tu clave de API estén autorizados 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 clientes anteriores del plan Premium de Google Maps Platform, se requiere la 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 de0
a360
(ambos valores indican el norte,90
indica el este y180
el sur). Si no especificas una orientación, se calcula un valor que dirige la cámara hacia ellocation
especificado, desde el punto en el que se tomó la fotografía más cercana.fov
(el valor predeterminado es90
) determina el campo visual horizontal de la imagen expresado en grados, con un valor máximo permitido de120
. Cuando se trata de un viewport 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.
(Izquierda:fov=120
; derecha:fov=20
)pitch
(el valor predeterminado0
) especifica el ángulo superior o inferior de la cámara en relación con el vehículo de Street View. Generalmente, pero no siempre, es plano horizontal. Los valores positivos orientan la cámara en un ángulo hacia arriba (donde90
grados indica que la cámara está en posición recta hacia arriba), mientras que los valores negativos la apuntan hacia abajo (donde-90
indica que la cámara es hacia abajo).radius
(valor predeterminado50
): Establece un radio, especificado en metros, en el que se buscará una panorámica, centrado 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 sontrue
yfalse
. Si se configura entrue
, se muestra un mensaje de error en lugar de la imagen gris genérica. Esto elimina la necesidad de realizar una llamada independiente para verificar la disponibilidad de la imagen.source
(el valor predeterminado esdefault
) 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 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 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 esféricas 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
No hay imágenes disponibles
En el caso de las ubicaciones donde 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 "Lo sentimos, no tenemos imágenes aquí.", como se muestra en este ejemplo:
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
entrue
. Esto hace 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 las imágenes de Street View a fin de determinar si hay imágenes disponibles para la ubicación especificada antes de enviar una solicitud.