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.

Zespół
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.

Stałe
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).

Właściwości
controls	Typ:  Array<MVCArray<HTMLElement>> 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	Typ:  MapTypeRegistry 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).

Metody
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.
getDatasetFeatureLayer	Uwaga: ta funkcja jest dostępna tylko w kanale v=beta. 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:  featureType:  FeatureType 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:  cameraOptions:  CameraOptions 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:  latLng:  LatLng|LatLngLiteral szerokość i długość geograficzna środkowa na mapie. 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:  latlng:  LatLng|LatLngLiteral 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:  mapTypeId:  MapTypeId|string Zwracana wartość: brak
setOptions	setOptions(options) Parametry:  options:  MapOptions optional Zwracana wartość: brak
setStreetView	setStreetView(panorama) Parametry:  panorama:  StreetViewPanorama optional panorama do powiązania z mapą. 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

Wydarzenia
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:  event:  MapMouseEvent|IconMouseEvent 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:  event:  MapMouseEvent To zdarzenie jest wywoływane po wywołaniu zdarzenia menu kontekstowego DOM w kontenerze mapy.
dblclick	function(event) Argumenty:  event:  MapMouseEvent 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:  event:  MapMouseEvent Zdarzenie to jest wywoływane za każdym razem, gdy użytkownik najedzie myszą na kontener mapy.
mouseout	function(event) Argumenty:  event:  MapMouseEvent Zdarzenie to jest wywoływane, gdy kursor myszy opuści kontener mapy.
mouseover	function(event) Argumenty:  event:  MapMouseEvent 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	Wycofane: zamiast tego użyj zdarzenia Map.contextmenu, aby zapewnić obsługę wzorców użytkowania takich jak kliknięcie z naciśniętym klawiszem Control w systemie macOS. function(event) Argumenty:  event:  MapMouseEvent 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.

Właściwości
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	Wycofane: wycofane w 2017 roku. Aby wyłączyć przeciąganie po mapie, możesz użyć właściwości gestureHandling z ustawieniem jej na "none". 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	Wycofane: we wrześniu 2015 r. wycofaliśmy element sterujący przesuwania. Typ:  boolean optional Włączony/wyłączony stan elementu sterującego Pan.
panControlOptions optional	Wycofane: we wrześniu 2015 r. wycofaliśmy element sterujący przesuwania. 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

Uwaga: ta funkcja jest dostępna tylko w kanale v=beta.

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.

Zespół
MapElement	MapElement([options]) Parametry:  options:  MapElementOptions optional

Właściwości
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>

Przedziały
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.

Metody
addEventListener	Uwaga: ta funkcja jest dostępna tylko w kanale v=beta. 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.
removeEventListener	Uwaga: ta funkcja jest dostępna tylko w kanale v=beta. 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.

Wydarzenia
gmp-zoomchange	function(event) Argumenty:  event:  ZoomChangeEvent To zdarzenie jest wywoływane po zmianie właściwości powiększenia mapy.

Interfejs MapElementOptions

google.maps.MapElementOptions interfejs

Uwaga: ta funkcja jest dostępna tylko w kanale v=beta.

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

Właściwości
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

Uwaga: ta funkcja jest dostępna tylko w kanale v=beta.

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.

Właściwości
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.

Właściwości
domEvent	Typ:  MouseEvent|TouchEvent|PointerEvent|KeyboardEvent|Event 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.

Metody
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.

Właściwości
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

Metody
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.

Stałe
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.

Zespół
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.

Metody
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ń.

Właściwości
latLngBounds	Typ:  LatLngBounds|LatLngBoundsLiteral 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.

Zespół
TrafficLayer	TrafficLayer([opts]) Parametry:  opts:  TrafficLayerOptions optional Warstwa, na której widać bieżące natężenie ruchu na drodze.

Metody
getMap	getMap() Parametry: brak Zwracana wartość:  Map Zwraca mapę, na której wyświetlana jest ta warstwa.
setMap	setMap(map) Parametry:  map:  Map Zwracana wartość: brak Renderuje warstwę na określonej mapie. Jeśli ustawienie mapy ma wartość null, warstwa zostanie usunięta.
setOptions	setOptions(options) Parametry:  options:  TrafficLayerOptions 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.

Właściwości
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.

Zespół
TransitLayer	TransitLayer() Parametry: brak Warstwa, na której wyświetlane są linie transportu publicznego.

Metody
getMap	getMap() Parametry: brak Zwracana wartość:  Map Zwraca mapę, na której wyświetlana jest ta warstwa.
setMap	setMap(map) Parametry:  map:  Map 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.

Zespół
BicyclingLayer	BicyclingLayer() Parametry: brak Warstwa, która wyświetla ścieżki i ścieżki rowerowe oraz przesuwa duże drogi w dół.

Metody
getMap	getMap() Parametry: brak Zwracana wartość:  Map Zwraca mapę, na której wyświetlana jest ta warstwa.
setMap	setMap(map) Parametry:  map:  Map 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

Uwaga: ta funkcja jest dostępna tylko w kanale v=beta.

Służy do konfigurowania opcji aparatu mapy.

Właściwości
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.

Właściwości
farLeft	Typ:  LatLng
farRight	Typ:  LatLng
latLngBounds	Typ:  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.

Stałe
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.

Właściwości
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.