Street View

Sélectionnez une plate-forme : Android iOS JavaScript

Street View de Google Maps vous permet d'explorer des lieux du monde entier grâce à des images à 360° au niveau de la rue. Vous pouvez explorer des sites célèbres du monde entier, découvrir des merveilles naturelles, suivre un itinéraire ou montrer l'extérieur de votre établissement.

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 consulter les zones couvertes sur une carte interactive, consultez la page À propos de Street View.

Le SDK Maps pour iOS fournit un service Street View pour obtenir et 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 le visionneuse Street View, un 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 (un tour complet) et une vue verticale à 180 degrés (de l'horizontale à la verticale). Le panorama à 360 degrés obtenu définit une projection sur une sphère, l'image étant enroulée sur la surface bidimensionnelle de cette sphère.

Les panoramas Street View sont visibles avec l'objet GMSPanoramaView. Cet objet fournit un lecteur qui rendra le panorama sous forme de sphère, avec une caméra au centre. Vous pouvez contrôler de manière programmatique l'orientation de la caméra, ainsi que plusieurs propriétés personnalisant le 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
ID unique d'un panorama Street View. Cette panoramaID peut changer au fil du temps et n'est pas adaptée comme référence à long terme ou codée en dur. panoramaID est particulièrement utile pour fournir un accès programmatique à différentes images Street View.
coordinate
Emplacement précis de cette image, exprimé en tant que CLLocationCoordinate2D. Utilisez un coordinate pour stocker de manière persistante un emplacement de panorama ou pour traduire les actions des utilisateurs sur la carte en image Street View.

Les panoramaID et coordinate sont tous deux stockés en tant que propriétés de l'objet GMSPanorama. Vous pouvez demander un GMSPanorama à partir du GMSPanoramaService à l'aide de coordinate ou panoramaID. L'objet obtenu inclura les deux éléments de métadonnées, ainsi qu'un tableau de liens vers les panoramas à proximité.

Définir la position géographique du panorama

La position du panorama Street View peut être définie en fonction des coordonnées.

  • La méthode moveNearCoordinate demande un panorama à proximité 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 limiter Street View à la recherche de panoramas situés à l'extérieur. Par défaut, les panoramas des lieux sont pris en intérieur ou en extérieur. Notez qu'il est possible qu'il n'existe pas de panoramas extérieurs pour l'emplacement 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 un lecteur Street View

Les principales étapes pour ajouter une visionneuse sont les suivantes :

  1. (Une fois) Suivez la procédure décrite dans la section Premiers pas pour obtenir le SDK, obtenir une clé et ajouter les frameworks requis.
  2. Créez ou mettez à jour un ViewController. Si le panorama s'affiche lorsque ce contrôleur de vue devient visible, veillez à le créer dans la méthode loadView.
  3. Créez et instanciez une classe GMSPanoramaView à l'aide de la méthode initWithFrame: GMSPanoramaView. Si cette vue doit être utilisée comme seule vue du contrôleur de vue, CGRectZero peut être utilisé comme cadre de la carte. La carte sera redimensionnée automatiquement.
  4. Définissez l'objet GMSPanoramaView comme vue du contrôleur de vue, par exemple self.view = panoView;.
  5. 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 l'aperçu

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 tous activés. Les gestes individuels sont contrôlés via les propriétés de GMSPanoramaView. Ces propriétés activent ou désactivent les gestes contrôlés par l'utilisateur. Les modifications programmatiques sont toujours possibles lorsque le geste est désactivé.

orientationGestures
Indique si l'utilisateur peut réorienter l'appareil photo en appuyant ou en faisant glisser l'écran. Définissez la valeur sur NO pour désactiver les changements d'orientation de la caméra.
zoomGestures
Indique si l'utilisateur peut faire un pincement pour zoomer. Définissez cette valeur sur NO pour désactiver le zoom.
navigationGestures
Indique si l'utilisateur peut choisir le panorama à afficher. Les utilisateurs peuvent appuyer une seule fois sur les liens de navigation ou appuyer deux fois sur la vue pour changer de panorama. Définissez la valeur sur NO pour désactiver les modifications de navigation.

Vous pouvez activer ou désactiver tous les gestes en même temps 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 disponibles dans 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 qui lance Street View. Pour en savoir plus, consultez la documentation sur le schéma d'URL.

comgooglemaps://?center=46.414382,10.013988&mapmode=streetview

Emplacements Street View et points de vue

GMSPanoramaCamera vous permet de définir le point de vue de la caméra Street View en combinant l'orientation, 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];

Orientation

L'emplacement Street View définit l'emplacement du point de focalisation de la caméra pour une image, mais pas l'orientation de la caméra pour cette image. À cette fin, l'objet GMSOrientation définit deux propriétés:

  • heading définit l'angle de rotation autour du lieu de la caméra en degrés par rapport au nord géographique. Les directions sont mesurées dans le sens des aiguilles d'une montre : le nord géographique est à 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 le "bas" à partir de l'inclinaison par défaut initiale de l'appareil photo, qui correspond généralement (mais pas toujours) à un angle horizontal plat. (Par exemple, une image prise sur une colline présentera probablement un angle par défaut qui n'est pas horizontal.) Les angles d'inclinaison sont mesurés avec des valeurs positives vers le haut (jusqu'à +90 degrés vers le haut et orthogonales à l'inclinaison par défaut) et des valeurs négatives vers le bas (jusqu'à -90 degrés vers le bas et orthogonales à 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 de manière programmatique, ou les utilisateurs peuvent modifier le niveau dans le visualiseur en pinçant pour faire un zoom.

Déplacer la caméra

Une fois que vous avez créé le GMSPanoramaView et qu'il dispose d'une caméra configurée ou par défaut, vous pouvez le modifier de plusieurs façons. Lorsque vous changez de caméra, vous pouvez animer le mouvement de la caméra qui en résulte. L'animation effectue une interpolation entre les attributs de la caméra actuelle et les nouveaux attributs de la caméra.

Vous pouvez modifier l'objet GMSPanoramaCamera et le définir sur la propriété camera de GMSPanoramaView. La caméra se fixe alors sur le nouveau point de vue sans animation. Vous pouvez créer un GMSCameraPosition pour configurer n'importe quelle 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. Cela est 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 ses 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 varie en fonction de la distance entre la position du repère et l'emplacement de GMSCameraView. Si cette distance devient trop importante, le repère devient trop petit pour s'afficher et est 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 les événements qui se produisent sur le panorama Street View, par exemple lorsqu'un utilisateur appuie dessus. Pour écouter des événements, vous devez implémenter le protocole GMSPanoramaViewDelegate. Consultez le guide des événements et la liste des méthodes sur GMSPanoramaViewDelegate.