Mapa zajęcia
google.maps.Map
zajęcia
Te zajęcia obejmują okres
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ę w danym kontenerze HTML, którym jest zwykle element DIV . |
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 (takich jak Styl Cloud). |
Właściwości | |
---|---|
controls |
Typ:
Array<MVCArray<HTMLElement>> Dodatkowe elementy sterujące, które można dołączyć do mapy. Aby dodać element sterujący do mapy, dodaj <div> elementu sterującego do parametru MVCArray odpowiadającego obiektowi ControlPosition , w którym ma być renderowany. |
data |
Typ:
Data Instancja Data powiązana z mapą. Dodaj cechy do tego obiektu Data , aby wygodnie wyświetlić 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 map nakładek są wyświetlane na mapie podstawowej, do której są dołączone, w kolejności, w jakiej występują w tablicy overlayMapTypes (nakładki o wyższych wartościach 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ł podane granice. Uwaga: jeśli mapa jest ustawiona na display: none , funkcja fitBounds odczytuje jej rozmiar jako 0 x 0 i dlatego nie wykonuje żadnych działań. Aby zmienić widoczny obszar, gdy mapa jest ukryta, ustaw ją na visibility: hidden . Zapewni to rzeczywisty rozmiar elementu div mapy. W przypadku map wektorowych ta metoda ustawia domyślną wartość przechylenia i kierunku mapy. Wywołanie tej metody może spowodować płynną animację, gdy mapa będzie przesuwana i powiększana odpowiednio do granic. To, czy ta metoda jest animowana, zależy od wewnętrznej heurystyki. |
getBounds |
getBounds() Parametry: brak
Zwracana wartość:
LatLngBounds|undefined granice szerokości i długości geograficznej bieżącego widocznego obszaru.Zwraca granice szerokości i długości geograficznej bieżącego widocznego obszaru. Jeśli widoczna jest więcej niż jedna kopia świata, granice geograficzne mieszczą się w zakresie od -180 do 180 stopni włącznie. Jeśli mapa nie jest jeszcze zainicjowana lub wyśrodkowana, a powiększenie nie zostało ustawione, wynik to undefined . W przypadku map wektorowych z pochyleniem lub kierunkiem o wartości niezerowej zwrócone granice szerokości i długości geograficznej oznaczają najmniejszą ramkę ograniczającą, która obejmuje widoczny obszar widoku mapy. Aby zobaczyć dokładny obszar widocznego obszaru mapy, sprawdź MapCanvasProjection.getVisibleRegion . |
getCenter |
getCenter() Parametry: brak
Zwracana wartość:
LatLng|undefined |
getClickableIcons |
getClickableIcons() Parametry: brak
Zwracana wartość:
boolean|undefined Zwraca klikalność ikon na mapie. Ikona mapy przedstawia ciekawe miejsce, nazywane również ważnym miejscem. Jeżeli zwrócona wartość to true , ikony na mapie można kliknąć. |
|
getDatasetFeatureLayer(datasetId) Parametry:
Zwracana wartość:
FeatureLayer Zwraca FeatureLayer dla określonego parametru datasetId . Identyfikatory zbiorów danych należy skonfigurować w konsoli Google Cloud. Jeśli identyfikator zbioru danych nie jest powiązany ze stylem mapy mapy lub styl oparty na danych jest niedostępny (brak identyfikatora mapy, brak kafelków wektorowych, warstwy cech ze stylem opartym na danych lub zbiory danych skonfigurowane w stylu mapy), to powoduje zgłoszenie błędu, a wynik FeatureLayer.isAvailable ma wartość false (fałsz). |
getDiv |
getDiv() Parametry: brak
Zwracana wartość:
HTMLElement wartość atrybutu mapDiv na mapie. |
getFeatureLayer |
getFeatureLayer(featureType) Parametry:
Zwracana wartość:
FeatureLayer Zwraca FeatureLayer określonej wartości FeatureType . W konsoli Google Cloud musi być włączona usługa FeatureLayer . Jeśli na tej mapie nie ma elementu FeatureLayer z określonego elementu FeatureType lub styl oparty na danych jest niedostępny (brak identyfikatora mapy, brak kafelków wektorowych i brak włączonego elementu FeatureLayer w stylu mapy), powoduje to zarejestrowanie błędu, a wynik FeatureLayer.isAvailable ma wartość false (fałsz). |
getHeading |
getHeading() Parametry: brak
Zwracana wartość:
number|undefined Zwraca kierunek kompasu na mapie. Wartość kierunku jest mierzona w stopniach (w prawo) od kierunku północnego. Jeśli mapa nie została jeszcze zainicjowana, wynik to undefined . |
getHeadingInteractionEnabled |
getHeadingInteractionEnabled() Parametry: brak
Zwracana wartość:
boolean|null Wskazuje, czy interakcje z nagłówkami są włączone. Ta opcja jest dostępna tylko wtedy, gdy mapa jest mapą wektorową. Jeśli nie jest ustawiona w kodzie, używana jest konfiguracja chmury dla identyfikatora mapy (jeśli jest dostępna). |
getMapCapabilities |
getMapCapabilities() Parametry: brak
Zwracana wartość:
MapCapabilities Informuje element wywołujący o aktualnych możliwościach dostępnych dla mapy na podstawie podanego identyfikatora mapy. |
getMapTypeId |
getMapTypeId() Parametry: brak
Zwracana wartość:
MapTypeId|string|undefined |
getProjection |
getProjection() Parametry: brak
Zwracana wartość:
Projection|undefined Zwraca bieżącą wartość Projection . Jeśli mapa nie została jeszcze zainicjowana, wynik to undefined . Wysłuchaj zdarzenia projection_changed i sprawdź jego wartość, aby upewnić się, że nie jest to undefined . |
getRenderingType |
getRenderingType() Parametry: brak
Zwracana wartość:
RenderingType Zwraca bieżący obiekt RenderingType mapy. |
getStreetView |
getStreetView() Parametry: brak
Return Value (Wartość zwrócona):
StreetViewPanorama panorama powiązana z mapą.Zwraca domyślną panoramę StreetViewPanorama powiązaną z mapą, która może być domyślną panoramą umieszczoną w obrębie mapy lub panoramą ustawioną w setStreetView() . Zmiany tego parametru (streetViewControl ) będą odzwierciedlane na wyświetlaczu 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ęć pod kątem 45°. Ta metoda nie zwraca wartości ustawionej przez funkcję setTilt . Aby dowiedzieć się więcej, wejdź na setTilt . |
getTiltInteractionEnabled |
getTiltInteractionEnabled() Parametry: brak
Zwracana wartość:
boolean|null Wskazuje, czy są włączone interakcje przechylania. Ta opcja jest dostępna tylko wtedy, gdy mapa jest mapą wektorową. Jeśli nie jest ustawiona w kodzie, używana jest konfiguracja chmury dla identyfikatora mapy (jeśli jest dostępna). |
getZoom |
getZoom() Parametry: brak
Zwracana wartość:
number|undefined Zwraca powiększenie mapy. Jeśli powiększenie nie zostało ustawione, wynik to undefined . |
moveCamera |
moveCamera(cameraOptions) Parametry:
Zwracana wartość: brak
Natychmiast ustawia kamerę na mapie 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 rośnie z zachodu na wschód (w przypadku wartości x) i z północy na południe (w przypadku wartości y). |
panTo |
panTo(latLng) Parametry:
Zwracana wartość: brak
Zmienia środek mapy na 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ą wartość niezbędną do umieszczenia na mapie LatLngBounds . Nie ma gwarancji, w którym miejscu na mapie pojawią się granice. Jedyna różnica polega na tym, że mapa zostanie przesunięta tak, aby pokazać jak najwięcej granic wewnątrz obszaru {currentMapSizeInPx} - {padding} . W przypadku map rastrowych i wektorowych powiększenie, pochylenie i kierunek mapy pozostają niezmienione. |
setCenter |
setCenter(latlng) Parametry:
Zwracana wartość: brak
|
setClickableIcons |
setClickableIcons(value) Parametry:
Zwracana wartość: brak
Określa, czy ikony na mapie mają być klikalne. Ikona mapy przedstawia ciekawe miejsce, nazywane również ważnym miejscem. Aby wyłączyć klikalność ikon mapy, przekaż do tej metody wartość false . |
setHeading |
setHeading(heading) Parametry:
Zwracana wartość: brak
Określa kierunek kompasu na mapie mierzony w stopniach od kierunku północnego. W przypadku map rastrowych ta metoda dotyczy tylko zdjęć lotniczych. |
setHeadingInteractionEnabled |
setHeadingInteractionEnabled(headingInteractionEnabled) Parametry:
Zwracana wartość: brak
Określa, czy mają być włączone interakcje z nagłówkami. Ta opcja jest dostępna tylko wtedy, gdy mapa jest mapą wektorową. Jeśli nie jest ustawiona w kodzie, używana jest konfiguracja chmury dla identyfikatora mapy (jeśli jest dostępna). |
setMapTypeId |
setMapTypeId(mapTypeId) Parametry:
Zwracana wartość: brak
|
setOptions |
setOptions(options) Parametry:
Zwracana wartość: brak
|
setRenderingType |
setRenderingType(renderingType) Parametry:
Zwracana wartość: brak
Ustawia bieżący obiekt RenderingType mapy. |
setStreetView |
setStreetView(panorama) Parametry:
Zwracana wartość: brak
Wiąże obiekt StreetViewPanorama z mapą. Ta panorama zastępuje domyślną wartość StreetViewPanorama , umożliwiając powiązanie mapy z zewnętrzną panoramą spoza mapy. Ustawienie panoramy null powoduje powiązanie domyślnej, umieszczonej panoramy z powrotem na mapie. |
setTilt |
setTilt(tilt) Parametry:
Zwracana wartość: brak
W przypadku map wektorowych określa kąt oddziaływania mapy. Dozwolone wartości są ograniczone w zależności od powiększenia mapy. W przypadku map rastrowych kontroluje działanie automatycznego przełączania kąta patrzenia na mapę. Jedyne dozwolone wartości to 0 i 45 . setTilt(0) powoduje, że mapa zawsze jest wyświetlana z powietrza na poziomie 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 są zdjęcia 45° dla bieżącego poziomu powiększenia i widocznego obszaru. Natomiast jeśli zdjęcia pod kątem 45° są niedostępne (jest to działanie domyślne), przełącza się z powrotem na 0. Zdjęcia pod kątem 45° są dostępne tylko dla map typu satellite i hybrid , w niektórych lokalizacjach oraz przy niektórych poziomach powiększenia. Uwaga: getTilt zwraca bieżący kąt pochylenia, a nie wartość ustawioną przez setTilt . Ponieważ getTilt i setTilt odnoszą się do różnych rzeczy, nie używaj bind() właściwości tilt ; może to przynieść nieprzewidywalne skutki. |
setTiltInteractionEnabled |
setTiltInteractionEnabled(tiltInteractionEnabled) Parametry:
Zwracana wartość: brak
Określa, czy mają być włączone interakcje przechylania. Ta opcja jest dostępna tylko wtedy, gdy mapa jest mapą wektorową. Jeśli nie jest ustawiona w kodzie, używana jest konfiguracja chmury dla identyfikatora mapy (jeśli jest dostępna). |
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
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:
Zdarzenie to jest wywoływane, gdy użytkownik kliknie mapę. Zwracane jest zdarzenie MapMouseEvent z właściwościami dla klikniętej lokalizacji, chyba że użytkownik kliknął ikonę miejsca – wtedy zwracane jest zdarzenie IconMouseEvent z identyfikatorem miejsca. IconMouseEvent i MapMouseEvent są identyczne z wyjątkiem pola IconMouseEvent, które zawiera pole identyfikatora miejsca. Zdarzenie może być zawsze traktowane jako MapMouseEvent, gdy identyfikator miejsca nie jest ważny. Zdarzenie kliknięcia nie jest wywoływane po kliknięciu znacznika lub okna informacyjnego. |
contextmenu |
function(event) Argumenty:
To zdarzenie jest wywoływane po wywołaniu zdarzenia menu kontekstowego DOM w kontenerze mapy. |
dblclick |
function(event) Argumenty:
Zdarzenie to jest wywoływane, gdy użytkownik dwukrotnie kliknie mapę. Pamiętaj, że zdarzenie kliknięcia będzie czasem uruchamiane raz, a czasem dwa razy, tuż przed tym. |
drag |
function() Argumenty: brak
To zdarzenie jest wielokrotnie wywoływane, 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, gdy 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 stanie się nieaktywna 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 mysz użytkownika znajdzie się w kontenerze 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 parametru 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:
Zdarzenie to jest wywoływane, gdy użytkownik kliknie mapę prawym przyciskiem myszy. |
MapOptions interfejs
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żyty jako tło elementu div mapy. Ten kolor będzie widoczny, gdy kafelki nie zostaną załadowane podczas przesuwania przez użytkownika. Tę opcję można ustawić tylko podczas inicjowania mapy. |
center optional |
Typ:
LatLng|LatLngLiteral optional Początkowe centrum mapy. |
clickableIcons optional |
Typ:
boolean optional Wartość domyślna:
true Gdy false , ikony mapy nie są klikalne. Ikona mapy przedstawia ciekawe miejsce, nazywane również ważnym miejscem. |
|
Typ:
ColorScheme|string optional Wartość domyślna:
ColorScheme.LIGHT Początkowy schemat kolorów mapy. Tę opcję można ustawić tylko podczas inicjowania mapy. |
controlSize optional |
Typ:
number optional Rozmiar elementów sterujących wyświetlanych na mapie w pikselach. Tę wartość należy podać bezpośrednio podczas tworzenia mapy. Późniejsza aktualizacja może spowodować zmianę ustawień na undefined . Dotyczy to tylko ustawień utworzonych przez interfejs API Map Google. Nie skaluje ustawień niestandardowych utworzonych przez dewelopera. |
disableDefaultUI optional |
Typ:
boolean optional Włącza/wyłącza wszystkie domyślne przyciski interfejsu. Można ją zastąpić pojedynczo. Nie wyłącza sterowania za pomocą klawiatury, którym oddzielnie zarządza opcja MapOptions.keyboardShortcuts . Nie wyłącza sterowania gestami, którym oddzielnie zarządza opcja MapOptions.gestureHandling . |
disableDoubleClickZoom optional |
Typ:
boolean optional Włącza/wyłącza powiększenie i wyśrodkowanie po dwukrotnym kliknięciu. Ta opcja jest domyślnie włączona. Uwaga: ta właściwość nie jest zalecana. Aby wyłączyć powiększanie po podwójnym kliknięciu, możesz użyć właściwości |
|
Typ:
boolean optional Jeśli false , uniemożliwia przeciągnięcie mapy. Przeciąganie jest domyślnie włączone. |
draggableCursor optional |
Typ:
string optional Nazwa lub adres URL kursora wyświetlanego po najechaniu kursorem na mapę, którą można przeciągać. Ta usługa zmienia ikonę za pomocą atrybutu CSS cursor . Podobnie jak w przypadku właściwości CSS, musisz określić co najmniej jeden zastępczy kursor, 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świetlanego podczas przeciągania mapy. Ta usługa zmienia ikonę za pomocą atrybutu CSS cursor . Podobnie jak w przypadku właściwości CSS, musisz określić co najmniej jeden zastępczy kursor, który nie jest adresem URL. Na przykład: draggingCursor: 'url(http://www.example.com/icon.png), auto;' . |
fullscreenControl optional |
Typ:
boolean optional Włączono/wyłączono stan elementu sterującego pełnego ekranu. |
fullscreenControlOptions optional |
Typ:
FullscreenControlOptions optional Opcje wyświetlania elementów sterujących pełnego ekranu. |
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 Kierunek na zdjęciach lotniczych mierzony w stopniach w prawo od kierunku północnego, w kierunku Kardynała. Nagłówki są przyciągane do najbliższego dostępnego kąta, dla którego dostępne są zdjęcia. |
headingInteractionEnabled optional |
Typ:
boolean optional Wartość domyślna:
false Określa, czy mapa powinna zezwalać użytkownikom na sterowanie kierunkiem kamery (obracaniem). Ta opcja jest dostępna tylko wtedy, gdy mapa jest mapą wektorową. Jeśli nie jest ustawiona w kodzie, używana jest konfiguracja chmury dla identyfikatora mapy (jeśli jest dostępna). |
isFractionalZoomEnabled optional |
Typ:
boolean optional Domyślnie:
true w przypadku map wektorowych i false w przypadku map rastrowychOkreśla, czy mapa powinna zezwalać na częściowe powiększenie. Włącz isfractionalzoomenabled_changed , aby dowiedzieć się, kiedy wartość domyślna została ustawiona. |
keyboardShortcuts optional |
Typ:
boolean optional Jeśli false , uniemożliwia sterowanie mapą 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. Za pomocą Map.DEMO_MAP_ID możesz wypróbować funkcje, które wymagają identyfikatora mapy, ale nie wymagają włączenia chmury. |
mapTypeControl optional |
Typ:
boolean optional Początkowy stan włączenia/wyłączenia ustawienia typu mapy. |
mapTypeControlOptions optional |
Typ:
MapTypeControlOptions optional Początkowe opcje wyświetlania dla elementów sterujących typu mapy. |
mapTypeId optional |
Typ:
MapTypeId|string optional Początkowy identyfikator mapTypeId. Domyślna wartość to ROADMAP . |
maxZoom optional |
Typ:
number optional Maksymalny poziom powiększenia, który będzie wyświetlany na mapie. Jeśli ta opcja zostanie pominięta lub ustawiona na null , zamiast niej zostanie użyte maksymalne powiększenie bieżącego typu mapy. Prawidłowe wartości powiększenia to liczby od 0 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 , w zamian używane będzie minimalne powiększenie bieżącego typu mapy. Prawidłowe wartości powiększenia to liczby od 0 do obsługiwanego maksymalnego poziomu powiększenia. |
noClear optional |
Typ:
boolean optional Jeśli true , nie usuwaj zawartości elementu div mapy. |
|
Typ:
boolean optional Włączono/wyłączono stan elementu sterującego przesuwaniem. |
|
Typ:
PanControlOptions optional Opcje wyświetlania elementu sterującego przesuwaniem. |
renderingType optional |
Typ:
RenderingType optional Wartość domyślna:
RenderingType.RASTER Określa, czy mapa powinna być mapą rastrową lub wektorową. Po utworzeniu instancji mapy nie można ustawić ani zmienić tego parametru. Jeśli zasada nie jest skonfigurowana, typ renderowania (jeśli jest dostępny) zależy od konfiguracji identyfikatora mapy w chmurze. Pamiętaj, że mapy wektorowe mogą być niedostępne na niektórych urządzeniach i w niektórych przeglądarkach. W razie potrzeby użyjemy mapy rastrowej. |
restriction optional |
Typ:
MapRestriction optional Określa granicę, która ogranicza obszar mapy dostępny dla użytkowników. Po ustawieniu użytkownik może tylko przesuwać i powiększać obraz, gdy pole widzenia kamery mieści się w granicach granicy. |
rotateControl optional |
Typ:
boolean optional Włączono/wyłączono stan elementu sterującego obrotem. |
rotateControlOptions optional |
Typ:
RotateControlOptions optional Opcje wyświetlania elementów sterujących obrotem. |
scaleControl optional |
Typ:
boolean optional Początkowy stan włączenia/wyłączenia ustawienia wagi. |
scaleControlOptions optional |
Typ:
ScaleControlOptions optional Początkowe opcje wyświetlania dla ustawienia skali. |
scrollwheel optional |
Typ:
boolean optional Jeśli false , wyłącza powiększanie mapy za pomocą kółka do przewijania myszy. Kółko do przewijania 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 , który wyświetla się, gdy Pegman Street View zostanie upuszczony na mapie. Jeśli nie określisz panoramy, po upuszczeniu Pegmana na mapie div wyświetli się domyślna wartość StreetViewPanorama . |
streetViewControl optional |
Typ:
boolean optional Początkowy stan włączenia/wyłączenia elementu sterującego Pegmana w Street View. To element sterujący jest częścią domyślnego interfejsu użytkownika.Podczas wyświetlania typu mapy, na której nie powinno się pojawiać nakładka dróg Street View (np. mapy spoza Earth), należy ustawić dla niej wartość false . |
streetViewControlOptions optional |
Typ:
StreetViewControlOptions optional Wstępne opcje wyświetlania dla 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 mapy. Pamiętaj, że w trybach satellite /hybrid i terrain te style będą stosowane tylko do etykiet i geometrii. Ta funkcja jest niedostępna, gdy używasz identyfikatora mapy lub map wektorowych (zamiast tego użyj określania stylu map w chmurze). |
tilt optional |
Typ:
number optional W przypadku map wektorowych określa kąt oddziaływania mapy. Dozwolone wartości są ograniczone w zależności od powiększenia mapy. W przypadku map rastrowych kontroluje działanie automatycznego przełączania kąta patrzenia na mapę. Jedyne dozwolone wartości to 0 i 45 . Wartość 0 sprawia, że mapa zawsze jest wyświetlana z powietrza o wartości 0°, 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° dla bieżącego poziomu powiększenia i widocznego obszaru. Natomiast jeśli zdjęcia pod kątem 45° są niedostępne (jest to działanie domyślne), przełącza się z powrotem na 0. Zdjęcia pod kątem 45° są dostępne tylko dla map typu satellite i hybrid , w niektórych lokalizacjach oraz przy niektórych poziomach powiększenia. Uwaga: getTilt zwraca bieżący kąt pochylenia, a nie wartość określoną przez tę opcję. Ponieważ getTilt i ta opcja odnoszą się do różnych rzeczy, nie używaj bind() właściwości tilt . może to przynieść nieprzewidywalne skutki. |
tiltInteractionEnabled optional |
Typ:
boolean optional Wartość domyślna:
false Określa, czy mapa powinna umożliwiać użytkownikowi kontrolowanie przechylenia kamery. Ta opcja jest dostępna tylko wtedy, gdy mapa jest mapą wektorową. Jeśli nie jest ustawiona w kodzie, używana jest konfiguracja chmury dla identyfikatora mapy (jeśli jest dostępna). |
zoom optional |
Typ:
number optional Początkowy poziom powiększenia mapy. Prawidłowe wartości powiększenia to liczby od 0 do obsługiwanego maksymalnego poziomu powiększenia. Większe wartości powiększenia oznaczają wyższą rozdzielczość. |
zoomControl optional |
Typ:
boolean optional Włączono lub wyłączono element sterujący powiększeniem. |
zoomControlOptions optional |
Typ:
ZoomControlOptions optional Opcje wyświetlania elementów sterujących powiększeniem. |
MapElement zajęcia
google.maps.MapElement
zajęcia
MapElement to podklasa HTMLElement
na potrzeby renderowania map. Po załadowaniu biblioteki maps
możesz 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 jest to funkcja
Map
, która jest dostępna za pomocą właściwości innerMap
.
Element niestandardowy:
<gmp-map center="lat,lng" heading-interaction-disabled map-id="string" rendering-type="vector" tilt-interaction-disabled zoom="number"></gmp-map>
Te zajęcia obejmują okres
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.
Zespół | |
---|---|
MapElement |
MapElement([options]) Parametry:
|
Właściwości | |
---|---|
center |
Typ:
LatLng|LatLngLiteral optional Długość i szerokość geograficzna środkowa mapy.
Atrybut HTML:
|
headingInteractionDisabled |
Typ:
boolean optional Wartość domyślna:
false Określa, czy mapa powinna zezwalać użytkownikom na sterowanie kierunkiem kamery (obracaniem). Ta opcja jest dostępna tylko wtedy, gdy mapa jest mapą wektorową. Jeśli nie jest ustawiona w kodzie, używana jest konfiguracja chmury dla identyfikatora mapy (jeśli jest dostępna).
Atrybut HTML:
|
innerMap |
Typ:
Map Odwołanie do obiektu Map , którego MapElement używa wewnętrznie. |
mapId |
Typ:
string optional Identyfikator mapy. Po utworzeniu instancji mapy nie można ustawić ani zmienić tego parametru. Za pomocą
Map.DEMO_MAP_ID możesz wypróbować funkcje, które wymagają identyfikatora mapy, ale nie wymagają włączenia chmury.Atrybut HTML:
|
renderingType |
Typ:
RenderingType optional Wartość domyślna:
RenderingType.VECTOR Określa, czy mapa powinna być mapą rastrową lub wektorową. Po utworzeniu instancji mapy nie można ustawić ani zmienić tego parametru. Jeśli zasada nie jest skonfigurowana, typ renderowania (jeśli jest dostępny) zależy od konfiguracji identyfikatora mapy w chmurze. Pamiętaj, że mapy wektorowe mogą być niedostępne na niektórych urządzeniach i w niektórych przeglądarkach. W razie potrzeby użyjemy mapy rastrowej.
Atrybut HTML:
|
tiltInteractionDisabled |
Typ:
boolean optional Wartość domyślna:
false Określa, czy mapa powinna umożliwiać użytkownikowi kontrolowanie przechylenia kamery. Ta opcja jest dostępna tylko wtedy, gdy mapa jest mapą wektorową. Jeśli nie jest ustawiona w kodzie, używana jest konfiguracja chmury dla identyfikatora mapy (jeśli jest dostępna).
Atrybut HTML:
|
zoom |
Typ:
number optional Poziom powiększenia mapy. Prawidłowe wartości powiększenia to liczby od 0 do obsługiwanego maksymalnego poziomu powiększenia. Większe wartości powiększenia oznaczają wyższą rozdzielczość.
Atrybut HTML:
|
Metody | |
---|---|
|
addEventListener(type, listener[, options]) Parametry:
Zwracana wartość:
void Ustawia funkcję, która będzie wywoływana za każdym razem, gdy określone zdarzenie pojawi się w miejscu docelowym. Zobacz addEventListener |
|
removeEventListener(type, listener[, options]) Parametry:
Zwracana wartość:
void Usuwa z miejsca docelowego detektor zdarzeń zarejestrowany wcześniej za pomocą addEventListener. Zobacz removeEventListener. |
Wydarzenia | |
---|---|
gmp-zoomchange |
function(event) Argumenty:
To zdarzenie jest wywoływane po zmianie właściwości powiększenia mapy. |
MapElementOptions interfejs
google.maps.MapElementOptions
interfejs
Obiekt MapElementOptions używany do definiowania właściwości, które można ustawić w elemencie MapElement.
Właściwości | |
---|---|
center optional |
Typ:
LatLng|LatLngLiteral optional Zobacz MapElement.center . |
headingInteractionDisabled optional |
Typ:
boolean optional |
mapId optional |
Typ:
string optional Zobacz MapElement.mapId . |
renderingType optional |
Typ:
RenderingType optional Zobacz MapElement.renderingType . |
tiltInteractionDisabled optional |
Typ:
boolean optional |
zoom optional |
Typ:
number optional Zobacz MapElement.zoom . |
ZoomChangeEvent zajęcia
google.maps.ZoomChangeEvent
zajęcia
To zdarzenie jest tworzone na podstawie monitorowania zmiany powiększenia.
Te zajęcia obejmują okres
Event
Uzyskaj dostęp, dzwoniąc pod numer const {ZoomChangeEvent} = await google.maps.importLibrary("maps")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
MapTypeStyle interfejs
google.maps.MapTypeStyle
interfejs
MapTypeStyle
to zbiór selektorów i stylatorów, które określają styl mapy. Selektory określają obiekty lub elementy mapy, na które ma to wpłynąć, a style określają, w jaki sposób te obiekty i elementy powinny być modyfikowane. Szczegółowe informacje znajdziesz w dokumentacji stylu.
Właściwości | |
---|---|
stylers |
Reguły stylu, które mają być stosowane do wybranych funkcji i elementów mapy. Reguły są stosowane w kolejności określonej w tej tablicy. Wskazówki dotyczące użycia i dozwolonych wartości znajdziesz w dokumentacji stylu. |
elementType optional |
Typ:
string optional Element, do którego należy zastosować stylizator. Element to wizualny aspekt obiektu na mapie. Na przykład etykieta, ikona, kreska lub wypełnienie zastosowane do geometrii itd. Opcjonalnie: Jeśli parametr elementType nie jest określony, przyjmuje się, że przyjmuje on wartość 'all' . Szczegółowe informacje o wykorzystaniu i dozwolonych wartościach znajdziesz w dokumentacji stylu. |
featureType optional |
Typ:
string optional Cecha lub grupa cech, do których należy zastosować stylizator. Opcjonalnie: Jeśli parametr featureType nie jest określony, przyjmuje się, że przyjmuje on wartość 'all' . Szczegółowe informacje o wykorzystaniu i dozwolonych wartościach znajdziesz w dokumentacji stylu. |
MapMouseEvent interfejs
google.maps.MapMouseEvent
interfejs
Ten obiekt jest zwracany po wywołaniu różnych zdarzeń myszą na mapie i w nakładkach. Zawiera wszystkie pola widoczne poniżej.
Właściwości | |
---|---|
domEvent |
Odpowiednie zdarzenie natywne DOM. Deweloperzy nie powinni polegać na zdefiniowaniu i spójności właściwości target , currentTarget , relatedTarget i path . Deweloperzy nie powinni też polegać na strukturze DOM wewnętrznej implementacji interfejsu API Map Google. Ze względu na wewnętrzne mapowanie zdarzeń pole domEvent może mieć inną semantykę niż MapMouseEvent (np. „kliknięcie” typu MapMouseEvent może mieć wartość domEvent typu KeyboardEvent ). |
latLng optional |
Typ:
LatLng optional Długość i szerokość geograficzna znajdujące się pod kursorem w momencie wystąpienia zdarzenia. |
Metody | |
---|---|
stop |
stop() Parametry: brak
Zwracana wartość:
void Zapobiega dalszemu propagowaniu tego zdarzenia. |
IconMouseEvent interfejs
google.maps.IconMouseEvent
interfejs
Ten obiekt jest wysyłany, gdy użytkownik kliknie ikonę na mapie. Identyfikator tego miejsca jest przechowywany we właściwościach elementu PlaceId. Aby zapobiec wyświetlaniu domyślnego okna informacyjnego, wywołaj przy tym zdarzeniu metodę stop() w celu uniemożliwienia jego rozpowszechnienia. Więcej informacji o identyfikatorach miejsc znajdziesz w przewodniku dla programistów interfejsu Places API.
Ten interfejs rozszerza
MapMouseEvent
Właściwości | |
---|---|
placeId optional |
Typ:
string optional Identyfikator klikniętego miejsca. Tego identyfikatora miejsca można użyć, aby uzyskać dodatkowe informacje o klikniętym obiekcie. Więcej informacji o identyfikatorach miejsc znajdziesz w przewodniku dla programistów interfejsu Places API. |
Dziedziczone:
domEvent ,
latLng
|
Metody | |
---|---|
Dziedziczone:
stop
|
Schemat kolorów stałe
google.maps.ColorScheme
stałe
Identyfikatory do schematów kolorów mapy. Określ je za pomocą wartości lub nazwy stałej. na przykład 'FOLLOW_SYSTEM'
lub google.maps.ColorScheme.FOLLOW_SYSTEM
.
Uzyskaj dostęp, dzwoniąc pod numer const {ColorScheme} = await google.maps.importLibrary("core")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Stałe | |
---|---|
DARK |
Ciemny schemat kolorów mapy. |
FOLLOW_SYSTEM |
Schemat kolorów jest wybierany na podstawie preferencji systemowych. |
LIGHT |
Jasny schemat kolorów mapy. Wartość domyślna starszych Map JS. |
MapTypeId stałe
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 pokazuje na zdjęciach satelitarnych przezroczystą warstwę głównych ulic. |
ROADMAP |
Ten typ mapy wyświetla zwykłą mapę ulicy. |
SATELLITE |
Ten typ mapy wyświetla zdjęcia satelitarne. |
TERRAIN |
Ten typ mapy zawiera mapy z obiektami fizycznymi, takimi jak teren czy roślinność. |
MapTypeRegistry zajęcia
google.maps.MapTypeRegistry
zajęcia
Rejestr instancji MapType z kluczami według identyfikatora MapType.
Te zajęcia obejmują okres
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 do wykorzystania. Interfejs API konsultuje się z tym rejestrem na przykład podczas dostarczania listy dostępnych typów map w ustawieniach. |
Metody | |
---|---|
set |
set(id, mapType) Parametry:
Zwracana wartość: brak
Konfiguruje rejestr tak, aby kojarzył przekazany identyfikator ciągu z przekazanym obiektem MapType. |
Dziedziczone:
addListener ,
bindTo ,
get ,
notify ,
setValues ,
unbind ,
unbindAll
|
MapRestriction interfejs
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 jego ustawieniu użytkownik może przesuwać i powiększać tylko określone granice. Ograniczenia mogą ograniczać długość i szerokość geograficzną lub tylko szerokość geograficzną. W przypadku granic tylko szerokości geograficznej użyj długości zachodniej i wschodniej odpowiednio z zakresu -180 i 180, na przykład latLngBounds: {north: northLat, south: southLat, west: -180, east: 180} . |
strictBounds optional |
Typ:
boolean optional Ograniczenia można zwiększyć, ustawiając flagę strictBounds na true . Zmniejsza to zakres, z jakiego użytkownik może pomniejszyć obraz, dzięki czemu wszystko, co znajduje się poza granicami, jest ukryte. Wartość domyślna to false , co oznacza, że użytkownik może pomniejszać widok, dopóki cały ograniczony obszar nie będzie widoczny, w tym również obszary spoza ograniczonego obszaru. |
TrafficLayer zajęcia
google.maps.TrafficLayer
zajęcia
Warstwa natężenia ruchu.
Te zajęcia obejmują okres
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, która wyświetla bieżący ruch na drodze. |
Metody | |
---|---|
getMap |
getMap() Parametry: brak
Zwracana wartość:
Map Zwraca mapę, na której wyświetla się ta warstwa. |
setMap |
setMap(map) Parametry:
Zwracana wartość: brak
Renderuje warstwę na określonej mapie. Jeśli mapa jest ustawiona na null , warstwa zostanie usunięta. |
setOptions |
setOptions(options) Parametry:
Zwracana wartość: brak
|
Dziedziczone:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
TrafficLayerOptions interfejs
google.maps.TrafficLayerOptions
interfejs
Obiekt TrafficLayerOptions używany do definiowania właściwości, które można ustawić w interfejsie TrafficLayer.
Właściwości | |
---|---|
autoRefresh optional |
Typ:
boolean optional Wartość domyślna:
true Określa, czy warstwa natężenia ruchu odświeża się automatycznie ze zaktualizowanymi informacjami. |
map optional |
Typ:
Map optional Mapa, na której ma być wyświetlana warstwa natężenia ruchu. |
TransitLayer zajęcia
google.maps.TransitLayer
zajęcia
Warstwa transportu publicznego.
Te zajęcia obejmują okres
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 wyświetlająca linie transportu publicznego. |
Metody | |
---|---|
getMap |
getMap() Parametry: brak
Zwracana wartość:
Map Zwraca mapę, na której wyświetla się ta warstwa. |
setMap |
setMap(map) Parametry:
Zwracana wartość: brak
Renderuje warstwę na określonej mapie. Jeśli mapa jest ustawiona na null , warstwa zostanie usunięta. |
Dziedziczone:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
BicyclingLayer zajęcia
google.maps.BicyclingLayer
zajęcia
Warstwa pokazująca ścieżki i ścieżki rowerowe.
Te zajęcia obejmują okres
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 w dół duże drogi. |
Metody | |
---|---|
getMap |
getMap() Parametry: brak
Zwracana wartość:
Map Zwraca mapę, na której wyświetla się ta warstwa. |
setMap |
setMap(map) Parametry:
Zwracana wartość: brak
Renderuje warstwę na określonej mapie. Jeśli mapa jest ustawiona na null , warstwa zostanie usunięta. |
Dziedziczone:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
CameraOptions interfejs
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 |
VisibleRegion interfejs
google.maps.VisibleRegion
interfejs
Zawiera cztery punkty definiujące czterostronny wielokąt będący obszarem widocznym na mapie. Na mapie wektorowej wielokąt ten może być trapezem, a nie prostokątem, jeśli mapa wektorowa ma przechylenie.
Właściwości | |
---|---|
farLeft |
Typ:
LatLng |
farRight |
Typ:
LatLng |
latLngBounds |
Typ:
LatLngBounds Najmniejsza ramka ograniczająca, która zawiera widoczny region. |
nearLeft |
Typ:
LatLng |
nearRight |
Typ:
LatLng |
RenderingType stałe
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ż nie została jeszcze zainicjowana. |
VECTOR |
Wskazuje, że mapa jest mapą wektorową. |
MapCapabilities interfejs
google.maps.MapCapabilities
interfejs
Obiekt zawierający podsumowanie funkcji dostępnych obecnie w mapie. Nie musi to oznaczać, ż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 we właściwościach.
Właściwości | |
---|---|
isAdvancedMarkersAvailable optional |
Typ:
boolean optional Jeśli ma wartość true (prawda), ta mapa jest skonfigurowana prawidłowo, aby umożliwić korzystanie ze znaczników zaawansowanych. Aby używać zaawansowanych znaczników, musisz zaimportować bibliotekę marker . Więcej informacji znajdziesz na stronie https://goo.gle/gmp-isAdvancedMarkersAvailable. |
isDataDrivenStylingAvailable optional |
Typ:
boolean optional Jeśli ma wartość prawda, ta mapa jest skonfigurowana prawidłowo, aby umożliwić użycie 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. |
isWebGLOverlayViewAvailable optional |
Typ:
boolean optional Jeśli ma wartość prawda, ta mapa jest skonfigurowana prawidłowo i pozwala na korzystanie z WebGLOverlayView . |