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 pour un lieu donné, et obtenir un accès programmatique à la latitude et à la longitude, l'ID de panorama, la date de la photo 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 d'images Street View, la précision des images panoramiques est de 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, 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'image 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/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 d'ID au fil du temps lorsque les images sont actualisées.
Ainsi que :
key
etsignature
: la clé API est requise pour authentifier la requête. La signature numérique est également obligatoire 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 requis, se présentera comme suit:
https://maps.googleapis.com/maps/api/streetview/metadata?location=<STRING>&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>
ou comme suit:
https://maps.googleapis.com/maps/api/streetview/metadata?pano=<STRING>&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>
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 concernant le 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 requête de métadonnées liée à une requête d'images spécifique. Cependant, 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 en savoir plus sur l'utilisation de 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 détecté
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 d'image et réponse, 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 à l'emplacement spécifié ou à proximité de celui-ci.
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 peuvent vous aider à comprendre pourquoi la requête Street View ne fonctionne pas. 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 l'ID de panorama fourni n'existe pas ou n'est pas valide. |
"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 qu'il manque des paramètres de requête (adresse, coordonnées latlng ou composants). |
"UNKNOWN_ERROR" |
Indique que la requête n'a pas pu être traitée en raison d'une erreur de serveur. Il s'agit souvent d'un état temporaire. Si vous essayez à nouveau, la requête pourrait aboutir. |
En savoir plus
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.