Metadatos de imágenes de Street View

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Introducción

Las solicitudes de metadatos a la API de Street View Static proporcionan datos sobre panoramas de Street View. Con los metadatos, puedes averiguar si una imagen de Street View está disponible en una ubicación determinada, así como obtener acceso programático a la 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.

Las solicitudes de metadatos de 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 con la API de Street View Static.

Al realizar solicitudes de metadatos de imágenes de Street View, las imágenes panorámicas tienen una precisión de 50 metros.

Acceso a metadatos de 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

Como es norma en las direcciones URL, 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 string 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 panorámica específico. Por lo general, son estables, aunque las panorámicas pueden cambiar de ID con el tiempo a medida que se actualizan las imágenes.

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 Cómo obtener una clave y una firma.

Tu solicitud de metadatos, con solo parámetros obligatorios, se verá de la siguiente manera:

https://maps.googleapis.com/maps/api/streetview/metadata?location=<STRING>&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>

o de esta manera:

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

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 en la panorámica 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íficas, pero para las solicitudes de metadatos, la API ignora los parámetros opcionales y sus valores. Consulta la guía para desarrolladores de la API de Street View Static si deseas obtener información sobre el uso de estos parámetros.

Formato de la respuesta

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

Ejemplos

Ejemplo 1: Panorámica encontrada

Las siguientes URL 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
Torre Eiffel

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
Marcador de posición No hay imágenes aquí

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 el problema por el que 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 un panorama y se muestran los metadatos.
"ZERO_RESULTS" Indica que no se encontró un panorama cerca de la ubicación proporcionada. Esto puede ocurrir si se proporciona un ID de panorama no existente o no válido.
"NOT_FOUND" Indica que no se pudo encontrar la string de dirección proporcionada en el parámetro location. Esto puede ocurrir 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. Esto puede ocurrir 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 los parámetros de búsqueda (dirección, latlng o componentes).
"UNKNOWN_ERROR" Indica que no se pudo procesar la solicitud debido a un error del servidor. Este suele ser un estado 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.