Demande et réponse Street View

Une requête Street View Image 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 pour toutes 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 valeur lat/lng (40.457375,-80.009353). Elle doit être encodée en URL, afin que des adresses telles que "City Hall, New York, NY" doivent être converties en "City+Hall,New+York,NY" avant que la requête ne soit signée. L'API Street View Static s'ancre sur le panorama photographié le plus proche de ce lieu. Lorsqu'une chaîne de texte d'adresse est fournie, l'API peut utiliser un autre emplacement de l'appareil photo pour mieux afficher l'emplacement spécifié. Lorsqu'une valeur de latitude/longitude est fournie, l'API recherche la photo la plus proche de ce lieu dans un rayon de 50 mètres. Les images Street View sont régulièrement actualisées et les photos peuvent être prises dans des positions légèrement différentes à chaque fois. Il est donc possible que votre location prenne un panorama différent lorsque les images sont mises à jour.

soit :

• pano est un identifiant de panorama spécifique. Ceux-ci sont généralement stables.

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 400 de haut.
• key vous permet de surveiller l'utilisation de l'API de votre application dans la console Google Cloud et garantit que Google peut vous contacter à propos de votre application si nécessaire. Pour en savoir plus, consultez la page Obtenir une clé et une signature.

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 à le faire. Les requêtes n'incluant pas de signature numérique risquent d'échouer. Pour en savoir plus, consultez 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 l'orientation de la boussole de la caméra. Les valeurs acceptées sont comprises entre 0 et 360 (les deux valeurs indiquent le nord, 90 indique l'est et 180 sud). Si aucun cap n'est spécifié, une valeur est calculée afin de diriger l'appareil photo vers le location spécifié, à partir du point où la photo la plus proche a été prise.
• fov (la valeur par défaut est 90) détermine le champ de vision horizontal de l'image. Le champ de vision est exprimé en degrés, avec la valeur maximale autorisée de 120. 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 correspond essentiellement au zoom. Plus un nombre est faible, plus le niveau de zoom est élevé.

  
  
  (Gauche: fov=120 ; Droite: fov=20)

• pitch (par défaut : 0) spécifie 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). Une valeur négative oriente l'appareil photo vers le bas (-90 indiquant l'inclinaison maximale vers le bas).
• radius (par défaut est 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 la valeur est true, un message d'erreur est renvoyé à la place de l'image grise générique. Ainsi, il n'est pas nécessaire d'effectuer un appel distinct pour vérifier la disponibilité des images.
• source (la valeur par défaut est default) 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 en 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 renvoie uniquement les panoramas lorsqu'il est possible de déterminer s'ils sont en intérieur ou en extérieur. Par exemple, les photo-sphères ne sont pas renvoyées, car il est impossible de savoir si elles se trouvent en intérieur ou en 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ù 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 aucune image ici.", comme illustré dans l'exemple suivant:

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, procédez comme suit:

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