Maps

Klasa Map

Klasa google.maps.Map

Te zajęcia obejmują MVCObject.

Zadzwoń pod numer const {Map} = await google.maps.importLibrary("maps"), aby uzyskać dostęp. Zobacz biblioteki w interfejsie Maps JavaScript API.

Map
Map(mapDiv[, opts])
Parametry: 
  • mapDivHTMLElement Mapa wyświetli się w celu wypełnienia tego elementu.
  • optsMapOptions optional Opcje
Tworzy nową mapę wewnątrz danego kontenera HTML, który zwykle jest elementem DIV.
controls
Dodatkowe opcje, które można dołączyć do mapy. Aby dodać element sterujący do mapy, dodaj <div> do elementu MVCArray odpowiadającego obiektowi ControlPosition, w którym ma być on renderowany.
data
Typ:  Data
Wystąpienie Data powiązane z mapą. Dodaj cechy do tego obiektu Data, aby wyświetlać je w wygodny sposób na tej mapie.
mapTypes
Rejestr instancji MapType z identyfikatorem ciągu znaków.
overlayMapTypes
Typ:  MVCArray<MapType optional>
Dodatkowe typy map do nałożenia. Typy map nakładek są wyświetlane na górze mapy podstawowej, w której są dołączone, w kolejności, w jakiej są wymienione w tablicy overlayMapTypes (nakładki z wyższymi wartościami indeksu są wyświetlane przed nakładkami o niższych wartościach indeksu).
fitBounds
fitBounds(bounds[, padding])
Parametry: 
  • boundsLatLngBounds|LatLngBoundsLiteral Ograniczenia do wyświetlenia.
  • paddingnumber|Padding optional Dopełnienie w pikselach. Granice zostaną dopasowane do tej części mapy, która pozostaje dostępna po usunięciu dopełnienia. Wartość liczbowa powoduje to samo dopełnienie po wszystkich stronach. Podaj tutaj wartość 0, aby idempotenty dopasowania do wyników miały wartość getBounds.
Zwracana wartość: brak
Ustawia widoczny obszar tak, aby zawierał określone granice.
Uwaga: jeśli mapa jest ustawiona na display: none, funkcja fitBounds odczytuje rozmiar mapy 0 x 0, więc nie wykonuje żadnych działań. Aby zmienić widoczny obszar, gdy mapa jest ukryta, ustaw mapę na visibility: hidden, dzięki czemu element div będzie miał rzeczywisty rozmiar. W przypadku map wektorowych ta metoda ustawia przechylenie i kierunek mapy na domyślne wartości zerowe. Wywołanie tej metody może spowodować płynną animację, gdy mapa będzie przesuwać się i powiększać, aby wyrównać granice. Animacja tej metody zależy od wewnętrznej heurystyki.
getBounds
getBounds()
Parametry: brak
Wartość zwrócona:  LatLngBounds|undefined Szerokość geograficzna (szerokość długości geograficznej) widocznego obszaru.
Zwraca granice bieżącego/widocznego obszaru. Jeśli widoczna jest więcej niż jedna kopia świata, długość geograficzna mieści się w zakresie od -180 do 180 stopni (włącznie). Jeśli mapa nie została jeszcze zainicjowana lub wyśrodkowano i nie ustawiono powiększenia, wynik to undefined. W przypadku map wektorowych, w których pochylenie lub nagłówek nie są zerowe, zwrócone wartości graniczne szerokości i długości wskazują najmniejsze pole, które zawiera widoczny obszar widocznego obszaru mapy. Dokładny widoczny obszar widocznego obszaru mapy znajdziesz na stronie MapCanvasProjection.getVisibleRegion.
getCenter
getCenter()
Parametry: brak
Wartość zwrotu:  LatLng|undefined
Zwraca pozycję widoczną na środku mapy. Pamiętaj, że ten obiekt LatLng nie jest opakowany. Aby dowiedzieć się więcej, przeczytaj LatLng. Jeśli środek ani granice nie zostały ustawione, wynik to undefined.
getClickableIcons
getClickableIcons()
Parametry: brak
Wartość zwrotu:  boolean|undefined
Zwraca klikalność mapy. Ikona mapy oznacza ciekawe miejsce, nazywane też miejscem Jeśli zwrócona wartość to true, ikony na mapie można klikać.
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
Parametry: 
  • datasetIdstring
