Maps

Klasa Map

google.maps.Map zajęcia

Ta klasa stanowi rozszerzenie MVCObject.

Uzyskaj dostęp, dzwoniąc pod numer const {Map} = await google.maps.importLibrary("maps"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

Map
Map(mapDiv[, opts])
Parametry: 
  • mapDivHTMLElement mapa zostanie wyrenderowana, aby wypełnić ten element.
  • optsMapOptions optional – opcje
Tworzy nową mapę wewnątrz danego kontenera HTML, który jest zwykle elementem DIV.
DEMO_MAP_ID Identyfikator mapy, który może być używany 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ć na potrzeby funkcji wymagających konfiguracji chmury (takich jak styl chmury).
controls
Dodatkowe elementy sterujące, które możesz dołączyć do mapy. Aby dodać element sterujący do mapy, dodaj <div> elementu do pola MVCArray odpowiadającego elementowi ControlPosition, w którym ma być renderowany.
data
Typ:  Data
Wystąpienie obszaru Data powiązanego z mapą. Dodaj funkcje do tego obiektu Data, aby wygodnie wyświetlać je na tej mapie.
mapTypes
Rejestr MapType instancji 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 nad mapami podstawowymi 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: 
  • boundsLatLngBounds|LatLngBoundsLiteral Ograniczenia do pokazania.
  • paddingnumber|Padding optional Dopełnienie w pikselach. Granice będą pasować do tej części mapy, która pozostanie po usunięciu dopełnienia. Wartość liczbowa wywoła takie samo dopełnienie ze wszystkich 4 stron. Podaj tutaj 0, aby utworzyć idempotentną wartość fitBounds w wyniku getBounds.
Zwracana wartość: brak
Ustawia widoczny obszar tak, by zawierał podane granice.
Uwaga: gdy mapa jest ustawiona na display: none, funkcja fitBounds odczytuje rozmiar mapy jako 0x0 i nie wykonuje żadnych działań. Aby zmienić widoczny obszar, gdy mapa jest ukryta, ustaw mapę na visibility: hidden. Dzięki temu jej element div będzie miał rzeczywisty rozmiar. W przypadku map wektorowych ta metoda ustawia domyślne wartości 0 pochyleń i kierunków mapy. Wywołanie tej metody może spowodować płynną animację podczas przesuwania i powiększania mapy w celu dopasowania do niej. Użycie 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/długości bieżącego widocznego obszaru. Jeśli widoczna jest więcej niż 1 kopia świata, granica długości geograficznej wynosi od -180 do 180 stopni włącznie. Jeśli mapa nie została jeszcze zainicjowana albo nie ustawiono powiększenia i powiększenia, wynik to undefined. W przypadku map wektorowych z nachyleniem lub nachyleniem niezerowym zwrócone granice szerokości i długości geograficznej odpowiadają najmniejszej ramce ograniczającej, która obejmuje widoczny obszar mapy. Aby sprawdzić, gdzie dokładnie wygląda widoczny obszar mapy, kliknij 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 przedstawia ciekawe miejsce, nazywane również miejscem POI. Jeśli zwrócona wartość to true, można kliknąć ikony na mapie.
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
Parametry: 
  • datasetIdstring
Zwracana wartość:  FeatureLayer
Zwraca wartość FeatureLayer w przypadku określonej datasetId. Identyfikatory zbiorów danych trzeba skonfigurować w Google Cloud Console. 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, brak warstw funkcji stylu opartego na danych ani zbiorów danych skonfigurowanych w stylu mapy), zostanie zarejestrowany błąd, a wynikowy FeatureLayer.isAvailable ma wartość fałsz.
getDiv
getDiv()
Parametry: brak
Return Value (Wartość zwrócona): HTMLElement Parametr mapDiv mapy.
getFeatureLayer
getFeatureLayer(featureType)
Parametry: 
Zwracana wartość:  FeatureLayer
Zwraca FeatureLayer elementu FeatureType. W konsoli Google Cloud musi być włączony FeatureLayer. Jeśli element FeatureLayer o określonym 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), zostanie zarejestrowany błąd, a wynikowy FeatureLayer.isAvailable będzie miał wartość Fałsz.
getHeading
getHeading()
Parametry: brak
Zwracana wartość:  number|undefined
Zwraca na kompasie kierunek 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 obiekt wywołujący o aktualnych 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. Odsłuchaj zdarzenie projection_changed i sprawdź jego wartość, aby upewnić się, że nie jest to zdarzenie undefined.
getRenderingType
getRenderingType()
Parametry: brak
Zwracana wartość:  RenderingType
Zwraca aktualną wartość RenderingType mapy.
getStreetView
getStreetView()
Parametry: brak
Return Value (Wartość zwrócona): StreetViewPanorama panorama powiązana z mapą.
Zwraca domyślną wartość StreetViewPanorama powiązaną z mapą, czyli domyślną panoramę umieszczonym w mapie lub panoramę ustawioną w setStreetView(). Zmiany w obszarze streetViewControl mapy zostaną odzwierciedlone w widoku 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 powietrza lub 45 w przypadku zdjęć zrobionych 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, będzie to undefined.
moveCamera
moveCamera(cameraOptions)
Parametry: 
Zwracana wartość: brak
Natychmiast ustawia kamerę mapy na opcje kamery docelowej (bez animacji).
panBy
panBy(x, y)
Parametry: 
  • xnumber liczba pikseli, o które można przesunąć mapę w kierunku x.
  • ynumber liczba pikseli, o które można przesunąć mapę 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: 
  • latLngLatLng|LatLngLiteral szerokość/długość geograficzna nowego obszaru środkowego na mapie.
