Introducción
Las solicitudes de metadatos a la API de Street View Static proporcionan datos sobre Street Ver panorámicas. Con los metadatos, puedes saber si una imagen de Street View está disponible en una ubicación determinada, así como obtener acceso programático a las coordenadas de latitud y longitud, el ID de la panorámica, la fecha en que se y la información de derechos de autor de la imagen. Acceder Los metadatos te permiten personalizar el comportamiento de error en tu aplicación.
Las solicitudes de metadatos a la API de Street View Static no están disponibles y cargar. No se consume cuota cuando solicitas metadatos. La cuota solo se consume cuando cargas una imagen con el API de Street View Static:
Al realizar solicitudes de metadatos de imágenes de Street View, la imagen panorámica es de 50 metros.
Accede a los metadatos de las imágenes
Una solicitud de metadatos de imagenes de Street View es una URL HTTP como la siguiente:
https://maps.googleapis.com/maps/api/streetview/metadata?parameters
Tal como es norma en las URLs, todos los parámetros se separan con el signo et (&).
Parámetros obligatorios para las solicitudes de metadatos
Las solicitudes de metadatos aceptan el con los mismos parámetros de URL que las solicitudes de imágenes de la API de Street View Static, aunque solo se requieren los siguientes parámetros:
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
) separados por comas.
o:
pano
: Es un ID de panorámica específico. Las panorámicas pueden cambiar sus IDs 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:
key
ysignature
: se requiere la clave de API para autenticar la para cada solicitud. La firma digital también es obligatoria en algunos casos. se recomienda siempre. Para obtener más información, consulta Obtén una clave y una firma.
Tu solicitud de metadatos, con solo los parámetros obligatorios, se ve de la siguiente manera:
https://maps.googleapis.com/maps/api/streetview/metadata?location=&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>
o así:
https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>
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.
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.
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 para solicitudes de metadatos
Puedes incluir los siguientes parámetros en tu solicitud de metadatos: size
,
heading
, fov
y pitch
. Ten en cuenta que estos parámetros no influyen
los datos sobre el panorama o qué panorama se encuentra.
La API permite incluir los mismos parámetros que el
solicitud de imágenes
para facilitar la construcción de una solicitud de metadatos relacionada con una imagen específica
pero para las solicitudes de metadatos, la API ignora los parámetros opcionales y
sus valores. Para obtener información sobre el uso de estos parámetros, consulta la
Guía para desarrolladores sobre la API de Street View Static.
Formato de respuesta
Las respuestas de metadatos se muestran en formato JSON únicamente.
Ejemplos
Ejemplo 1: Se encontró una panorámica
Las siguientes URLs solicitan correctamente los metadatos y la imagen del mismo panorámica.
Solicitud de metadatos y respuesta
https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
{ "copyright" : "© 2017 Google", "date" : "2016-05", "location" : { "lat" : 48.85783227207914, "lng" : 2.295226175151347 }, "pano_id" : "tu510ie_z4ptBZYo2BGEJg", "status" : "OK" }
Solicitud y respuesta de imágenes, en las que se espera la imagen faltante.
https://maps.googleapis.com/maps/api/streetview?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
Ejemplo 2: No se encontró la panorámica
Las siguientes URL solicitan los metadatos y la imagen para una panorámica que no se pudo encontrar en la ubicación especificada o cerca de ella.
Solicitud de metadatos y respuesta
https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
{ "status" : "ZERO_RESULTS" }
Solicitud de imágenes y respuesta
https://maps.googleapis.com/maps/api/streetview?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
Códigos de estado
El campo status
en el objeto de respuesta de metadatos contiene el estado de
la solicitud y puede contener información de depuración para ayudarte a solucionar problemas
por qué no funciona la solicitud de Street View. El campo status
puede contener
los siguientes valores:
Estado | Descripción |
---|---|
"OK" |
Indica que no se produjeron errores. se encuentra una panorámica y los metadatos que se devuelven. |
"ZERO_RESULTS" |
Indica que no se encontró un panorama cerca de la ubicación proporcionada. Esta respuesta puede ocurrir si proporcionas un ID de panorámica que no existe o no es válido. Consulta [Actualizar los IDs de panorámica borrados](#refresh-pano). |
"NOT_FOUND" |
Indica que la cadena de dirección proporcionada en el archivo location
no se pudo encontrar el parámetro. Este mensaje puede aparecer si una dirección inexistente
de un modelo de AA. |
"OVER_QUERY_LIMIT" |
Indica que superaste tu cuota diaria o la cuota por segundo. para esta API. |
"REQUEST_DENIED" |
Indica que se rechazó tu solicitud. Este mensaje puede aparecer si no autorices tu solicitud o si La API de Street View Static no está activada en el Proyecto de la consola de Google Cloud que contiene tu clave de API. |
"INVALID_REQUEST" |
Generalmente indica que los parámetros de consulta (dirección, coordenadas de latitud y longitud o componentes). |
"UNKNOWN_ERROR" |
Indica que no se pudo procesar la solicitud debido a un error del servidor. Este problema suele ser temporal. La solicitud podría completarse si realizas un nuevo intento. |
Más información
Para obtener más información sobre cómo usar la API de Street View Static o otros productos de la API de Google Maps, asegúrate de consultar la API de Google Maps Página de asistencia.