Wartość zwrotu:  FeatureLayer
Zwraca wartość FeatureLayer dla określonego parametru datasetId. Identyfikatory zbiorów danych musisz skonfigurować w konsoli Google Cloud. Jeśli identyfikator zbioru danych nie jest powiązany ze stylem mapy lub jeśli styl oparty na danych jest niedostępny (bez identyfikatora mapy, bez kafelków wektorowych, warstw stylów opartych na danych ani zbiorów danych skonfigurowanych w stylu mapy), rejestruje on błąd, a wynik FeatureLayer.isAvailable ma wartość Fałsz.
getDiv
getDiv()
Parametry: brak
Zwracana wartość:  HTMLElement element mapDiv.
getFeatureLayer
getFeatureLayer(featureType)
Parametry: 
Wartość zwrotu:  FeatureLayer
Zwraca wartość FeatureLayer konkretnej wartości FeatureType. W Google Cloud Console należy włączyć FeatureLayer. Jeśli FeatureLayer na tej mapie nie istnieje lub jeśli styl oparty na danych jest niedostępny (brak identyfikatora mapy, brak kafelków wektorowych i włączenie FeatureLayer nie jest włączone w stylu mapy), rejestrowany jest błąd, a wynik FeatureLayer.isAvailable ma wartość Fałsz.FeatureType
getHeading
getHeading()
Parametry: brak
Wartość zwrotu:  number|undefined
Zwraca nagłówek kompasu mapy. Wartość nagłówka jest mierzona w stopniach (w prawo) od kierunku kardynała na północy. Jeśli mapa nie jest jeszcze zainicjowana, wynik to undefined.
getMapCapabilities
getMapCapabilities()
Parametry: brak
Wartość zwrotu:  MapCapabilities
Informuje o obecnych możliwościach mapy na podstawie podanego identyfikatora mapy.
getMapTypeId
getMapTypeId()
Parametry: brak
Wartość zwrotu:  MapTypeId|string|undefined
getProjection
getProjection()
Parametry: brak
Wartość zwrotu:  Projection|undefined
Zwraca aktualną wartość Projection. Jeśli mapa nie jest jeszcze zainicjowana, wynik to undefined. Posłuchaj zdarzenia projection_changed i sprawdź jego wartość, aby upewnić się, że nie jest to undefined.
getRenderingType
getRenderingType()
Parametry: brak
Wartość zwrotu:  RenderingType
Zwraca bieżący typ renderowania mapy.
getStreetView
getStreetView()
Parametry: brak
Wartość zwrócona:  StreetViewPanorama panorama powiązana z mapą.
Zwraca domyślną wartość StreetViewPanorama powiązaną z mapą, która może być domyślną panoramą umieszczoną na mapie lub panoramą ustawioną za pomocą setStreetView(). Zmiany wartości streetViewControl na mapie zostaną odzwierciedlone w widoku takiej wiążącej panoramy.
getTilt
getTilt()
Parametry: brak
Wartość zwrotu:  number|undefined
Zwraca bieżący kąt położenia mapy w stopniach od platformy widokowej do platformy. W przypadku map rastrowych wynikiem będzie 0 w przypadku zdjęć zrobionych bezpośrednio nad głową i 45 w przypadku zdjęć 45°. Ta metoda nie zwraca wartości określonej przez zasadę setTilt. Więcej informacji: setTilt.
getZoom
getZoom()
Parametry: brak
Wartość zwrotu:  number|undefined
Zwraca powiększenie mapy. Jeśli powiększenie nie zostało ustawione, wynik to undefined.
moveCamera
moveCamera(cameraOptions)
Parametry: 
Zwracana wartość: brak
Od razu ustaw kamerę na docelowych opcjach kamery, bez animacji.
panBy
panBy(x, y)
Parametry: 
  • xnumber liczba pikseli do przesunięcia mapy w kierunku x.
  • ynumber liczba pikseli do przesunięcia mapy w kierunku Y.
Zwracana wartość: brak
Zmienia środek mapy przez podaną odległość w pikselach. Jeśli odległość jest mniejsza niż szerokość i wysokość mapy, przejście będzie płynnie animowane. Pamiętaj, że system współrzędnych mapy zwiększa się z zachodu na wschód (wartości x), a z północy na południe (wartości y).
panTo
panTo(latLng)
Parametry: 
Zwracana wartość: brak
Zmienia środek mapy na podany LatLng. Jeśli zmiana jest mniejsza niż szerokość i wysokość mapy, przejście będzie płynnie animowane.
panToBounds
panToBounds(latLngBounds[, padding])
Parametry: 
  • latLngBoundsLatLngBounds|LatLngBoundsLiteral Granice, do których możesz przesunąć mapę.
  • paddingnumber|Padding optional Dopełnienie w pikselach. Wartość liczbowa powoduje to samo dopełnienie po wszystkich stronach. Wartość domyślna to 0.
Zwracana wartość: brak
Przesuwa mapę o minimalną minimalną wartość, która obejmuje LatLngBounds. Nie ma gwarancji, gdzie na mapie będą znajdować się granice, poza tym, że mapa będzie przesunięta, aby pokazać jak najwięcej jej granic wewnątrz {currentMapSizeInPx} - {padding}. Zarówno mapy rastrowe, jak i wektorowe nie zmieniają powiększenia, pochylenia ani nagłówka.
setCenter
setCenter(latlng)
Parametry: 
Zwracana wartość: brak
setClickableIcons
setClickableIcons(value)
Parametry: 
  • valueboolean
Zwracana wartość: brak
Określa, czy ikony mapy można klikać. Ikona mapy oznacza ciekawe miejsce, nazywane też miejscem Aby wyłączyć klikalność ikon mapy, przekaż do tej metody wartość false.
setHeading
setHeading(heading)
Parametry: 
  • headingnumber
