Requête et réponse Street View

Une requête d'image Street View est une URL HTTP au format suivant:

https://maps.googleapis.com/maps/api/streetview?parameters

L'image est spécifiée à l'aide des paramètres de la requête. Comme c'est la norme pour les URL, les différents paramètres sont séparés par une esperluette (&). Vous trouverez ci-dessous la liste des paramètres autorisés et leurs différentes valeurs possibles.

Paramètres 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 (40.457375,-80.009353). Elle doit être encodée en URL. Convertissez donc les adresses telles que "City Hall, New York, NY" en "City+Hall,New+York,NY" avant d'envoyer la requête. L'API Street View Static s'ancre au panorama photographié le plus proche de l'emplacement. Lorsque vous fournissez une chaîne de texte d'adresse, l'API peut utiliser un emplacement de caméra différent pour mieux afficher l'emplacement spécifié. Lorsque vous fournissez des coordonnées de latitude et de longitude, l'API recherche une photographie la plus proche de l'emplacement dans un rayon de 50 mètres. Étant donné que les images Street View sont régulièrement actualisées et que les photos peuvent être prises à des positions légèrement différentes à chaque fois, il est possible que votre location s'affiche sur un panorama différent lorsque les images sont mises à jour.

soit :

  • pano correspond à un 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 :

  • size spécifie la taille de sortie de l'image en pixels. La taille est spécifiée sous la forme {width}x{height}. Par exemple, size=600x400 renvoie une image de 600 x 400 pixels.
  • key vous permet de surveiller l'utilisation de l'API de votre application dans la console Google Cloud et de vous assurer que Google peut vous contacter au sujet de votre application si nécessaire. Pour en savoir plus, consultez Obtenir une clé et une 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é.

  1. 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.

  2. 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

  • signature (recommandé) est une signature numérique utilisée pour vérifier que tout site générant des requêtes à l'aide de votre clé API est autorisé à le faire. Les requêtes qui n'incluent pas de signature numérique peuvent échouer. Pour en savoir plus, consultez Obtenir une clé et une signature.

    Remarque:Pour les anciens clients du forfait Premium de Google Maps Platform, la signature numérique est obligatoire. En savoir plus sur les paramètres d'authentification pour les clients du forfait Premium

  • heading indique la direction prise par la boussole dans la vue de l'appareil photo. Les valeurs acceptées sont comprises entre 0 et 360 (les deux valeurs indiquant le nord, 90 indiquant l'est et 180 le sud). Si vous ne spécifiez pas de direction, une valeur est calculée de façon à diriger l'appareil photo vers l'location spécifié, selon l'angle de vue de la photo prise au plus près.
  • fov (valeur par défaut : 90) détermine le champ de vision horizontal de l'image, exprimé en degrés, avec une valeur maximale autorisée de 120. Lorsqu'il s'agit d'une fenêtre d'affichage de taille fixe, comme pour une image Street View de taille définie, le champ de vision représente essentiellement le zoom, les nombres plus petits indiquant un niveau de zoom plus élevé.


    Capture d'écran d'un champ de vision large, montrant le plafond, les murs, le sol et une fenêtre de réservoir dans un aquarium. Capture d'écran d'un champ de vision en gros plan, montrant les détails d'une photo Street View prise dans un aquarium.
    (Gauche: fov=120, Droite: fov=20)

  • pitch (par défaut : 0) indique l'angle d'inclinaison vers le haut ou vers le bas de l'appareil photo par rapport au véhicule Street View. Le plus souvent, il s'agit d'un angle plat, horizontal. Une valeur positive oriente l'appareil photo vers le haut (90 degrés indiquant l'inclinaison maximale vers le haut), tandis qu'une valeur négative oriente l'appareil photo vers le bas (-90 degrés indiquant l'inclinaison maximale vers le bas).90-90
  • radius (valeur par défaut : 50) définit un rayon, spécifié en mètres, dans lequel rechercher un panorama, centré sur la latitude et la longitude données. Les valeurs valides sont des entiers non négatifs.
  • return_error_code indique si l'API doit renvoyer un code d'erreur lorsqu'aucune image n'est trouvée (404 NOT FOUND) ou en réponse à une requête non valide (400 BAD REQUEST). Les valeurs valides sont true et false. Si ce champ est défini sur true, un message d'erreur est renvoyé à la place de l'image grise générique. Vous n'avez donc pas besoin d'effectuer un appel distinct pour vérifier la disponibilité des images.
  • source (valeur par défaut : default) limite les recherches Street View à des sources sélectionnées. Les valeurs valides sont les suivantes :
    • default utilise les sources par défaut pour Street View. Les recherches ne sont pas limitées à des sources spécifiques.
    • outdoor limite les recherches aux collections extérieures. Les collections intérieures ne sont pas incluses dans les résultats de recherche. Notez qu'il est possible que les panoramas extérieurs ne soient pas disponibles pour le lieu spécifié. Notez également que la recherche ne renvoie que des panoramas pour lesquels il est possible de déterminer s'ils sont intérieurs ou extérieurs. Par exemple, les PhotoSpheres ne sont pas renvoyées, car on ne sait pas si elles sont prises en intérieur ou en extérieur.

Voici un exemple de requête.

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=46.414382,10.013988&heading=151.78&pitch=-0.76&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
Capture d'écran d'une photo prise au niveau de la rue montrant des voies ferrées électrifiées.

Pas d'image disponible

Pour les lieux où les images Street View ne sont pas disponibles, l'API Street View Static renvoie une image générique grise, avec le texte "Désolé, nous n'avons aucune image ici", comme illustré dans cet exemple:

Capture d'écran de l'image générique affichée lorsqu'aucune image n'est disponible pour l'emplacement spécifié. L'arrière-plan est marron clair et affiche le texte "Désolé, aucune image n'est disponible pour cette zone."
Figure: Image générique affichée lorsqu'aucune image n'est disponible pour l'emplacement spécifié.

Afficher uniquement les images valides

Pour éviter d'afficher l'image générique et vous assurer que votre page Web n'affiche que des images valides de l'API Street View Static, suivez ces suggestions:

  • Définissez le paramètre return_error_code sur true. Si aucune image n'est disponible pour l'emplacement spécifié, l'API Street View Static renvoie une erreur 404 "NOT FOUND" à la place de l'image grise générique.
  • Demandez des métadonnées d'image Street View pour déterminer si des images sont disponibles pour l'emplacement spécifié avant d'envoyer une requête.