Introduction
L'API Google Street View Image vous permet d'insérer un panoramique Street View statique (non interactif) dans vos pages web. La zone à afficher est définie à partir des paramètres contenus dans une URL. Cette URL insérée dans l'attribut src="votre_URL_ici" d'une balise <img/> est ensuite envoyée au moyen d'une requête HTTP standard aux serveurs de Google. En retour, vous obtenez une Street View sous la forme d'une image statique.
Exemple : insértion d'une image statique 'Street View' correspondant à la sortie du pont Wilson à Tours.
Voici l'URL :
http://maps.googleapis.com/maps/api/streetview?size=600x300&location=47.397187,0.686066&fov=180&heading=235&pitch=0&sensor=false
Il ne reste plus qu'a l'insérer dans une balise <img/> et à ajouter les attributs width height et alt :
<img src="http://maps.googleapis.com/maps/api/streetview?size=600x300&location=47.397187,0.686066&fov=90&heading=180&pitch=0&sensor=false width="600" height="300" alt="Image Street View à Tours" />
Et voici le résultat :
Les conditions d'utilisation
Nombre de requêtes image Street View autorisées
L'utilisation de l'API Google Street View Image est soumise à une limite de 1.000 requêtes image différentes par visiteur et par jour. Cette restriction étant un quota par visiteur, la plupart des développeurs n'auront pas à se soucier du quota. Notez que Google applique également une limite supplémentaire sur le taux de requêtes pour prévenir les abus de service. En général, les demandes d'images identiques, ne sont pas décomptées du quota au-delà de la requête initiale.
Si un utilisateur venait à dépasser le quota imposé, l'image ci-dessous s'afficherait pour indiquer que la limite a été dépassé :
Cette limite, appliquée pour empêcher les abus et/ou la réutilisation de l'API Street View Image, pourra être modifiée dans l'avenir sans préavis. Si, dans un délai de 24 heures vous dépassez la limite fixée ou abusez du service, l'API Street View Image pourra cesser de fonctionner temporairement pour vous. Si vous continuez à outrepasser cette limite, votre accès à l'API Street View Image pourra être bloqué.
Les clients de l'API Google Maps Premier sont exemptés des quotas indiqués ci-dessus. Les requêtes via l'API Google Maps Premier doivent être signées.
Taille maxi des images Street View
Les images statiques de Street View peuvent être affichées dans n'importe quelle taille jusqu'à 640 X 640 pixels.
Les clients de l'API Google Maps Premier ayant correctement signé leur URL peuvent demander des images dont la taille maximale est 2.048 X 2.048 pixels.
Paramètres dans l'URL
La requête utilisée pour obtenir une Image Street View doit respecter la forme suivante :
http://maps.googleapis.com/maps/api/streetview?vos_parametres_ici
L'image est spécifiée grâce aux paramètres insérés dans la requête. Conformément au standard s'appliquant aux URLs, tous les paramètres sont séparés à l'aide du caractère esperluette (&). Les paramètres autorisés et leurs valeurs possibles sont énumérés dans le tableau ci-dessous :
| Liste des paramètres utilisables dans l'URL | ||
|---|---|---|
| Nom | Utilisation | Description |
size | obligatoire | Spécifie la taille de sortie de l'image. La taille est indiquée ainsi {largeur}x{hauteur} - par exemple, size=600x300 retourne une image large de 600 pixels, et haute de 300 px. |
location | obligatoire | Il peut s'agir de texte (ex : Tours, FR) ou de coordonnées GPS ( Latitude,Longitude - ex : 47.39028,0.688818). L'API Street View Image va s'aligner sur le panoramique photographié le plus proche de ce point.Note: l'imagerie Street View étant régulièrement actualisée, et les photographies pouvant être prises à partir de positions légérement différentes d'une fois à l'autre, il est possible que votre emplacement location puisse s'aligner sur une vue panoramique différente une fois l'imagerie mise à jour. |
heading | facultatif | Indique la position de la caméra par rapport au Nord vrai. Les valeurs acceptées vont de 0 à 360 (ces deux valeurs indiquent le Nord, 90 indique l'Est, et 180 le Sud). Si aucun cap n'est spécifié, une valeur sera alors calculée afin de diriger la caméra vers l'emplacement location indiqué, depuis le point auquel la photo la plus proche a été prise. |
fov | facultatif | Par défaut 90. Maximum autorisé 120. Ce champ représente un niveau de zoom (les valeurs faibles représentant des niveaux de zoom élevés).
|
pitch | facultatif | Par défaut 0. Il specifie l'angle vers le haut ou le bas de la caméra par rapport au véhicule Street View. La plupart du temps il s'agit de l'horizontale. Lorsque la caméra regarde vers le haut la valeur est positive (90 désigne le ciel) et lorsqu'elle regarde vers le bas elle est négative (-90 désigne le centre de la terre). |
sensor | obligatoire | Indique si la requête provient d'un appareil doté d'un système de localiation (ex : un GPS) pour déterminer l'emplacement d'où vient cette requête. Cettre valeur doit être true or false. |