StreetViewPanorama class
google.maps.StreetViewPanorama
zajęcia
Wyświetla panoramę dla danego identyfikatora LatLng lub identyfikatora panoramy. Obiekt StreetViewPanorama udostępnia „przeglądarkę” Street View, która może być samodzielna w ramach osobnego obiektu <div> lub powiązana z obiektem Map.
Ta klasa rozszerza klasę MVCObject.
Dostęp przez połączenie pod numer const {StreetViewPanorama} = await google.maps.importLibrary("streetView").
Zobacz Biblioteki w Maps JavaScript API.
Zespół | |
|---|---|
StreetViewPanorama |
StreetViewPanorama(container[, opts])Parametry:
Tworzy panoramę z przekazanym parametrem StreetViewPanoramaOptions. |
Właściwości | |
|---|---|
controls |
Typ:
Array<MVCArray<HTMLElement>>Dodatkowe elementy sterujące 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ć renderowany. |
Metody | |
|---|---|
focus |
focus()Parametry: brak
Zwracana wartość: brak
Ustawia ostrość na tym StreetViewPanorama. Możesz użyć tej metody wraz ze zdarzeniem visible_changed, aby mieć pewność, że element StreetViewPanorama jest widoczny przed ustawieniem na nim fokusu. Na StreetViewPanorama, który jest niewidoczny, nie można ustawić ostrości. |
getLinks |
getLinks()Parametry: brak
Zwracana wartość:
Array<StreetViewLink>Zwraca zestaw linków nawigacyjnych do panoramy Street View. |
getLocation |
getLocation()Parametry: brak
Zwracana wartość:
StreetViewLocationZwraca StreetViewLocation bieżącej panoramy. |
getMotionTracking |
getMotionTracking()Parametry: brak
Zwracana wartość:
booleanZwraca stan modułu do śledzenia ruchu. Jeśli true, gdy użytkownik fizycznie porusza urządzeniem, a przeglądarka to obsługuje, panorama Street View śledzi ruchy fizyczne. |
getPano |
getPano()Parametry: brak
Zwracana wartość:
stringZwraca bieżący identyfikator panoramy Street View. Ten identyfikator jest stały tylko w bieżącej sesji przeglądarki. |
getPhotographerPov |
getPhotographerPov()Parametry: brak
Zwracana wartość:
StreetViewPovZwraca kierunek i kąt nachylenia fotografa w momencie wykonania panoramy. W przypadku panoram Street View na drodze pokazuje to również, w którym kierunku jechał samochód. Te dane są dostępne po wydarzeniu pano_changed. |
getPosition |
getPosition()Parametry: brak
Zwracana wartość:
LatLng|nullZwraca bieżącą pozycję LatLng panoramy Street View. |
getPov |
getPov()Parametry: brak
Zwracana wartość:
StreetViewPovZwraca bieżący punkt widzenia panoramy Street View. |
getStatus |
getStatus()Parametry: brak
Zwracana wartość:
StreetViewStatusZwraca stan panoramy po zakończeniu żądania setPosition() lub setPano(). |
getVisible |
getVisible()Parametry: brak
Zwracana wartość:
booleanZwraca wartość true, jeśli panorama jest widoczna. Nie określa, czy w danym miejscu dostępne są zdjęcia Street View. |
getZoom |
getZoom()Parametry: brak
Zwracana wartość:
numberZwraca poziom powiększenia panoramy. Całkowite oddalenie to poziom 0, przy 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ę panoram, który jest wywoływany przy zmianie panoramy, aby wczytywać niestandardowe panoramy. |
setLinks |
setLinks(links)Parametry:
Zwracana wartość: brak
Ustawia zestaw linków nawigacyjnych dla panoramy Street View. |
setMotionTracking |
setMotionTracking(motionTracking)Parametry:
Zwracana wartość: brak
Ustawia stan modułu do śledzenia ruchu. Jeśli true, gdy użytkownik fizycznie porusza urządzeniem, a przeglądarka to obsługuje, panorama Street View śledzi ruchy fizyczne. |
setOptions |
setOptions(options)Parametry:
Zwracana wartość: brak
Ustawia zbiór par klucz-wartość. |
setPano |
setPano(pano)Parametry:
Zwracana wartość: brak
Ustawia bieżący identyfikator panoramy dla panoramy Street View. |
setPosition |
setPosition(latLng)Parametry:
Zwracana wartość: brak
Ustawia bieżącą LatLng pozycję panoramy Street View. |
setPov |
setPov(pov)Parametry:
Zwracana wartość: brak
Ustawia punkt widzenia panoramy Street View. |
setVisible |
setVisible(flag)Parametry:
Zwracana wartość: brak
Ustaw wartość true, aby panorama była widoczna. Jeśli ustawisz wartość false, panorama zostanie ukryta niezależnie od tego, czy jest osadzona na mapie, czy w osobnym <div>. |
setZoom |
setZoom(zoom)Parametry:
Zwracana wartość: brak
Ustawia poziom powiększenia panoramy. Całkowite oddalenie to poziom 0, przy którym pole widzenia wynosi 180 stopni. Powiększanie zwiększa poziom powiększenia. |
Odziedziczone:
addListener,
bindTo,
get,
notify,
set,
setValues,
unbind,
unbindAll
| |
Wydarzenia | |
|---|---|
closeclick |
function(event)Argumenty:
To zdarzenie jest wywoływane po kliknięciu przycisku zamykania. |
pano_changed |
function()Argumenty: brak
To zdarzenie jest wywoływane, gdy zmienia się identyfikator panoramy. Panorama może się zmieniać, gdy użytkownik porusza się po niej lub gdy pozycja jest ustawiana ręcznie. Pamiętaj, że nie wszystkie zmiany pozycji powodują wywołanie pano_changed. |
position_changed |
function()Argumenty: brak
To zdarzenie jest wywoływane, gdy zmienia się pozycja panoramy. Pozycja zmienia się, gdy użytkownik porusza się po panoramie lub gdy 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ą nachylenia, powiększenia lub kierunku. |
resize |
function()Argumenty: brak
Deweloperzy powinni wywoływać to zdarzenie w panoramie, gdy zmieni się rozmiar 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ą funkcji setPosition() lub setPano(). |
visible_changed |
function()Argumenty: brak
To zdarzenie jest wywoływane, gdy zmienia się widoczność panoramy. Widoczność zmienia się, gdy przeciągniesz ludzika na mapę, klikniesz przycisk zamykania lub wywołasz funkcję setVisible(). |
zoom_changed |
function()Argumenty: brak
To zdarzenie jest wywoływane, gdy zmienia się poziom powiększenia panoramy. |
StreetViewPanoramaOptions interfejs
google.maps.StreetViewPanoramaOptionsinterfejs
Opcje określające właściwości obiektu StreetViewPanorama.
Właściwości | |
|---|---|
addressControl optional |
Typ:
boolean optionalStan włączenia/wyłączenia elementu sterującego adresem. |
addressControlOptions optional |
Typ:
StreetViewAddressControlOptions optionalOpcje wyświetlania kontrolki adresu. |
clickToGo optional |
Typ:
boolean optionalDomyślnie:
trueStan włączenia/wyłączenia funkcji kliknij, aby przejść. Nie dotyczy panoram niestandardowych. |
controlSize optional |
Typ:
number optionalRozmiar elementów sterujących wyświetlanych na panoramie w pikselach. Tę wartość należy podać bezpośrednio podczas tworzenia panoramy. Późniejsza aktualizacja tej wartości może spowodować, że elementy sterujące znajdą się w niezdefiniowanym stanie. Dotyczy tylko elementów sterujących udostępnianych przez sam interfejs API Map Google. Nie skaluje utworzonych przez dewelopera niestandardowych elementów sterujących. |
disableDefaultUI optional |
Typ:
boolean optionalWłącza i wyłącza cały domyślny interfejs. Można je zastąpić pojedynczo. |
disableDoubleClickZoom optional |
Typ:
boolean optionalDomyślnie:
trueWłącza i wyłącza powiększanie po dwukrotnym kliknięciu. |
enableCloseButton optional |
Typ:
boolean optionalDomyślnie:
falseJeśli true, wyświetla się przycisk zamknięcia. |
fullscreenControl optional |
Typ:
boolean optionalStan włączenia/wyłączenia elementu sterującego pełnym ekranem. |
fullscreenControlOptions optional |
Typ:
FullscreenControlOptions optionalOpcje wyświetlania elementu sterującego trybem pełnoekranowym. |
imageDateControl optional |
Typ:
boolean optionalStan włączenia/wyłączenia kontrolki daty pozyskania zdjęć. Domyślnie wyłączona. |
linksControl optional |
Typ:
boolean optionalStan włączenia/wyłączenia elementu sterującego linkami. |
motionTracking optional |
Typ:
boolean optionalOkreśla, czy śledzenie ruchu jest włączone czy wyłączone. Jest domyślnie włączone, gdy dostępny jest element sterujący śledzeniem ruchu, a użytkownik przyznał uprawnienia lub nie są one wymagane. Dzięki temu punkt widzenia podąża za orientacją urządzenia. Dotyczy to głównie urządzeń mobilnych. Jeśli motionTracking ma wartość false, a motionTrackingControl jest włączone, wyświetla się element sterujący śledzeniem ruchu, ale śledzenie jest wyłączone. Użytkownik może kliknąć element sterujący śledzeniem ruchu, aby przełączyć tę opcję. Jeśli wartość motionTracking jest ustawiona na true, a uprawnienia są wymagane, ale jeszcze nie zostały poproszone, pojawi się kontrolka śledzenia ruchu, ale śledzenie będzie wyłączone. Użytkownik może kliknąć kontrolkę śledzenia ruchu, aby poprosić o uprawnienia. Jeśli wartość motionTracking jest ustawiona na true, a użytkownik odmówi udzielenia uprawnień, element sterujący śledzeniem ruchu będzie wyglądać na wyłączony, a śledzenie będzie wyłączone. |
motionTrackingControl optional |
Typ:
boolean optionalStan włączenia/wyłączenia elementu sterującego śledzeniem ruchu. Domyślnie włączona, 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 |
Typ:
MotionTrackingControlOptions optionalOpcje wyświetlania elementu sterującego śledzeniem ruchu. |
panControl optional |
Typ:
boolean optionalStan włączenia/wyłączenia elementu sterującego panoramą. |
panControlOptions optional |
Typ:
PanControlOptions optionalOpcje wyświetlania kontrolki panoramy. |
pano optional |
Typ:
string optionalIdentyfikator panoramy, który należy ustawić podczas określania panoramy niestandardowej. |
position optional |
Typ:
LatLng|LatLngLiteral optionalLatLng Położenie panoramy Street View. |
pov optional |
Typ:
StreetViewPov optionalOrientacja kamery, określona jako kierunek i kąt nachylenia panoramy. |
scrollwheel optional |
Typ:
boolean optionalDomyślnie:
trueJeśli false, wyłącza powiększanie za pomocą kółka przewijania w Street View. |
showRoadLabels optional |
Typ:
boolean optionalDomyślnie:
trueWyświetlanie nazw ulic na panoramie. Jeśli ta wartość nie jest określona lub jest ustawiona na true, na panoramie wyświetlane są nazwy ulic. Jeśli zasada ma wartość false, nazwy ulic nie są wyświetlane. |
visible optional |
Typ:
boolean optionalJeśli true, panorama Street View jest widoczna po wczytaniu. |
zoom optional |
Typ:
number optionalPowiększenie panoramy podane jako liczba. Powiększenie 0 daje pole widzenia 180 stopni. |
zoomControl optional |
Typ:
boolean optionalStan włączenia/wyłączenia elementu sterującego powiększeniem. |
zoomControlOptions optional |
Typ:
ZoomControlOptions optionalOpcje wyświetlania elementu sterującego powiększeniem. |
StreetViewAddressControlOptions interfejs
google.maps.StreetViewAddressControlOptionsinterfejs
Opcje renderowania kontrolki adresu Street View.
Właściwości | |
|---|---|
position optional |
Typ:
ControlPosition optionalIdentyfikator pozycji. Ten identyfikator służy do określania pozycji elementu sterującego na mapie. Domyślna pozycja to TOP_LEFT. |
PanoProviderOptions interfejs
google.maps.PanoProviderOptionsinterfejs
Opcje niestandardowego dostawcy panoram.
Właściwości | |
|---|---|
cors optional |
Typ:
boolean optionalJeśli to ustawienie jest włączone, moduł renderujący będzie używać technologii (takich jak WebGL), które działają tylko wtedy, gdy nagłówki CORS są prawidłowo ustawione na podanych obrazach. Obowiązkiem dewelopera jest prawidłowe wyświetlanie obrazów w połączeniu z tą flagą, co w przeciwnym razie może prowadzić do błędów związanych z bezpieczeństwem. |
StreetViewTileData interfejs
google.maps.StreetViewTileDatainterfejs
Właściwości zestawu kafelków używanego w panoramie Street View.
Właściwości | |
|---|---|
centerHeading |
Typ:
numberKierunek (w stopniach) na środku kafelków panoramicznych. |
tileSize |
Typ:
SizeRozmiar (w pikselach), w jakim będą renderowane kafelki. |
worldSize |
Typ:
SizeRozmiar (w pikselach) całego „świata” panoramy. |
Metody | |
|---|---|
getTileUrl |
getTileUrl(pano, tileZoom, tileX, tileY)Parametry:
Zwracana wartość:
stringPobiera adres URL obrazu kafelka dla określonego kafelka. Jest to metoda niestandardowa, którą musisz wdrożyć, aby dostarczać własne kafelki. Interfejs API wywołuje tę metodę, przekazując te parametry: pano to identyfikator panoramy kafelka Street View.tileZoom to poziom powiększenia kafelka.tileX to współrzędna x kafelka.tileY to współrzędna Y kafelka.Twoja niestandardowa metoda musi zwracać adres URL obrazu kafelka. |
StreetViewPov interface
google.maps.StreetViewPovinterfejs
Obiekt punktu widzenia, który określa orientację kamery w miejscu panoramy Street View. Punkt widzenia jest określany przez kierunek i kąt nachylenia.
Właściwości | |
|---|---|
heading |
Typ:
numberKierunek kamery w stopniach względem true północy. Północ to 0°, wschód to 90°, południe to 180°, a zachód to 270°. |
pitch |
Typ:
numberOkreśla kąt nachylenia kamery w stopniach względem pojazdu Street View. Zakres od 90° (bezpośrednio w górę) do -90° (bezpośrednio w dół). |
StreetViewCoverageLayer class
google.maps.StreetViewCoverageLayer
zajęcia
Warstwa pokazująca lokalizacje, w których dostępna jest funkcja Street View.
Ta klasa rozszerza klasę MVCObject.
Dostęp przez połączenie pod numer const {StreetViewCoverageLayer} = await google.maps.importLibrary("streetView").
Zobacz Biblioteki w Maps JavaScript API.
Zespół | |
|---|---|
StreetViewCoverageLayer |
StreetViewCoverageLayer()Parametry: brak
Tworzy nową instancję StreetViewCoverageLayer. |
Metody | |
|---|---|
getMap |
getMap()Parametry: brak
Zwracana wartość:
Map|nullZwraca mapę, na której wyświetlana jest ta warstwa. |
setMap |
setMap(map)Parametry:
Zwracana wartość:
undefinedRenderuje warstwę na określonej mapie. Jeśli mapa ma wartość null, warstwa zostanie usunięta. |
Odziedziczone:
addListener,
bindTo,
get,
notify,
set,
setValues,
unbind,
unbindAll
| |