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 pour un lieu donné et d'obtenir un accès programmatique aux coordonnées de latitude et de longitude, à l'identifiant de panorama, à la date de prise de vue et aux 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.

Remarque : La valeur du champ de date peut varier :

• Le niveau de précision du champ de date peut varier en fonction des panoramas. Par exemple, pour certains panoramas, le champ de date contient une année et un mois, tandis que pour d'autres, il ne contient que l'année.
• Le champ date est omis si aucune donnée n'est disponible.

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 utilisé 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

Remarque: Le protocole https:// est obligatoire pour les requêtes de métadonnées.

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

Paramètres obligatoires pour les requêtes 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. 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 et de longitude séparées par une virgule (40.457375,-80.009353).

soit :

• pano : identifiant de panorama spécifique. Les panoramas peuvent changer d'identifiant au fil du temps. Par conséquent, ne conservez pas cet identifiant. À la place, enregistrez l'adresse du lieu ou les coordonnées de latitude et de longitude afin d'actualiser l'identifiant du panorama. Pour en savoir plus, consultez Actualiser des identifiants de panorama 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=

ou comme ceci:

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

Actualiser les identifiants des panoramas supprimés

Si vous essayez de récupérer un identifiant de panorama et d'obtenir ZERO_RESULTS ou aucune valeur, l'identifiant de panorama a été supprimé et doit être actualisé.

1. Enregistrez l'adresse de l'emplacement ou les coordonnées de latitude et de longitude que vous avez utilisées pour obtenir un identifiant de panorama afin de pouvoir actualiser la page si nécessaire.

2. Lorsque vous détectez qu'un identifiant de panorama a été modifié, utilisez l'adresse de localisation d'origine ou les coordonnées de latitude et de longitude pour rechercher à nouveau les panoramas les plus proches de ce lieu et obtenir un nouvel identifiant de panorama.

Remarque :Étant donné que les images Street View sont régulièrement actualisées et que les photographies peuvent être prises à des positions légèrement différentes à chaque fois, un ID de panorama donné peut correspondre à un panorama différent lorsque les images ou l'ID de panorama sont mis à jour.

Paramètres facultatifs pour les requêtes 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'influencent pas les données relatives au panorama, ni le panorama trouvé. L'API permet d'inclure les mêmes paramètres que la requête d'images afin de faciliter la création d'une requête de métadonnées liée à une requête d'images spécifique. Toutefois, pour ce type de requête, elle ignore les paramètres facultatifs et leurs valeurs. Pour plus d'informations 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 bien 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"
}

Requête d'images et réponse, alors que 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

Les exemples ne sont peut-être pas disponibles dans votre région.

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é pour le lieu spécifié ou à proximité.

Demande 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 d'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

Les exemples ne sont peut-être pas disponibles dans votre région.

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 le problème lié à la requête Street View. Le champ status peut contenir les valeurs suivantes:

État	Description
"OK"	Indique qu'aucune erreur ne s'est produite, qu'un panorama a été trouvé et que des métadonnées sont renvoyées.
"ZERO_RESULTS"	Indique qu'aucun panorama n'a été trouvé à proximité du lieu spécifié. Cette réponse peut se produire si vous fournissez un identifiant de panorama inexistant ou non valide. Reportez-vous à la section [Actualiser les identifiants des panoramas supprimés](#refresh-pano).
"NOT_FOUND"	Indique que la chaîne d'adresse fournie dans le paramètre location est introuvable. Ce message peut s'afficher si une adresse inexistante est fournie.
"OVER_QUERY_LIMIT"	Indique que vous avez dépassé votre quota quotidien ou par seconde pour cette API.
"REQUEST_DENIED"	Indique que votre requête a été rejetée. Ce message peut s'afficher 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, coordonnées de latitude et de longitude, 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. Ce problème est souvent temporaire. Si vous essayez à nouveau, la requête pourrait aboutir.

Plus d'informations

Pour plus d'informations 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 Google Maps.