Il s'agit de la classe principale de la fonctionnalité Street View du SDK Google Maps pour Android. C'est également le point d'entrée de toutes les méthodes liées aux panoramas Street View. Vous ne pouvez pas instancier directement un objet StreetViewPanorama
. Vous devez en obtenir un à partir de la méthode #getStreetViewPanoramaAsync()
sur un StreetViewPanoramaFragment
ou un StreetViewPanoramaView
que vous avez ajouté à votre application.
Remarque: Comme pour un objet View
, un StreetViewPanorama
ne peut être lu et modifié qu'à partir du thread principal. L'appel de méthodes StreetViewPanorama
à partir d'un autre thread entraînera une exception.
Guide du développeur
Pour commencer à utiliser le SDK Google Maps pour Android, consultez le guide du développeur SDK Google Maps pour Android .
Récapitulatif des classes imbriquées
interface | StreetViewPanorama.OnStreetViewPanoramaCameraChangeListener | Écouteur des changements de StreetViewPanoramaCamera | |
interface | StreetViewPanorama.OnStreetViewPanoramaChangeListener | Écouteur du moment où le panorama Street View charge un nouveau panorama. | |
interface | StreetViewPanorama.OnStreetViewPanoramaClickListener | Interface de rappel utilisée lorsque l'utilisateur appuie sur le panorama. | |
interface | StreetViewPanorama.OnStreetViewPanoramaLongClickListener | Interface de rappel utilisée lorsque l'utilisateur appuie de manière prolongée sur le panorama. |
Récapitulatif des méthodes publiques
void |
animateTo(caméra StreetViewPanoramaCamera, longue durée)
Modifie la position, l'orientation et le zoom actuels de la caméra sur une position donnée pendant une durée spécifiée
|
StreetViewPanoramaLocation |
getLocation()
Renvoie la position actuelle de l'utilisateur et des informations sur les panoramas adjacents du panorama actuel.
|
StreetViewPanoramaCamera |
getPanoramaCamera()
Renvoie l'orientation et le zoom actuels
|
boolean |
isPanningGesturesEnabled()
Indique si les gestes de panoramique sont activés pour l'utilisateur
|
boolean |
isStreetNamesEnabled()
Indique si les noms des rues apparaissent ou non sur le panorama
|
boolean |
isUserNavigationEnabled()
Indique si la navigation est activée ou non pour l'utilisateur.
|
boolean |
isZoomGesturesEnabled()
Indique si les gestes de zoom sont activés pour l'utilisateur
|
Point |
orientationToPoint(orientation StreetViewPanoramaOrientation)
Renvoie un emplacement d'écran correspondant à une orientation (
StreetViewPanoramaOrientation ). |
StreetViewPanoramaOrientation |
pointToOrientation(point point)
Renvoie l'orientation correspondant à un emplacement sur l'écran.
|
vide final |
setOnStreetViewPanoramaCameraChangeListener(écouteur StreetViewPanorama.OnStreetViewPanoramaCameraChangeListener)
Définit un rappel invoqué lorsque la caméra change.
|
vide final |
setOnStreetViewPanoramaChangeListener(écouteur StreetViewPanorama.OnStreetViewPanoramaChangeListener)
Définit un rappel qui est invoqué lorsque le panorama change.
|
vide final |
setOnStreetViewPanoramaClickListener(écouteur StreetViewPanorama.OnStreetViewPanoramaClickListener)
Définit un rappel qui est invoqué lorsque l'utilisateur appuie sur le panorama.
|
vide final |
setOnStreetViewPanoramaLongClickListener(écouteur StreetViewPanorama.OnStreetViewPanoramaLongClickListener)
Définit un rappel qui est invoqué lorsque l'utilisateur appuie de manière prolongée sur le panorama.
|
void |
setPanningGesturesEnabled(valeur booléenne enablePanning)
Détermine si l'utilisateur peut utiliser les gestes de panoramique
|
void |
setPosition(Chaîne panoId)
Définit le StreetViewPanorama sur un lieu donné.
|
void | |
void |
setPosition(position LatLng, source StreetViewSource)
Définit le StreetViewPanorama sur un lieu donné.
|
void |
setPosition(position LatLng, rayon entier, source StreetViewSource)
Définit le StreetViewPanorama sur un lieu donné.
|
void | |
void |
setStreetNamesEnabled(valeur booléenne enableStreetNames)
Détermine si l'utilisateur peut voir le nom des rues sur les panoramas.
|
void |
setUserNavigationEnabled(booléen enableUserNavigation)
Détermine si l'utilisateur peut passer à un autre panorama
|
void |
setZoomGesturesEnabled(booléen enableZoom)
Détermine si l'utilisateur peut utiliser les gestes de zoom
|
Récapitulatif des méthodes héritées
Méthodes publiques
public vide animateTo (caméra StreetViewPanoramaCamera, longue durée)
Modifie la position, l'orientation et le zoom actuels de la caméra sur une position donnée pendant une durée spécifiée
Paramètres
appareil photo | Position de la caméra à laquelle appliquer l'animation |
---|---|
de visionnage | Durée, en millisecondes, nécessaire pour passer de la position actuelle de la caméra à la position donnée. |
public StreetViewPanoramaLocation getLocation ()
Renvoie la position actuelle de l'utilisateur et des informations sur les panoramas adjacents du panorama actuel.
Renvoie
- La position actuelle de l'utilisateur
public StreetViewPanoramaCamera getPanoramaCamera ()
Renvoie l'orientation et le zoom actuels
Renvoie
- La caméra actuelle
public boolean isPanningGesturesEnabled ()
Indique si les gestes de panoramique sont activés pour l'utilisateur
Renvoie
true
si les gestes panoramiques sont activés
public boolean isStreetNamesEnabled ()
Indique si les noms des rues apparaissent ou non sur le panorama
Renvoie
true
si les noms de rues sont affichés
public boolean isUserNavigationEnabled ()
Indique si la navigation est activée ou non pour l'utilisateur. Par exemple, vous pouvez appuyer deux fois et utiliser les liens de navigation.
Renvoie
true
si la navigation est activée
public boolean isZoomGesturesEnabled ()
Indique si les gestes de zoom sont activés pour l'utilisateur
Renvoie
true
si les gestes de zoom sont activés
public Point orientationToPoint (orientation StreetViewPanoramaOrientation)
Renvoie un emplacement d'écran qui correspond à une orientation (StreetViewPanoramaOrientation
). L'emplacement de l'écran est exprimé en pixels (et non en pixels d'affichage) par rapport à l'angle supérieur gauche du panorama Street View (et non à l'ensemble de l'écran).
Paramètres
orientation | StreetViewPanoramaOrientation sur le panorama Street View à convertir en position à l'écran. |
---|
Renvoie
Point
représentant l'emplacement de l'écran, en pixels. Renvoienull
si l'orientation ne peut pas être projetée à l'écran (par exemple, derrière le champ de vision de l'utilisateur).
public StreetViewPanoramaOrientation pointToOrientation (point point)
Renvoie l'orientation correspondant à un emplacement sur l'écran. L'emplacement de l'écran est spécifié en pixels d'écran (et non en pixels d'affichage) par rapport à l'angle supérieur gauche du panorama Street View (et non à l'angle supérieur gauche de l'ensemble de l'écran).
Paramètres
point | Une Point s'affiche à l'écran en pixels. |
---|
Renvoie
StreetViewPanoramaOrientation
correspondant aupoint
affiché à l'écran, ounull
si le panorama Street View n'a pas été initialisé ou si le point donné n'est pas un point valide à l'écran
public final void setOnStreetViewPanoramaCameraChangeListener (écouteur StreetViewPanorama.OnStreetViewPanoramaCameraChangeListener)
Définit un rappel invoqué lorsque la caméra change.
Paramètres
écouteur | Rappel invoqué lorsque la caméra change. Pour annuler la définition du rappel, utilisez null .
|
---|
public final void setOnStreetViewPanoramaChangeListener (écouteur StreetViewPanorama.OnStreetViewPanoramaChangeListener)
Définit un rappel qui est invoqué lorsque le panorama change.
Paramètres
écouteur | Rappel invoqué lorsque le panorama change. Pour annuler la définition du rappel, utilisez null .
|
---|
public final void setOnStreetViewPanoramaClickListener (écouteur StreetViewPanorama.OnStreetViewPanoramaClickListener)
Définit un rappel qui est invoqué lorsque l'utilisateur appuie sur le panorama.
Paramètres
écouteur | Rappel invoqué lorsque l'utilisateur appuie sur le panorama. Pour annuler la définition du rappel, utilisez null .
|
---|
public final void setOnStreetViewPanoramaLongClickListener (écouteur StreetViewPanorama.OnStreetViewPanoramaLongClickListener)
Définit un rappel qui est invoqué lorsque l'utilisateur appuie de manière prolongée sur le panorama.
Paramètres
écouteur | Rappel invoqué lorsque l'utilisateur appuie de manière prolongée sur le panorama. Pour annuler la définition du rappel, utilisez null .
|
---|
public void setPanningGesturesEnabled (boolean enablePanning)
Détermine si l'utilisateur peut utiliser les gestes de panoramique
Paramètres
enablePanning | true si les utilisateurs sont autorisés à se servir des gestes de panoramique
|
---|
public void setPosition (String panoId)
Définit le StreetViewPanorama sur un lieu donné.
Paramètres
panoId | ID de panorama du lieu souhaité |
---|
public void setPosition (position LatLng)
Définit le StreetViewPanorama sur un lieu donné.
Paramètres
position | Latitude et longitude du lieu souhaité. |
---|
public void setPosition (position LatLng, source StreetViewSource)
Définit le StreetViewPanorama sur un lieu donné.
Paramètres
position | Latitude et longitude du lieu souhaité. |
---|---|
source | StreetViewSource spécifie la source des panoramas à rechercher. |
public void setPosition (position LatLng, rayon entier, source StreetViewSource)
Définit le StreetViewPanorama sur un lieu donné.
Paramètres
position | Latitude et longitude du lieu souhaité. |
---|---|
rayon | Rayon, spécifié en mètres, qui définit la zone dans laquelle rechercher un panorama, centrée sur la latitude et la longitude données |
source | StreetViewSource spécifie la source des panoramas à rechercher. |
public void setPosition (position LatLng, rayon int)
Définit le StreetViewPanorama sur un lieu donné.
Paramètres
position | Latitude et longitude du lieu souhaité. |
---|---|
rayon | Rayon, spécifié en mètres, qui définit la zone dans laquelle rechercher un panorama, centrée sur la latitude et la longitude données |
public vide setStreetNamesEnabled (boolean enableStreetNames)
Détermine si l'utilisateur peut voir le nom des rues sur les panoramas.
Paramètres
enableStreetNames | true si les utilisateurs peuvent voir le nom des rues sur les panoramas
|
---|
public void setUserNavigationEnabled (boolean enableUserNavigation)
Détermine si l'utilisateur peut passer à un autre panorama
Paramètres
enableUserNavigation | true si les utilisateurs sont autorisés à passer à un autre panorama
|
---|
public void setZoomGesturesEnabled (boolean enableZoom)
Détermine si l'utilisateur peut utiliser les gestes de zoom
Paramètres
enableZoom | true si les utilisateurs sont autorisés à se servir des gestes de zoom
|
---|