Zwracana wartość: brak
Wyśrodkowuje mapę na wybrany obszar 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 należy przesunąć mapę.
  • paddingnumber|Padding optional Dopełnienie w pikselach. Wartość liczbowa wywoła takie samo dopełnienie ze wszystkich 4 stron. Wartością domyślną jest 0.
Zwracana wartość: brak
Przesuwa mapę o minimalną wielkość niezbędną do umieszczenia wybranego elementu LatLngBounds. Nie daje to żadnej gwarancji, w którym miejscu na mapie znajdą się granice. Mapa zostanie przesunięta w taki sposób, aby jak najlepiej pokazać obszar w obszarze {currentMapSizeInPx} - {padding}. Zarówno w przypadku map rastrowych, jak i wektorowych powiększenie, pochylenie i nagłówek mapy nie ulegną zmianie.
setCenter
setCenter(latlng)
Parametry: 
Zwracana wartość: brak
setClickableIcons
setClickableIcons(value)
Parametry: 
  • valueboolean
Zwracana wartość: brak
Określa, czy ikony mapy mają być klikalne. Ikona mapy przedstawia ciekawe miejsce, nazywane również miejscem POI. Aby wyłączyć klikalność ikon mapy, przekaż do tej metody wartość false.
setHeading
setHeading(heading)
Parametry: 
  • headingnumber
Zwracana wartość: brak
Ustawia kierunek na kompasie na mapie mierzony w stopniach od kierunku północnego. W przypadku map rastrowych ta metoda ma zastosowanie tylko do 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ślne ustawienie StreetViewPanorama, co umożliwia powiązanie mapy z panoramą zewnętrzną spoza niej. 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 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 pod kątem kąta padania mapy. Jedyne dozwolone wartości to 0 i 45. setTilt(0) powoduje, że mapa jest zawsze wyświetlana z powietrza o wartości 0°, niezależnie od poziomu powiększenia i widocznego obszaru. setTilt(45) automatycznie przełącza kąt nachylenia na 45°, gdy dla bieżącego poziomu powiększenia i widocznego obszaru dostępne są zdjęcia 45°, oraz przełącza się z powrotem na 0, gdy zdjęcia 45° są niedostępne (jest to zachowanie domyślne). Zdjęcia 45° są dostępne tylko na mapach typu satellite i hybrid, w niektórych lokalizacjach i przy niektórych poziomach powiększenia. Uwaga: getTilt zwraca bieżący kąt pochylenia, a nie wartość ustawioną w setTilt. Właściwości getTilt i setTilt odnoszą się do różnych rzeczy, dlatego nie używaj właściwości bind() do właściwości tilt, ponieważ może to przynieść nieprzewidywalne efekty.
setZoom
setZoom(zoom)
Parametry: 
  • zoomnumber Większe wartości powiększenia oznaczają większą rozdzielczość.
