Google Maps Street View vous permet d'explorer les sites du monde entier en profitant d'images à 360 degrés des rues. Vous pouvez explorer des monuments du monde entier, admirer des merveilles de la nature, suivre un voyage ou montrer l'extérieur de votre entreprise.
Présentation
Google Street View offre des vues panoramiques à 360 degrés à partir des routes sélectionnées dans sa zone de couverture. La couverture disponible via le SDK est la même que celle de l'application Google Maps pour iOS ou de https://maps.google.com/
. Pour en savoir plus sur Street View et voir les zones prises en charge sur une carte interactive, consultez la page À propos de Street View.
Le SDK Maps pour iOS fournit un service Street View permettant d'obtenir et de manipuler les images utilisées dans Google Maps Street View.
Les images Street View sont renvoyées sous forme de panoramas et sont affichées dans la visionneuse Street View (objet de type GMSPanoramaView
).
Panoramas Street View
Chaque panorama Street View est une image, ou une série d'images, représentant une vue complète à 360 degrés d'un même lieu. Les images sont conformes à la projection équirectangulaire (Plate Carrée), qui contient une vue horizontale à 360 degrés (tour d'horizon complet) et une vue verticale à 180 degrés (du zénith au nadir). Le panorama à 360 degrés ainsi obtenu définit une projection sur une sphère, l'image recouvrant la surface à deux dimensions de cette sphère.
Les panoramas Street View peuvent être affichés avec l'objet GMSPanoramaView
. Cet objet fournit une visionneuse qui affiche le panorama sous forme de sphère avec un appareil photo en son centre. Vous pouvez contrôler l'orientation de la caméra par programmation, ainsi que plusieurs propriétés de personnalisation de la visionneuse.
Accéder aux données Street View
Les panoramas Street View sont identifiés par l'un des deux éléments de métadonnées suivants :
panoramaID
- Identifiant unique d'un panorama Street View. Cette
panoramaID
est susceptible de changer au fil du temps et n'est pas adaptée comme référence à long terme ni codée en dur. L'optionpanoramaID
est idéale pour fournir un accès programmatique aux différentes images Street View. coordinate
- Emplacement précis de cette image, exprimé sous la forme
CLLocationCoordinate2D
. Utilisez uncoordinate
pour stocker de façon persistante un emplacement de panorama, ou pour traduire les actions de l'utilisateur sur la carte en une image Street View.
panoramaID
et coordinate
sont tous deux stockés en tant que propriétés de l'objet GMSPanorama
. Vous pouvez demander un GMSPanorama
à partir de GMSPanoramaService
à l'aide de coordinate
ou de panoramaID
. L'objet résultant inclura les deux métadonnées, ainsi qu'un tableau de liens vers les panoramas à proximité.
Définition de la position d'un panorama
L'emplacement du panorama Street View peut être défini en fonction des coordonnées.
La méthode
moveNearCoordinate
demande un panorama proche de la coordonnée.La méthode
moveNearCoordinate:radius
est similaire, mais vous permet de spécifier un rayon de recherche, en mètres, autour de la coordonnée.La méthode
moveNearCoordinate:source
vous permet de spécifier une source. Une source est utile si vous souhaitez que Street View ne recherche que des panoramas extérieurs. Par défaut, les panoramas des lieux se trouvent à l'intérieur ou à l'extérieur. Notez qu'il est possible que les panoramas extérieurs ne soient pas disponibles pour le lieu spécifié.La méthode
moveNearCoordinate:radius:source
vous permet de spécifier à la fois un rayon et une source.
Afficher des images Street View
Ajouter une visionneuse Street View
Les principales étapes pour ajouter une visionneuse sont les suivantes :
- (Une fois) Suivez les étapes de la section Premiers pas pour obtenir le SDK, obtenir une clé et ajouter les frameworks requis.
- Créez ou mettez à jour un
ViewController
. Si le panorama est affiché lorsque ce contrôleur de vue devient visible, veillez à le créer dans la méthodeloadView
. - Créez et instanciez une classe
GMSPanoramaView
à l'aide de la méthodeGMSPanoramaView
initWithFrame:
. S'il doit être utilisé comme seule vue du contrôleur de vue, vous pouvez utiliserCGRectZero
comme cadre de la carte. Celle-ci sera redimensionnée automatiquement. - Définissez l'objet
GMSPanoramaView
comme vue du contrôleur de vue, par exempleself.view = panoView;
. - Définissez l'emplacement de l'image Street View à l'aide d'une méthode telle que
moveNearCoordinate:
.
Dans l'exemple ci-dessous, une visionneuse Street View est ajoutée à une application.
Swift
import GoogleMaps class StreetView: UIViewController { override func loadView() { let panoView = GMSPanoramaView(frame: .zero) self.view = panoView panoView.moveNearCoordinate(CLLocationCoordinate2D(latitude: -33.732, longitude: 150.312)) } }
Objective-C
#import "StreetView.h" @import GoogleMaps; @interface StreetView () @end @implementation StreetView - (void)loadView { GMSPanoramaView *panoView = [[GMSPanoramaView alloc] initWithFrame:CGRectZero]; self.view = panoView; [panoView moveNearCoordinate:CLLocationCoordinate2DMake(-33.732, 150.312)]; } @end
Personnaliser la visionneuse
Vous pouvez personnaliser la visionneuse en limitant les gestes disponibles. Par défaut, le panoramique, le zoom et l'accès aux panoramas adjacents sont activés.
Les gestes individuels sont contrôlés par les propriétés de GMSPanoramaView
.
Ces propriétés activent ou désactivent les gestes contrôlés par l'utilisateur. Des modifications programmatiques sont toujours possibles lorsque le geste est désactivé.
orientationGestures
- Indique si l'utilisateur peut réorienter la caméra en appuyant dessus ou en la faisant glisser. Définissez la valeur sur
NO
pour désactiver les changements d'orientation de la caméra. zoomGestures
- Indique si l'utilisateur peut pincer pour zoomer. Définissez la valeur sur
NO
pour désactiver le zoom. navigationGestures
- Indique si l'utilisateur peut modifier le panorama visible. Les utilisateurs peuvent appuyer une fois sur les liens de navigation ou appuyer deux fois sur la vue pour définir les panoramas sur
NO
et désactiver les modifications de la navigation.
Vous pouvez activer ou désactiver tous les gestes à la fois avec la méthode setAllGesturesEnabled:
.
Swift
panoView.setAllGesturesEnabled(false)
Objective-C
[panoView setAllGesturesEnabled:NO];
Lancer Street View avec le schéma d'URL
Les images Google Street View sont visibles depuis l'application Google Maps pour iOS. Vous pouvez lancer l'application Google Maps pour iOS en mode Street View avec le schéma d'URL comgooglemaps
en définissant le paramètre mapmode
sur streetview
. Vous trouverez ci-dessous un exemple d'URL permettant de lancer Street View. Pour en savoir plus, consultez la documentation sur les schémas d'URL.
comgooglemaps://?center=46.414382,10.013988&mapmode=streetview
Lieux Street View et point de vue
GMSPanoramaCamera
vous permet de définir le point de vue de la caméra Street View en combinant la direction, l'inclinaison et le zoom.
Le fragment ci-dessous oriente l'appareil photo vers le sud et légèrement vers le bas.
Swift
panoView.camera = GMSPanoramaCamera(heading: 180, pitch: -10, zoom: 1)
Objective-C
panoView.camera = [GMSPanoramaCamera cameraWithHeading:180 pitch:-10 zoom:1];
Intégration
Le lieu Street View définit la position de l'appareil photo pour une image, mais pas son orientation pour cette image.
À cette fin, l'objet GMSOrientation
définit deux propriétés:
heading
définit l'angle de rotation en degrés autour de l'emplacement de la caméra par rapport au nord géographique. Les caps sont mesurés dans le sens des aiguilles d'une montre : le nord géographique à 0, l'est à 90, le sud à 180 et l'ouest à 270.pitch
(0
par défaut) définit l'écart de l'angle "vers le haut" ou "vers le bas" à partir de l'inclinaison par défaut initiale de la caméra, qui est souvent (mais pas toujours) horizontale plane. Par exemple, une image prise sur une colline présentera probablement une inclinaison par défaut qui n'est pas horizontale. Les angles d'inclinaison sont mesurés avec des valeurs positives orientées vers le haut (jusqu'à +90 degrés vers le haut et perpendiculaires à l'inclinaison par défaut) et des valeurs négatives orientées vers le bas (jusqu'à -90 degrés à droite et perpendiculaire à l'inclinaison par défaut).
Zoom
Street View prend en charge différents niveaux de détails des images via l'utilisation du zoom. Vous pouvez définir le niveau de zoom par programmation, ou les utilisateurs peuvent le modifier dans la visionneuse en pinçant pour zoomer.
Déplacer la caméra
Une fois que vous avez créé la GMSPanoramaView
et qu'elle dispose d'une caméra configurée ou par défaut, vous pouvez la modifier de plusieurs manières. Lorsque vous modifiez la caméra, vous avez la possibilité d'animer le mouvement de caméra qui en résulte. L'animation effectue une interpolation entre les attributs de caméra actuels et les nouveaux attributs.
Vous pouvez modifier l'objet GMSPanoramaCamera
et le définir sur la propriété camera
de GMSPanoramaView
. La caméra sera ancrée au nouveau point de vue sans animation. Un GMSCameraPosition
peut être créé pour configurer toute combinaison d'orientation et de zoom.
Swift
panoView.camera = GMSPanoramaCamera(heading: 180, pitch: -10, zoom: 1)
Objective-C
panoView.camera = [GMSPanoramaCamera cameraWithHeading:180 pitch:-10 zoom:1];
Vous pouvez animer une transition en appelant la méthode animateToCamera:animationDuration:
de GMSPanoramaView
.
Vous pouvez également contrôler l'appareil photo à l'aide de Core Animation. Disponible via le CALayer
personnalisé sur GMSPanoramaView
, GMSPanoramaLayer
.
Repères dans Street View
L'objet GMSPanoramaView
peut afficher des repères sur la carte. Vous pouvez utiliser le même objet GMSMarker
sur un objet GMSMapView
ou GMSPanoramaView
en définissant les propriétés correspondantes:
Swift
// Create a marker at the Eiffel Tower let position = CLLocationCoordinate2D(latitude: 48.858, longitude: 2.294) let marker = GMSMarker(position: position) // Add the marker to a GMSPanoramaView object named panoView marker.panoramaView = panoView // Add the marker to a GMSMapView object named mapView marker.map = mapView
Objective-C
// Create a marker at the Eiffel Tower CLLocationCoordinate2D position = CLLocationCoordinate2DMake(48.858,2.294); GMSMarker *marker = [GMSMarker markerWithPosition:position]; // Add the marker to a GMSPanoramaView object named panoView marker.panoramaView = panoView; // Add the marker to a GMSMapView object named mapView marker.map = mapView;
La taille des repères est mise à l'échelle en fonction de la distance entre leur position et l'emplacement de GMSCameraView
. Si cette distance devient trop grande, le repère deviendra trop petit pour être affiché et sera masqué.
Définissez la propriété panoramaView
sur nil
pour la supprimer de GMSPanoramaView
.
Swift
marker.panoramaView = nil
Objective-C
marker.panoramaView = nil;
Événements
Vous pouvez écouter des événements qui se produisent sur le panorama Street View, par exemple lorsqu'un utilisateur appuie sur le panorama. Pour écouter des événements, vous devez implémenter le protocole GMSPanoramaViewDelegate
. Consultez le guide général des événements et la liste des méthodes sur GMSPanoramaViewDelegate
.