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 les URL, tous les 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 au format URL. Alors convertissez telles que "City Hall, New York, NY", par "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 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 indiquez 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. Les images Street View sont actualisées régulièrement et les photos peuvent être prises à des positions légèrement différentes à chaque fois, il est possible que votrelocation
peut s'aligner sur un panorama différent lorsque les images sont mises à jour.
soit :
pano
est un identifiant de panorama spécifique. Les panoramas pouvant changer d'identifiant 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 :
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 le console Google Cloud, et permet à Google de vous contacter à propos 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 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
signature
(recommandé) est une signature numérique utilisée pour vérifier que tous les sites qui génèrent des requêtes à l'aide de votre clé API sont autorisés pour ce 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, le code numérique signature est obligatoire. En savoir plus sur paramètres d'authentification Clients du forfait Premium
heading
indique la direction de la boussole la caméra. Les valeurs acceptées sont comprises entre0
et360
. (les deux valeurs indiquent le nord,90
indiquant l'est et180
Sud). Si vous ne spécifiez pas d'en-tête, une valeur est oriente l'appareil photo vers la valeurlocation
, à partir du point auquel la photo la plus proche était prises.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 dans le cas d'une image Street View d'une taille définie. Le champ de vision représente essentiellement le zoom, avec des nombres plus faibles. indiquant un niveau de zoom plus élevé.
(Gauche:fov=120
; Droite:fov=20
)pitch
(la valeur par défaut est0
) spécifie l'angle haut ou bas de l'appareil photo par rapport à Street View. véhicule. Le plus souvent, il s'agit d'un angle plat, horizontal. Valeurs positives orienter l'appareil photo vers le haut (90
degrés indiquant une inclinaison vers le haut) ; des valeurs négatives orientent l'appareil photo vers le bas (-90
indiquant que vers le bas).radius
(la valeur par défaut est50
) définit un rayon, spécifié en mètres, dans lequel rechercher un panorama, centrée sur la latitude et la longitude données. Les valeurs valides ne sont pas négatives entiers.return_error_code
indique si l'API doit renvoyer un code d'erreur lorsqu'aucune image n'est trouvée (404 INTROUVABLE) ou en réponse à une requête non valide (400 BAD REQUEST). Les valeurs valides sonttrue
etfalse
S'il est défini surtrue
, un message d'erreur est affiché à la place de l'image grise générique. Il n'est donc plus nécessaire effectuez un appel distinct pour vérifier la disponibilité des images.source
(la valeur par défaut estdefault
) limite les recherches Street View aux sources sélectionnées. Les valeurs possibles sont les suivantes: <ph type="x-smartling-placeholder">- </ph>
default
utilise les sources par défaut pour Street View. les recherches ne se limitent pas à des sources spécifiques.outdoor
limite les recherches aux collections extérieures. Intérieur les collections 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 l'emplacement spécifié. Notez également que la recherche ne renvoie que des panoramas. lorsqu'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 si elles 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 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 l'exemple suivant:
<ph type="x-smartling-placeholder">Afficher uniquement les images valides
Pour éviter d'afficher l'image générique, assurez-vous que votre page Web n'affiche que des images valides de l'API Street View Static. suggestions:
- Définissez le paramètre
return_error_code
surtrue
. L'API Street View Static renvoie alors un code d'erreur 404 INTROUVABLE au lieu de l'image générique en gris, si aucune image n'est disponible pour à l'emplacement spécifié. - Demander des métadonnées d'image Street View pour déterminer si des images sont disponibles pour le lieu spécifié avant le à l'envoi d'une demande.