Rendering

Klasa StreetViewPanorama

class google.maps.StreetViewPanorama extends MVCObject
library "streetView"

Wyświetla panoramę dla danego obiektu LatLng lub identyfikatora panoramy. Obiekt StreetViewPanorama udostępnia „przeglądarkę” Street View, która może być samodzielna w osobnym elemencie <div> lub powiązana z elementem Map.

const {StreetViewPanorama} = await google.maps.importLibrary("streetView");
StreetViewPanorama
StreetViewPanorama(container[, opts])
Parametry:
Tworzy panoramę z przekazanym obiektem StreetViewPanoramaOptions.
controls
Dodatkowe elementy sterujące, które można dołączyć do panoramy. Aby dodać element sterujący do panoramy, dodaj <div> elementu sterującego do MVCArray odpowiadającego ControlPosition, w którym ma być renderowany.
focus
focus()
Parametry: brak
Zwracana wartość: brak
Ustawia zaznaczenie na tym elemencie: StreetViewPanorama. Możesz rozważyć użycie tej metody wraz ze zdarzeniem visible_changed, aby upewnić się, że element StreetViewPanorama jest widoczny, zanim zostanie zaznaczony. Nie można ustawić fokusu na niewidocznym elemencie StreetViewPanorama.
getLocation
getLocation()
Parametry: brak
Wartość zwracana: StreetViewLocation
Zwraca StreetViewLocation bieżącej panoramy.
getMotionTracking
getMotionTracking()
Parametry: brak
Wartość zwracana: boolean
Zwraca stan ś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
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 nachylenie aparatu podczas robienia zdjęcia panoramicznego. W przypadku panoram Street View na drodze pokazuje to również kierunek, w którym 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 dla panoramy Street View.
getPov
getPov()
Parametry: brak
Wartość zwracana: StreetViewPov
Zwraca bieżący punkt widzenia panoramy 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 zdjęcia Street View są dostępne w określonej lokalizacji.
getZoom
getZoom()
Parametry: brak
Wartość zwracana: number
Zwraca poziom powiększenia panoramy. Poziom 0 to maksymalne pomniejszenie, przy którym pole widzenia wynosi 180 stopni. Powiększenie zwiększa poziom powiększenia.
registerPanoProvider
registerPanoProvider(provider[, opt_options])
Parametry:
Zwracana wartość: brak
Ustaw niestandardowego dostawcę panoramy wywoływanego przy zmianie panoramy, aby wczytywać niestandardowe panoramy.
setMotionTracking
setMotionTracking(motionTracking)
Parametry:
  • motionTracking: boolean
Zwracana wartość: brak
Ustawia stan ś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 kolekcję par klucz-wartość.
setPano
setPano(pano)
Parametry:
  • pano: string
Zwracana wartość: brak
Ustawia bieżący identyfikator panoramy Street View.
setPosition
setPosition(latLng)
Parametry:
Zwracana wartość: brak
Ustawia bieżącą pozycję LatLng dla panoramy Street View.
setPov
setPov(pov)
Parametry:
Zwracana wartość: brak
Ustawia punkt widzenia dla panoramy Street View.
setVisible
setVisible(flag)
Parametry:
  • flag: boolean
Zwracana wartość: brak
Ustaw wartość true, aby panorama była widoczna. Jeśli ustawisz wartość false, panorama będzie ukryta niezależnie od tego, czy jest umieszczona na mapie, czy w osobnym elemencie <div>.
setZoom
setZoom(zoom)
Parametry:
  • zoom: number
Zwracana wartość: brak
Ustawia poziom powiększenia panoramy. Poziom 0 to maksymalne pomniejszenie, przy którym pole widzenia wynosi 180 stopni. Powiększenie zwiększa poziom powiększenia.
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
closeclick
function(event)
Argumenty:
  • event: Event optional Zdarzenie zostało wywołane.
