Rendering

klasa StreetViewPanorama

google.maps.StreetViewPanorama class

Wyświetla panoramę dla danego LatLng lub identyfikatora panoramy. Obiekt StreetViewPanorama udostępnia „widok” Street View, który może być samodzielny w ramach osobnego <div> lub powiązany z Map.

Te zajęcia trwają MVCObject.

Dostęp przez połączenie telefoniczne const {StreetViewPanorama} = await google.maps.importLibrary("streetView"). Zobacz Biblioteki w Maps JavaScript API.

StreetViewPanorama
StreetViewPanorama(container[, opts])
Parametry: 
Tworzy panoramę z przekazaną StreetViewPanoramaOptions.
controls
dodatkowe opcje do dołączenia do panoramy; Aby dodać element sterujący do panoramy, dodaj jego <div> do MVCArray odpowiadającego ControlPosition, w którym ma być on renderowany.
focus
focus()
Parametry: brak
Zwracana wartość:  brak
Ustawia ostrość na tym StreetViewPanorama. Możesz użyć tej metody razem ze zdarzeniem visible_changed, aby mieć pewność, że element StreetViewPanorama jest widoczny, zanim ustawisz na nim fokus. StreetViewPanorama, który jest niewidoczny, nie może być zaznaczony.
getLocation
getLocation()
Parametry: brak
Wartość zwracana:  StreetViewLocation
Zwraca lokalizację Street View bieżącej panoramy.
getMotionTracking
getMotionTracking()
Parametry: brak
Wartość zwracana:  boolean
Zwraca stan śledzenia ruchu. Jeśli true, gdy użytkownik fizycznie przemieszcza urządzenie, a przeglądarka obsługuje tę funkcję, panorama Street View śledzi te ruchy.
getPano
getPano()
Parametry: brak
Wartość zwracana:  string
Zwraca bieżący identyfikator panoramy Street View. Ten identyfikator jest stabilny tylko w ramach bieżącej sesji przeglądarki.
getPhotographerPov
getPhotographerPov()
Parametry: brak
Wartość zwracana:  StreetViewPov
Zwraca kierunek i pochylenie fotografa w momencie zrobienia tej panoramy. W przypadku panoram na drodze w Street View widać też, w jakim kierunku jechał samochód. Te dane są dostępne po zdarzeniu pano_changed.
getPosition
getPosition()
Parametry: brak
Wartość zwracana:  LatLng|null
Zwraca bieżącą pozycję LatLng panoramy Street View.
getPov
getPov()
Parametry: brak
Wartość zwracana:  StreetViewPov
Zwraca bieżący punkt widzenia w panoramie Street View.
getStatus
getStatus()
Parametry: brak
Wartość zwracana:  StreetViewStatus
Zwraca stan panoramy po zakończeniu żądania setPosition() lub setPano().
getVisible
getVisible()
Parametry: brak
Wartość zwracana:  boolean
Zwraca true, jeśli panorama jest widoczna. Nie określa, czy w określonym miejscu są dostępne zdjęcia Street View.
getZoom
getZoom()
Parametry: brak
Wartość zwracana:  number
Zwraca poziom powiększenia panoramy. W trybie maksymalnego oddalenia poziom 0, w którym pole widzenia wynosi 180 stopni. Powiększanie zwiększa poziom powiększenia.
registerPanoProvider
registerPanoProvider(provider[, opt_options])
Parametry: 
Zwracana wartość:  brak
Ustaw niestandardowego dostawcę panoramy wywoływanego po zmianie panoramy, aby wczytywać niestandardowe panoramy.
setMotionTracking
setMotionTracking(motionTracking)
Parametry: 
  • motionTrackingboolean
Zwracana wartość:  brak
Ustawia stan śledzenia ruchu. Jeśli true, gdy użytkownik fizycznie przemieszcza urządzenie, a przeglądarka obsługuje tę funkcję, panorama Street View śledzi te ruchy.
setOptions
setOptions(options)
Parametry: 
Zwracana wartość:  brak
Ustawia zbiór par klucz-wartość.
setPano
setPano(pano)
Parametry: 
  • panostring
