Metadatos de imágenes de Street View

Introducción

Las solicitudes de metadatos de la API de Street View Static proporcionan datos sobre las panorámicas de Street View. Con los metadatos, puedes saber si una imagen de Street View está disponible en una ubicación determinada, además de obtener acceso programático a las coordenadas de latitud y longitud, el ID de panorámica, la fecha en 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 la fecha puede tener un nivel de detalle diferente para las distintas panorámicas. Por ejemplo, el campo de fecha de algunas panorámicas contiene el año y el mes, mientras que, para otras, solo contiene el año.
• El campo de la fecha se omite si no hay datos disponibles.

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

Cuando se solicitan 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: El protocolo https:// es obligatorio para las solicitudes de metadatos.

Como es norma en las URLs, todos los parámetros se separan usando el signo et (&).

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 los siguientes parámetros son obligatorios:

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 separados por comas (40.457375,-80.009353).

o:

• pano: Es un ID de panorámica específico. Los IDs de las panorámicas pueden cambiar con el tiempo, así 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 información detallada, consulta Cómo actualizar los IDs de panorámica borrados.

Y también:

• key y signature: Se requiere la clave de API para autenticar la solicitud. La firma digital también es obligatoria en ciertas instancias y siempre se recomienda. Para obtener más información, consulta Obtén una clave y una firma.

Tu solicitud de metadatos, que solo contiene 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 esta manera:

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

Actualizar los IDs de panorámica borrados

Si intentas recuperar un ID de panorámica y obtienes ZERO_RESULTS o ningún valor, el ID de panorámica se borró y debe actualizarse.

1. Guarda la dirección de la ubicación o las coordenadas de latitud y longitud que usaste para obtener un ID de panorámica, de modo que puedas actualizarla cuando sea necesario.

2. Cuando detectes que cambió un ID de panorámica, usa la dirección de ubicación original o las coordenadas de latitud y longitud para volver a buscar las panorámicas más cercanas a esa ubicación y obtener un ID de panorámica nuevo.

Nota: Debido a que las imágenes de Street View se actualizan periódicamente y que las fotografías pueden tomarse desde posiciones ligeramente diferentes en cada ocasión, un ID de panorámica determinado puede ajustarse a una panorámica diferente cuando se actualizan las imágenes o el ID de panorámica.

Parámetros opcionales para las 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 en los datos sobre la panorámica ni sobre qué panorámica 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. Sin embargo, para las solicitudes de metadatos, la API ignora los parámetros opcionales y sus valores. Para obtener información sobre cómo usar estos parámetros, consulta la Guía para desarrolladores de la API de Street View Static.

Formato de la 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 de la misma 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 URLs 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 dentro del objeto de respuesta de metadatos contiene el estado de la solicitud y puede contener información de depuración para ayudarte a solucionar por qué la solicitud de Street View no funciona. El campo status puede contener los siguientes valores:

Estado	Descripción
"OK"	Indica que no se produjeron errores, se encuentra una panorámica y se muestran metadatos.
"ZERO_RESULTS"	Indica que no se encontró un panorama cerca de la ubicación proporcionada. Esto puede ocurrir si proporcionas un ID de panorámica que no existe o no es válido. Consulta [Cómo actualizar las IDs de panorámicas borradas](#refresh-pano).
"NOT_FOUND"	Indica que no se pudo encontrar la string 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 aparecer si no autorizaste tu solicitud o si la API de Street View Static no está activada en el proyecto de Google Cloud Console que contiene tu clave de API.
"INVALID_REQUEST"	Por lo general, indica que faltan parámetros de consulta (direcciones, coordenadas de latitud y longitud o componentes).
"UNKNOWN_ERROR"	Indica que no se pudo procesar la solicitud debido a un error de 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 Google Maps.