Zwracana wartość: brak
Określa na kompasie kierunek, w którym mierzono stopnie w kierunku północnym. W przypadku map rastrowych ta metoda dotyczy tylko zdjęć lotniczych.
setMapTypeId
setMapTypeId(mapTypeId)
Parametry: 
Zwracana wartość: brak
setOptions
setOptions(options)
Parametry: 
Zwracana wartość: brak
setStreetView
setStreetView(panorama)
Parametry: 
Zwracana wartość: brak
Przypisuje StreetViewPanorama do mapy. Ta panorama zastępuje domyślną właściwość StreetViewPanorama, co umożliwia powiązanie mapy z panoramą zewnętrzną spoza mapy. Ustawienie panoramy na null powoduje powiązanie domyślnej umieszczonej panoramy z mapą.
setTilt
setTilt(tilt)
Parametry: 
  • tiltnumber
Zwracana wartość: brak
W przypadku map wektorowych określa kąt występowania mapy. Dozwolone wartości są ograniczone w zależności od poziomu powiększenia mapy. W przypadku map rastrowych kontroluje automatyczne przełączanie pod kątem kąta intensywności mapy. Dozwolone są tylko wartości 0 i 45. setTilt(0) powoduje, że mapa zawsze używa widoku z góry 0°, niezależnie od poziomu powiększenia i widocznego obszaru. setTilt(45) powoduje, że kąt nachylenia jest automatycznie zmieniany na 45°, gdy dostępne jest ustawienie 45°, gdy dostępny jest bieżący poziom powiększenia oraz widoczny obszar, i z powrotem ustawiam 0, jeśli obraz pod kątem 45° nie jest dostępny (jest to ustawienie domyślne). Zdjęcia pod kątem 45° są dostępne tylko dla typów map satellite i hybrid, w niektórych lokalizacjach oraz na niektórych poziomach powiększenia. Uwaga: getTilt zwraca bieżący kąt nachylenia, a nie wartość ustawioną w setTilt. getTilt i setTilt odnoszą się do różnych rzeczy, dlatego nie bind() używaj właściwości tilt. Może to mieć nieprzewidywalne skutki.
setZoom
setZoom(zoom)
Parametry: 
  • zoomnumberWiększe wartości powiększenia oznaczają wyższą rozdzielczość.
Zwracana wartość: brak
Ustawia powiększenie mapy.
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
DEMO_MAP_ID Identyfikator mapy, którego można używać w przykładach kodu wymagających identyfikatora mapy. Ten identyfikator mapy nie jest przeznaczony do użytku w aplikacjach produkcyjnych i nie można go używać w przypadku funkcji, które wymagają konfiguracji chmury (np. Cloud Styling).
bounds_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane po zmianie granic widocznego obszaru.
center_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości centrum mapy.
click
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy użytkownik kliknie mapę. Zwrócone jest zdarzenie MapMouseEvent z właściwościami klikniętej lokalizacji, chyba że została kliknięta ikona miejsca. W takim przypadku zwracana jest ikona IconMouseEvent z identyfikatorem miejsca. Wskaźniki IconMouseEvent i MapMouseEvent są identyczne, z tą różnicą, że IconMouseEvent ma pole identyfikatora miejsca. Jeśli identyfikator miejsca nie ma znaczenia, zdarzenie może być zawsze traktowane jako zdarzenie MapMouse. Zdarzenie kliknięcia nie jest wywoływane, gdy użytkownik kliknie znacznik lub okno informacyjne.
contextmenu
function(event)
Argumenty: 
To zdarzenie jest wywoływane po wywołaniu zdarzenia menu kontekstowego DOM w kontenerze mapy.
dblclick
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy użytkownik kliknie dwukrotnie mapę. Pamiętaj, że zdarzenie kliknięcia jest czasem uruchamiane raz, a nawet dwukrotnie, tuż przed tym.
drag
function()
Argumenty: brak
To zdarzenie jest wywoływane wielokrotnie, gdy użytkownik przeciąga mapę.
dragend
function()
Argumenty: brak
To zdarzenie jest wywoływane, gdy użytkownik przestaje przeciągać mapę.
dragstart
function()
Argumenty: brak
To zdarzenie jest wywoływane, kiedy użytkownik zaczyna przeciągać mapę.
heading_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości nagłówka mapy.
idle
function()
Argumenty: brak
To zdarzenie jest wywoływane, gdy mapa jest nieaktywny po przesunięciu lub powiększeniu.
isfractionalzoomenabled_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości isFractionalZoomEnabled.
mapcapabilities_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane po zmianie możliwości mapy.
maptypeid_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości mapTypeId.
mousemove
function(event)
Argumenty: 
To zdarzenie jest wywoływane za każdym razem, gdy użytkownik przesunie kursor myszy na kontener mapy.
mouseout
function(event)
Argumenty: 
To zdarzenie jest wywoływane po wyjściu przez użytkownika z kontenera mapy.
mouseover
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy użytkownik przechodzi do kontenera mapy.
projection_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane po zmianie prognozy.
renderingtype_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane po zmianie ustawienia renderType.
tilesloaded
function()
Argumenty: brak
To zdarzenie jest wywoływane po zakończeniu wczytywania widocznych kafelków.
tilt_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości przechylenia mapy.
zoom_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości powiększenia mapy.
rightclick
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy użytkownik kliknie na mapie prawym przyciskiem myszy.

Interfejs MapOptions

google.maps.MapOptions interfejs

Obiekt MapOptions służący do definiowania właściwości, które można ustawić w Mapach.