Zwracana wartość:  brak
Ustawia bieżący identyfikator panoramy w Street View.
setPosition
setPosition(latLng)
Parametry: 
Zwracana wartość:  brak
Ustawia bieżącą pozycję LatLng panoramy Street View.
setPov
setPov(pov)
Parametry: 
Zwracana wartość:  brak
Określa punkt widzenia panoramy Street View.
setVisible
setVisible(flag)
Parametry: 
  • flagboolean
Zwracana wartość:  brak
Ustawia wartość true, aby panorama była widoczna. Jeśli ustawisz wartość false, panorama zostanie ukryta, niezależnie od tego, czy jest umieszczona na mapie, czy na osobnej stronie <div>.
setZoom
setZoom(zoom)
Parametry: 
  • zoomnumber
Zwracana wartość:  brak
Ustawia poziom powiększenia panoramy. W trybie maksymalnego oddalenia poziom 0, w którym pole widzenia wynosi 180 stopni. Powiększanie zwiększa poziom powiększenia.
Uzyskane: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
closeclick
function(event)
Argumenty: 
  • eventEventZdarzenie wywołane.
To zdarzenie jest wywoływane po kliknięciu przycisku Zamknij.
pano_changed
function()
Argumenty: brak.
To zdarzenie jest wywoływane, gdy identyfikator panoramy (pano_id) ulegnie zmianie. Panorama może się zmieniać, gdy użytkownik przewija panoramę lub gdy pozycja jest ustawiana ręcznie. Pamiętaj, że nie wszystkie zmiany pozycji powodują pano_changed.
position_changed
function()
Argumenty: brak.
To zdarzenie jest wywoływane, gdy zmienia się pozycja panoramy. Pozycja zmienia się, gdy użytkownik przewija panoramę lub gdy pozycja jest ustawiana ręcznie.
pov_changed
function()
Argumenty: brak.
To zdarzenie jest wywoływane, gdy zmienia się punkt widzenia panoramy. Punkt widzenia zmienia się wraz ze zmianą pochylenia, powiększenia lub kierunku.
resize
function()
Argumenty: brak.
Deweloperzy powinni wywoływać to zdarzenie w panoramie, gdy zmienia się rozmiar jej elementu div: google.maps.event.trigger(panorama, 'resize').
status_changed
function()
Argumenty: brak.
To zdarzenie jest wywoływane po każdym wyszukiwaniu panoramy według identyfikatora lub lokalizacji za pomocą metody setPosition() lub setPano().
visible_changed
function()
Argumenty: brak.
To zdarzenie jest wywoływane, gdy widoczność panoramy się zmienia. Widoczność zmienia się, gdy przeciągniesz Pegmana na mapę, klikniesz przycisk Zamknij lub wywołasz setVisible().
zoom_changed
function()
Argumenty: brak.
To zdarzenie jest wywoływane, gdy zmienia się poziom powiększenia panoramy.

interfejs StreetViewPanoramaOptions

google.maps.StreetViewPanoramaOptionsinterfejs

Opcje definiujące właściwości obiektu StreetViewPanorama.

