Maps

Klasa Map

google.maps.Map zajęcia

Ta klasa stanowi rozszerzenie zajęć MVCObject.

Aby uzyskać dostęp, zadzwoń pod numer const {Map} = await google.maps.importLibrary("maps"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
Map
Map(mapDiv[, opts])
Parametry: 
  • mapDiv:  HTMLElement mapa zostanie wyrenderowana tak, aby wypełnić ten element.
  • opts:  MapOptions optional – opcje
Tworzy nową mapę wewnątrz danego kontenera HTML, który zwykle jest elementem DIV.
DEMO_MAP_ID Identyfikator mapy, którego można użyć w przykładowym kodzie wymagających identyfikatora mapy. Ten identyfikator mapy nie jest przeznaczony do aplikacji produkcyjnych i nie można go używać w przypadku funkcji, które wymagają konfiguracji w chmurze (takich jak Cloud Styleing).
controls
Dodatkowe elementy sterujące, które można dołączyć do mapy. Aby dodać element sterujący do mapy, dodaj <div> elementu sterującego do sekcji MVCArray odpowiadającej elementowi ControlPosition, w którym powinien być renderowany.
data
Typ:  Data
Wystąpienie Data, powiązane z mapą. Dodaj obiekty do tego obiektu Data, aby wygodnie je wyświetlać na tej mapie.
mapTypes
Rejestr z MapType instancjami według identyfikatora ciągu znaków.
overlayMapTypes
Typ:  MVCArray<MapType optional>
Dodatkowe typy map do nałożenia. Typy nakładek map są wyświetlane na górze mapy podstawowej, do których są dołączone, w kolejności, w jakiej występują w tablicy overlayMapTypes (nakładki z wyższymi wartościami indeksu są wyświetlane przed nakładkami z niższymi wartościami indeksu).
fitBounds
fitBounds(bounds[, padding])
Parametry: 
  • bounds:  LatLngBounds|LatLngBoundsLiteral Ograniczenia do pokazania.
  • padding:  number|Padding optional Dopełnienie w pikselach. Granice zostaną dopasowane do części mapy, która pozostanie po usunięciu dopełnienia. Wartość liczbowa spowoduje takie samo dopełnienie po wszystkich 4 stronach. Podaj 0, aby utworzyć idempotentną wartość typu fitBounds w wyniku getBounds.
Zwracana wartość: brak
Ustawia widoczny obszar tak, aby zawierał podane granice.
Uwaga: gdy mapa jest ustawiona na display: none, funkcja fitBounds odczytuje rozmiar mapy jako 0 x 0 i nie wykonuje żadnych działań. Aby zmienić widoczny obszar, gdy mapa jest ukryta, ustaw mapę na visibility: hidden. Pozwoli to sprawdzić, czy element div ma rzeczywisty rozmiar. W przypadku map wektorowych ta metoda ustawia domyślne 0 wartości przechylenia i kierunku mapy. Wywołanie tej metody może spowodować płynną animację podczas przesuwania i powiększania mapy w celu dopasowania do granic. Występowanie tej metody zależy od wewnętrznej heurystyki.
getBounds
getBounds()
Parametry: brak
Zwracana wartość:  LatLngBounds|undefined Granice szerokości/długości bieżącego widocznego obszaru.
Zwraca granice szerokości i długości geograficznej bieżącego widocznego obszaru. Jeśli widać więcej niż 1 kopię świata, granica długości geograficznej wynosi od -180 do 180 stopni włącznie. Jeśli mapa nie została jeszcze zainicjowana lub nie została wyśrodkowana i powiększenie nie zostało ustawione, wynik to undefined. W przypadku map wektorowych z niezerowym przechyleniem lub nachyleniem zwracana wartość graniczna szerokości i długości geograficznej odpowiada najmniejszej ramce obejmującej widoczny obszar widocznego obszaru mapy. Aby sprawdzić dokładny obszar widocznego obszaru mapy, przejdź do sekcji MapCanvasProjection.getVisibleRegion.
getCenter
getCenter()
Parametry: brak
Zwracana wartość:  LatLng|undefined
Zwraca pozycję wyświetlaną na środku mapy. Pamiętaj, że ten obiekt LatLng nie jest opakowany. Aby dowiedzieć się więcej, przeczytaj LatLng. Jeśli środek lub granice nie są ustawione, zwracany jest wynik undefined.
getClickableIcons
getClickableIcons()
Parametry: brak
Zwracana wartość:  boolean|undefined
Zwraca klikalność ikon mapy. Ikona mapy oznacza ciekawe miejsce, nazywane też ważnym miejscem. Jeśli zwrócona wartość to true, można kliknąć ikony na mapie.
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
Parametry: 
  • datasetId:  string
Zwracana wartość:  FeatureLayer
Zwraca wartość FeatureLayer w przypadku określonej wartości datasetId. Identyfikatory zbiorów danych trzeba skonfigurować w konsoli Google Cloud. Jeśli identyfikator zbioru danych nie jest powiązany ze stylem mapy mapy lub styl oparty na danych jest niedostępny (brak identyfikatora mapy, kafelków wektorów, żadnych warstw cech stylu opartego na danych lub zbiorów danych skonfigurowanych w stylu mapy), zostanie zarejestrowany błąd, a wynikowy FeatureLayer.isAvailable będzie miał wartość fałsz.
getDiv
getDiv()
Parametry: brak
Return Value (Wartość zwracana): HTMLElement Parametr mapDiv mapy.
getFeatureLayer
getFeatureLayer(featureType)
Parametry: 
Zwracana wartość:  FeatureLayer
Zwraca wartość FeatureLayer elementu FeatureType. W konsoli Google Cloud musi być włączony FeatureLayer. Jeśli element FeatureLayer o podanym elemencie FeatureType nie istnieje na tej mapie lub styl oparty na danych jest niedostępny (brak identyfikatora mapy, kafelków wektorów i nie włączono FeatureLayer w stylu mapy), rejestruje błąd, a wynikowy element FeatureLayer.isAvailable ma wartość fałsz.
getHeading
getHeading()
Parametry: brak
Zwracana wartość:  number|undefined
Zwraca kierunek kompasu na mapie. Wartość nagłówka jest mierzona w stopniach (w prawo) od kierunku północnego. Jeśli mapa nie została jeszcze zainicjowana, wynik to undefined.
getMapCapabilities
getMapCapabilities()
Parametry: brak
Zwracana wartość:  MapCapabilities
Informuje osobę wywołującą o bieżących możliwościach dostępnych na mapie na podstawie podanego identyfikatora mapy.
getMapTypeId
getMapTypeId()
Parametry: brak
Zwracana wartość:  MapTypeId|string|undefined
getProjection
getProjection()
Parametry: brak
Zwracana wartość:  Projection|undefined
Zwraca bieżącą wartość Projection. Jeśli mapa nie została jeszcze zainicjowana, wynik to undefined. Wysłuchaj zdarzenia projection_changed i sprawdź jego wartość, aby upewnić się, że nie jest to zdarzenie undefined.
getRenderingType
getRenderingType()
Parametry: brak
Zwracana wartość:  RenderingType
Zwraca bieżący obiekt RenderingType mapy.
getStreetView
getStreetView()
Parametry: brak
Return Value (Wartość zwracana): StreetViewPanorama panorama powiązana z mapą.
Zwraca domyślny obszar StreetViewPanorama powiązany z mapą, którym może być domyślna panorama umieszczona w mapie lub panorama ustawiona za pomocą setStreetView(). Zmiany w ustawieniu streetViewControl mapy będą odzwierciedlane podczas wyświetlania takiej powiązanej panoramy.
getTilt
getTilt()
Parametry: brak
Zwracana wartość:  number|undefined
Zwraca bieżący kąt padania mapy w stopniach od płaszczyzny widocznego obszaru do płaszczyzny mapy. W przypadku map rastrowych wynik będzie wynosić 0 w przypadku zdjęć zrobionych bezpośrednio z góry lub 45 w przypadku zdjęć pod kątem 45°. Ta metoda nie zwraca wartości ustawionej przez setTilt. Aby dowiedzieć się więcej, wejdź na setTilt.
getZoom
getZoom()
Parametry: brak
Zwracana wartość:  number|undefined
Zwraca powiększenie mapy. Jeśli powiększenie nie zostało ustawione, zwracany jest wynik undefined.
moveCamera
moveCamera(cameraOptions)
Parametry: 
Zwracana wartość: brak
Natychmiast ustawia kamerę mapy na opcje kamery docelowej (bez animacji).
panBy
panBy(x, y)
Parametry: 
  • x:  number liczba pikseli przesunięcia mapy w kierunku x.
  • y:  number liczba pikseli przesunięcia mapy w kierunku Y.
Zwracana wartość: brak
Zmienia środek mapy o podaną odległość w pikselach. Jeśli odległość jest mniejsza niż szerokość i wysokość mapy, przejście będzie płynnie animowane. Zwróć uwagę, że układ współrzędnych mapy zwiększa się z zachodu na wschód (w przypadku wartości x) i z północy na południe (w przypadku wartości y).
panTo
panTo(latLng)
Parametry: 
Zwracana wartość: brak
Zmienia środek mapy na wybrany element (LatLng). Jeśli zmiana jest mniejsza niż szerokość i wysokość mapy, przejście będzie płynnie animowane.
panToBounds
panToBounds(latLngBounds[, padding])
Parametry: 
  • latLngBounds:  LatLngBounds|LatLngBoundsLiteral granice, do których można przesunąć mapę.
  • padding:  number|Padding optional Dopełnienie w pikselach. Wartość liczbowa spowoduje takie samo dopełnienie po wszystkich 4 stronach. Wartością domyślną jest 0.
Zwracana wartość: brak
Przesuwa mapę o minimalną wartość niezbędną do umieszczenia obiektu LatLngBounds. Nie ma żadnej gwarancji, w którym miejscu na mapie znajdą się granice. Wyjątkiem jest przesunięcie mapy w taki sposób, by pokazała się jak najwięcej z nich wewnątrz obszaru {currentMapSizeInPx} - {padding}. Zarówno w przypadku map rastrowych, jak i wektorowych powiększenie, nachylenie i kierunek mapy nie ulegną zmianie.
setCenter
setCenter(latlng)
Parametry: 
Zwracana wartość: brak
setClickableIcons
setClickableIcons(value)
Parametry: 
  • value:  boolean
Zwracana wartość: brak
Określa, czy ikony mapy mają być klikalne. Ikona mapy oznacza ciekawe miejsce, nazywane też ważnym miejscem. Aby wyłączyć klikalność ikon mapy, przekaż do tej metody wartość false.
setHeading
setHeading(heading)
Parametry: 
  • heading:  number
Zwracana wartość: brak
Ustawia kierunek kompasu na mapie mierzony w stopniach od kierunku północnego. 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
Wiąże obiekt StreetViewPanorama z mapą. Ta panorama zastępuje domyślny widok StreetViewPanorama, co umożliwia powiązanie mapy z zewnętrzną panoramą, która znajduje się poza mapą. Ustawienie panoramy na null powoduje powiązanie domyślnej umieszczonej panoramy z powrotem z mapą.
setTilt
setTilt(tilt)
Parametry: 
  • tilt:  number
Zwracana wartość: brak
W przypadku map wektorowych ustawia kąt padania mapy. Dozwolone wartości są ograniczone w zależności od powiększenia mapy. W przypadku map rastrowych steruje automatycznym przełączaniem kąta wyświetlania mapy. Jedyne dozwolone wartości to 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. Funkcja setTilt(45) automatycznie przełącza kąt nachylenia na 45, gdy dostępne są zdjęcia 45° dla bieżącego poziomu powiększenia i widocznego obszaru, oraz przełącza się z powrotem na 0, gdy zdjęcia 45° są niedostępne (jest to działanie domyślne). Zdjęcia pod kątem 45° są dostępne tylko dla map satellite i hybrid, w niektórych lokalizacjach i przy niektórych poziomach powiększenia. Uwaga: getTilt zwraca bieżące kąty pochylenia, a nie wartość ustawioną przez setTilt. Ponieważ elementy getTilt i setTilt odnoszą się do różnych rzeczy, nie używaj właściwości bind() tilt, ponieważ może to przynieść nieprzewidywalne efekty.
setZoom
setZoom(zoom)
Parametry: 
  • zoom:  number większe powiększenie oznacza wyższą rozdzielczość.
Zwracana wartość: brak
Ustawia powiększenie mapy.
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
bounds_changed
function()
Argumenty: brak
Zdarzenie to 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: 
Zdarzenie to jest wywoływane, gdy użytkownik kliknie mapę. Zwracane jest zdarzenie MapMouseEvent z właściwościami klikniętej lokalizacji, o ile nie zostanie kliknięta ikona miejsca. W takim przypadku zwracane jest zdarzenie IconMouseEvent z identyfikatorem miejsca. IconMouseEvent i MapMouseEvent są identyczne z tą różnicą, że IconMouseEvent ma pole identyfikatora miejsca. Jeśli identyfikator miejsca nie jest ważny, to zdarzenie może być zawsze traktowane jako zdarzenie MapMouseEvent. Zdarzenie kliknięcia nie jest wywoływane po kliknięciu znacznika lub okna informacyjnego.
contextmenu
function(event)
Argumenty: 
To zdarzenie jest wywoływane po wywołaniu zdarzenia menu kontekstowego DOM w kontenerze mapy.
dblclick
function(event)
Argumenty: 
Zdarzenie to jest wywoływane, gdy użytkownik dwukrotnie kliknie mapę. Pamiętaj, że zdarzenie kliknięcia będzie czasami uruchamiane raz, a czasem dwa razy, tuż przed tym zdarzeniem.
drag
function()
Argumenty: brak
To zdarzenie jest uruchamiane wielokrotnie, gdy użytkownik przeciąga mapę.
dragend
function()
Argumenty: brak
Zdarzenie to jest wywoływane, gdy użytkownik przestaje przeciągać mapę.
dragstart
function()
Argumenty: brak
Zdarzenie to jest wywoływane, gdy użytkownik zacznie 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
Zdarzenie to jest wywoływane, gdy mapa staje się bezczynna 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, gdy zmienią się 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: 
Zdarzenie to jest wywoływane za każdym razem, gdy użytkownik najedzie myszą na kontener mapy.
mouseout
function(event)
Argumenty: 
Zdarzenie to jest wywoływane, gdy kursor myszy opuści kontener mapy.
mouseover
function(event)
Argumenty: 
Zdarzenie to jest wywoływane, gdy użytkownik najedzie myszą na kontener mapy.
projection_changed
function()
Argumenty: brak
Zdarzenie to jest wywoływane po zmianie prognozy.
renderingtype_changed
function()
Argumenty: brak
Zdarzenie to jest wywoływane po zmianie obiektu renderType.
tilesloaded
function()
Argumenty: brak
Zdarzenie jest uruchamiane po zakończeniu ładowania 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: 
Zdarzenie to jest wywoływane przez kliknięcie mapy przez użytkownika prawym przyciskiem myszy.

Interfejs MapOptions

google.maps.MapOptions interfejs

Obiekt MapOptions używany do definiowania właściwości, które można ustawić w mapie.
backgroundColor optional
Typ:  string optional
Kolor używany do tła elementu div mapy. Ten kolor będzie widoczny, gdy kafelki nie zostaną jeszcze wczytane podczas przesuwania użytkownika. Tę opcję można ustawić tylko po zainicjowaniu mapy.
center optional
Typ:  LatLng|LatLngLiteral optional
Początkowe środek mapy.
clickableIcons optional
Typ:  boolean optional
Wartość domyślna: true
Przy ustawieniu false ikony mapy nie można klikać. Ikona mapy oznacza ciekawe miejsce, nazywane też ważnym miejscem.
controlSize optional
Typ:  number optional
Rozmiar w pikselach elementów sterujących wyświetlanych na mapie. Ta wartość musi zostać podana bezpośrednio podczas tworzenia mapy. Jej późniejsza aktualizacja może spowodować, że ustawienia będą miały stan undefined. Reguluje wyłącznie ustawienia skonfigurowane przez interfejs API Map Google. Nie skaluje elementów sterujących utworzonych przez dewelopera.
disableDefaultUI optional
Typ:  boolean optional
Włącza/wyłącza wszystkie domyślne przyciski interfejsu użytkownika. Mogą zostać zastąpione pojedynczo. Nie wyłącza sterowania za pomocą klawiatury, które można osobno kontrolować w opcji MapOptions.keyboardShortcuts. Nie wyłącza sterowania gestami, które można kontrolować za pomocą opcji MapOptions.gestureHandling.
disableDoubleClickZoom optional
Typ:  boolean optional
Włącza/wyłącza powiększenie i wyśrodkowanie po dwukrotnym kliknięciu. Ta opcja jest domyślnie włączona.

Uwaga: ta właściwość nie jest zalecana. Aby wyłączyć powiększanie po dwukrotnym kliknięciu, możesz użyć właściwości gestureHandling z ustawieniem jej na "none".
draggable optional
Typ:  boolean optional
Jeśli false, uniemożliwia przeciąganie mapy. Przeciąganie jest domyślnie włączone.
draggableCursor optional
Typ:  string optional
Nazwa lub adres URL kursora wyświetlany po najechaniu kursorem na mapę, którą można przeciągnąć. Ta właściwość używa atrybutu CSS cursor do zmiany ikony. Podobnie jak w przypadku właściwości CSS, musisz określić co najmniej 1 kurs zastępczy, który nie jest adresem URL. Na przykład: draggableCursor: 'url(http://www.example.com/icon.png), auto;'.
draggingCursor optional
Typ:  string optional
Nazwa lub adres URL kursora wyświetlane podczas przeciągania mapy. Ta właściwość używa atrybutu CSS cursor do zmiany ikony. Podobnie jak w przypadku właściwości CSS, musisz określić co najmniej 1 kurs zastępczy, który nie jest adresem URL. Na przykład: draggingCursor: 'url(http://www.example.com/icon.png), auto;'.
fullscreenControl optional
Typ:  boolean optional
Włączony/wyłączony stan elementu sterującego pełnego ekranu.
fullscreenControlOptions optional
Typ:  FullscreenControlOptions optional
Opcje wyświetlania elementu sterującego pełnego ekranu.
gestureHandling optional
Typ:  string optional
To ustawienie określa, jak interfejs API obsługuje gesty na mapie. Dozwolone wartości:
  • "cooperative": zdarzenia przewijania i gesty dotykowe 1 palcem umożliwiają przewijanie strony bez powiększania ani przesuwania mapy. Gesty dotykowe 2 palcami pozwalają przesuwać i powiększać mapę. Powiększanie mapy przy użyciu klawisza Ctrl lub klawisza ⌘ – zdarzenia przewijania.
    W tym trybie mapa współpracuje ze stroną.
  • "greedy": wszystkie gesty dotykowe i zdarzenia przewijania przesuwają lub powiększają mapę.
  • "none": mapy nie można przesuwać ani powiększać gestami użytkownika.
  • "auto" (domyślnie): obsługa gestów może być metodą współpracy lub zachłannością w zależności od tego, czy stronę można przewijać czy w elemencie iframe.
heading optional
Typ:  number optional
Nagłówek zdjęć lotniczych w stopniach mierzony w prawo od kierunku północnego. Nagłówki są przycinane pod kątem najbliższego dostępnego kąta, dla którego są dostępne zdjęcia.
isFractionalZoomEnabled optional
Typ:  boolean optional
Wartość domyślna: true w przypadku map wektorowych i false dla map rastrowych
Określa, czy mapa ma zezwalać na częściowe powiększenie. Posłuchaj isfractionalzoomenabled_changed, aby dowiedzieć się, kiedy zostanie ustawiona wartość domyślna.
keyboardShortcuts optional
Typ:  boolean optional
Jeśli ustawiona jest wartość false, nie można sterować mapą z klawiatury. Skróty klawiszowe są domyślnie włączone.
mapId optional
Typ:  string optional
Identyfikator mapy. Po utworzeniu wystąpienia mapy tego parametru nie można ustawić ani zmienić.
mapTypeControl optional
Typ:  boolean optional
Początkowy stan włączenia/wyłączenia opcji typu mapy.
mapTypeControlOptions optional
Typ:  MapTypeControlOptions optional
Początkowe opcje wyświetlania elementu sterującego typu mapy.
mapTypeId optional
Typ:  MapTypeId|string optional
Początkowy identyfikator typu 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 ta opcja zostanie pominięta lub ustawiona na null, zamiast niej używane będzie maksymalne powiększenie z 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 ta właściwość zostanie pominięta lub ustawiona na null, zamiast niej używane będzie 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 ustawiona jest wartość true, nie usuwaj zawartości elementu div mapy.
panControl optional
Typ:  boolean optional
Włączony/wyłączony stan elementu sterującego Pan.

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

restriction optional
Typ:  MapRestriction optional
Określa granicę ograniczającą obszar mapy dostępny dla użytkowników. Po ustawieniu tej zasady użytkownik może przesuwać i powiększać tylko widok z kamery w granicach granic.
rotateControl optional
Typ:  boolean optional
Włączony/wyłączony stan elementu sterującego obrotem.
rotateControlOptions optional
Typ:  RotateControlOptions optional
Opcje wyświetlania elementu sterującego obracaniem.
scaleControl optional
Typ:  boolean optional
Początkowy stan włączenia/wyłączenia elementu sterującego Skalowanie.
scaleControlOptions optional
Typ:  ScaleControlOptions optional
Początkowe opcje wyświetlania elementu sterującego Skalowanie.
scrollwheel optional
Typ:  boolean optional
Jeśli false, wyłącza powiększanie mapy za pomocą kółka myszy. Kółko myszy jest domyślnie włączone.

Uwaga: ta właściwość nie jest zalecana. Aby wyłączyć powiększanie za pomocą kółka przewijania, możesz użyć właściwości gestureHandling z ustawieniem wartości "cooperative" lub "none".
streetView optional
Typ:  StreetViewPanorama optional
StreetViewPanorama wyświetlany, gdy Pegman Street View zostanie umieszczony na mapie. Jeśli nie podasz panoramy, po przesunięciu Pegmana na mapie w Mapach div wyświetli się domyślna wartość StreetViewPanorama.
streetViewControl optional
Typ:  boolean optional
Początkowy stan włączenia/wyłączenia elementu sterującego Pegmana w Street View. Ten element sterujący jest częścią domyślnego interfejsu i powinien być ustawiony na wartość false podczas wyświetlania typu mapy, na której nie powinna być wyświetlana nakładka drogi Street View (np. mapy innego typu niż Earth).
streetViewControlOptions optional
Typ:  StreetViewControlOptions optional
Początkowe opcje wyświetlania elementu sterującego Pegmana w Street View.
styles optional
Typ:  Array<MapTypeStyle> optional
Style, które mają być stosowane do każdego z domyślnych typów map. Pamiętaj, że w przypadku trybów satellite/hybrid i terrain te style mają zastosowanie tylko do etykiet i geometrii.
tilt optional
Typ:  number optional
W przypadku map wektorowych ustawia kąt padania mapy. Dozwolone wartości są ograniczone w zależności od powiększenia mapy. W przypadku map rastrowych steruje automatycznym przełączaniem kąta wyświetlania mapy. Jedyne dozwolone wartości to 0 i 45. Wartość 0 powoduje, że mapa zawsze używa widoku z góry 0°, niezależnie od poziomu powiększenia i widocznego obszaru. Wartość 45 powoduje automatyczne przełączanie kąta nachylenia na 45, gdy dostępne są zdjęcia 45° dla bieżącego poziomu powiększenia i widocznego obszaru, oraz powrót do 0, gdy zdjęcia 45° są niedostępne (jest to działanie domyślne). Zdjęcia pod kątem 45° są dostępne tylko dla map satellite i hybrid, w niektórych lokalizacjach i przy niektórych poziomach powiększenia. Uwaga: getTilt zwraca bieżące kąty pochylenia, a nie wartość określoną przez tę opcję. Ponieważ getTilt i ta opcja odnoszą się do różnych rzeczy, nie używaj właściwości bind() do właściwości tilt, ponieważ może to przynieść nieprzewidywalne efekty.
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ą większą rozdzielczość.
zoomControl optional
Typ:  boolean optional
Włączony/wyłączony stan elementu sterującego Powiększenie.
zoomControlOptions optional
Typ:  ZoomControlOptions optional
Opcje wyświetlania elementu sterującego Powiększenie.

Klasa MapElement

google.maps.MapElement zajęcia

MapElement to podklasa HTMLElement służąca do renderowania map. Po wczytaniu biblioteki maps można utworzyć mapę w kodzie HTML. Na przykład: 

<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID">
  <button slot="control-block-start-inline-end">Custom Control</button>
</gmp-map>

Wewnętrznie używany jest interfejs Map, do którego można uzyskać dostęp za pomocą właściwości innerMap.

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

Ta klasa stanowi rozszerzenie zajęć HTMLElement.

Ta klasa implementuje MapElementOptions.

Aby uzyskać dostęp, zadzwoń pod numer const {MapElement} = await google.maps.importLibrary("maps"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
MapElement
MapElement([options])
Parametry: 
center
Typ:  LatLng|LatLngLiteral optional
Długość i szerokość geograficzna środkowej mapy.
Atrybut HTML:
  • <gmp-map center="lat,lng"></gmp-map>
innerMap
Typ:  Map
Odwołanie do obiektu Map używanego wewnętrznie przez element MapElement.
mapId
Typ:  string optional
Identyfikator mapy. Więcej informacji znajdziesz w dokumentacji identyfikatorów mapy.
Atrybut HTML:
  • <gmp-map map-id="string"></gmp-map>
zoom
Typ:  number optional
Poziom powiększenia mapy.
Atrybut HTML:
  • <gmp-map zoom="number"></gmp-map>
control-block-end-inline-center
Umieszcza element z boksem na pozycji ControlPosition.BLOCK_END_INLINE_CENTER.
control-block-end-inline-end
Umieszcza element z boksem na pozycji ControlPosition.BLOCK_END_INLINE_END.
control-block-end-inline-start
Umieszcza element z boksem na pozycji ControlPosition.BLOCK_END_INLINE_START.
control-block-start-inline-center
Umieszcza element z boksem na pozycji ControlPosition.BLOCK_START_INLINE_CENTER.
control-block-start-inline-end
Umieszcza element z boksem na pozycji ControlPosition.BLOCK_START_INLINE_END.
control-block-start-inline-start
Umieszcza element z boksem na pozycji ControlPosition.BLOCK_START_INLINE_START.
control-inline-end-block-center
Umieszcza element z boksem na pozycji ControlPosition.INLINE_END_BLOCK_CENTER.
control-inline-end-block-end
Umieszcza element z boksem na pozycji ControlPosition.INLINE_END_BLOCK_END.
control-inline-end-block-start
Umieszcza element z boksem na pozycji ControlPosition.INLINE_END_BLOCK_START.
control-inline-start-block-center
Umieszcza element z boksem na pozycji ControlPosition.INLINE_START_BLOCK_CENTER.
control-inline-start-block-end
Umieszcza element z boksem na pozycji ControlPosition.INLINE_START_BLOCK_END.
control-inline-start-block-start
Umieszcza element z boksem na pozycji ControlPosition.INLINE_START_BLOCK_START.
BetaaddEventListener
addEventListener(type, listener[, options])
Parametry: 
  • type:  string ciąg znaków reprezentujący typ nasłuchiwanego zdarzenia (wielkość liter ma znaczenie).
  • listener:  EventListener|EventListenerObject obiekt, który otrzymuje powiadomienie. Musi to być funkcja lub obiekt z metodą handleEvent
  • options:  boolean|AddEventListenerOptions optional Zobacz opcje. Zdarzenia niestandardowe obsługują tylko zdarzenia capture i passive.
Zwracana wartość:  void
Konfiguruje funkcję, która będzie wywoływana za każdym razem, gdy określone zdarzenie zostanie dostarczone do miejsca docelowego. Zobacz addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametry: 
  • type:  string ciąg tekstowy określający typ zdarzenia, z którego ma zostać usunięty odbiornik.
  • listener:  EventListener|EventListenerObject odbiornik zdarzenia modułu obsługi zdarzeń do usunięcia z celu zdarzenia.
  • options:  boolean|EventListenerOptions optional Zobacz opcje
Zwracana wartość:  void
Usuwa z elementu docelowego detektor zdarzeń zarejestrowany wcześniej przez addEventListener. Zobacz removeEventListener.
gmp-zoomchange
function(event)
Argumenty: 
To zdarzenie jest wywoływane po zmianie właściwości powiększenia mapy.

Interfejs MapElementOptions

google.maps.MapElementOptions interfejs

Obiekt MapElementOptions służący do definiowania właściwości, które można ustawić w elemencie MapElement.
center optional
Typ:  LatLng|LatLngLiteral optional
Początkowe środek mapy.
mapId optional
Typ:  string optional
Identyfikator mapy. Po utworzeniu wystąpienia mapy tego parametru nie można ustawić ani zmienić.
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ą większą rozdzielczość.

Klasa ZoomChangeEvent

google.maps.ZoomChangeEvent zajęcia

To zdarzenie jest tworzone na podstawie monitorowania zmiany powiększenia.

Ta klasa stanowi rozszerzenie zajęć Event.

Aby uzyskać dostęp, zadzwoń pod numer const {ZoomChangeEvent} = await google.maps.importLibrary("maps"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

Interfejs MapTypeStyle

google.maps.MapTypeStyle interfejs

MapTypeStyle to zbiór selektorów i stylów, które określają styl mapy. Selektory wskazują obiekty i/lub elementy mapy, na które należy wpłynąć. Selektory stylu określają, jak te obiekty i elementy należy zmodyfikować. Szczegółowe informacje znajdziesz w opisie stylu.
stylers
Typ:  Array<Object>
Reguły stylu, które mają zastosowanie do wybranych funkcji i elementów mapy. Reguły zostaną zastosowane w kolejności, którą określisz w tej tablicy. Wskazówki dotyczące użytkowania i dozwolonych wartości znajdziesz w dokumentacji stylów.
elementType optional
Typ:  string optional
Element, do którego ma zostać zastosowany stylizator. Element to wizualny aspekt obiektu na mapie. Przykład: etykieta, ikona, stylizacja lub wypełnienie zastosowane do geometrii lub inne. Opcjonalnie. Jeśli zasada elementType nie została określona, przyjmuje się, że wartość to 'all'. Szczegółowe informacje o użytkowaniu i dozwolonych wartościach znajdziesz w dokumentacji stylów.
featureType optional
Typ:  string optional
Funkcja lub grupa funkcji, do których ma zostać zastosowana stylizacja. Opcjonalnie. Jeśli zasada featureType nie została określona, przyjmuje się, że wartość to 'all'. Szczegółowe informacje o użytkowaniu i dozwolonych wartościach znajdziesz w dokumentacji stylów.

Interfejs MapMouseEvent

google.maps.MapMouseEvent interfejs

Ten obiekt jest zwracany z różnych zdarzeń myszy na mapie i nakładkach oraz zawiera wszystkie widoczne poniżej pola.
domEvent
Odpowiednie natywne zdarzenie DOM. Deweloperzy nie powinni polegać na tym, że właściwości target, currentTarget, relatedTarget i path są zdefiniowane i spójne. Deweloperzy nie powinni również polegać na strukturze DOM w wewnętrznej implementacji interfejsu API Map Google. Z powodu wewnętrznego mapowania zdarzeń domEvent może mieć inną semantykę niż MapMouseEvent (np. MapMouseEvent „kliknięcie” może mieć typ domEvent KeyboardEvent).
latLng optional
Typ:  LatLng optional
Długość i szerokość geograficzna widoczna pod kursorem w chwili wystąpienia zdarzenia.
stop
stop()
Parametry: brak
Zwracana wartość:  void
Uniemożliwia dalsze rozpowszechnianie tego zdarzenia.

Interfejs IconMouseEvent

google.maps.IconMouseEvent interfejs

Ten obiekt jest wysyłany w zdarzeniu, gdy użytkownik kliknie ikonę na mapie. Identyfikator miejsca tego miejsca jest zapisany w elemencie „placeId”. Aby zapobiec wyświetlaniu domyślnego okna informacyjnego, wywołaj w tym zdarzeniu metodę stop(), co uniemożliwi jego rozpowszechnienie. Więcej informacji na temat identyfikatorów miejsc znajdziesz w przewodniku dla programistów po interfejsie Places API.

Ten interfejs stanowi rozszerzenie MapMouseEvent.

placeId optional
Typ:  string optional
Identyfikator miejsca klikniętego miejsca. Można go użyć, aby uzyskać więcej informacji o klikniętym obiekcie.

Więcej informacji na temat identyfikatorów miejsc znajdziesz w przewodniku dla programistów po interfejsie Places API.
Odziedziczone: domEvent, latLng
Dziedziczone: stop

MapTypeId

google.maps.MapTypeId stałe

Identyfikatory typowych obiektów MapType. Określ je za pomocą wartości lub nazwy stałej. Na przykład 'satellite' lub google.maps.MapTypeId.SATELLITE.

Aby uzyskać dostęp, zadzwoń pod numer const {MapTypeId} = await google.maps.importLibrary("maps"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
HYBRID Ten typ mapy pokazuje przezroczystą warstwę głównych ulic na zdjęciach satelitarnych.
ROADMAP Ten typ mapy wyświetla zwykłą mapę ulic.
SATELLITE Ten typ mapy wyświetla zdjęcia satelitarne.
TERRAIN Ten typ mapy wyświetla mapy z obiektami fizycznymi, takimi jak ukształtowanie terenu i roślinność.

Klasa MapTypeRegistry

google.maps.MapTypeRegistry zajęcia

Rejestr instancji MapType, określony przez identyfikator MapType.

Ta klasa stanowi rozszerzenie zajęć MVCObject.

Aby uzyskać dostęp, zadzwoń pod numer const {MapTypeRegistry} = await google.maps.importLibrary("maps"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
MapTypeRegistry
MapTypeRegistry()
Parametry: brak
MapTypeRegistry zawiera zbiór niestandardowych typów map dostępnych dla mapy. Interfejs API konsultuje się z tym rejestrem, na przykład podając listę dostępnych typów map w elementach sterujących.
set
set(id, mapType)
Parametry: 
  • id:  string identyfikator obiektu MapType, który chcesz dodać do rejestru.
  • mapType:  MapType|* obiekt MapType do dodania do rejestru.
Zwracana wartość: brak
Ustawia w rejestrze powiązanie przekazywanego identyfikatora ciągu z przekazanym obiektem MapType.
Dziedziczone: addListener, bindTo, get, notify, setValues, unbind, unbindAll

Interfejs MapRestriction

google.maps.MapRestriction interfejs

Ograniczenie, które może zostać zastosowane do mapy. Widoczny obszar mapy nie przekroczy tych ograniczeń.
latLngBounds
Po ustawieniu tej zasady użytkownik może tylko przesuwać i powiększać w obrębie określonych granic. Ograniczenia mogą ograniczać długość i szerokość geograficzną lub tylko szerokość geograficzną. W przypadku granic długości geograficznej użyj długości geograficznej zachodniej i wschodniej odpowiednio –180 i 180, na przykład latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}.
strictBounds optional
Typ:  boolean optional
Ograniczenia można zwiększyć, ustawiając flagę strictBounds na true. Dzięki temu użytkownik może oddalić obraz tak daleko, aby nie wykraczał poza granice geograficzne. Wartość domyślna to false, co oznacza, że użytkownik może pomniejszyć obszar, dopóki nie znajdzie się cały ograniczony obszar, z uwzględnieniem obszarów spoza niego.

Klasa TrafficLayer

google.maps.TrafficLayer zajęcia

Warstwa natężenia ruchu.

Ta klasa stanowi rozszerzenie zajęć MVCObject.

Aby uzyskać dostęp, zadzwoń pod numer const {TrafficLayer} = await google.maps.importLibrary("maps"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
TrafficLayer
TrafficLayer([opts])
Parametry: 
Warstwa, na której widać bieżące natężenie ruchu na drodze.
getMap
getMap()
Parametry: brak
Zwracana wartość:  Map
Zwraca mapę, na której wyświetlana jest ta warstwa.
setMap
setMap(map)
Parametry: 
Zwracana wartość: brak
Renderuje warstwę na określonej mapie. Jeśli ustawienie mapy 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 służący do definiowania właściwości, które można ustawić w warstwie TrafficLayer.
autoRefresh optional
Typ:  boolean optional
Wartość domyślna: true
Określa, czy warstwa natężenia ruchu automatycznie odświeża się o aktualne informacje.
map optional
Typ:  Map optional
Mapa, na której ma być wyświetlana warstwa natężenia ruchu.

Klasa TransitLayer

google.maps.TransitLayer zajęcia

Warstwa transportu publicznego.

Ta klasa stanowi rozszerzenie zajęć MVCObject.

Aby uzyskać dostęp, zadzwoń pod numer const {TransitLayer} = await google.maps.importLibrary("maps"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
TransitLayer
TransitLayer()
Parametry: brak
Warstwa, na której wyświetlane są linie transportu publicznego.
getMap
getMap()
Parametry: brak
Zwracana wartość:  Map
Zwraca mapę, na której wyświetlana jest ta warstwa.
setMap
setMap(map)
Parametry: 
Zwracana wartość: brak
Renderuje warstwę na określonej mapie. Jeśli ustawienie mapy ma wartość null, warstwa zostanie usunięta.
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Zajęcia BicyclingLayer

google.maps.BicyclingLayer zajęcia

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

Ta klasa stanowi rozszerzenie zajęć MVCObject.

Aby uzyskać dostęp, zadzwoń pod numer const {BicyclingLayer} = await google.maps.importLibrary("maps"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
BicyclingLayer
BicyclingLayer()
Parametry: brak
Warstwa, która wyświetla ścieżki i ścieżki rowerowe oraz przesuwa duże drogi w dół.
getMap
getMap()
Parametry: brak
Zwracana wartość:  Map
Zwraca mapę, na której wyświetlana jest ta warstwa.
setMap
setMap(map)
Parametry: 
Zwracana wartość: brak
Renderuje warstwę na określonej mapie. Jeśli ustawienie mapy ma wartość null, warstwa zostanie usunięta.
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Interfejs CameraOptions

google.maps.CameraOptions interfejs

Służy do konfigurowania opcji aparatu mapy.
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

Składa się z czterech punktów definiujących czteroboczny wielokąt, który jest widoczny na mapie. Na mapie wektorowej ten wielokąt może być trapezem, a nie prostokątem, jeśli mapa wektorowa ma przechylenie.
farLeft
Typ:  LatLng
farRight
Typ:  LatLng
latLngBounds
Najmniejsza ramka ograniczająca, która obejmuje widoczny obszar.
nearLeft
Typ:  LatLng
nearRight
Typ:  LatLng

Stałe RenderingType

google.maps.RenderingType stałe

Aby uzyskać dostęp, zadzwoń pod numer const {RenderingType} = await google.maps.importLibrary("maps"). 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, ponieważ jej inicjowanie nie zostało jeszcze zakończone.
VECTOR Wskazuje, że mapa jest mapą wektorową.

Interfejs MapCapabilities

google.maps.MapCapabilities interfejs

Obiekt zawierający podsumowanie funkcji dostępnych obecnie w Mapach. Nie musi to oznaczać, że odpowiednie moduły są wczytywane lub inicjowane, ale że bieżąca mapa ma uprawnienia do korzystania z tych interfejsów API. Listę możliwych funkcji znajdziesz we właściwościach.
isAdvancedMarkersAvailable optional
Typ:  boolean optional
Jeśli ma wartość prawda, ta mapa jest skonfigurowana prawidłowo i umożliwia korzystanie z zaawansowanych znaczników. Pamiętaj, że aby używać znaczników zaawansowanych, musisz jeszcze zaimportować bibliotekę marker. Więcej informacji znajdziesz na stronie https://goo.gle/gmp-isAdvancedMarkersAvailable.
isDataDrivenStylingAvailable optional
Typ:  boolean optional
Jeśli ma wartość prawda, ta mapa jest skonfigurowana prawidłowo i pozwala na korzystanie ze stylu opartego na danych w przypadku co najmniej 1 warstwy cech. Więcej informacji znajdziesz na stronach https://goo.gle/gmp-data-driven-styling i https://goo.gle/gmp-FeatureLayerIsAvailable.