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
) et doit être encodée en URL. Convertissez donc des 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'aligne sur la photo panoramique la plus proche du lieu. Lorsque vous fournissez une chaîne de texte d'adresse, l'API peut utiliser un autre emplacement de caméra pour mieux afficher le lieu spécifié. Lorsque vous fournissez des coordonnées de latitude et de longitude, l'API recherche la photo la plus proche du lieu 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 votrelocation
s'aligne sur un panorama différent lors de la mise à jour des images.
soit :
pano
est un identifiant de panorama spécifique. Les identifiants des panoramas pouvant changer au fil du temps, ne conservez pas cet identifiant. Enregistrez plutôt l'adresse du lieu ou les coordonnées de latitude et de longitude afin de pouvoir actualiser l'identifiant du panorama. Pour en savoir plus, reportez-vous à la section 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 en tant que{width}x{height}
. Par exemple,size=600x400
renvoie une image de 600 pixels de large et de 400 pixels de haut.key
vous permet de surveiller l'utilisation des 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 la page Obtenir une clé et une 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 de panorama a été supprimé et 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 identifiant de panorama afin de pouvoir l'actualiser si nécessaire.
Lorsque vous détectez qu'un identifiant de panorama a changé, utilisez l'adresse ou les coordonnées de latitude et de longitude du lieu d'origine pour rechercher à nouveau les panoramas les plus proches de ce lieu et obtenir un nouvel identifiant de panorama.
Paramètres facultatifs
signature
(recommandé) est une signature numérique qui permet de vérifier que tous les sites qui génèrent des requêtes à l'aide de votre clé API sont autorisés à le faire. Les requêtes qui n'incluent pas de signature numérique peuvent échouer. Pour en savoir plus, consultez la page Obtenir une clé et une signature.Remarque:Pour les anciens clients du forfait Premium Google Maps Platform, la signature numérique est obligatoire. Obtenez plus d'informations sur les paramètres d'authentification pour les clients du forfait Premium.
heading
indique la direction de la boussole de la caméra. Les valeurs acceptées sont comprises entre0
et360
(les deux valeurs indiquant le nord,90
indiquant l'est et180
le sud). Si vous ne spécifiez pas de cap, une valeur est calculée qui dirige l'appareil photo vers la valeurlocation
spécifiée, à partir du point où la photo la plus proche a été prise.fov
(la valeur par défaut est90
) détermine le champ de vision horizontal de l'image, exprimé en degrés, avec une valeur maximale autorisée de120
. Dans le cas d'une fenêtre d'affichage de taille fixe, comme pour une image Street View d'une taille définie, le champ de vision représente essentiellement le zoom. Plus les valeurs sont faibles, plus le niveau de zoom est élevé.
(Gauche:fov=120
; Droite:fov=20
)pitch
(par défaut :0
) spécifie l'angle supérieur ou inférieur de l'appareil photo par rapport au véhicule Street View. Le plus souvent, il s'agit d'un angle plat, horizontal. Les valeurs positives orientent l'appareil photo vers le haut (90
degrés indiquant l'inclinaison maximale vers le haut) ; les valeurs négatives orientent l'appareil photo vers le bas (-90
indique l'inclinaison maximale vers le bas).radius
(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 sonttrue
etfalse
. Si la valeur esttrue
, un message d'erreur est renvoyé à la place de l'image générique en gris. Il n'est donc pas nécessaire d'effectuer un appel distinct pour vérifier la disponibilité des images.source
(par défautdefault
) limite les recherches Street View aux sources sélectionnées. Les valeurs possibles 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 d'intérieur 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 les panoramas s'il est possible de déterminer s'ils se trouvent à l'intérieur ou à l'extérieur. Par exemple, les photo-sphères ne sont pas renvoyées, car il est impossible de savoir s'ils se trouvent à l'intérieur ou à l'extérieur.
Ceci est 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
Pas d'image disponible
Pour les zones géographiques où aucune image Street View n'est disponible, l'API Street View Static renvoie une image générique grise avec le texte "Désolé, nous n'avons pas d'images ici", comme illustré dans cet exemple:
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
surtrue
. Si aucune image n'est disponible pour le lieu spécifié, l'API Street View Static renvoie alors une erreur 404 NOT FOUND (non trouvé) à la place de l'image grise générique. - Avant d'envoyer une requête, demandez des métadonnées d'image Street View afin de déterminer si des images sont disponibles pour le lieu spécifié.