To zdarzenie jest wywoływane po kliknięciu przycisku zamknięcia.
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 zdarzenia 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 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 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ą setPosition() lub setPano().
visible_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane, gdy zmienia się widoczność panoramy. Widoczność zmienia się, gdy Pegman zostanie przeciągnięty na mapę, kliknięty zostanie przycisk zamknięcia lub wywołana zostanie metoda setVisible().
zoom_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane, gdy zmienia się poziom powiększenia panoramy.

Interfejs StreetViewPanoramaOptions

interfejs google.maps.StreetViewPanoramaOptions

Opcje definiujące właściwości obiektu StreetViewPanorama.
addressControl
opcjonalne
Typ: boolean optional
Stan włączenia/wyłączenia elementu sterującego adresu.
addressControlOptions
opcjonalne
Opcje wyświetlania elementu sterującego adresem.
clickToGo
opcjonalne
Typ: boolean optional
Domyślnie: true
Stan włączenia/wyłączenia funkcji kliknij, aby przejść. Nie dotyczy panoram niestandardowych.
controlSize
opcjonalne
Typ: number optional
Rozmiar 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 będą w niezdefiniowanym stanie. Dotyczy tylko elementów sterujących utworzonych przez sam interfejs API Map Google. Nie skaluje niestandardowych elementów sterujących utworzonych przez dewelopera.
disableDefaultUI
opcjonalne
Typ: boolean optional
Włącza lub wyłącza cały domyślny interfejs. Można je zastąpić pojedynczo.
disableDoubleClickZoom
opcjonalne
Typ: boolean optional
Domyślnie: true
Włącza/wyłącza powiększanie po dwukrotnym kliknięciu.
enableCloseButton
opcjonalne
Typ: boolean optional
Domyślnie: false
Jeśli true, przycisk zamknięcia jest wyświetlany.
fullscreenControl
opcjonalne
Typ: boolean optional
Stan włączenia/wyłączenia elementu sterującego pełnym ekranem.
fullscreenControlOptions
opcjonalne
Opcje wyświetlania elementu sterującego pełnym ekranem.
imageDateControl
opcjonalne
Typ: boolean optional
Stan włączenia/wyłączenia elementu sterującego datą pozyskania zdjęć. Domyślnie jest wyłączona.
linksControl
opcjonalne
Typ: boolean optional
Stan włączenia/wyłączenia elementu sterującego linkami.
motionTracking
opcjonalne
Typ: boolean optional
Określa, czy śledzenie ruchu jest włączone czy wyłączone. Domyślnie jest włączone, gdy dostępna jest kontrola śledzenia ruchu i użytkownik udzielił uprawnień lub nie są one wymagane, dzięki czemu punkt widzenia podąża za orientacją urządzenia. Dotyczy to głównie urządzeń mobilnych. Jeśli zasada motionTracking jest ustawiona na false, a zasada motionTrackingControl jest włączona, element sterujący śledzeniem ruchu jest widoczny, ale śledzenie jest wyłączone. Użytkownik może kliknąć element sterujący śledzeniem ruchu, aby przełączyć tę opcję. Jeśli zasada motionTracking jest ustawiona na true, gdy uprawnienia są wymagane, ale nie zostały jeszcze poproszone, pojawia się element sterujący śledzeniem ruchu, ale śledzenie jest wyłączone. Użytkownik może kliknąć element sterujący śledzeniem ruchu, aby poprosić o uprawnienia. Jeśli zasada motionTracking jest ustawiona na true, a użytkownik odmówił uprawnień, element sterujący śledzeniem ruchu jest wyłączony, a śledzenie jest wyłączone.
motionTrackingControl
opcjonalne
Typ: boolean optional
Stan włączenia/wyłączenia elementu sterującego śledzeniem 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
opcjonalne
Opcje wyświetlania elementu sterującego śledzeniem ruchu.
panControl
opcjonalne
Typ: boolean optional
Stan włączenia/wyłączenia elementu sterującego przesuwaniem.
panControlOptions
opcjonalne
Typ: PanControlOptions optional
Opcje wyświetlania elementu sterującego przesuwaniem.
pano
opcjonalne
Typ: string optional
Identyfikator panoramy, który należy ustawić podczas określania niestandardowej panoramy.
position
opcjonalne
Typ: LatLng|LatLngLiteral optional
Pozycja LatLng panoramy Street View.
pov
opcjonalne
Typ: StreetViewPov optional
Orientacja kamery, określona jako kierunek i nachylenie, dla panoramy.
scrollwheel
opcjonalne
Typ: boolean optional
Domyślnie: true
Jeśli ma wartość false, wyłącza powiększanie kółkiem myszy w Street View.
showRoadLabels
opcjonalne
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, na panoramie wyświetlane są nazwy ulic. Jeśli zasada ma wartość false, nazwy ulic nie są wyświetlane.
visible
opcjonalne
Typ: boolean optional
Jeśli true, panorama Street View jest widoczna po wczytaniu.
zoom
opcjonalne
Typ: number optional
Powiększenie panoramy określone jako liczba. Powiększenie 0 daje pole widzenia 180 stopni.
zoomControl
opcjonalne
Typ: boolean optional
Stan włączenia/wyłączenia elementu sterującego powiększeniem.
zoomControlOptions
opcjonalne
Typ: ZoomControlOptions optional
Opcje wyświetlania elementu sterującego powiększeniem.

