Rendering

StreetPanorama

Classe google.maps.StreetViewPanorama

Affiche le panorama pour un LatLng ou un ID de panorama donné. Un objet StreetViewPanorama fournit un "lecteur" Street View qui peut être autonome dans un <div> distinct ou lié à un Map.

Cette classe étend MVCObject.

Accédez à en appelant const {StreetViewPanorama} = await google.maps.importLibrary("streetView"). Consultez Bibliothèques dans l'API Maps JavaScript.

StreetViewPanorama
StreetViewPanorama(container[, opts])
Paramètres:
Crée un panorama avec l'élément StreetViewPanoramaOptions transmis.
controls
Commandes supplémentaires à associer au panorama. Pour ajouter une commande au panorama, ajoutez le <div> de la commande à la MVCArray correspondant au ControlPosition où elle doit être affichée.
focus
focus()
Paramètres:aucun
Valeur de retour:aucune
Active le StreetViewPanorama. Nous vous conseillons d'utiliser cette méthode en même temps qu'un événement visible_changed pour vous assurer que StreetViewPanorama est visible avant d'activer la mise au point. Un élément StreetViewPanorama non visible ne peut pas être sélectionné.
getLocation
getLocation()
Paramètres:aucun
Valeur renvoyée:StreetViewLocation
Renvoie la valeur StreetViewLocation du panorama actuel.
getMotionTracking
getMotionTracking()
Paramètres:aucun
Valeur renvoyée:boolean
Affiche l'état de l'outil de suivi du mouvement. Si true lorsque l'utilisateur déplace physiquement l'appareil et que le navigateur le prend en charge, le panorama Street View suit les mouvements physiques.
getPano
getPano()
Paramètres:aucun
Valeur renvoyée:string
Renvoie l'identifiant actuel du panorama Street View. Cet identifiant n'est stable que dans la session actuelle du navigateur.
getPhotographerPov
getPhotographerPov()
Paramètres:aucun
Valeur renvoyée:StreetViewPov
Renvoie le cap et la hauteur du photographe lorsque ce panorama a été pris. Pour les panoramas Street View sur la route, cela indique également la direction du trajet. Ces données sont disponibles après l'événement pano_changed.
getPosition
getPosition()
Paramètres:aucun
Valeur renvoyée:LatLng
Renvoie la position LatLng actuelle du panorama Street View.
getPov
getPov()
Paramètres:aucun
Valeur renvoyée:StreetViewPov
Renvoie le point de vue actuel du panorama Street View.
getStatus
getStatus()
Paramètres:aucun
Valeur renvoyée:StreetViewStatus
Renvoie l'état du panorama à la fin de la requête setPosition() ou setPano().
getVisible
getVisible()
Paramètres:aucun
Valeur renvoyée:boolean
Renvoie true si le panorama est visible. Il n'indique pas si les images Street View sont disponibles à l'emplacement spécifié.
getZoom
getZoom()
Paramètres:aucun
Valeur renvoyée:number
Renvoie le niveau de zoom du panorama. Le zoom 0 est appliqué au niveau de zoom 0, avec un champ de vision de 180 degrés. Un zoom avant augmente le niveau de zoom.
registerPanoProvider
registerPanoProvider(provider[, opt_options])
Paramètres:
Valeur de retour:aucune
Définissez le fournisseur de panorama personnalisé appelé lors du changement de panorama pour charger les panoramas personnalisés.
setMotionTracking
setMotionTracking(motionTracking)
Paramètres:
  • motionTrackingboolean
Valeur de retour:aucune
Définit l'état de l'outil de suivi du mouvement. Si true lorsque l'utilisateur déplace physiquement l'appareil et que le navigateur le prend en charge, le panorama Street View suit les mouvements physiques.
setOptions
setOptions(options)
Paramètres:
Valeur de retour:aucune
Définit un ensemble de paires clé-valeur.
setPano
setPano(pano)
Paramètres:
  • panostring
Valeur de retour:aucune
Définit l'ID de panorama actuel pour le panorama Street View.
setPosition
setPosition(latLng)
Paramètres:
Valeur de retour:aucune
Définit la position LatLng actuelle du panorama Street View.
setPov
setPov(pov)
Paramètres:
Valeur de retour:aucune
Définit le point de vue du panorama Street View.
setVisible
setVisible(flag)
Paramètres:
  • flagboolean
Valeur de retour:aucune
Définie sur true pour rendre le panorama visible. S'il est défini sur false, le panorama sera masqué, qu'il soit intégré à la carte ou dans son propre <div>.
setZoom
setZoom(zoom)
Paramètres:
  • zoomnumber