addressControl optional
Typ:  boolean optional
Włączony lub wyłączony stan elementu sterującego adresem.
addressControlOptions optional
Opcje wyświetlania elementu sterującego adresem.
clickToGo optional
Typ:  boolean optional
Domyślnie: true
Włączony lub wyłączony stan kliknięcia, aby przejść. Nie dotyczy niestandardowych panoram.
controlSize optional
Typ:  number optional
Rozmiar elementów sterujących widocznych na panoramie (w pikselach). Ta wartość musi zostać podana bezpośrednio podczas tworzenia panoramy. Zmiana tej wartości w późniejszym czasie może spowodować nieokreślony stan elementów sterujących. Dotyczy tylko ustawień wprowadzonych przez interfejs API Map. Nie skaluje elementów sterujących niestandardowych utworzonych przez dewelopera.
disableDefaultUI optional
Typ:  boolean optional
Włącza lub wyłącza cały interfejs domyślny. Można je zastąpić pojedynczo.
disableDoubleClickZoom optional
Typ:  boolean optional
Domyślnie: true
Włącza lub wyłącza powiększanie po dwukrotnym kliknięciu.
enableCloseButton optional
Typ:  boolean optional
Domyślnie: false
Jeśli true, wyświetla się przycisk Zamknij.
fullscreenControl optional
Typ:  boolean optional
Włączony lub wyłączony stan elementu sterującego pełnym ekranem.
fullscreenControlOptions optional
Typ:  FullscreenControlOptions optional
Opcje wyświetlania elementu sterującego trybem pełnoekranowym.
imageDateControl optional
Typ:  boolean optional
Włączony lub wyłączony stan kontroli daty pozyskania zdjęć. Domyślnie jest wyłączona.
linksControl optional
Typ:  boolean optional
Włączony lub wyłączony stan elementu sterującego linkami.
motionTracking optional
Typ:  boolean optional
Włączanie i wyłączanie śledzenia ruchu. Funkcja jest domyślnie włączona, gdy dostępna jest opcja śledzenia ruchu, a użytkownik udzielił zgody lub nie jest ona wymagana, dzięki czemu punkt widzenia (POV) podąża za orientacją urządzenia. Dotyczy to przede wszystkim urządzeń mobilnych. Jeśli motionTracking ma wartość false, a opcja motionTrackingControl jest włączona, pojawia się kontrolka śledzenia ruchu, ale śledzenie jest wyłączone. Użytkownik może kliknąć kontrolkę śledzenia ruchu, aby włączyć lub wyłączyć tę opcję. Jeśli motionTracking ma wartość true, gdy wymagane jest uprawnienie, ale nie zostało jeszcze poproszono o jego przyznanie, pojawia się kontrolka śledzenia ruchu, ale śledzenie jest wyłączone. Użytkownik może kliknąć kontrolkę śledzenia ruchu, aby poprosić o przyznanie uprawnienia. Jeśli motionTracking jest ustawione na true, a użytkownik odmówił udzielenia uprawnień, kontrola śledzenia ruchu będzie wyglądać jak wyłączona.
motionTrackingControl optional
Typ:  boolean optional
Włączony/wyłączony stan sterowania śledzenia ruchu. Domyślnie włączone, gdy urządzenie ma dane o ruchu, dzięki czemu element sterujący pojawia się na mapie. Dotyczy to głównie urządzeń mobilnych.
motionTrackingControlOptions optional
Opcje wyświetlania sterowania śledzeniem ruchu.
panControl optional
Typ:  boolean optional
Włączony lub wyłączony stan sterowania przesuwaniem.
panControlOptions optional
Typ:  PanControlOptions optional
Opcje wyświetlania sterowania przesuwaniem.
pano optional
Typ:  string optional
Identyfikator panoramy, który powinien być ustawiony podczas określania niestandardowej panoramy.
position optional
Typ:  LatLng|LatLngLiteral optional
LatLng położenie panoramy Street View.
pov optional
Typ:  StreetViewPov optional
Orientacja kamery, określona jako kierunek i pochylenie, dla panoramy.
scrollwheel optional
Typ:  boolean optional
Domyślnie: true
Jeśli false, wyłącza powiększanie za pomocą kółka przewijania w Street View.
showRoadLabels optional
Typ:  boolean optional
Domyślnie: true
Wyświetlanie nazw ulic na panoramie. Jeśli ta wartość nie jest określona lub jest ustawiona na true, nazwy ulic są wyświetlane na panoramie. Jeśli zasada ma wartość false, nazwy ulic nie są wyświetlane.
visible optional
Typ:  boolean optional
Jeśli true, po załadowaniu widoku widoczna jest panorama Street View.
zoom optional
Typ:  number optional
Powiększenie panoramy, podane jako liczba. Powiększenie 0 daje pole widzenia 180 stopni.
zoomControl optional
Typ:  boolean optional
Włączony lub wyłączony stan elementu sterującego powiększeniem.
zoomControlOptions optional
Typ:  ZoomControlOptions optional
Opcje wyświetlania elementu sterującego powiększeniem.