backgroundColor optional
Typ:  string optional
Kolor używany do tła elementu div mapy. Jest widoczny, gdy kafelki nie zostały jeszcze wczytane podczas przesuwania użytkownika. Ta opcja jest dostępna tylko przy inicjowaniu mapy.
center optional
Typ:  LatLng|LatLngLiteral optional
Początkowe centrum mapy.
clickableIcons optional
Typ:  boolean optional
Domyślne: true
Gdy ikona false nie jest klikalna, nie można jej kliknąć. Ikona mapy oznacza ciekawe miejsce, nazywane też miejscem
controlSize optional
Typ:  number optional
Rozmiar pikseli sterujących elementów sterujących widocznych na mapie. Tę wartość należy podać bezpośrednio podczas tworzenia mapy. Później możesz zmienić stan elementów sterujących na undefined. Te ustawienia dotyczą tylko elementów sterujących interfejsu API Map Google. Nie skaluje niestandardowych elementów sterujących utworzonych przez dewelopera.
disableDefaultUI optional
Typ:  boolean optional
Włącza/wyłącza wszystkie domyślne przyciski interfejsu. Można je zastępować pojedynczo. Nie wyłącza opcji klawiatury, które są niezależnie kontrolowane przez opcję MapOptions.keyboardShortcuts. Nie wyłącza sterowania gestami, które są kontrolowane osobno przez opcję MapOptions.gestureHandling.
disableDoubleClickZoom optional
Typ:  boolean optional
Włącza lub wyłącza powiększenie i wyśrodkowowanie po dwukrotnym kliknięciu. Ta opcja jest domyślnie włączona.

Uwaga: ta właściwość nie jest zalecana. Aby wyłączyć powiększenie dwukrotnego kliknięcia, możesz użyć właściwości gestureHandling i ustawić wartość "none".

draggable optional
Typ:  boolean optional
Jeśli zasada false ma wartość, uniemożliwia przeciąganie mapy. Przeciąganie jest domyślnie włączone.
draggableCursor optional
Typ:  string optional
Nazwa lub adres URL kursora wyświetlane po najechaniu kursorem na mapę. Ta właściwość do zmiany ikony używa atrybutu cursor CSS. Podobnie jak w przypadku właściwości CSS, musisz określić co najmniej 1 kursor kreacji zastępczej, który nie jest adresem URL. Przykład: draggableCursor: 'url(http://www.example.com/icon.png), auto;'.
draggingCursor optional
Typ:  string optional
Nazwa lub adres URL kursora, które będą się wyświetlać podczas przeciągania mapy. Ta właściwość do zmiany ikony używa atrybutu cursor CSS. Podobnie jak w przypadku właściwości CSS, musisz określić co najmniej 1 kursor kreacji zastępczej, który nie jest adresem URL. Przykład: draggingCursor: 'url(http://www.example.com/icon.png), auto;'.
fullscreenControl optional
Typ:  boolean optional
Włączony/wyłączony element sterujący trybem pełnoekranowym.
fullscreenControlOptions optional
Typ:  FullscreenControlOptions optional
Opcje wyświetlania elementu sterującego na pełnym ekranie.
gestureHandling optional
Typ:  string optional
To ustawienie kontroluje sposób, w jaki interfejs API obsługuje gesty na mapie. Dozwolone wartości:
  • "cooperative": zdarzenia przewijania i dotknięcia ekranu jednym palcem przewijają stronę i nie powiększają ani nie przesuwają mapy. Gesty dotykowe 2 palcami przesuwają i powiększają mapę. Zdarzenia przewijania za pomocą klawisza Ctrl lub ⌘ powodują powiększenie mapy.
    W tym trybie mapa współpracuje ze stroną.
  • "greedy": wszystkie gesty dotykowe i zdarzenia przewijania przewijają lub powiększają mapę.
  • "none": nie można przesuwać ani powiększać mapy za pomocą gestów.
  • "auto": (domyślna) obsługa gestów odbywa się w trybie współpracy lub zachłanności, w zależności od tego, czy stronę można przewijać, czy też w elemencie iframe.
heading optional
Typ:  number optional
Nagłówek zdjęć lotniczych w stopniach, mierzony w kierunku zgodnym z ruchem wskazówek zegara na północ. Nagłówki są przyciągane do najbliższego dostępnego kąta, dla którego są dostępne zdjęcia.
isFractionalZoomEnabled optional
Typ:  boolean optional
Domyślnie: true w przypadku map wektorowych i false w przypadku map rastrowych
Określa, czy na mapie powinny być dozwolone ułamkowe poziomy powiększenia. Posłuchaj ustawienia isfractionalzoomenabled_changed, żeby dowiedzieć się, kiedy ustawiono ustawienie domyślne.
keyboardShortcuts optional
Typ:  boolean optional
Jeśli zasada false uniemożliwia kontrolowanie mapy za pomocą klawiatury. Skróty klawiszowe są domyślnie włączone.
mapId optional
Typ:  string optional
Identyfikator mapy. Po utworzeniu instancji mapy nie można ustawić ani zmienić tego parametru.
mapTypeControl optional
Typ:  boolean optional
Początkowy włączony lub wyłączony stan sterowania mapą.
mapTypeControlOptions optional
Typ:  MapTypeControlOptions optional
Początkowe opcje wyświetlania elementów sterujących Mapą.
mapTypeId optional
Typ:  MapTypeId|string optional
Początkowy parametr mapTypeId. Domyślna wartość to ROADMAP.
maxZoom optional
Typ:  number optional
Maksymalny poziom powiększenia, który będzie wyświetlany na mapie. Jeśli pominiesz ten parametr lub ustawisz wartość null, zostanie użyte maksymalne powiększenie bieżącego typu mapy. Prawidłowe wartości powiększenia to liczby od zera do obsługiwanego maksymalnego poziomu powiększenia.
minZoom optional
Typ:  number optional
Minimalny poziom powiększenia, który będzie wyświetlany na mapie. Jeśli pominiesz ten parametr lub ustawisz wartość null, zostanie użyte minimalne powiększenie z bieżącego typu mapy. Prawidłowe wartości powiększenia to liczby od zera do obsługiwanego maksymalnego poziomu powiększenia.
noClear optional
Typ:  boolean optional
Jeśli true, nie czyść zawartości elementu div mapy.
panControl optional
Typ:  boolean optional
Włączony lub wyłączony element sterujący przesuwaniem.