Zwracana wartość: brak
Ustawia powiększenie mapy.
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
bounds_changed
function()
Argumenty: brak
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ę. Zwracane jest zdarzenie MapMouseEvent z właściwościami klikniętej lokalizacji, o ile nie została 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 zawiera 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 może się uruchamiać raz, a czasem dwa razy, tuż przed tym zdarzeniem.
drag
function()
Argumenty: brak
To zdarzenie jest wywoływane wielokrotnie, gdy użytkownik przeciąga mapę.
dragend
function()
Argumenty: brak
To zdarzenie jest uruchamiane, gdy użytkownik przestanie przeciągać mapę.
dragstart
function()
Argumenty: brak
To zdarzenie jest uruchamiane, gdy użytkownik rozpoczyna przeciąganie mapy.
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 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: 
To zdarzenie jest wywoływane za każdym razem, gdy użytkownik najedzie myszą na kontener mapy.
mouseout
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy mysz użytkownika opuści kontener mapy.
mouseover
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy kursor użytkownika trafi 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 obiektu 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, gdy zmieni się właściwość powiększenia mapy.
rightclick
function(event)
Argumenty: 
Zdarzenie to jest wywoływane, gdy użytkownik kliknie mapę 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 jako tło elementu div mapy. Ten kolor będzie widoczny, gdy kafelki nie zostaną jeszcze załadowane jako 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
Gdy ustawiona jest opcja false, ikony mapy nie można klikać. Ikona mapy przedstawia ciekawe miejsce, nazywane również miejscem POI.
controlSize optional
Typ:  number optional
Rozmiar w pikselach elementów sterujących widocznych na mapie. Tę wartość należy podać bezpośrednio podczas tworzenia mapy. Jej późniejsza zmiana może sprawić, że elementy sterujące przejdą do stanu undefined. Reguluje tylko ustawienia skonfigurowane przez interfejs API Map Google. Nie skaluje niestandardowych elementów sterujących utworzonych przez dewelopera.
disableDefaultUI optional
Typ:  boolean optional
Włącza lub wyłącza wszystkie domyślne przyciski interfejsu. Mogą zostać zastąpione pojedynczo. Nie wyłącza sterowania na klawiaturze, którym oddzielnie steruje opcja MapOptions.keyboardShortcuts. Nie wyłącza sterowania za pomocą gestów, którymi oddzielnie steruje opcja MapOptions.gestureHandling.
disableDoubleClickZoom optional
Typ:  boolean optional
Włącza/wyłącza powiększenie i wyśrodkuj 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 "none".

draggable optional
Typ:  boolean optional
Jeśli ustawiona jest wartość false, uniemożliwia to przeciągnięcie 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ągać. Do zmiany ikony ta właściwość wykorzystuje atrybut CSS cursor. Podobnie jak w przypadku właściwości CSS, musisz określić co najmniej jeden kursor 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świetlany podczas przeciągania mapy. Do zmiany ikony ta właściwość wykorzystuje atrybut CSS cursor. Podobnie jak w przypadku właściwości CSS, musisz określić co najmniej jeden kursor 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 trybem pełnoekranowym.
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 przewijają stronę bez powiększania ani przesuwania mapy. Gesty dotykowe 2 palcami przesuwają i powiększają mapę. Zdarzenia przewijania za pomocą klawisza Ctrl lub ⌘ (klawisz ⌘) powiększają mapę.
    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" (wartość domyślna): sterowanie gestami może być oparte na współpracy lub zachłannym charakterze 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ą przyciągane pod najbliższym dostępnym kątem, dla którego dostępne są zdjęcia.