Interfejs StreetViewAddressControlOptions

interfejs google.maps.StreetViewAddressControlOptions

Opcje renderowania elementu sterującego adresem w Street View.
position
opcjonalne
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

interfejs google.maps.PanoProviderOptions

Opcje niestandardowego dostawcy panoramy.
cors
opcjonalne
Typ: boolean optional
Jeśli ta opcja jest ustawiona, mechanizm renderowania będzie używać technologii (takich jak webgl), które działają tylko wtedy, gdy w podanych obrazach są odpowiednio ustawione nagłówki CORS. Deweloper musi prawidłowo wyświetlać obrazy w połączeniu z tą flagą, ponieważ w przeciwnym razie mogą wystąpić błędy SecurityError.

Interfejs StreetViewTileData

interfejs google.maps.StreetViewTileData

Właściwości zestawu kafelków używanego 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:
  • pano: string
  • tileZoom: number
  • tileX: number
  • tileY: number
Wartość zwracana: string
Pobiera adres URL obrazu kafelka dla określonego kafelka.
To jest metoda niestandardowa, którą musisz zaimplementować, aby dostarczać niestandardowe kafelki. Interfejs API wywołuje tę metodę, podają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.
Metoda niestandardowa musi zwracać adres URL obrazu kafelka.

Interfejs StreetViewPov

interfejs google.maps.StreetViewPov

Obiekt punktu widzenia, który określa orientację kamery w pozycji panoramy Street View. Punkt widzenia jest określany przez kierunek i nachylenie.
heading
Typ: number
Kierunek kamery w stopniach względem północy true. Północ geograficzna to 0°, wschód to 90°, południe to 180°, a zachód to 270°.
pitch
Typ: number
Pochylenie kamery w stopniach względem pojazdu Street View. Zakres wynosi od 90° (bezpośrednio w górę) do -90° (bezpośrednio w dół).

Klasa StreetViewCoverageLayer

class google.maps.StreetViewCoverageLayer extends MVCObject
library "streetView"

Warstwa, która pokazuje lokalizacje, w których dostępna jest funkcja Street View.

const {StreetViewCoverageLayer} = await google.maps.importLibrary("streetView");
StreetViewCoverageLayer
StreetViewCoverageLayer()
Parametry: brak
Tworzy nową instancję StreetViewCoverageLayer.
getMap
getMap()
Parametry: brak
Wartość zwracana: Map|null
Zwraca mapę, na której wyświetlana jest ta warstwa.
setMap
setMap(map)
Parametry:
  • map: Map optional
Wartość zwracana: undefined
Renderuje warstwę na określonej mapie. Jeśli mapa ma wartość null, warstwa zostanie usunięta.
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll