Métadonnées des images Street View

Introduction

Les requêtes de métadonnées de l'API Street View Static fournissent des données sur les panoramas Street View. Grâce aux métadonnées, vous pouvez savoir si une image Street View est disponible à un endroit donné, et obtenir un accès programmatique aux coordonnées de latitude et de longitude, à l'ID du panorama, à la date à laquelle la photo a été prise et aux informations sur les droits d'auteur de l'image. L'accès à ces métadonnées vous permet de personnaliser le comportement des erreurs dans votre application.

Les requêtes de métadonnées de l'API Street View Static sont disponibles sans frais. Elles ne sont soumises à aucun quota. Le quota n'est consommé que lorsque vous chargez une image à l'aide de l'API Street View Static.

Lorsque vous effectuez des demandes de métadonnées d'images Street View, les images panoramiques sont précises à 50 mètres.

Accéder aux métadonnées des images

Une requête de métadonnées d'image Street View est une URL HTTP au format suivant :

https://maps.googleapis.com/maps/api/streetview/metadata?parameters

Comme c'est la norme pour les URL, les différents paramètres sont séparés par une esperluette (&).

Paramètres requis pour les demandes de métadonnées

Les requêtes de métadonnées acceptent les mêmes paramètres d'URL que les requêtes d'images de l'API Street View Static, bien que seuls les paramètres suivants soient obligatoires :

L'une des options ci-dessous :

• location : peut être une chaîne de texte (comme Chagrin Falls, OH) ou une paire de coordonnées de latitude et de longitude séparées par une virgule (40.457375,-80.009353).

soit :

• pano : ID de panorama spécifique. Les ID des panoramas peuvent changer au fil du temps. Par conséquent, ne conservez pas cet ID. Enregistrez plutôt l'adresse de l'établissement ou les coordonnées de latitude et de longitude pour pouvoir actualiser l'ID de panorama. Pour en savoir plus, consultez Actualiser les ID de panoramas supprimés.

Ainsi que :

• key et signature : la clé API est requise pour authentifier la requête. La signature numérique est également requise dans certains cas et toujours recommandée. Pour en savoir plus, consultez Obtenir une clé et une signature.

Votre requête de métadonnées, avec uniquement les paramètres obligatoires, se présente comme suit :

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

ou comme ceci :

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

Actualiser les identifiants de panorama supprimés

Si vous essayez de récupérer un ID de panorama et que vous obtenez ZERO_RESULTS ou aucune valeur, cela signifie que l'ID de panorama a été supprimé et doit être actualisé.

1. Enregistrez l'adresse ou les coordonnées de latitude et de longitude que vous avez utilisées pour obtenir un ID de panorama. Vous pourrez ainsi actualiser le panorama si nécessaire.

2. Lorsque vous détectez qu'un ID de panorama a changé, utilisez l'adresse ou les coordonnées de latitude et de longitude d'origine pour rechercher à nouveau les panoramas les plus proches de cet emplacement et obtenir un nouvel ID de panorama.

Paramètres facultatifs pour les demandes de métadonnées

Vous pouvez inclure les paramètres suivants dans votre demande de métadonnées : size, heading, fov et pitch. Notez que ces paramètres n'ont aucune incidence sur les données concernant le panorama ni sur le panorama trouvé. L'API permet d'inclure les mêmes paramètres que la requête d'imagerie pour faciliter la création d'une requête de métadonnées liée à une requête d'imagerie spécifique. Toutefois, pour les requêtes de métadonnées, l'API ignore les paramètres facultatifs et leurs valeurs. Pour en savoir plus sur l'utilisation de ces paramètres, consultez le guide du développeur de l'API Street View Static.

Format de réponse

Les réponses aux requêtes de métadonnées sont fournies au format JSON uniquement.

Exemples

Exemple 1 : Panorama trouvé

Les URL suivantes demandent les métadonnées et l'image du même panorama.

Requête de métadonnées et réponse

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"
}

Demande et réponse concernant une image, lorsque l'image manquante est attendue.

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

Exemple 2 : Panorama introuvable

Les URL suivantes demandent les métadonnées et l'image d'un panorama qui n'a pas pu être trouvé à l'emplacement spécifié ou à proximité.

Requête et réponse de métadonnées

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"
}

Requête et réponse concernant les images

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

Codes d'état

Le champ status de l'objet de réponse des métadonnées contient l'état de la requête et peut contenir des informations de débogage pour vous aider à résoudre les problèmes liés à la requête Street View. Le champ status peut contenir les valeurs suivantes :

En savoir plus

Pour en savoir plus sur l'utilisation de l'API Street View Static ou d'autres produits de l'API Google Maps, consultez la page d'assistance de l'API Maps.