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.
Zespół | |
---|---|
Map |
Map(mapDiv[, opts]) Parametry:
Tworzy nową mapę wewnątrz danego kontenera HTML, który jest zwykle elementem DIV . |
Stałe | |
---|---|
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). |
Właściwości | |
---|---|
controls |
Typ:
Array<MVCArray<HTMLElement>> 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 |
Typ:
MapTypeRegistry Rejestr MapType instancji według identyfikatora ciągu znaków. |
overlayMapTypes |
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). |
Metody | |
---|---|
fitBounds |
fitBounds(bounds[, padding]) Parametry:
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 |
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. |
|
getDatasetFeatureLayer(datasetId) Parametry:
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:
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
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:
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:
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:
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:
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:
Zwracana wartość: brak
Ustawia powiększenie mapy. |
Dziedziczone:
addListener , bindTo , get , notify , set , setValues , unbind , unbindAll
|
Wydarzenia | |
---|---|
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. |
|
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.
Właściwości | |
---|---|
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 |
|
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:
|
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 rastrowychOkreś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. |
|
Typ:
boolean optional Stan włączenia/wyłączenia elementu sterującego przesuwaniem. |
|
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 |
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.
Właściwości | |
---|---|
center |
Typ:
LatLng|LatLngLiteral optional Szerokość/długość geograficzna środkowa mapy.
Atrybut HTML:
|
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:
|
zoom |
Typ:
number optional Poziom powiększenia mapy.
Atrybut HTML:
|
Metody | |
---|---|
|
addEventListener(type, listener[, options]) Parametry:
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. |
|
removeEventListener(type, listener[, options]) Parametry:
Zwracana wartość:
void Usuwa z celu detektor zdarzeń zarejestrowany wcześniej w addEventListener. Zobacz removeEventListener. |
Wydarzenia | |
---|---|
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.
Właściwości | |
---|---|
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.
Właściwości | |
---|---|
stylers |
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.
Właściwości | |
---|---|
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. |
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 rozpowszechnianie. Więcej informacji o identyfikatorach miejsc znajdziesz w przewodniku dla programistów dotyczącym interfejsu API Miejsc Google.
Ten interfejs rozszerza zakres MapMouseEvent
.
Właściwości | |
---|---|
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
|
Metody | |
---|---|
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.
Stałe | |
---|---|
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.
Zespół | |
---|---|
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ń. |
Metody | |
---|---|
set |
set(id, mapType) Parametry:
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ń.
Właściwości | |
---|---|
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.
Zespół | |
---|---|
TrafficLayer |
TrafficLayer([opts]) Parametry:
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 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.
Właściwości | |
---|---|
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.
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 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.
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 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.
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 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.
Właściwości | |
---|---|
farLeft |
Typ:
LatLng |
farRight |
Typ:
LatLng |
latLngBounds |
Typ:
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.
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 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.
Właściwości | |
---|---|
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. |