Uwaga: element sterujący „Przesuwanie” jest niedostępny w nowym zestawie elementów sterujących wprowadzonych w wersji 3.22 interfejsu API Map Google w języku JavaScript. Podczas korzystania z wersji 3.22 i 3.23 możesz używać wcześniejszego zestawu elementów sterujących zamiast nowych, dzięki czemu element sterujący przesuwaniem będzie dostępny jako część starego zestawu sterowania. Zobacz Nowości w wersji 3.22.

panControlOptions optional
Typ:  PanControlOptions optional
Opcje wyświetlania elementu sterującego przesuwaniem.

Uwaga: element sterujący „Przesuwanie” jest niedostępny w nowym zestawie elementów sterujących wprowadzonych w wersji 3.22 interfejsu API Map Google w języku JavaScript. Podczas korzystania z wersji 3.22 i 3.23 możesz używać wcześniejszego zestawu elementów sterujących zamiast nowych, dzięki czemu element sterujący przesuwaniem będzie dostępny jako część starego zestawu sterowania. Zobacz Nowości w wersji 3.22.

restriction optional
Typ:  MapRestriction optional
Określa granicę, która ogranicza obszar mapy dostępny dla użytkowników. Po ustawieniu tego ustawienia użytkownik może przesuwać i powiększać tylko widok, gdy kamera wykracza poza granice.
rotateControl optional
Typ:  boolean optional
Włączono/wyłączono ustawienie rotacji.
rotateControlOptions optional
Typ:  RotateControlOptions optional
Opcje wyświetlania elementu sterującego obracaniem.
scaleControl optional
Typ:  boolean optional
Początkowy włączony lub wyłączony stan wagi.
scaleControlOptions optional
Typ:  ScaleControlOptions optional
Początkowe opcje wyświetlania wagi.
scrollwheel optional
Typ:  boolean optional
Jeśli zasada false, wyłącza powiększenie mapy, używając kółka myszy. Kółko przewijania jest domyślnie włączone.

Uwaga: ta właściwość nie jest zalecana. Aby wyłączyć powiększenie za pomocą kółka myszy, użyj właściwości gestureHandling i ustaw jej wartość na "cooperative" lub "none".

streetView optional
Typ:  StreetViewPanorama optional
StreetViewPanorama, który wyświetla się, gdy użytkownik Pegmana Street View zostaje usunięty na mapie. Jeśli nie podasz panoramy, po kliknięciu Pegmana na mapie wyświetli się domyślna wartość StreetViewPanorama.div
streetViewControl optional
Typ:  boolean optional
Początkowy włączony lub wyłączony stan Pegmana w Street View. Ten element sterujący jest częścią domyślnego interfejsu i powinien być ustawiony na false podczas wyświetlania typu mapy, na której nie powinna być wyświetlana nakładka widoku ulicy (np. typu mapy innego niż Earth).
streetViewControlOptions optional
Typ:  StreetViewControlOptions optional
Początkowe opcje wyświetlania elementu sterującego Pegmanem w Street View.
styles optional
Typ:  Array<MapTypeStyle> optional
Style stosowane do każdego domyślnego typu mapy. Pamiętaj, że w trybach satellite/hybrid i terrain te style będą stosowane tylko do etykiet i geometrii.
tilt optional
Typ:  number optional
W przypadku map wektorowych określa kąt występowania mapy. Dozwolone wartości są ograniczone w zależności od poziomu powiększenia mapy. W przypadku map rastrowych kontroluje automatyczne przełączanie pod kątem kąta intensywności mapy. Dozwolone są tylko wartości 0 i 45. Wartość 0 powoduje, że mapa zawsze używa widoku 0° z góry niezależnie od poziomu powiększenia i widocznego obszaru. Wartość 45 powoduje, że kąt nachylenia jest automatycznie zmieniany na 45, gdy dostępne są zdjęcia pod kątem 45°, gdy dostępny jest bieżący poziom powiększenia oraz widoczny obszar, i z powrotem ustawia się 0, jeśli obraz 45° nie jest dostępny (jest to ustawienie domyślne). Zdjęcia pod kątem 45° są dostępne tylko dla typów map satellite i hybrid, w niektórych lokalizacjach oraz na niektórych poziomach powiększenia. Uwaga: getTilt zwraca bieżący kąt nachylenia, a nie wartość określoną przez tę opcję. Parametr getTilt i ta opcja odnoszą się do różnych rzeczy, dlatego nie bind() używaj właściwości tilt. Takie działanie może mieć nieprzewidywalne skutki.
zoom optional
Typ:  number optional
Początkowy poziom powiększenia mapy. Prawidłowe wartości powiększenia to liczby od zera do obsługiwanego maksymalnego poziomu powiększenia. Większe wartości powiększenia oznaczają wyższą rozdzielczość.
zoomControl optional
Typ:  boolean optional
Włączony/wyłączony stan elementu sterującego powiększeniem.
zoomControlOptions optional
Typ:  ZoomControlOptions optional
Opcje wyświetlania elementu sterującego powiększeniem.