isFractionalZoomEnabled optional
Typ:  boolean optional
Domyślnie: 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, uniemożliwia to sterowanie mapą z poziomu klawiatury. Skróty klawiszowe są domyślnie włączone.
mapId optional
Typ:  string optional
Identyfikator mapy. Tego parametru nie można ustawić ani zmienić po utworzeniu wystąpienia mapy.
mapTypeControl optional
Typ:  boolean optional
Początkowy stan włączenia/wyłączenia elementu sterującego Typ mapy.
mapTypeControlOptions optional
Typ:  MapTypeControlOptions optional
Początkowe opcje wyświetlania elementu sterującego Typ mapy.
mapTypeId optional
Typ:  MapTypeId|string optional
Początkowy identyfikator typu mapy. Domyślna wartość to ROADMAP.
maxZoom optional
Typ:  number optional
Maksymalny poziom powiększenia wyświetlany na mapie. Jeśli ta opcja zostanie pominięta lub ustawiona na null, zamiast niej używane będzie maksymalne powiększenie w stosunku do 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 opcja zostanie pominięta lub ustawiona na null, zamiast niej używane będzie minimalne powiększenie mapy bieżącego typu. 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
Stan włączenia/wyłączenia elementu sterującego przesuwaniem.

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

restriction optional
Typ:  MapRestriction optional
Definiuje granicę ograniczającą obszar mapy dostępny dla użytkowników. Po ustawieniu tej opcji użytkownik może przesuwać i powiększać tylko wtedy, gdy widok kamery mieści się w granicach granicy.
rotateControl optional
Typ:  boolean optional
Stan włączenia/wyłączenia elementu sterującego obrotem.
rotateControlOptions optional
Typ:  RotateControlOptions optional
Opcje wyświetlania elementu sterującego obrotem.
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
W przypadku wartości 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 "cooperative" lub "none".

streetView optional
Typ:  StreetViewPanorama optional
StreetViewPanorama do wyświetlenia, gdy Pegman Street View zostanie przesunięty na mapę. Jeśli nie określisz panoramy, po upuszczeniu Pegmana na mapie wyświetli się domyślny StreetViewPanorama div.
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 użytkownika i powinien mieć wartość false podczas wyświetlania typu mapy, na której nie ma być wyświetlana nakładka drogi w 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 style te będą miały 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 pod kątem kąta padania 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, że kąt nachylenia automatycznie przełącza się na 45°, gdy dla bieżącego poziomu powiększenia i widocznego obszaru dostępne są zdjęcia 45°, oraz przełącza się z powrotem na 0, gdy zdjęcia 45° są niedostępne (jest to zachowanie domyślne). Zdjęcia 45° są dostępne tylko na mapach typu satellite i hybrid, w niektórych lokalizacjach i przy niektórych poziomach powiększenia. Uwaga: getTilt zwraca bieżący kąt pochylenia, a nie wartość określoną przez tę opcję. getTilt i ta opcja odnoszą się do różnych rzeczy, więc 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 HTMLElement.

Ta klasa implementuje MapElementOptions.

