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 emplacement donné, et obtenir un accès programmatique aux coordonnées de latitude et de longitude, à l'ID du panorama, à la date de prise de vue de la photo 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 requêtes de métadonnées d'images Street View, les images panoramiques sont précises à 50 mètres près.
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 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, bien que seuls les paramètres suivants soient 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
: ID de panorama spécifique. Les panoramas peuvent changer d'ID au fil du temps. Par conséquent, ne conservez pas cet ID. Enregistrez plutôt l'adresse de l'emplacement ou les coordonnées de latitude et de longitude afin de pouvoir actualiser l'ID du panorama. Pour en savoir plus, consultez Actualiser les ID de panorama supprimés.
Ainsi que :
key
etsignature
: 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 la section Obtenir une clé et une signature.
Votre requête de métadonnées, qui ne contient que 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 ID 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 qu'il doit être actualisé.
Enregistrez l'adresse du lieu ou les coordonnées de latitude et de longitude que vous avez utilisées pour obtenir un ID de panorama afin de pouvoir l'actualiser si nécessaire.
Lorsque vous détectez qu'un ID de panorama a changé, utilisez l'adresse du lieu 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 ID de panorama.
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'ont aucune 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'images pour faciliter la création d'une requête de métadonnées liée à une requête d'images 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 permettent de demander 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 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 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 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
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 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 est détecté et 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 s'afficher si vous fournissez un ID de panorama inexistant ou non valide. Consultez [Actualiser les ID de panorama supprimés](#refresh-pano). |
"NOT_FOUND" |
Indique que la chaîne d'adresse fournie dans le paramètre location n'a pas pu être trouvée. Ce message peut s'afficher si vous indiquez une adresse inexistante. |
"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. 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 Google Cloud Console 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 du serveur. Ce problème est souvent temporaire. Si vous essayez à nouveau, la requête pourrait aboutir. |
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.