Metadatos de imágenes de Street View

Introducción

Las solicitudes de metadatos de la API de Street View Static proporcionan datos sobre panoramas de Street View. Con los metadatos, puedes averiguar si hay una imagen de Street View disponible en una ubicación determinada, y obtener acceso mediante programación a las coordenadas de latitud y longitud, el ID del panorama, la fecha en la que se tomó la foto y la información de derechos de autor de la imagen. El acceso a estos metadatos te permite personalizar el comportamiento de error en tu aplicación.

Nota: El valor del campo de fecha puede variar:

• El campo de fecha puede tener un nivel de detalle diferente para diferentes panoramas. Por ejemplo, el campo de fecha de algunos panoramas contiene un año y un mes, mientras que en otros solo contiene el año.
• El campo de fecha se omite si no hay datos disponibles.

Las solicitudes de metadatos a la API de Street View Static están disponibles sin costo. No se consume cuota cuando solicitas metadatos. La cuota solo se consume cuando cargas una imagen con la API de Street View Static.

Cuando se realizan solicitudes de metadatos de imágenes de Street View, las imágenes panorámicas tienen una precisión 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

Nota: Se requiere el protocolo https:// para las solicitudes de metadatos.

Como es norma en las URLs, todos los parámetros se separan con el carácter de Y comercial (&).

Parámetros obligatorios para las solicitudes de metadatos

Las solicitudes de metadatos aceptan 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 (como Chagrin Falls, OH) o un par de coordenadas de latitud y longitud separadas por comas (40.457375,-80.009353).

o:

• pano: Es un ID de panorama específico. Los panoramas pueden cambiar de ID con el tiempo, por lo que no debes conservar este ID. En su lugar, guarda la dirección de la ubicación o las coordenadas de latitud y longitud para que puedas actualizar el ID de panorama. Para obtener más detalles, consulta Cómo actualizar los IDs de panoramas borrados.

Y también:

• key y signature: La clave de API es obligatoria para autenticar la solicitud. La firma digital también es obligatoria en algunos casos y siempre se recomienda. 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=

o de la siguiente manera:

https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&signature=

Actualiza los IDs de panoramas borrados

Si intentas recuperar un ID de panorama y obtienes ZERO_RESULTS o ningún valor, significa que se borró el ID de panorama y se debe actualizar.

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

2. Cuando detectes que cambió el ID de un panorama, usa la dirección de la ubicación original o las coordenadas de latitud y longitud para volver a buscar los panoramas más cercanos a esa ubicación y obtener un nuevo ID de panorama.

Nota: 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, un ID de panorama determinado puede integrarse a otra panorámica cuando se actualizan las imágenes o el ID de panorama.

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 afectan los datos sobre el panorama ni sobre el panorama que se encuentra. La API permite incluir los mismos parámetros que la solicitud de imágenes para facilitar la construcción de una solicitud de metadatos relacionada con una solicitud de imágenes específica, aunque 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 de la API estática de Street View.

Formato de respuesta

Las respuestas de metadatos se muestran en formato JSON únicamente.

Ejemplos

Ejemplo 1: Se encontró un panorama

Las siguientes URLs solicitan correctamente metadatos e imágenes del mismo panorama.

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, donde 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

Es posible que las muestras no estén disponibles en tu región.

Ejemplo 2: No se encontró el panorama

Las siguientes URLs solicitan los metadatos y la imagen de un panorama que no se podía encontrar en la ubicación especificada ni cerca de ella.

Solicitud y respuesta de metadatos

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 y respuesta de imágenes

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

Es posible que las muestras no estén disponibles en tu región.

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 el problema por el que 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 un panorama y se muestran los metadatos.
"ZERO_RESULTS"	Indica que no se encontró un panorama cerca de la ubicación proporcionada. Esta respuesta puede ocurrir si proporcionas un ID de panorama que no existe o no es válido. Consulta [Cómo actualizar los IDs de panoramas borrados](#refresh-pano).
"NOT_FOUND"	Indica que no se pudo encontrar la cadena de dirección proporcionada en el parámetro location. Este mensaje puede aparecer si se proporciona una dirección que no existe.
"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 ocurrir si no autorizaste 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"	Por lo general, indica que faltan 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 el uso de la API de Street View Static o de otros productos de la API de Google Maps, asegúrate de consultar la página de asistencia de la API de Maps.