Uzyskaj dostęp, dzwoniąc pod numer const {MapElement} = await google.maps.importLibrary("maps"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

center
Typ:  LatLng|LatLngLiteral optional
Szerokość/długość geograficzna środkowa mapy.
Atrybut HTML:
  • <gmp-map center="lat,lng"></gmp-map>
innerMap
Typ:  Map
Odwołanie do Map, którego MapElement używa wewnętrznie.
mapId
Typ:  string optional
Identyfikator mapy. Więcej informacji znajdziesz w dokumentacji identyfikatora 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 boks reklamowy w pozycji ControlPosition.BLOCK_END_INLINE_CENTER.
control-block-end-inline-end
Umieszcza boks reklamowy w pozycji ControlPosition.BLOCK_END_INLINE_END.
control-block-end-inline-start
Umieszcza boks reklamowy w pozycji ControlPosition.BLOCK_END_INLINE_START.
control-block-start-inline-center
Umieszcza boks reklamowy w pozycji ControlPosition.BLOCK_START_INLINE_CENTER.
control-block-start-inline-end
Umieszcza boks reklamowy w pozycji ControlPosition.BLOCK_START_INLINE_END.
control-block-start-inline-start
Umieszcza boks reklamowy w pozycji ControlPosition.BLOCK_START_INLINE_START.
control-inline-end-block-center
Umieszcza boks reklamowy w pozycji ControlPosition.INLINE_END_BLOCK_CENTER.
control-inline-end-block-end
Umieszcza boks reklamowy w pozycji ControlPosition.INLINE_END_BLOCK_END.
control-inline-end-block-start
Umieszcza boks reklamowy w pozycji ControlPosition.INLINE_END_BLOCK_START.
control-inline-start-block-center
Umieszcza boks reklamowy w pozycji ControlPosition.INLINE_START_BLOCK_CENTER.
control-inline-start-block-end
Umieszcza boks reklamowy w pozycji ControlPosition.INLINE_START_BLOCK_END.
control-inline-start-block-start
Umieszcza boks reklamowy w pozycji ControlPosition.INLINE_START_BLOCK_START.
BetaaddEventListener
addEventListener(type, listener[, options])
Parametry: 
  • typestring Ciąg znaków reprezentujący typ zdarzenia, na które ma być nasłuchiwany ciąg znaków (wielkość liter ma znaczenie).
  • listenerEventListener|EventListenerObject obiekt, który otrzymuje powiadomienie. Musi to być funkcja lub obiekt z metodą handleEvent
  • optionsboolean|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 elementu docelowego. Zobacz addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametry: 
  • typestring ciąg tekstowy określający typ zdarzenia, z którego ma zostać usunięty detektor zdarzeń.
  • listenerEventListener|EventListenerObject detektor zdarzeń modułu obsługi zdarzeń usuwany z celu zdarzenia.
  • optionsboolean|EventListenerOptions optional Zobacz opcje
Zwracana wartość:  void
Usuwa z celu detektor zdarzeń zarejestrowany wcześniej w addEventListener. Zobacz removeEventListener.
gmp-zoomchange
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy zmieni się właściwość powiększenia mapy.

Interfejs MapElementOptions

google.maps.MapElementOptions interfejs

Obiekt MapElementOptions służy 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. Tego parametru nie można ustawić ani zmienić po utworzeniu wystąpienia mapy.
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 Event.

Uzyskaj dostęp, dzwoniąc 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 stylerów, które określają styl mapy. Selektory określają funkcje i elementy mapy, na które powinny one zostać wprowadzone, a style określają, jak te obiekty i elementy należy modyfikować. Szczegółowe informacje znajdziesz w informacjach o stylu.

stylers
Typ:  Array<Object>
Reguły stylu, które mają być stosowane do wybranych funkcji i elementów mapy. Reguły zostaną zastosowane w kolejności określonej w tej tablicy. Wskazówki dotyczące użycia i dozwolonych wartości znajdziesz w informacjach o stylach.
elementType optional
Typ:  string optional
Element, do którego ma zostać zastosowana stylizacja. Element to wizualny aspekt obiektu na mapie. Przykład: etykieta, ikona, linia tekstu lub wypełnienie zastosowane do geometrii. Opcjonalnie. Jeśli elementType nie został określony, przyjmuje się, że wartość to 'all'. Szczegółowe informacje o używaniu i dozwolonych wartościach znajdziesz w dokumentacji stylu.
featureType optional
Typ:  string optional
Funkcja lub grupa funkcji, do których ma zostać zastosowana stylizacja. Opcjonalnie. Jeśli featureType nie został określony, przyjmuje się, że wartość to 'all'. Szczegółowe informacje o używaniu 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ładkach oraz zawiera wszystkie pokazane 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 także polegać na strukturze DOM przy wewnętrznej implementacji interfejsu API Map Google. Z powodu wewnętrznego mapowania zdarzeń domEvent może mieć inną semantykę niż MapMouseEvent (np. „kliknięcie” MapMouseEvent może mieć typ domEvent KeyboardEvent.
latLng optional
Typ:  LatLng optional
Długość i szerokość geograficzna, które znajdowały się pod kursorem w momencie 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 rozpowszechnianie. Więcej informacji o identyfikatorach miejsc znajdziesz w przewodniku dla programistów dotyczącym interfejsu API Miejsc Google.

Ten interfejs rozszerza zakres MapMouseEvent.

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

Więcej informacji o identyfikatorach miejsc znajdziesz w przewodniku dla programistów dotyczącym interfejsu API Miejsc Google.

Odziedziczone: domEvent, latLng
Odziedziczone: stop

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

Uzyskaj dostęp, dzwoniąc pod numer const {MapTypeId} = await google.maps.importLibrary("maps"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

HYBRID Ten typ mapy wyświetla przezroczystą warstwę głównych ulic na zdjęciach satelitarnych.
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 obiektami fizycznymi, takimi jak ukształtowanie terenu i roślinność.

Klasa MapTypeRegistry

google.maps.MapTypeRegistry zajęcia

Rejestr instancji MapType oznaczony kluczem według identyfikatora MapType.

Ta klasa stanowi rozszerzenie MVCObject.

Uzyskaj dostęp, dzwoniąc pod numer const {MapTypeRegistry} = await google.maps.importLibrary("maps"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

MapTypeRegistry
MapTypeRegistry()
Parametry: brak
MapTypeRegistry zawiera kolekcję niestandardowych typów map dostępnych dla mapy, z których można korzystać. Interfejs API sprawdza ten rejestr, na przykład udostępniając listę typów map dostępnych w ramach ustawień.
set
set(id, mapType)
Parametry: 
  • idstring identyfikator MapType do dodania do rejestru.
  • mapTypeMapType|* obiekt MapType do dodania do rejestru.
Zwracana wartość: brak
Konfiguruje rejestr w taki sposób, aby powiązać przekazany identyfikator 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 opcji użytkownik może tylko przesuwać i powiększać w obrębie określonych granic. Ograniczenia mogą określać długość i szerokość geograficzną lub tylko szerokość geograficzną. W przypadku granic tylko szerokość geograficzna użyj długości geograficznej zachodniej i wschodniej -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, ustawiając flagę strictBounds na true. Dzięki temu użytkownik może oddalić obraz tak daleko, że nie mieści się w ograniczonym zakresie. Wartość domyślna to false, co oznacza, że użytkownik może pomniejszać widok, aż pojawi się cały ograniczony obszar, łącznie z obszarami spoza tego obszaru.

Klasa TrafficLayer

google.maps.TrafficLayer zajęcia

Warstwa natężenia ruchu.

Ta klasa stanowi rozszerzenie MVCObject.

Uzyskaj dostęp, dzwoniąc 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 warstwa.
setMap
setMap(map)
Parametry: 
Zwracana wartość: brak
Renderuje warstwę na określonej mapie. Jeśli ustawiona jest 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
Wartość domyślna: true
Czy warstwa natężenia ruchu jest automatycznie odświeżana przy użyciu aktualnych informacji.
map optional
Typ:  Map optional
Mapa, na której wyświetli się warstwa natężenia ruchu.

Klasa TransitLayer

google.maps.TransitLayer zajęcia

Warstwa transportu publicznego.

Ta klasa stanowi rozszerzenie MVCObject.

Uzyskaj dostęp, dzwoniąc 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 warstwa.
setMap
setMap(map)
Parametry: 
Zwracana wartość: brak
Renderuje warstwę na określonej mapie. Jeśli ustawiona jest wartość null, warstwa zostanie usunięta.
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Klasa BicyclingLayer

google.maps.BicyclingLayer zajęcia

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

Ta klasa stanowi rozszerzenie MVCObject.

Uzyskaj dostęp, dzwoniąc 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 warstwa.
setMap
setMap(map)
Parametry: 
Zwracana wartość: brak
Renderuje warstwę na określonej mapie. Jeśli ustawiona jest 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 ustawiania 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 wieloboczny wielokąt, który jest widocznym obszarem mapy. 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 obejmująca widoczny obszar.
nearLeft
Typ:  LatLng
nearRight
Typ:  LatLng

Stałe RenderingType

google.maps.RenderingType stałe

Uzyskaj dostęp, dzwoniąc 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 migawkę funkcji dostępnych obecnie w mapie. Pamiętaj, że niekoniecznie oznacza to, że odpowiednie moduły zostały wczytane lub zainicjowane, ale że bieżąca mapa ma uprawnienia do korzystania z tych interfejsów API. Listę dostępnych funkcji znajdziesz w właściwościach.

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