Klasa MapElement

Klasa google.maps.MapElement

MapElement to podklasa HTMLElement do renderowania map. Po wczytaniu biblioteki maps mapę można utworzyć w kodzie HTML. Na przykład:
<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID"></gmp-map>

Wewnętrznie używa elementu Map, który jest dostępny we właściwości innerMap.

Element niestandardowy:
<gmp-map center="lat,lng" map-id="string" zoom="number"></gmp-map>

Te zajęcia obejmują HTMLElement.

Te zajęcia implementują MapElementOptions.

Zadzwoń pod numer const {MapElement} = await google.maps.importLibrary("maps"), aby uzyskać dostęp. Zobacz biblioteki w interfejsie Maps JavaScript API.

center
Typ:  LatLng|LatLngLiteral optional
Atrybut HTML:
  • <gmp-map center="lat,lng"></gmp-map>
innerMap
Typ:  Map
Odwołanie do metody Map, której MapMap używa wewnętrznie.
mapId
Typ:  string optional
Atrybut HTML:
  • <gmp-map map-id="string"></gmp-map>
zoom
Typ:  number optional
Atrybut HTML:
  • <gmp-map zoom="number"></gmp-map>
BetaaddEventListener
addEventListener(type, listener[, options])
Parametry: 
  • typestring wielkość liter w nagłówku oznacza typ zdarzenia, które ma być nasłuchiwane.
  • listenerEventListener|EventListenerObject obiekt, który otrzymuje powiadomienia. Musi to być funkcja lub obiekt z metodą handleEvent
  • optionsboolean|AddEventListenerOptions optional Zobacz opcje. Zdarzenia niestandardowe obsługują tylko zdarzenia capture i passive.
Wartość zwrotu:  void
Konfiguruje funkcję, która będzie wywoływana za każdym razem, gdy określone zdarzenie zostanie dostarczone do celu. Zobacz addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametry: 
  • typestring to ciąg znaków określający typ zdarzenia, dla którego chcesz usunąć detektor.
  • listenerEventListener|EventListenerObject odbiornik zdarzenia modułu obsługi zdarzeń, które chcesz usunąć z celu zdarzenia
  • optionsboolean|EventListenerOptions optional Zobacz opcje
Wartość zwrotu:  void
Usuwa odbiornik zarejestrowany wcześniej w usłudze addEventListener z poziomu elementu docelowego. Zobacz removeEventListener

Interfejs MapElementOptions

google.maps.MapElementOptions interfejs

Obiekt MapElementOptions używany do definiowania właściwości, które można ustawić w MapElement.

center optional
Typ:  LatLng|LatLngLiteral optional
Początkowe centrum mapy.
mapId optional
Typ:  string optional
Identyfikator mapy. Po utworzeniu instancji mapy nie można ustawić ani zmienić tego parametru.
zoom optional
Typ:  number optional
Początkowy poziom powiększenia mapy. Prawidłowe wartości powiększenia to liczby od zera do obsługiwanego maksymalnego poziomu powiększenia. Większe wartości powiększenia oznaczają wyższą rozdzielczość.

Interfejs MapTypeStyle

google.maps.MapTypeStyle interfejs

MapTypeStyle to zbiór selektorów i stylów określających styl mapy. Selektory określają elementy mapy lub elementy, których ma dotyczyć zmiana, a style – sposób, w jaki mają być modyfikowane. Szczegółowe informacje znajdziesz w przewodniku po stylu.

stylers
Typ:  Array<Object>
Reguły stylu, które mają być stosowane do wybranych elementów i elementów mapy. Reguły są stosowane w kolejności, którą określisz w tej tablicy. Wytyczne dotyczące stosowania i dozwolonych wartości znajdziesz w przewodniku po stylu.
elementType optional
Typ:  string optional
Element, do którego należy zastosować styl. Element to wizualny aspekt obiektu na mapie. Przykłady: etykieta, ikona, kreska lub wypełnienie zastosowane do geometrii. Opcjonalnie. Jeśli nie określono właściwości elementType, przyjmuje się wartość 'all'. Szczegółowe informacje o wykorzystaniu i dozwolonych wartościach znajdziesz w dokumentacji stylu.
featureType optional
Typ:  string optional
Obiekt lub grupa cech, do których należy zastosować styl. Opcjonalnie. Jeśli nie określono właściwości featureType, przyjmuje się wartość 'all'. Szczegółowe informacje o wykorzystaniu i dozwolonych wartościach znajdziesz w dokumentacji stylu.

