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. Les métadonnées vous permettent de savoir si une image Street View est disponible dans un lieu donné. Vous pouvez également obtenir un accès programmatique à la latitude et à la longitude, l'ID de panorama, la date de la prise de vue et les informations sur les droits d'auteur de l'image. L'accès à ces métadonnées vous permet de personnaliser le comportement d'erreur 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 envoyez des requêtes de métadonnées pour des images Street View, les images panoramiques sont exactes jusqu'à 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 pour toutes les URL, les différents paramètres sont séparés par une esperluette (&).

Paramètres obligatoires 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'image de l'API Street View Static, mais seuls les paramètres suivants sont obligatoires:

L'une des options ci-dessous :

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

soit :

• pano : ID de panorama spécifique. Elles sont généralement stables, bien que les panoramas puissent changer au fil du temps en fonction de l'actualisation des images.

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. Elle est toujours recommandée. Pour en savoir plus, consultez Obtenir une clé et une signature.

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

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

ou ceci:

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

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

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

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 correspondent à des requêtes de métadonnées et d'image réussies pour le 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"
}

Requête et réponse d'images, où 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 introuvable à cet emplacement ou à proximité.

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

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 d'image et réponse

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 aux métadonnées contient l'état de la requête et éventuellement des informations de débogage qui vous aident à résoudre les problèmes de fonctionnement de la requête Street View. Le champ status peut contenir les valeurs suivantes:

État	Description
"OK"	Indique qu'aucune erreur ne s'est produite ; un panorama a été trouvé et des métadonnées ont été renvoyées.
"ZERO_RESULTS"	Indique qu'aucun panorama n'a été trouvé à proximité du lieu spécifié. Cela peut se produire si un ID de panorama inexistant ou non valide est fourni.
"NOT_FOUND"	Indique que la chaîne d'adresse fournie dans le paramètre location est introuvable. Cela peut se produire si l'adresse fournie n'existe pas.
"OVER_QUERY_LIMIT"	Indique que vous avez dépassé votre quota quotidien ou votre quota par seconde pour cette API.
"REQUEST_DENIED"	Indique que votre requête a été rejetée. Cela peut se produire si vous n'avez pas autorisé votre requête, ou si l'API Street View Static n'est pas activée dans le projet de la console Google Cloud contenant votre clé API.
"INVALID_REQUEST"	Indique généralement que les paramètres de requête (adresse, latlng ou composants) sont manquants.
"UNKNOWN_ERROR"	Indique que la requête n'a pas pu être traitée en raison d'une erreur de serveur. Il s'agit bien souvent d'un état temporaire. Si vous essayez à nouveau, la requête pourrait aboutir.

Plus d'informations

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