Eso es todo.

Para comenzar a desarrollar, consulta nuestra documentación para desarrolladores.

Activar la Google Street View Image API

Para que puedas comenzar, te proporcionaremos orientación en la consola para desarrolladores de Google a fin de que hagas primero algunas acciones:

  1. Crear o seleccionar un proyecto
  2. Activar la Google Street View Image API
  3. Crear claves correspondientes
Continuar

Metadatos de imágenes de Street View

Introducción

Las solicitudes de metadatos de la Google Street View Image API proporcionan datos sobre panoramas de Street View. Mediante el uso de metadatos, puedes averiguar si hay una imagen de Street View disponible en una ubicación determinada, y obtener acceso mediante programación a la latitud y longitud, al ID del panorama, a la fecha en la que se tomó la foto y a 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 Google Street View Image API son gratuitas. No se consume cuota cuando solicitas metadatos. La cuota solo se consume cuando cargas una imagen usando la Google Street View Image API.

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

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

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

Parámetros obligatorios para solicitudes de metadatos

Las solicitudes de metadatos aceptan los mismos parámetros URL que las solicitudes de imágenes de la Street View Image API, aunque solo los siguientes parámetros son obligatorios:

Tienes una de las siguientes opciones:

  • location: puede ser una string de texto (como Chagrin Falls, OH) o un valor de latitud y longitud (40.457375,-80.009353).

O bien:

  • pano: ID de panorama específico. Generalmente son estables.

Y también:

  • key o client y signature: la clave de API o el ID de cliente son credenciales obligatorias para autenticar la solicitud. También se requiere la firma digital en algunas instancias. Para acceder a más información, consulta Obtener una clave y una firma.

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 encuentre. La API permite incluir los mismos parámetros que la solicitud de imagen para facilitar la construcción de una solicitud de metadatos relacionada con una solicitud de imágenes específicas, aunque para las solicitudes de metadatos la API ignora los parámetros opcionales y sus valores. Consulta del desarrollador para la Street View Image API si deseas obtener información sobre el uso de estos parámetros.

Formato de respuesta

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

Ejemplos

Ejemplo 1

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&fov=110&pitch=38&key=YOUR_API_KEY
{
   "copyright" : "© 2016 Google",
   "date" : "2016-04",
   "location" : {
      "lat" : 48.85895346423429,
      "lng" : 2.293383539827548
   },
   "pano_id" : "ou7kIuLmb-TE-EnFkxhPHQ",
   "status" : "OK"
}

Solicitud de imágenes y respuesta

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=eiffel%20tower,%20paris,%20france&fov=110&pitch=38&key=YOUR_API_KEY

Ejemplo 2

Las siguientes URL solicitan los metadatos y la imagen para un panorama que no se podía encontrar en la ubicación especificada ni 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
{
   "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

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 localizar el motivo 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. Esto puede ocurrir si se proporciona un ID de panorama que no existe o no es 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 usaste una clave de API o un ID de cliente, o si la Google Street View Image API no está activada en el proyecto de la Google API Console que contiene tu clave de API.
"INVALID_REQUEST" Generalmente indica que faltan los parámetros de consulta (dirección, latitud y longitud o componentes).
"UNKNOWN_ERROR" Indica que no se pudo procesar la solicitud debido a un error del servidor. Generalmente, este es un estado temporal. La solicitud puede tener éxito si realizas un nuevo intento.

Más información

Para obtener más información acerca del uso de Google Street View Image API, u otros productos de Google Maps API, asegúrate de consultar la página de soporte de la Maps API.

Enviar comentarios sobre…

Google Street View Image API
¿Necesitas ayuda? Visita nuestra página de asistencia.