Interfejs MapMouseEvent

google.maps.MapMouseEvent interfejs

Ten obiekt jest zwracany z różnych zdarzeń myszy na mapie i nakładki oraz zawiera wszystkie pola widoczne poniżej.

domEvent
Odpowiednie natywne zdarzenie DOM. Deweloperzy nie powinni polegać na zdefiniowanych i spójnych właściwościach target, currentTarget, relatedTarget i path. Deweloperzy nie powinni również polegać na strukturze DOM wewnętrznej implementacji interfejsu API Map Google. Ze względu na wewnętrzne mapowanie zdarzeń domEvent może mieć semantykę innego typu niż MapMouseEvent (np. domEvent „kliknięcie” może mieć typ domEvent domEvent).MapMouseEventKeyboardEvent
latLng optional
Typ:  LatLng optional
Szerokość i szerokość geograficzna, która znajdowała się pod kursorem w czasie wystąpienia zdarzenia.
stop
stop()
Parametry: brak
Wartość zwrotu:  void
Uniemożliwia to dalszemu rozpowszechnieniu tego zdarzenia.

Interfejs IconMouseEvent

google.maps.IconMouseEvent interfejs

Ten obiekt jest wysyłany, gdy użytkownik kliknie ikonę na mapie. Identyfikator miejsca tego miejsca jest przechowywany w elemencieplaceId. Aby zapobiec wyświetlaniu domyślnego okna informacyjnego, wywołaj metodę stop() tego zdarzenia, aby zapobiec jego rozpowszechnieniu. Więcej informacji o identyfikatorach miejsc znajdziesz w przewodniku dla programistów korzystających z interfejsu Places API.

Ten interfejs jest rozszerzany do MapMouseEvent.

placeId optional
Typ:  string optional
Identyfikator klikniętego miejsca. Ten identyfikator miejsca może służyć do wysyłania zapytań o więcej informacji o klikniętym obiekcie.

Więcej informacji o identyfikatorach miejsc znajdziesz w przewodniku dla programistów korzystających z interfejsu Places API.

Dziedziczone: domEvent, latLng
Dziedziczone: stop

Stałe MapTypeId

google.maps.MapTypeId stałe

Identyfikatory często używanych typów obiektów MapType. Możesz je określać według wartości lub używając nazwy stałej. na przykład 'satellite' lub google.maps.MapTypeId.SATELLITE.

Zadzwoń pod numer const {MapTypeId} = await google.maps.importLibrary("maps"), aby uzyskać dostęp. Zobacz biblioteki w interfejsie Maps JavaScript API.

HYBRID Ten typ mapy pokazuje na zdjęciach satelitarnych przezroczystą warstwę głównych ulic.
ROADMAP Ten typ mapy wyświetla normalną mapę ulic.
SATELLITE Ten typ mapy wyświetla zdjęcia satelitarne.
TERRAIN Ten typ mapy wyświetla mapy z elementami fizycznymi, takimi jak teren i roślinność.

Klasa MapTypeRegistry

Klasa google.maps.MapTypeRegistry

Rejestr instancji MapType z kluczem IDType.

Te zajęcia obejmują MVCObject.

Zadzwoń pod numer const {MapTypeRegistry} = await google.maps.importLibrary("maps"), aby uzyskać dostęp. Zobacz biblioteki w interfejsie Maps JavaScript API.

MapTypeRegistry
MapTypeRegistry()
Parametry: brak
MapTypeRegistry zawiera zbiór dostępnych typów map, które można wykorzystać na mapie. Na przykład interfejs API sprawdza to rejestry, dostarczając listę typów map dostępnych w opcjach.
set
set(id, mapType)
Parametry: 
  • idstring identyfikator typu mapy, który należy dodać do rejestru.
  • mapTypeMapType|* obiekt MapType, który chcesz dodać do rejestru.
Zwracana wartość: brak
Ustawia w rejestrze powiązanie przekazywanego identyfikatora ciągu znaków z przekazanym typem mapy.
Dziedziczone: addListener, bindTo, get, notify, setValues, unbind, unbindAll

Interfejs MapRestriction

google.maps.MapRestriction interfejs

Ograniczenie, które można zastosować do mapy. Widoczny obszar mapy nie przekroczy tych ograniczeń.

latLngBounds
Po ustawieniu użytkownik może tylko przesuwać i powiększać widok w określonych granicach. Ograniczenia mogą ograniczać długość i szerokość geograficzną lub tylko szerokość geograficzną. W przypadku granic szerokości geograficznej użyj długości geograficznej zachodniej i wschodniej wynoszącej odpowiednio -180 i 180, na przykład latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}.
strictBounds optional
Typ:  boolean optional
Ograniczenia mogą być bardziej restrykcyjne, jeśli flaga strictBounds ma wartość true. Zmniejsza to odległość, jaką użytkownik może pomniejszyć, zapewniając, że wszystkie elementy znajdujące się poza granicami będą ukryte. Wartość domyślna to false, co oznacza, że użytkownik może pomniejszać widok, aż cały obszar ograniczony, włącznie z obszarami spoza niego.

TrafficLayer

Klasa google.maps.TrafficLayer

Warstwa ruchu.

Te zajęcia obejmują MVCObject.

