Cette page a été traduite par l'API Cloud Translation.

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 images Street View Affichez les panoramas. Grâce aux métadonnées, vous pouvez savoir si une image Street View est disponible dans une zone géographique donnée. Il offre aussi un accès par programmation la latitude et la longitude, l'identifiant du panorama, la date à laquelle la photo a été prise et les informations sur les droits d'auteur de l'image. Accès vous permettent de personnaliser le comportement des erreurs dans votre application.

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

Lorsque vous demandez des métadonnées d'images Street View, les images panoramiques avec une précision 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 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 mêmes paramètres d'URL que les demandes d'images de l'API Street View Static, même si seules 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 identifiants des panoramas peuvent changer au fil du temps. ne conservez pas cet ID. Enregistrez plutôt l'adresse du lieu ou latitude et longitude afin de pouvoir actualiser l'identifiant du panorama. Pour pour les détails, reportez-vous à la section Actualiser les identifiants de panorama supprimés.

Ainsi que :

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

Votre demande 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 ID de panorama supprimés

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

Enregistrez l'adresse ou les coordonnées de latitude et de longitude que vous aviez l'habitude d'utiliser. obtenir un identifiant de panorama afin de pouvoir l'actualiser si nécessaire.
Lorsque vous détectez qu'un identifiant de panorama a changé, utilisez l'emplacement d'origine. ou ses coordonnées géographiques (latitude et longitude) pour rechercher de panoramas vers ce lieu et d'obtenir un nouvel identifiant 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 les données relatives au panorama ou quel panorama est trouvé. L'API permet d'inclure les mêmes paramètres que demande d'image pour faciliter la création d'une demande de métadonnées liée à une image spécifique. mais 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 les 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 correctement les métadonnées et l'image du 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 qui est introuvable à l'emplacement spécifié 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"
}

Demande 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 de métadonnées contient l'état la requête et peut contenir des informations de débogage qui vous aideront à résoudre pourquoi la demande 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 est trouvé et les métadonnées renvoyé.
`"ZERO_RESULTS"`	Indique qu'aucun panorama n'a été trouvé à proximité du lieu spécifié. Cette réponse peut se produire si vous indiquez un identifiant de panorama inexistant ou non valide. Reportez-vous à la section [Actualiser les identifiants de panorama supprimés](#refresh-pano).
`"NOT_FOUND"`	Indique que la chaîne d'adresse fournie dans le `location` paramètre 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 avez n'autorisera pas votre demande, ou si le 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, les coordonnées (latitude et longitude, ou composants) sont manquantes.
`"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 aux autres produits de l'API Google Maps, consultez la documentation Page d'assistance.