Interfejs StreetViewAddressControlOptions

google.maps.StreetViewAddressControlOptionsinterfejs

Opcje renderowania kontrolki adresu Street View.

position optional
Typ:  ControlPosition optional
Identyfikator pozycji. Ten identyfikator służy do określania pozycji elementu sterującego na mapie. Domyślna pozycja to TOP_LEFT.

Interfejs PanoProviderOptions

google.maps.PanoProviderOptionsinterfejs

Opcje dostawcy niestandardowych panoram.

cors optional
Typ:  boolean optional
Jeśli to ustawienie jest ustawione, procesor graficzny będzie używać technologii (takich jak WebGL), które działają tylko wtedy, gdy nagłówki cors są odpowiednio skonfigurowane w dostarczonych obrazach. Do obowiązków dewelopera należy prawidłowe wyświetlanie obrazów w połączeniu z tą flagą, ponieważ w przeciwnym razie może to spowodować błędy zabezpieczeń.

interfejs StreetViewTileData

google.maps.StreetViewTileDatainterfejs

Właściwości zestawu płytek użytych w panoramie Street View.

centerHeading
Typ:  number
Kierunek (w stopniach) w środku kafelków panoramicznych.
tileSize
Typ:  Size
Rozmiar (w pikselach), w jakim będą renderowane kafelki.
worldSize
Typ:  Size
Rozmiar (w pikselach) całego „świata” panoramy.
getTileUrl
getTileUrl(pano, tileZoom, tileX, tileY)
Parametry: 
  • panostring
  • tileZoomnumber
  • tileXnumber
  • tileYnumber
Wartość zwracana:  string
Pobiera adres URL obrazu kafelka dla określonego kafelka.
To niestandardowa metoda, którą musisz zaimplementować, aby udostępniać niestandardowe płytki. Interfejs API wywołuje tę metodę, podając te parametry:
pano to identyfikator panoramy w płytce Street View.
tileZoom to poziom powiększenia kafelka.
tileX to współrzędna X kafelka.
tileY to współrzędna Y kafelka.
 Metoda niestandardowa musi zwracać adres URL obrazu kafelka.

Interfejs StreetViewPov

google.maps.StreetViewPovinterfejs

Obiekt punktu widzenia, który określa orientację kamery w miejscu widoku w panoramie Street View. Punkt widzenia jest zdefiniowany jako kierunek i pochylenie.

heading
Typ:  number
Kierunek kamery podany w stopniach względem true północy. Prawdziwa północ to 0°, wschód to 90°, południe to 180°, a zachód to 270°.
pitch
Typ:  number
Kąt nachylenia kamery w stopniach względem pojazdu Street View. Zakres: od 90° (prosto do góry) do -90° (prosto w dół).

Klasa StreetViewCoverageLayer

google.maps.StreetViewCoverageLayer class

Warstwa pokazująca lokalizacje, w których dostępna jest funkcja Street View.

Te zajęcia trwają MVCObject.

Dostęp przez połączenie telefoniczne const {StreetViewCoverageLayer} = await google.maps.importLibrary("streetView"). Zobacz Biblioteki w Maps JavaScript API.

StreetViewCoverageLayer
StreetViewCoverageLayer()
Parametry: brak
Tworzy nową instancję StreetViewCoverageLayer.
getMap
getMap()
Parametry: brak
Wartość zwracana:  Map|null
Zwraca mapę, na której wyświetla się ta warstwa.
setMap
setMap(map)
Parametry: 
  • mapMap optional
Zwracana wartość:  brak
Renderuje warstwę na określonej mapie. Jeśli mapa ma wartość null, warstwa zostanie usunięta.
Uzyskane: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll