Klasa Map
Klasa google.maps.Map
Te zajęcia obejmują MVCObject
.
Zadzwoń pod numer const {Map} = await google.maps.importLibrary("maps")
, aby uzyskać dostęp. Zobacz biblioteki w interfejsie Maps JavaScript API.
Zespół | |
---|---|
Map |
Map(mapDiv[, opts]) Parametry:
Tworzy nową mapę wewnątrz danego kontenera HTML, który zwykle jest elementem DIV . |
Właściwości | |
---|---|
controls |
Typ:
Array<MVCArray<HTMLElement>> Dodatkowe opcje, które można dołączyć do mapy. Aby dodać element sterujący do mapy, dodaj <div> do elementu MVCArray odpowiadającego obiektowi ControlPosition , w którym ma być on renderowany. |
data |
Typ:
Data Wystąpienie Data powiązane z mapą. Dodaj cechy do tego obiektu Data , aby wyświetlać je w wygodny sposób na tej mapie. |
mapTypes |
Typ:
MapTypeRegistry Rejestr instancji MapType z identyfikatorem ciągu znaków. |
overlayMapTypes |
Dodatkowe typy map do nałożenia. Typy map nakładek są wyświetlane na górze mapy podstawowej, w której są dołączone, w kolejności, w jakiej są wymienione w tablicy overlayMapTypes (nakładki z wyższymi wartościami indeksu są wyświetlane przed nakładkami o niższych wartościach indeksu). |
Metody | |
---|---|
fitBounds |
fitBounds(bounds[, padding]) Parametry:
Zwracana wartość: brak
Ustawia widoczny obszar tak, aby zawierał określone granice. Uwaga: jeśli mapa jest ustawiona na display: none , funkcja fitBounds odczytuje rozmiar mapy 0 x 0, więc nie wykonuje żadnych działań. Aby zmienić widoczny obszar, gdy mapa jest ukryta, ustaw mapę na visibility: hidden , dzięki czemu element div będzie miał rzeczywisty rozmiar. W przypadku map wektorowych ta metoda ustawia przechylenie i kierunek mapy na domyślne wartości zerowe. Wywołanie tej metody może spowodować płynną animację, gdy mapa będzie przesuwać się i powiększać, aby wyrównać granice. Animacja tej metody zależy od wewnętrznej heurystyki. |
getBounds |
getBounds() Parametry: brak
Wartość zwrócona:
LatLngBounds|undefined Szerokość geograficzna (szerokość długości geograficznej) widocznego obszaru.Zwraca granice bieżącego/widocznego obszaru. Jeśli widoczna jest więcej niż jedna kopia świata, długość geograficzna mieści się w zakresie od -180 do 180 stopni (włącznie). Jeśli mapa nie została jeszcze zainicjowana lub wyśrodkowano i nie ustawiono powiększenia, wynik to undefined . W przypadku map wektorowych, w których pochylenie lub nagłówek nie są zerowe, zwrócone wartości graniczne szerokości i długości wskazują najmniejsze pole, które zawiera widoczny obszar widocznego obszaru mapy. Dokładny widoczny obszar widocznego obszaru mapy znajdziesz na stronie MapCanvasProjection.getVisibleRegion . |
getCenter |
getCenter() Parametry: brak
Wartość zwrotu:
LatLng|undefined |
getClickableIcons |
getClickableIcons() Parametry: brak
Wartość zwrotu:
boolean|undefined Zwraca klikalność mapy. Ikona mapy oznacza ciekawe miejsce, nazywane też miejscem Jeśli zwrócona wartość to true , ikony na mapie można klikać. |
|
getDatasetFeatureLayer(datasetId) Parametry:
Wartość zwrotu:
FeatureLayer Zwraca wartość FeatureLayer dla określonego parametru datasetId . Identyfikatory zbiorów danych musisz skonfigurować w konsoli Google Cloud. Jeśli identyfikator zbioru danych nie jest powiązany ze stylem mapy lub jeśli styl oparty na danych jest niedostępny (bez identyfikatora mapy, bez kafelków wektorowych, warstw stylów opartych na danych ani zbiorów danych skonfigurowanych w stylu mapy), rejestruje on błąd, a wynik FeatureLayer.isAvailable ma wartość Fałsz. |
getDiv |
getDiv() Parametry: brak
Zwracana wartość:
HTMLElement element mapDiv. |
getFeatureLayer |
getFeatureLayer(featureType) Parametry:
Wartość zwrotu:
FeatureLayer Zwraca wartość FeatureLayer konkretnej wartości FeatureType . W Google Cloud Console należy włączyć FeatureLayer . Jeśli FeatureLayer na tej mapie nie istnieje lub jeśli styl oparty na danych jest niedostępny (brak identyfikatora mapy, brak kafelków wektorowych i włączenie FeatureLayer nie jest włączone w stylu mapy), rejestrowany jest błąd, a wynik FeatureLayer.isAvailable ma wartość Fałsz.FeatureType |
getHeading |
getHeading() Parametry: brak
Wartość zwrotu:
number|undefined Zwraca nagłówek kompasu mapy. Wartość nagłówka jest mierzona w stopniach (w prawo) od kierunku kardynała na północy. Jeśli mapa nie jest jeszcze zainicjowana, wynik to undefined . |
getMapCapabilities |
getMapCapabilities() Parametry: brak
Wartość zwrotu:
MapCapabilities Informuje o obecnych możliwościach mapy na podstawie podanego identyfikatora mapy. |
getMapTypeId |
getMapTypeId() Parametry: brak
Wartość zwrotu:
MapTypeId|string|undefined |
getProjection |
getProjection() Parametry: brak
Wartość zwrotu:
Projection|undefined Zwraca aktualną wartość Projection . Jeśli mapa nie jest jeszcze zainicjowana, wynik to undefined . Posłuchaj zdarzenia projection_changed i sprawdź jego wartość, aby upewnić się, że nie jest to undefined . |
getRenderingType |
getRenderingType() Parametry: brak
Wartość zwrotu:
RenderingType Zwraca bieżący typ renderowania mapy. |
getStreetView |
getStreetView() Parametry: brak
Wartość zwrócona:
StreetViewPanorama panorama powiązana z mapą.Zwraca domyślną wartość StreetViewPanorama powiązaną z mapą, która może być domyślną panoramą umieszczoną na mapie lub panoramą ustawioną za pomocą setStreetView() . Zmiany wartości streetViewControl na mapie zostaną odzwierciedlone w widoku takiej wiążącej panoramy. |
getTilt |
getTilt() Parametry: brak
Wartość zwrotu:
number|undefined Zwraca bieżący kąt położenia mapy w stopniach od platformy widokowej do platformy. W przypadku map rastrowych wynikiem będzie 0 w przypadku zdjęć zrobionych bezpośrednio nad głową i 45 w przypadku zdjęć 45°. Ta metoda nie zwraca wartości określonej przez zasadę setTilt . Więcej informacji: setTilt . |
getZoom |
getZoom() Parametry: brak
Wartość zwrotu:
number|undefined Zwraca powiększenie mapy. Jeśli powiększenie nie zostało ustawione, wynik to undefined . |
moveCamera |
moveCamera(cameraOptions) Parametry:
Zwracana wartość: brak
Od razu ustaw kamerę na docelowych opcjach kamery, bez animacji. |
panBy |
panBy(x, y) Parametry:
Zwracana wartość: brak
Zmienia środek mapy przez podaną odległość w pikselach. Jeśli odległość jest mniejsza niż szerokość i wysokość mapy, przejście będzie płynnie animowane. Pamiętaj, że system współrzędnych mapy zwiększa się z zachodu na wschód (wartości x), a z północy na południe (wartości y). |
panTo |
panTo(latLng) Parametry:
Zwracana wartość: brak
Zmienia środek mapy na podany LatLng . Jeśli zmiana jest mniejsza niż szerokość i wysokość mapy, przejście będzie płynnie animowane. |
panToBounds |
panToBounds(latLngBounds[, padding]) Parametry:
Zwracana wartość: brak
Przesuwa mapę o minimalną minimalną wartość, która obejmuje LatLngBounds . Nie ma gwarancji, gdzie na mapie będą znajdować się granice, poza tym, że mapa będzie przesunięta, aby pokazać jak najwięcej jej granic wewnątrz {currentMapSizeInPx} - {padding} . Zarówno mapy rastrowe, jak i wektorowe nie zmieniają powiększenia, pochylenia ani nagłówka. |
setCenter |
setCenter(latlng) Parametry:
Zwracana wartość: brak
|
setClickableIcons |
setClickableIcons(value) Parametry:
Zwracana wartość: brak
Określa, czy ikony mapy można klikać. Ikona mapy oznacza ciekawe miejsce, nazywane też miejscem Aby wyłączyć klikalność ikon mapy, przekaż do tej metody wartość false . |
setHeading |
setHeading(heading) Parametry:
Zwracana wartość: brak
Określa na kompasie kierunek, w którym mierzono stopnie w kierunku północnym. W przypadku map rastrowych ta metoda dotyczy tylko zdjęć lotniczych. |
setMapTypeId |
setMapTypeId(mapTypeId) Parametry:
Zwracana wartość: brak
|
setOptions |
setOptions(options) Parametry:
Zwracana wartość: brak
|
setStreetView |
setStreetView(panorama) Parametry:
Zwracana wartość: brak
Przypisuje StreetViewPanorama do mapy. Ta panorama zastępuje domyślną właściwość StreetViewPanorama , co umożliwia powiązanie mapy z panoramą zewnętrzną spoza mapy. Ustawienie panoramy na null powoduje powiązanie domyślnej umieszczonej panoramy z mapą. |
setTilt |
setTilt(tilt) Parametry:
Zwracana wartość: brak
W przypadku map wektorowych określa kąt występowania mapy. Dozwolone wartości są ograniczone w zależności od poziomu powiększenia mapy. W przypadku map rastrowych kontroluje automatyczne przełączanie pod kątem kąta intensywności mapy. Dozwolone są tylko wartości 0 i 45 . setTilt(0) powoduje, że mapa zawsze używa widoku z góry 0°, niezależnie od poziomu powiększenia i widocznego obszaru. setTilt(45) powoduje, że kąt nachylenia jest automatycznie zmieniany na 45°, gdy dostępne jest ustawienie 45°, gdy dostępny jest bieżący poziom powiększenia oraz widoczny obszar, i z powrotem ustawiam 0, jeśli obraz pod kątem 45° nie jest dostępny (jest to ustawienie domyślne). Zdjęcia pod kątem 45° są dostępne tylko dla typów map satellite i hybrid , w niektórych lokalizacjach oraz na niektórych poziomach powiększenia. Uwaga: getTilt zwraca bieżący kąt nachylenia, a nie wartość ustawioną w setTilt . getTilt i setTilt odnoszą się do różnych rzeczy, dlatego nie bind() używaj właściwości tilt . Może to mieć nieprzewidywalne skutki. |
setZoom |
setZoom(zoom) Parametry:
Zwracana wartość: brak
Ustawia powiększenie mapy. |
Dziedziczone:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Stałe | |
---|---|
DEMO_MAP_ID |
Identyfikator mapy, którego można używać w przykładach kodu wymagających identyfikatora mapy. Ten identyfikator mapy nie jest przeznaczony do użytku w aplikacjach produkcyjnych i nie można go używać w przypadku funkcji, które wymagają konfiguracji chmury (np. Cloud Styling). |
Zdarzenia | |
---|---|
bounds_changed |
function() Argumenty: brak
To zdarzenie jest wywoływane po zmianie granic widocznego obszaru. |
center_changed |
function() Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości centrum mapy. |
click |
function(event) Argumenty:
To zdarzenie jest wywoływane, gdy użytkownik kliknie mapę. Zwrócone jest zdarzenie MapMouseEvent z właściwościami klikniętej lokalizacji, chyba że została kliknięta ikona miejsca. W takim przypadku zwracana jest ikona IconMouseEvent z identyfikatorem miejsca. Wskaźniki IconMouseEvent i MapMouseEvent są identyczne, z tą różnicą, że IconMouseEvent ma pole identyfikatora miejsca. Jeśli identyfikator miejsca nie ma znaczenia, zdarzenie może być zawsze traktowane jako zdarzenie MapMouse. Zdarzenie kliknięcia nie jest wywoływane, gdy użytkownik kliknie znacznik lub okno informacyjne. |
contextmenu |
function(event) Argumenty:
To zdarzenie jest wywoływane po wywołaniu zdarzenia menu kontekstowego DOM w kontenerze mapy. |
dblclick |
function(event) Argumenty:
To zdarzenie jest wywoływane, gdy użytkownik kliknie dwukrotnie mapę. Zwróć uwagę, że zdarzenie kliknięcia będzie uruchamiane tuż przed tym. |
drag |
function() Argumenty: brak
To zdarzenie jest wywoływane wielokrotnie, gdy użytkownik przeciąga mapę. |
dragend |
function() Argumenty: brak
To zdarzenie jest wywoływane, gdy użytkownik przestaje przeciągać mapę. |
dragstart |
function() Argumenty: brak
To zdarzenie jest wywoływane, kiedy użytkownik zaczyna przeciągać mapę. |
heading_changed |
function() Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości nagłówka mapy. |
idle |
function() Argumenty: brak
To zdarzenie jest wywoływane, gdy mapa jest nieaktywny po przesunięciu lub powiększeniu. |
isfractionalzoomenabled_changed |
function() Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości isFractionalZoomEnabled. |
mapcapabilities_changed |
function() Argumenty: brak
To zdarzenie jest wywoływane po zmianie możliwości mapy. |
maptypeid_changed |
function() Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości mapTypeId. |
mousemove |
function(event) Argumenty:
To zdarzenie jest wywoływane za każdym razem, gdy użytkownik przesunie kursor myszy na kontener mapy. |
mouseout |
function(event) Argumenty:
To zdarzenie jest wywoływane po wyjściu przez użytkownika z kontenera mapy. |
mouseover |
function(event) Argumenty:
To zdarzenie jest wywoływane, gdy użytkownik przechodzi do kontenera mapy. |
projection_changed |
function() Argumenty: brak
To zdarzenie jest wywoływane po zmianie prognozy. |
renderingtype_changed |
function() Argumenty: brak
To zdarzenie jest wywoływane po zmianie ustawienia renderType. |
tilesloaded |
function() Argumenty: brak
To zdarzenie jest wywoływane po zakończeniu wczytywania widocznych kafelków. |
tilt_changed |
function() Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości przechylenia mapy. |
zoom_changed |
function() Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości powiększenia mapy. |
|
function(event) Argumenty:
To zdarzenie jest wywoływane, gdy użytkownik kliknie na mapie prawym przyciskiem myszy. |
Interfejs MapOptions
google.maps.MapOptions
interfejs
Obiekt MapOptions służący do definiowania właściwości, które można ustawić w Mapach.
Właściwości | |
---|---|
backgroundColor optional |
Typ:
string optional Kolor używany do tła elementu div mapy. Jest widoczny, gdy kafelki nie zostały jeszcze wczytane podczas przesuwania użytkownika. Ta opcja jest dostępna tylko przy inicjowaniu mapy. |
center optional |
Typ:
LatLng|LatLngLiteral optional Początkowe centrum mapy. |
clickableIcons optional |
Typ:
boolean optional Domyślne:
true Gdy ikona false nie jest klikalna, nie można jej kliknąć. Ikona mapy oznacza ciekawe miejsce, nazywane też miejscem |
controlSize optional |
Typ:
number optional Rozmiar pikseli sterujących elementów sterujących widocznych na mapie. Tę wartość należy podać bezpośrednio podczas tworzenia mapy. Później możesz zmienić stan elementów sterujących na undefined . Te ustawienia dotyczą tylko elementów sterujących interfejsu API Map Google. Nie skaluje niestandardowych elementów sterujących utworzonych przez dewelopera. |
disableDefaultUI optional |
Typ:
boolean optional Włącza/wyłącza wszystkie domyślne przyciski interfejsu. Można je zastępować pojedynczo. Nie wyłącza opcji klawiatury, które są niezależnie kontrolowane przez opcję MapOptions.keyboardShortcuts . Nie wyłącza sterowania gestami, które są kontrolowane osobno przez opcję MapOptions.gestureHandling . |
disableDoubleClickZoom optional |
Typ:
boolean optional Włącza lub wyłącza powiększenie i wyśrodkowowanie po dwukrotnym kliknięciu. Ta opcja jest domyślnie włączona. Uwaga: ta właściwość nie jest zalecana. Aby wyłączyć powiększenie dwukrotnego kliknięcia, możesz użyć właściwości |
|
Typ:
boolean optional Jeśli zasada false ma wartość, uniemożliwia przeciąganie mapy. Przeciąganie jest domyślnie włączone. |
draggableCursor optional |
Typ:
string optional Nazwa lub adres URL kursora wyświetlane po najechaniu kursorem na mapę. Ta właściwość do zmiany ikony używa atrybutu cursor CSS. Podobnie jak w przypadku właściwości CSS, musisz określić co najmniej 1 kursor kreacji zastępczej, który nie jest adresem URL. Przykład: draggableCursor: 'url(http://www.example.com/icon.png), auto;' . |
draggingCursor optional |
Typ:
string optional Nazwa lub adres URL kursora, które będą się wyświetlać podczas przeciągania mapy. Ta właściwość do zmiany ikony używa atrybutu cursor CSS. Podobnie jak w przypadku właściwości CSS, musisz określić co najmniej 1 kursor kreacji zastępczej, który nie jest adresem URL. Przykład: draggingCursor: 'url(http://www.example.com/icon.png), auto;' . |
fullscreenControl optional |
Typ:
boolean optional Włączony/wyłączony element sterujący trybem pełnoekranowym. |
fullscreenControlOptions optional |
Typ:
FullscreenControlOptions optional Opcje wyświetlania elementu sterującego na pełnym ekranie. |
gestureHandling optional |
Typ:
string optional To ustawienie kontroluje sposób, w jaki interfejs API obsługuje gesty na mapie. Dozwolone wartości:
|
heading optional |
Typ:
number optional Nagłówek zdjęć lotniczych w stopniach, mierzony w kierunku zgodnym z ruchem wskazówek zegara na północ. Nagłówki są przyciągane do najbliższego dostępnego kąta, dla którego są dostępne zdjęcia. |
isFractionalZoomEnabled optional |
Typ:
boolean optional Domyślnie:
true w przypadku map wektorowych i false w przypadku map rastrowychOkreśla, czy na mapie powinny być dozwolone ułamkowe poziomy powiększenia. Posłuchaj ustawienia isfractionalzoomenabled_changed , żeby dowiedzieć się, kiedy ustawiono ustawienie domyślne. |
keyboardShortcuts optional |
Typ:
boolean optional Jeśli zasada false uniemożliwia kontrolowanie mapy za pomocą klawiatury. Skróty klawiszowe są domyślnie włączone. |
mapId optional |
Typ:
string optional Identyfikator mapy. Po utworzeniu instancji mapy nie można ustawić ani zmienić tego parametru. |
mapTypeControl optional |
Typ:
boolean optional Początkowy włączony lub wyłączony stan sterowania mapą. |
mapTypeControlOptions optional |
Typ:
MapTypeControlOptions optional Początkowe opcje wyświetlania elementów sterujących Mapą. |
mapTypeId optional |
Typ:
MapTypeId|string optional Początkowy parametr mapTypeId. Domyślna wartość to ROADMAP . |
maxZoom optional |
Typ:
number optional Maksymalny poziom powiększenia, który będzie wyświetlany na mapie. Jeśli pominiesz ten parametr lub ustawisz wartość null , zostanie użyte maksymalne powiększenie bieżącego typu mapy. Prawidłowe wartości powiększenia to liczby od zera do obsługiwanego maksymalnego poziomu powiększenia. |
minZoom optional |
Typ:
number optional Minimalny poziom powiększenia, który będzie wyświetlany na mapie. Jeśli pominiesz ten parametr lub ustawisz wartość null , zostanie użyte minimalne powiększenie z bieżącego typu mapy. Prawidłowe wartości powiększenia to liczby od zera do obsługiwanego maksymalnego poziomu powiększenia. |
noClear optional |
Typ:
boolean optional Jeśli true , nie czyść zawartości elementu div mapy. |
panControl optional |
Typ:
boolean optional Włączony lub wyłączony element sterujący przesuwaniem. Uwaga: element sterujący „Przesuwanie” jest niedostępny w nowym zestawie elementów sterujących wprowadzonych w wersji 3.22 interfejsu API Map Google w języku JavaScript. Podczas korzystania z wersji 3.22 i 3.23 możesz używać wcześniejszego zestawu elementów sterujących zamiast nowych, dzięki czemu element sterujący przesuwaniem będzie dostępny jako część starego zestawu sterowania. Zobacz Nowości w wersji 3.22. |
panControlOptions optional |
Typ:
PanControlOptions optional Opcje wyświetlania elementu sterującego przesuwaniem. Uwaga: element sterujący „Przesuwanie” jest niedostępny w nowym zestawie elementów sterujących wprowadzonych w wersji 3.22 interfejsu API Map Google w języku JavaScript. Podczas korzystania z wersji 3.22 i 3.23 możesz używać wcześniejszego zestawu elementów sterujących zamiast nowych, dzięki czemu element sterujący przesuwaniem będzie dostępny jako część starego zestawu sterowania. Zobacz Nowości w wersji 3.22. |
restriction optional |
Typ:
MapRestriction optional Określa granicę, która ogranicza obszar mapy dostępny dla użytkowników. Po ustawieniu tego ustawienia użytkownik może przesuwać i powiększać tylko widok, gdy kamera wykracza poza granice. |
rotateControl optional |
Typ:
boolean optional Włączono/wyłączono ustawienie rotacji. |
rotateControlOptions optional |
Typ:
RotateControlOptions optional Opcje wyświetlania elementu sterującego obracaniem. |
scaleControl optional |
Typ:
boolean optional Początkowy włączony lub wyłączony stan wagi. |
scaleControlOptions optional |
Typ:
ScaleControlOptions optional Początkowe opcje wyświetlania wagi. |
scrollwheel optional |
Typ:
boolean optional Jeśli zasada false , wyłącza powiększenie mapy, używając kółka myszy. Kółko przewijania jest domyślnie włączone. Uwaga: ta właściwość nie jest zalecana. Aby wyłączyć powiększenie za pomocą kółka myszy, użyj właściwości |
streetView optional |
Typ:
StreetViewPanorama optional StreetViewPanorama , który wyświetla się, gdy użytkownik Pegmana Street View zostaje usunięty na mapie. Jeśli nie podasz panoramy, po kliknięciu Pegmana na mapie wyświetli się domyślna wartość StreetViewPanorama .div |
streetViewControl optional |
Typ:
boolean optional Początkowy włączony lub wyłączony stan Pegmana w Street View. Ten element sterujący jest częścią domyślnego interfejsu i powinien być ustawiony na false podczas wyświetlania typu mapy, na której nie powinna być wyświetlana nakładka widoku ulicy (np. typu mapy innego niż Earth). |
streetViewControlOptions optional |
Typ:
StreetViewControlOptions optional Początkowe opcje wyświetlania elementu sterującego Pegmanem w Street View. |
styles optional |
Typ:
Array<MapTypeStyle> optional Style stosowane do każdego domyślnego typu mapy. Pamiętaj, że w trybach satellite /hybrid i terrain te style będą stosowane tylko do etykiet i geometrii. |
tilt optional |
Typ:
number optional W przypadku map wektorowych określa kąt występowania mapy. Dozwolone wartości są ograniczone w zależności od poziomu powiększenia mapy. W przypadku map rastrowych kontroluje automatyczne przełączanie pod kątem kąta intensywności mapy. Dozwolone są tylko wartości 0 i 45 . Wartość 0 powoduje, że mapa zawsze używa widoku 0° z góry niezależnie od poziomu powiększenia i widocznego obszaru. Wartość 45 powoduje, że kąt nachylenia jest automatycznie zmieniany na 45, gdy dostępne są zdjęcia pod kątem 45°, gdy dostępny jest bieżący poziom powiększenia oraz widoczny obszar, i z powrotem ustawia się 0, jeśli obraz 45° nie jest dostępny (jest to ustawienie domyślne). Zdjęcia pod kątem 45° są dostępne tylko dla typów map satellite i hybrid , w niektórych lokalizacjach oraz na niektórych poziomach powiększenia. Uwaga: getTilt zwraca bieżący kąt nachylenia, a nie wartość określoną przez tę opcję. Parametr getTilt i ta opcja odnoszą się do różnych rzeczy, dlatego nie bind() używaj właściwości tilt . Takie działanie może mieć nieprzewidywalne skutki. |
zoom optional |
Typ:
number optional Początkowy poziom powiększenia mapy. Prawidłowe wartości powiększenia to liczby od zera do obsługiwanego maksymalnego poziomu powiększenia. Większe wartości powiększenia oznaczają wyższą rozdzielczość. |
zoomControl optional |
Typ:
boolean optional Włączony/wyłączony stan elementu sterującego powiększeniem. |
zoomControlOptions optional |
Typ:
ZoomControlOptions optional Opcje wyświetlania elementu sterującego powiększeniem. |
Klasa MapElement
Klasa google.maps.MapElement
MapElement to podklasa HTMLElement
do renderowania map. Po wczytaniu biblioteki maps
mapę można utworzyć w kodzie HTML. Na przykład:
<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID"></gmp-map>
Wewnętrznie używa elementu Map
, który jest dostępny we właściwości innerMap
.
Element niestandardowy:
<gmp-map center="lat,lng" map-id="string" zoom="number"></gmp-map>
Te zajęcia obejmują HTMLElement
.
Te zajęcia implementują MapElementOptions
.
Zadzwoń pod numer const {MapElement} = await google.maps.importLibrary("maps")
, aby uzyskać dostęp. Zobacz biblioteki w interfejsie Maps JavaScript API.
Właściwości | |
---|---|
center |
Typ:
LatLng|LatLngLiteral optional Atrybut HTML:
|
innerMap |
Typ:
Map Odwołanie do metody Map , której MapMap używa wewnętrznie. |
mapId |
Typ:
string optional Atrybut HTML:
|
zoom |
Typ:
number optional Atrybut HTML:
|
Metody | |
---|---|
|
addEventListener(type, listener[, options]) Parametry:
Wartość zwrotu:
void Konfiguruje funkcję, która będzie wywoływana za każdym razem, gdy określone zdarzenie zostanie dostarczone do celu. Zobacz addEventListener |
|
removeEventListener(type, listener[, options]) Parametry:
Wartość zwrotu:
void Usuwa odbiornik zarejestrowany wcześniej w usłudze addEventListener z poziomu elementu docelowego. Zobacz removeEventListener |
Interfejs MapElementOptions
google.maps.MapElementOptions
interfejs
Obiekt MapElementOptions używany do definiowania właściwości, które można ustawić w MapElement.
Właściwości | |
---|---|
center optional |
Typ:
LatLng|LatLngLiteral optional Początkowe centrum mapy. |
mapId optional |
Typ:
string optional Identyfikator mapy. Po utworzeniu instancji mapy nie można ustawić ani zmienić tego parametru. |
zoom optional |
Typ:
number optional Początkowy poziom powiększenia mapy. Prawidłowe wartości powiększenia to liczby od zera do obsługiwanego maksymalnego poziomu powiększenia. Większe wartości powiększenia oznaczają wyższą rozdzielczość. |
Interfejs MapTypeStyle
google.maps.MapTypeStyle
interfejs
MapTypeStyle
to zbiór selektorów i stylów określających styl mapy. Selektory określają elementy mapy lub elementy, których ma dotyczyć zmiana, a style – sposób, w jaki mają być modyfikowane. Szczegółowe informacje znajdziesz w przewodniku po stylu.
Właściwości | |
---|---|
stylers |
Reguły stylu, które mają być stosowane do wybranych elementów i elementów mapy. Reguły są stosowane w kolejności, którą określisz w tej tablicy. Wytyczne dotyczące stosowania i dozwolonych wartości znajdziesz w przewodniku po stylu. |
elementType optional |
Typ:
string optional Element, do którego należy zastosować styl. Element to wizualny aspekt obiektu na mapie. Przykłady: etykieta, ikona, kreska lub wypełnienie zastosowane do geometrii. Opcjonalnie. Jeśli nie określono właściwości elementType , przyjmuje się wartość 'all' . Szczegółowe informacje o wykorzystaniu i dozwolonych wartościach znajdziesz w dokumentacji stylu. |
featureType optional |
Typ:
string optional Obiekt lub grupa cech, do których należy zastosować styl. Opcjonalnie. Jeśli nie określono właściwości featureType , przyjmuje się wartość 'all' . Szczegółowe informacje o wykorzystaniu i dozwolonych wartościach znajdziesz w dokumentacji stylu. |
Interfejs MapMouseEvent
google.maps.MapMouseEvent
interfejs
Ten obiekt jest zwracany z różnych zdarzeń myszy na mapie i nakładki oraz zawiera wszystkie pola widoczne poniżej.
Właściwości | |
---|---|
domEvent |
Odpowiednie natywne zdarzenie DOM. Deweloperzy nie powinni polegać na zdefiniowanych i spójnych właściwościach target , currentTarget , relatedTarget i path . Deweloperzy nie powinni również polegać na strukturze DOM wewnętrznej implementacji interfejsu API Map Google. Ze względu na wewnętrzne mapowanie zdarzeń domEvent może mieć semantykę innego typu niż MapMouseEvent (np. domEvent „kliknięcie” może mieć typ domEvent domEvent ).MapMouseEvent KeyboardEvent |
latLng optional |
Typ:
LatLng optional Szerokość i szerokość geograficzna, która znajdowała się pod kursorem w czasie wystąpienia zdarzenia. |
Metody | |
---|---|
stop |
stop() Parametry: brak
Wartość zwrotu:
void Uniemożliwia to dalszemu rozpowszechnieniu tego zdarzenia. |
Interfejs IconMouseEvent
google.maps.IconMouseEvent
interfejs
Ten obiekt jest wysyłany, gdy użytkownik kliknie ikonę na mapie. Identyfikator miejsca tego miejsca jest przechowywany w elemencieplaceId. Aby zapobiec wyświetlaniu domyślnego okna informacyjnego, wywołaj metodę stop() tego zdarzenia, aby zapobiec jego rozpowszechnieniu. Więcej informacji o identyfikatorach miejsc znajdziesz w przewodniku dla programistów korzystających z interfejsu Places API.
Ten interfejs jest rozszerzany do MapMouseEvent
.
Właściwości | |
---|---|
placeId optional |
Typ:
string optional Identyfikator klikniętego miejsca. Ten identyfikator miejsca może służyć do wysyłania zapytań o więcej informacji o klikniętym obiekcie. Więcej informacji o identyfikatorach miejsc znajdziesz w przewodniku dla programistów korzystających z interfejsu Places API. |
Dziedziczone:
domEvent ,
latLng
|
Metody | |
---|---|
Dziedziczone:
stop
|
Stałe MapTypeId
google.maps.MapTypeId
stałe
Identyfikatory często używanych typów obiektów MapType. Możesz je określać według wartości lub używając nazwy stałej. na przykład 'satellite'
lub google.maps.MapTypeId.SATELLITE
.
Zadzwoń pod numer const {MapTypeId} = await google.maps.importLibrary("maps")
, aby uzyskać dostęp. Zobacz biblioteki w interfejsie Maps JavaScript API.
Stałe | |
---|---|
HYBRID |
Ten typ mapy pokazuje na zdjęciach satelitarnych przezroczystą warstwę głównych ulic. |
ROADMAP |
Ten typ mapy wyświetla normalną mapę ulic. |
SATELLITE |
Ten typ mapy wyświetla zdjęcia satelitarne. |
TERRAIN |
Ten typ mapy wyświetla mapy z elementami fizycznymi, takimi jak teren i roślinność. |
Klasa MapTypeRegistry
Klasa google.maps.MapTypeRegistry
Rejestr instancji MapType z kluczem IDType.
Te zajęcia obejmują MVCObject
.
Zadzwoń pod numer const {MapTypeRegistry} = await google.maps.importLibrary("maps")
, aby uzyskać dostęp. Zobacz biblioteki w interfejsie Maps JavaScript API.
Zespół | |
---|---|
MapTypeRegistry |
MapTypeRegistry() Parametry: brak
MapTypeRegistry zawiera zbiór dostępnych typów map, które można wykorzystać na mapie. Na przykład interfejs API sprawdza to rejestry, dostarczając listę typów map dostępnych w opcjach. |
Metody | |
---|---|
set |
set(id, mapType) Parametry:
Zwracana wartość: brak
Ustawia w rejestrze powiązanie przekazywanego identyfikatora ciągu znaków z przekazanym typem mapy. |
Dziedziczone:
addListener ,
bindTo ,
get ,
notify ,
setValues ,
unbind ,
unbindAll
|
Interfejs MapRestriction
google.maps.MapRestriction
interfejs
Ograniczenie, które można zastosować do mapy. Widoczny obszar mapy nie przekroczy tych ograniczeń.
Właściwości | |
---|---|
latLngBounds |
Po ustawieniu użytkownik może tylko przesuwać i powiększać widok w określonych granicach. Ograniczenia mogą ograniczać długość i szerokość geograficzną lub tylko szerokość geograficzną. W przypadku granic szerokości geograficznej użyj długości geograficznej zachodniej i wschodniej wynoszącej odpowiednio -180 i 180, na przykład latLngBounds: {north: northLat, south: southLat, west: -180, east: 180} . |
strictBounds optional |
Typ:
boolean optional Ograniczenia mogą być bardziej restrykcyjne, jeśli flaga strictBounds ma wartość true . Zmniejsza to odległość, jaką użytkownik może pomniejszyć, zapewniając, że wszystkie elementy znajdujące się poza granicami będą ukryte. Wartość domyślna to false , co oznacza, że użytkownik może pomniejszać widok, aż cały obszar ograniczony, włącznie z obszarami spoza niego. |
TrafficLayer
Klasa google.maps.TrafficLayer
Warstwa ruchu.
Te zajęcia obejmują MVCObject
.
Zadzwoń pod numer const {TrafficLayer} = await google.maps.importLibrary("maps")
, aby uzyskać dostęp. Zobacz biblioteki w interfejsie Maps JavaScript API.
Zespół | |
---|---|
TrafficLayer |
TrafficLayer([opts]) Parametry:
Warstwa pokazująca aktualny ruch drogowy. |
Metody | |
---|---|
getMap |
getMap() Parametry: brak
Wartość zwrotu:
Map Zwraca mapę, na której jest wyświetlana ta warstwa. |
setMap |
setMap(map) Parametry:
Zwracana wartość: brak
Renderuje warstwę na określonej mapie. Jeśli mapa ma wartość null , warstwa zostanie usunięta. |
setOptions |
setOptions(options) Parametry:
Zwracana wartość: brak
|
Dziedziczone:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Interfejs TrafficLayerOptions
google.maps.TrafficLayerOptions
interfejs
Obiekt TrafficLayerOptions używany do definiowania właściwości, które można ustawić w warstwie TrafficLayer.
Właściwości | |
---|---|
autoRefresh optional |
Typ:
boolean optional Domyślne:
true Określa, czy warstwa natężenia ruchu ma być odświeżana automatycznie po zaktualizowaniu informacji. |
map optional |
Typ:
Map optional Mapa, na której wyświetlana jest warstwa natężenia ruchu. |
Klasa TransitLayer
Klasa google.maps.TransitLayer
Warstwa transportu publicznego.
Te zajęcia obejmują MVCObject
.
Zadzwoń pod numer const {TransitLayer} = await google.maps.importLibrary("maps")
, aby uzyskać dostęp. Zobacz biblioteki w interfejsie Maps JavaScript API.
Zespół | |
---|---|
TransitLayer |
TransitLayer() Parametry: brak
Warstwa, w której wyświetlane są linie transportu publicznego. |
Metody | |
---|---|
getMap |
getMap() Parametry: brak
Wartość zwrotu:
Map Zwraca mapę, na której jest wyświetlana ta warstwa. |
setMap |
setMap(map) Parametry:
Zwracana wartość: brak
Renderuje warstwę na określonej mapie. Jeśli mapa ma wartość null , warstwa zostanie usunięta. |
Dziedziczone:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
zajęcia rowerowe
Klasa google.maps.BicyclingLayer
Warstwa pokazująca ścieżki i ścieżki rowerowe.
Te zajęcia obejmują MVCObject
.
Zadzwoń pod numer const {BicyclingLayer} = await google.maps.importLibrary("maps")
, aby uzyskać dostęp. Zobacz biblioteki w interfejsie Maps JavaScript API.
Zespół | |
---|---|
BicyclingLayer |
BicyclingLayer() Parametry: brak
Warstwa, która pokazuje pasy i ścieżki rowerowe, przesuwa szlaki w dół. |
Metody | |
---|---|
getMap |
getMap() Parametry: brak
Wartość zwrotu:
Map Zwraca mapę, na której jest wyświetlana ta warstwa. |
setMap |
setMap(map) Parametry:
Zwracana wartość: brak
Renderuje warstwę na określonej mapie. Jeśli mapa ma wartość null , warstwa zostanie usunięta. |
Dziedziczone:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Opcje aparatu
google.maps.CameraOptions
interfejs
Służy do ustawiania opcji aparatu na mapie.
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
Zawiera 4 punkty określające wielostronny wielokąt stanowiący widoczny obszar mapy. Na mapie wektorowej wielokąt może być trapezem, a nie prostokątem, gdy mapa wektorowa ma przechylenie.
Właściwości | |
---|---|
farLeft |
Typ:
LatLng |
farRight |
Typ:
LatLng |
latLngBounds |
Typ:
LatLngBounds Najmniejsza ramka ograniczająca z widocznym regionem. |
nearLeft |
Typ:
LatLng |
nearRight |
Typ:
LatLng |
Stałe renderType
google.maps.RenderingType
stałe
Zadzwoń pod numer const {RenderingType} = await google.maps.importLibrary("maps")
, aby uzyskać dostęp. Zobacz biblioteki w interfejsie Maps JavaScript API.
Stałe | |
---|---|
RASTER |
Wskazuje, że mapa jest mapą rastrową. |
UNINITIALIZED |
Wskazuje, że nie wiadomo jeszcze, czy mapa jest wektorowa, czy rastrowa, bo nie została jeszcze zainicjowana. |
VECTOR |
Wskazuje, że mapa jest wektorową. |
Interfejs MapCapabilities
google.maps.MapCapabilities
interfejs
Obiekt zawierający podsumowanie dostępnych możliwości mapy. Listę możliwości znajdziesz we właściwościach.
Właściwości | |
---|---|
isAdvancedMarkersAvailable optional |
Typ:
boolean optional |
isDataDrivenStylingAvailable optional |
Typ:
boolean optional |