Valeur de retour:aucune
Définit le niveau de zoom du panorama. Le zoom 0 est appliqué au niveau de zoom 0, avec un champ de vision de 180 degrés. Un zoom avant augmente le niveau de zoom.
Hérité: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
closeclick
function(event)
Arguments: 
  • eventEvent événement déclenché.
Cet événement est déclenché lorsque l'utilisateur clique sur le bouton de fermeture.
pano_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque l'identifiant de panorama du panorama change. Le panorama peut changer lorsque l'utilisateur parcourt le panorama ou lorsque la position est définie manuellement. Notez que toutes les modifications de position ne déclenchent pas de pano_changed.
position_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque la position du panorama change. La position change lorsque l'utilisateur parcourt le panorama, ou la position est définie manuellement.
pov_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque le point de vue du panorama change. Le point de vue change lorsque l'inclinaison, le zoom ou le cap changent.
resize
function()
Arguments:aucun
Les développeurs doivent déclencher cet événement sur le panorama lorsque son élément div change de taille: google.maps.event.trigger(panorama, 'resize').
status_changed
function()
Arguments:aucun
Cet événement est déclenché après chaque recherche de panorama par ID ou par lieu, via setPosition() ou setPano().
visible_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque la visibilité du panorama change. La visibilité est modifiée lorsque l'utilisateur déplace Pegman sur la carte, clique sur le bouton de fermeture ou appelle setVisible().
zoom_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque le niveau de zoom du panorama change.

StreetPanoramaOptions

google.maps.StreetViewPanoramaOptions interface

Options définissant les propriétés d'un objet StreetViewPanorama.

addressControl optional
Type:boolean optional
État activé/désactivé de la commande d'adresse.
addressControlOptions optional
Options d'affichage du contrôle d'adresse.
clickToGo optional
Type:boolean optional
Par défaut:true
État "click-to-go" activé/désactivé. Non applicable aux panoramas personnalisés.
controlSize optional
Type:number optional
Taille en pixels des commandes affichées sur le panorama. Cette valeur doit être fournie directement lors de la création du panorama. Si vous la modifiez ultérieurement, les commandes risquent de ne pas être définies. Ne régit que les commandes effectuées par l'API Google Maps. N'ajuste pas les contrôles personnalisés créés par les développeurs.
disableDefaultUI optional
Type:boolean optional
Active/désactive toutes les interfaces utilisateur par défaut. Peut être ignoré individuellement.
disableDoubleClickZoom optional
Type:boolean optional
Par défaut:true
Active/désactive le zoom sur les doubles clics.
enableCloseButton optional
Type:boolean optional
Par défaut:false
Si la valeur est true, le bouton de fermeture est affiché.
fullscreenControl optional
Type:boolean optional
État activé/désactivé de la commande plein écran.
fullscreenControlOptions optional
Options d'affichage de la commande plein écran.
imageDateControl optional
Type:boolean optional
État activé/désactivé du contrôle de la date d'acquisition des images. Désactivée par défaut.
linksControl optional
Type:boolean optional
État activé/désactivé de la commande d'association.
motionTracking optional
Type:boolean optional
Indique si le suivi du mouvement est activé. Il est activé par défaut lorsque la commande de suivi du mouvement est activée et que l'autorisation est accordée par l'utilisateur ou non, afin que le point de vue corresponde à l'orientation de l'appareil. Cela concerne principalement les appareils mobiles. Si motionTracking est défini sur false alors que motionTrackingControl est activé, la commande de suivi du mouvement s'affiche, mais le suivi est désactivé. L'utilisateur peut appuyer sur cette commande pour activer/désactiver cette option. Si motionTracking est défini sur true alors que l'autorisation est requise mais pas encore demandée, la commande de suivi du mouvement s'affiche, mais le suivi est désactivé. L'utilisateur peut appuyer sur la commande de suivi du mouvement pour demander l'autorisation. Si motionTracking est défini sur true alors que l'autorisation est refusée par un utilisateur, la commande de suivi du mouvement s'affiche alors que le suivi est désactivé.
motionTrackingControl optional
Type:boolean optional
État activé/désactivé de la commande de suivi du mouvement. Activé par défaut lorsque l'appareil contient des données de mouvement, afin que la commande s'affiche sur la carte. Cela concerne principalement les appareils mobiles.
motionTrackingControlOptions optional
Options d'affichage de la commande de suivi du mouvement.
panControl optional
Type:boolean optional
État activé/désactivé de la commande de panoramique.
panControlOptions optional
Type:PanControlOptions optional
Options d'affichage de la commande de panoramique.
pano optional
Type:string optional
Identifiant de panorama, à définir lorsque vous spécifiez un panorama personnalisé.
position optional
Type:LatLng|LatLngLiteral optional
Position LatLng du panorama Street View.
pov optional
Type:StreetViewPov optional
Orientation de l'appareil photo, spécifiée comme cap et inclinaison, pour le panorama.
scrollwheel optional
Type:boolean optional
Par défaut:true
Si la valeur est false, le zoom à l'aide de la molette de défilement est désactivé dans Street View.
showRoadLabels optional
Type:boolean optional
Par défaut:true
Affichage des noms de rue sur le panorama. Si cette valeur n'est pas spécifiée ou est définie sur true, les noms des rues sont affichés sur le panorama. Si elle est définie sur false, les noms de rue ne sont pas affichés.
visible optional
Type:boolean optional
Si la valeur est true, le panorama Street View est visible au chargement.
zoom optional
Type:number optional
Zoom du panorama, spécifié sous forme de nombre. Un zoom de 0 donne un champ de vision de 180 degrés.
zoomControl optional
Type:boolean optional
État activé/désactivé de la commande de zoom.
zoomControlOptions optional
Type:ZoomControlOptions optional
Options d'affichage de la commande de zoom.