Zadzwoń pod numer const {TrafficLayer} = await google.maps.importLibrary("maps"), aby uzyskać dostęp. Zobacz biblioteki w interfejsie Maps JavaScript API.

TrafficLayer
TrafficLayer([opts])
Parametry: 
Warstwa pokazująca aktualny ruch drogowy.
getMap
getMap()
Parametry: brak
Wartość zwrotu:  Map
Zwraca mapę, na której jest wyświetlana ta warstwa.
setMap
setMap(map)
Parametry: 
Zwracana wartość: brak
Renderuje warstwę na określonej mapie. Jeśli mapa ma wartość null, warstwa zostanie usunięta.
setOptions
setOptions(options)
Parametry: 
Zwracana wartość: brak
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Interfejs TrafficLayerOptions

google.maps.TrafficLayerOptions interfejs

Obiekt TrafficLayerOptions używany do definiowania właściwości, które można ustawić w warstwie TrafficLayer.

autoRefresh optional
Typ:  boolean optional
Domyślne: true
Określa, czy warstwa natężenia ruchu ma być odświeżana automatycznie po zaktualizowaniu informacji.
map optional
Typ:  Map optional
Mapa, na której wyświetlana jest warstwa natężenia ruchu.

Klasa TransitLayer

Klasa google.maps.TransitLayer

Warstwa transportu publicznego.

Te zajęcia obejmują MVCObject.

Zadzwoń pod numer const {TransitLayer} = await google.maps.importLibrary("maps"), aby uzyskać dostęp. Zobacz biblioteki w interfejsie Maps JavaScript API.

TransitLayer
TransitLayer()
Parametry: brak
Warstwa, w której wyświetlane są linie transportu publicznego.
getMap
getMap()
Parametry: brak
Wartość zwrotu:  Map
Zwraca mapę, na której jest wyświetlana ta warstwa.
setMap
setMap(map)
Parametry: 
Zwracana wartość: brak
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

zajęcia rowerowe

Klasa google.maps.BicyclingLayer

Warstwa pokazująca ścieżki i ścieżki rowerowe.

Te zajęcia obejmują MVCObject.

Zadzwoń pod numer const {BicyclingLayer} = await google.maps.importLibrary("maps"), aby uzyskać dostęp. Zobacz biblioteki w interfejsie Maps JavaScript API.

BicyclingLayer
BicyclingLayer()
Parametry: brak
Warstwa, która pokazuje pasy i ścieżki rowerowe, przesuwa szlaki w dół.
getMap
getMap()
Parametry: brak
Wartość zwrotu:  Map
Zwraca mapę, na której jest wyświetlana ta warstwa.
setMap
setMap(map)
Parametry: 
Zwracana wartość: brak
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

Opcje aparatu

google.maps.CameraOptions interfejs

Służy do ustawiania opcji aparatu na mapie.

center optional
Typ:  LatLngLiteral|LatLng optional
heading optional
Typ:  number optional
tilt optional
Typ:  number optional
zoom optional
Typ:  number optional

Interfejs VisibleRegion

google.maps.VisibleRegion interfejs

Zawiera 4 punkty określające wielostronny wielokąt stanowiący widoczny obszar mapy. Na mapie wektorowej wielokąt może być trapezem, a nie prostokątem, gdy mapa wektorowa ma przechylenie.

farLeft
Typ:  LatLng
farRight
Typ:  LatLng
latLngBounds
Najmniejsza ramka ograniczająca z widocznym regionem.
nearLeft
Typ:  LatLng
nearRight
Typ:  LatLng

Stałe renderType

google.maps.RenderingType stałe

Zadzwoń pod numer const {RenderingType} = await google.maps.importLibrary("maps"), aby uzyskać dostęp. Zobacz biblioteki w interfejsie Maps JavaScript API.

RASTER Wskazuje, że mapa jest mapą rastrową.
UNINITIALIZED Wskazuje, że nie wiadomo jeszcze, czy mapa jest wektorowa, czy rastrowa, bo nie została jeszcze zainicjowana.
VECTOR Wskazuje, że mapa jest wektorową.

Interfejs MapCapabilities

google.maps.MapCapabilities interfejs

Obiekt zawierający podsumowanie dostępnych możliwości mapy. Nie musi to oznaczać, że odpowiednie moduły zostały wczytane lub zainicjowane, ale że bieżąca mapa ma uprawnienia do używania tych interfejsów API. Listę możliwości znajdziesz we właściwościach.

isAdvancedMarkersAvailable optional
Typ:  boolean optional
Jeśli ma wartość true (prawda), ta mapa jest skonfigurowana prawidłowo, aby można było używać znaczników zaawansowanych. Pamiętaj, że musisz jeszcze zaimportować bibliotekę marker, aby używać znaczników zaawansowanych. Więcej informacji znajdziesz na stronie https://goo.gle/gmp-isAdvancedMarkersAvailable.
isDataDrivenStylingAvailable optional
Typ:  boolean optional
Jeśli ma wartość true (prawda), ta mapa jest odpowiednio skonfigurowana i umożliwia korzystanie ze stylu opartego na danych w przypadku co najmniej 1 warstwy cech. Więcej informacji znajdziesz na stronach https://goo.gle/gmp-data-powered-styling i https://goo.gle/gmp-FeatureLayerIsAvailable.