Interface StreetViewAddressControlOptions

google.maps.StreetViewAddressControlOptions interface

Options d'affichage de la commande d'adresse Street View.

position optional
Type:ControlPosition optional
ID de position. Cet ID permet de spécifier la position de la commande sur la carte. La position par défaut est TOP_LEFT.

Interface PanoProviderOptions

google.maps.PanoProviderOptions interface

Options du fournisseur de panoramas personnalisés

cors optional
Type:boolean optional
S'il est défini, le moteur de rendu utilisera des technologies (telles que webgl) qui ne fonctionnent que lorsque les en-têtes cors sont correctement définis sur les images fournies. C'est au développeur qu'il revient de diffuser les images correctement avec cette option, ce qui peut entraîner des erreurs de sécurité.

Interface StreetViewTileData

google.maps.StreetViewTileData interface

Propriétés de l'ensemble de tuiles utilisé dans un panorama Street View.

centerHeading
Type:number
Cap (en degrés) au centre des tuiles panoramiques.
tileSize
Type:Size
Taille (en pixels) de rendu des tuiles.
worldSize
Type:Size
Taille (en pixels) du "monde" entier du panorama.
getTileUrl
getTileUrl(pano, tileZoom, tileX, tileY)
Paramètres:
  • panostring
  • tileZoomnumber
  • tileXnumber
  • tileYnumber
Valeur renvoyée:string
Récupère l'URL de l'image de la tuile spécifiée.
Il s'agit d'une méthode personnalisée que vous devez implémenter pour fournir vos tuiles personnalisées. L'API appelle cette méthode et fournit les paramètres suivants:
pano est l'ID de panorama de la tuile Street View.
tileZoom est le niveau de zoom de la tuile.
tileX est la coordonnée X de la tuile.
tileY est la coordonnée Y de la tuile.
Votre méthode personnalisée doit renvoyer l'URL de l'image de la tuile.

Interface StreetViewPov

google.maps.StreetViewPov interface

Objet de point de vue indiquant l'orientation de la caméra sur la position du panorama Street View. Le point de vue correspond au cap et au ton.

heading
Type:number
Direction de la caméra en degrés par rapport au nord (true). Le nord géographique est à 0°, l'est à 90°, le sud à 180° et l'ouest à 270°.
pitch
Type:number
Inclinaison de la caméra en degrés par rapport au véhicule Street View. Les valeurs possibles sont comprises entre 90 ° (directement vers le haut) et -90 ° (directement vers le bas).

Classe StreetViewCoverageLayer

Classe google.maps.StreetViewCoverageLayer

Calque illustrant les lieux où Street View est disponible.

Cette classe étend MVCObject.

Accédez à en appelant const {StreetViewCoverageLayer} = await google.maps.importLibrary("streetView"). Consultez Bibliothèques dans l'API Maps JavaScript.

StreetViewCoverageLayer
StreetViewCoverageLayer()
Paramètres:aucun
Crée une instance de StreetViewCoverageLayer.
getMap
getMap()
Paramètres:aucun
Valeur renvoyée:Map|null
Affiche la carte sur laquelle ce calque est affiché.
setMap
setMap(map)
Paramètres:
  • mapMap optional
Valeur de retour:aucune
Affiche le calque sur la carte spécifiée. Si la carte est définie sur null, le calque est supprimé.
Hérité: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll