Klasa Map
google.maps.Map
class
Te zajęcia trwają MVCObject
.
Dostęp przez połączenie telefoniczne pod numer const {Map} = await google.maps.importLibrary("maps")
. Zobacz Biblioteki w Maps JavaScript API.
Zespół | |
---|---|
Map |
Map(mapDiv[, opts]) Parametry:
Tworzy nową mapę wewnątrz podanego kontenera HTML, który jest zwykle elementem DIV . |
Stałe | |
---|---|
DEMO_MAP_ID |
Identyfikator mapy, który można wykorzystać w przypadku przykładów kodu wymagających identyfikatora mapy. Ten identyfikator mapy nie jest przeznaczony do użytku w aplikacji produkcyjnej i nie można go używać w przypadku funkcji, które wymagają konfiguracji w chmurze (np. dostosowywania stylu przez konsolę 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 funkcje do obiektu Data , aby wygodnie wyświetlać je na mapie. |
mapTypes |
Typ:
MapTypeRegistry Rejestr instancji usługi MapType według identyfikatora ciągu znaków. |
overlayMapTypes |
Dodatkowe typy map do nakładania. Typy map nakładek będą wyświetlane na mapie podstawowej, do której są dołączone, w kolejności, w jakiej występują w tablicy overlayMapTypes (nakładki o większych wartościach indeksu będą wyświetlane przed nakładkami o mniejszych wartościach indeksu). |
Metody | |
---|---|
fitBounds |
fitBounds(bounds[, padding]) Parametry:
Zwracana wartość: brak
Ustawia widoczny obszar tak, aby zawierał podane granice. Uwaga: gdy mapę ustawiono na display: none , funkcja fitBounds odczytuje rozmiar mapy jako 0x0 i w konsekwencji nie wykona żadnej operacji. Aby zmienić widoczny obszar, gdy mapa jest ukryta, ustaw ją na visibility: hidden , co zapewni, że element mapy będzie miał rzeczywisty rozmiar. 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 powoduje animację, zależy od wewnętrznej heurystyki. |
getBounds |
getBounds() Parametry: brak
Wartość zwracana:
LatLngBounds|undefined granice lat/lng bieżącego widocznego obszaru.Zwraca zakres szerokości i długości geograficznej bieżącego widoku. Jeśli widoczna jest więcej niż 1 kopia świata, zakresy długości geograficznej mieszczą się w zakresie od -180 do 180 stopni. Jeśli mapa nie została jeszcze zainicjowana lub nie ustawiono jej środka i poziomu powiększenia, wynik to undefined . W przypadku map wektorowych o niezerowym pochyleniu lub kierunku zwrócone granice lat/lng odpowiadają najmniejszemu prostokątowi ograniczającemu widoczny obszar widoku mapy. Aby uzyskać dokładny widoczny obszar na mapie, zobacz 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 |
getDatasetFeatureLayer(datasetId) Parametry:
Zwracana wartość:
FeatureLayer Zwraca FeatureLayer dla określonego datasetId . Identyfikatory zbiorów danych muszą być skonfigurowane w konsoli Google Cloud. Jeśli identyfikator zbioru danych nie jest powiązany ze stylem mapy lub styl oparty na danych jest niedostępny (brak identyfikatora mapy, brak elementów wektorowych, brak warstw funkcji stylu opartego na danych lub brak zbiorów danych skonfigurowanych w stylu mapy), zostanie zarejestrowany błąd, a wartość FeatureLayer.isAvailable będzie miała wartość false. |
getDiv |
getDiv() Parametry: brak
Wartość zwracana:
HTMLElement mapDiv mapy. |
getFeatureLayer |
getFeatureLayer(featureType) Parametry:
Zwracana wartość:
FeatureLayer Zwraca FeatureLayer określonego elementu 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 na kompasie mapy. Wartość kierunku jest mierzona w stopniach (w prawo) od kierunku północnego. Jeśli mapa nie jest jeszcze zainicjalizowana, wynik to undefined . |
getHeadingInteractionEnabled |
getHeadingInteractionEnabled() Parametry: brak
Zwracana wartość:
boolean|null Zwraca informacje o tym, czy interakcje z nagłówkiem są włączone. Ta opcja jest dostępna tylko wtedy, gdy mapa jest mapą wektorową. Jeśli nie zostanie ustawiony w kodzie, zostanie użyta konfiguracja mapy w chmurze (jeśli jest dostępna). |
getMapCapabilities |
getMapCapabilities() Parametry: brak
Zwracana wartość:
MapCapabilities Informuje wywołującego o dostępnych obecnie funkcjach mapy na podstawie podawanego 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 jest jeszcze zainicjalizowana, 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 typ renderowania mapy. |
getStreetView |
getStreetView() Parametry: brak
Zwracana wartość:
StreetViewPanorama Panorama powiązana z mapą.Zwraca domyślną StreetViewPanorama związaną z mapą, która może być domyślną panoramą umieszczoną na mapie lub panoramą ustawioną za pomocą setStreetView() . Zmiany w mapie streetViewControl będą widoczne w wyświetlanej panoramie. |
getTilt |
getTilt() Parametry: brak
Zwracana wartość:
number|undefined Zwraca bieżący kąt padania mapy w stopniach od płaszczyzny widoku do płaszczyzny mapy. W przypadku map rastrowych wynik będzie wynosił 0 w przypadku zdjęć wykonanych bezpośrednio z poziomu lub 45 w przypadku zdjęć pod kątem 45°. Ta metoda nie zwraca wartości ustawionej przez setTilt . Więcej informacji znajdziesz w artykule setTilt . |
getTiltInteractionEnabled |
getTiltInteractionEnabled() Parametry: brak
Zwracana wartość:
boolean|null Wskazuje, czy są włączone interakcje przechylania. Ta opcja ma zastosowanie tylko wtedy, gdy mapa jest mapą wektorową. Jeśli nie zostanie ustawiony w kodzie, zostanie użyta konfiguracja mapy w chmurze (jeśli jest dostępna). |
getZoom |
getZoom() Parametry: brak
Zwracana wartość:
number|undefined Zwraca powiększenie mapy. Jeśli zoom nie został ustawiony, wynik to undefined . |
moveCamera |
moveCamera(cameraOptions) Parametry:
Zwracana wartość: brak
Natychmiast ustawia kamerę mapy na opcje docelowej kamery bez animacji. |
panBy |
panBy(x, y) Parametry:
Zwracana wartość: brak
Zmienia położenie środka 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. Pamiętaj, że system 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
Zmienia położenie środka mapy na podane 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ą odległość, która mieści dany LatLngBounds . Nie ma gwarancji, w którym miejscu na mapie pojawią się granice. Mapa zostanie przesunięta tak, aby pokazać jak najwięcej granic wewnątrz obszaru {currentMapSizeInPx} - {padding} . W przypadku map rastrowych i wektorów powiększenie, przechylenie i kierunek mapy nie ulegną zmianie. |
setCenter |
setCenter(latlng) Parametry:
Zwracana wartość: brak
|
setClickableIcons |
setClickableIcons(value) Parametry:
Zwracana wartość: brak
Określa, czy ikony na mapie są klikalne. Ikona mapy przedstawia ciekawe miejsce, nazywane również ważnym miejscem. Aby wyłączyć możliwość klikania ikon mapy, prześlij do tej metody wartość false . |
setHeading |
setHeading(heading) Parametry:
Zwracana wartość: brak
Ustawia kierunek 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 interakcje z nagłówkiem są włączone. Ta opcja ma zastosowanie 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 typ renderowania mapy. |
setStreetView |
setStreetView(panorama) Parametry:
Zwracana wartość: brak
Wiązanie StreetViewPanorama z mapą. Ta panorama zastępuje domyślną panoramę StreetViewPanorama , umożliwiając mapie wiązanie się z zewnętrzną panoramą poza mapą. 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 ustawia kąt padania mapy. Dozwolone wartości są ograniczone w zależności od powiększenia mapy. W przypadku map rastrowych kontroluje automatyczne przełączanie kąta padania mapy. Jedynymi dozwolonymi wartościami są 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: funkcja getTilt zwraca bieżący kąt nachylenia, a nie wartość ustawioną przez funkcję setTilt . Ponieważ getTilt i setTilt odnoszą się do różnych rzeczy, nie używaj bind() właściwości tilt , bo może to spowodować nieprzewidywalne skutki. |
setTiltInteractionEnabled |
setTiltInteractionEnabled(tiltInteractionEnabled) Parametry:
Zwracana wartość: brak
Określa, czy interakcje z przechylaniem 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). |
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, gdy zmienią się granice widoku. |
center_changed |
function() Argumenty: brak.
To zdarzenie jest wywoływane, gdy zmienia się właściwość mapCenter. |
click |
function(event) Argumenty:
Zdarzenie to jest wywoływane, gdy użytkownik kliknie mapę. Zwracany jest obiekt MapMouseEvent z właściwościami klikniętej lokalizacji, chyba że kliknięto ikonę miejsca, w którym to przypadku zwracany jest obiekt IconMouseEvent z identyfikatorem miejsca. IconMouseEvent i MapMouseEvent są identyczne z wyjątkiem pola IconMouseEvent, które zawiera pole identyfikatora miejsca. Gdy identyfikator miejsca nie jest ważny, zdarzenie może być zawsze traktowane jako zdarzenie MapMouseEvent. Zdarzenie kliknięcia nie jest wywoływane, jeśli kliknięto znacznik lub okno informacyjne. |
contextmenu |
function(event) Argumenty:
To zdarzenie jest wywoływane, gdy zdarzenie DOM contextmenu zostanie wywołane 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 przestanie przeciągać mapę. |
dragstart |
function() Argumenty: brak.
To zdarzenie jest wywoływane, gdy użytkownik zacznie przeciągać mapę. |
heading_changed |
function() Argumenty: brak.
To zdarzenie jest wywoływane, gdy zmienia się właściwość nagłówka mapy. |
idle |
function() Argumenty: brak.
To zdarzenie jest wywoływane, gdy mapa staje się nieaktywna po przesunięciu lub powiększeniu. |
isfractionalzoomenabled_changed |
function() Argumenty: brak
To zdarzenie jest wywoływane, gdy zmieni się wartość właściwości isFractionalZoomEnabled. |
mapcapabilities_changed |
function() Argumenty: brak.
To zdarzenie jest wywoływane, gdy zmieniają się możliwości mapy. |
maptypeid_changed |
function() Argumenty: brak.
To zdarzenie jest wywoływane, gdy zmienia się właściwość mapTypeId. |
mousemove |
function(event) Argumenty:
To zdarzenie jest wywoływane, gdy użytkownik najedzie kursorem na kontener mapy. |
mouseout |
function(event) Argumenty:
To zdarzenie jest wywoływane, gdy kursor myszy użytkownika opuszcza kontener mapy. |
mouseover |
function(event) Argumenty:
To zdarzenie jest wywoływane, gdy kursor myszy użytkownika znajdzie się na obszarze mapy. |
projection_changed |
function() Argumenty: brak.
To zdarzenie jest wywoływane, gdy zmieni się projekcja. |
renderingtype_changed |
function() Argumenty: brak.
To zdarzenie jest wywoływane, gdy typ renderowania ulegnie zmianie. |
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, gdy zmienia się właściwość pochylenia mapy. |
zoom_changed |
function() Argumenty: brak.
To zdarzenie jest wywoływane, gdy zmienia się właściwość powiększenia mapy. |
|
function(event) Argumenty:
To zdarzenie jest wywoływane, gdy użytkownik kliknie mapę prawym przyciskiem myszy. |
Interfejs MapOptions
Interfejs
google.maps.MapOptions
Obiekt MapOptions służy do definiowania właściwości, które można ustawić na mapie.
Właściwości | |
---|---|
backgroundColor optional |
Typ:
string optional Kolor używany jako tło elementu mapy. Ten kolor będzie widoczny, zanim kafelki zostaną wczytane, gdy użytkownik przesunie mapę. Tę opcję można ustawić tylko podczas inicjowania mapy. |
cameraControl optional |
Typ:
boolean optional Włączony lub wyłączony stan kontroli aparatu. |
cameraControlOptions optional |
Typ:
CameraControlOptions optional Opcje wyświetlania elementów sterujących aparatem. |
center optional |
Typ:
LatLng|LatLngLiteral optional Początkowa lokalizacja środkowa na mapie. |
clickableIcons optional |
Typ:
boolean optional Domyślnie:
true Gdy false , ikony map nie można kliknąć. Ikona mapy symbolizuje punkt zainteresowania, zwany też punktem POI. |
colorScheme optional |
Typ:
ColorScheme|string optional Domyślnie:
ColorScheme.LIGHT Początkowy schemat kolorów mapy. Tę opcję można ustawić tylko po zainicjowaniu mapy. |
controlSize optional |
Typ:
number optional Rozmiar elementów sterujących 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 tylko ustawień wprowadzonych przez interfejs API Map. Nie skaluje ustawień niestandardowych utworzonych przez dewelopera. |
disableDefaultUI optional |
Typ:
boolean optional Włącza/wyłącza wszystkie domyślne przyciski interfejsu. Można je zastąpić pojedynczo. Nie wyłącza elementów sterujących klawiaturą, które są sterowane oddzielnie przez opcję MapOptions.keyboardShortcuts . Nie wyłącza sterowania gestami, które jest kontrolowane oddzielnie przez opcję 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 usługa nie jest zalecana. Aby wyłączyć powiększanie po dwukrotnym kliknięciu, użyj właściwości |
|
Typ:
boolean optional Jeśli false , uniemożliwia przeciąganie mapy. Domyślnie jest ona włączona. |
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 używa atrybutu css cursor do zmiany ikony. Podobnie jak w przypadku właściwości css musisz określić co najmniej 1 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świetlanego podczas przeciągania mapy. Ta usługa używa atrybutu css cursor do zmiany ikony. 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 lotu w obrazach lotniczych w stopniach mierzonych zgodnie z kierunkiem wskazówek zegara od kierunku północnego. Nagłówki są przycinane do najbliższego dostępnego kąta, dla którego dostępne są zdjęcia. |
headingInteractionEnabled optional |
Typ:
boolean optional Domyślnie:
false Określa, czy mapa ma umożliwiać użytkownikowi kontrolowanie kierunku (obrotu) kamery. Ta opcja ma zastosowanie tylko wtedy, gdy mapa jest mapą wektorową. Jeśli nie zostanie ustawiony w kodzie, zostanie użyta konfiguracja mapy w chmurze (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 ma zezwalać na poziomy powiększenia z ułamkami. Aby dowiedzieć się, kiedy ustawienie domyślne zostało ustawione, posłuchaj isfractionalzoomenabled_changed . |
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 uruchomieniu mapy tego parametru nie można zmienić. 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 elementu sterującego typem mapy. |
mapTypeControlOptions optional |
Typ:
MapTypeControlOptions optional Początkowe opcje wyświetlania elementu sterującego Typ mapy. |
mapTypeId optional |
Typ:
MapTypeId|string optional Początkowy typ mapy Map. Domyślna wartość to ROADMAP . |
maxZoom optional |
Typ:
number optional Maksymalny poziom powiększenia, który będzie wyświetlany na mapie. Jeśli parametr jest pominięty lub ustawiony na null , zamiast niego używane jest maksymalne powiększenie z 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 nie zostanie podany lub zostanie ustawiona wartość null , zamiast tego zostanie użyte minimalne powiększenie z 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 czyść zawartości elementu mapy. |
|
Typ:
boolean optional Włączony lub wyłączony stan elementu sterującego Przesunięcie. |
|
Typ:
PanControlOptions optional Opcje wyświetlania elementu sterującego przesuwaniem. |
renderingType optional |
Typ:
RenderingType optional Domyślnie:
RenderingType.RASTER Określa, czy mapa ma być rastrowa, czy wektorowa. Po uruchomieniu mapy tego parametru nie można zmienić. Jeśli nie jest ustawiony, typ renderowania (jeśli jest dostępny) będzie określany przez konfigurację w chmurze dla identyfikatora mapy. Pamiętaj, że mapy wektorowe mogą być niedostępne na niektórych urządzeniach i w niektórych przeglądarkach. W takim przypadku mapa zostanie automatycznie przekształcona w mapę rastrową. |
restriction optional |
Typ:
MapRestriction optional Określa granicę, która ogranicza obszar mapy dostępny dla użytkowników. Gdy ta opcja jest włączona, użytkownik może przesuwać i powiększać obraz tylko wtedy, gdy widok kamery mieści się w ramach granicy. |
rotateControl optional |
Typ:
boolean optional Włączono/wyłączono stan elementu sterującego obrotem. |
rotateControlOptions optional |
Typ:
RotateControlOptions optional Opcje wyświetlania elementu sterującego Obróć. |
scaleControl optional |
Typ:
boolean optional Początkowy stan włączenia/wyłączenia elementu sterującego Skala. |
scaleControlOptions optional |
Typ:
ScaleControlOptions optional Początkowe opcje wyświetlania elementu sterującego Skala. |
scrollwheel optional |
Typ:
boolean optional Jeśli false , wyłącza powiększanie na mapie za pomocą kółka myszy. Koło przewijania jest domyślnie włączone. Uwaga: ta usługa 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 zostanie określona żadna panorama, po umieszczeniu człowieczka na mapie w miejscu div zostanie wyświetlona domyślna panorama StreetViewPanorama . |
streetViewControl optional |
Typ:
boolean optional Początkowy stan włączenia/wyłączenia Pegmana Street View. Ten element sterujący jest częścią domyślnego interfejsu użytkownika i powinien być ustawiony na false podczas wyświetlania typu mapy, na której nie powinna być widoczna nakładka dróg Street View (np. typ mapy inny niż Ziemia). |
streetViewControlOptions optional |
Typ:
StreetViewControlOptions optional Początkowe opcje wyświetlania elementu sterującego Pegman 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 trybach satellite /hybrid i terrain te style będą stosowane tylko do etykiet i geometrii. Ta funkcja nie jest dostępna w przypadku identyfikatora mapy ani map wektorowych (zamiast tego użyj stylu map w chmurze). |
tilt optional |
Typ:
number optional W przypadku map wektorowych ustawia kąt padania mapy. Dozwolone wartości są ograniczone w zależności od poziomu 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 powoduje, że mapa zawsze używa widoku z lotu pod kątem 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. Obrazy o kącie 45° są dostępne tylko w przypadku typów map 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 właściwości tilt bind() , bo może to spowodować nieprzewidywalne skutki. |
tiltInteractionEnabled optional |
Typ:
boolean optional Domyślnie:
false Określa, czy mapa powinna umożliwiać użytkownikowi kontrolowanie przechylenia kamery. Ta opcja ma zastosowanie tylko wtedy, gdy mapa jest mapą wektorową. Jeśli nie zostanie ustawiony w kodzie, zostanie użyta konfiguracja mapy w chmurze (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łączony lub wyłączony stan elementu sterującego Powiększenie. |
zoomControlOptions optional |
Typ:
ZoomControlOptions optional Opcje wyświetlania elementu sterującego powiększeniem. |
Klasa MapElement
google.maps.MapElement
class
MapElement to podklasa HTMLElement
służąca do 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 używa elementu
Map
, do którego można uzyskać dostęp 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>
Ta klasa rozszerza zakres HTMLElement
.
Ta klasa implementuje MapElementOptions
.
Dostęp przez połączenie telefoniczne pod numer const {MapElement} = await google.maps.importLibrary("maps")
. Zobacz Biblioteki w Maps JavaScript API.
Zespół | |
---|---|
MapElement |
MapElement([options]) Parametry:
|
Właściwości | |
---|---|
center |
Typ:
LatLng|LatLngLiteral optional Szerokość geograficzna/długość geograficzna środka mapy.
Atrybut HTML:
|
headingInteractionDisabled |
Typ:
boolean optional Domyślnie:
false Określa, czy mapa ma umożliwiać użytkownikowi kontrolowanie kierunku (obrotu) kamery. Ta opcja ma zastosowanie tylko wtedy, gdy mapa jest mapą wektorową. Jeśli nie zostanie ustawiony w kodzie, zostanie użyta konfiguracja mapy w chmurze (jeśli jest dostępna).
Atrybut HTML:
|
innerMap |
Typ:
Map Odwołuje się do Map , którego używa MapElement wewnętrznie. |
mapId |
Typ:
string optional Identyfikator mapy. Po uruchomieniu mapy tego parametru nie można zmienić.
Map.DEMO_MAP_ID można używać do testowania funkcji, które wymagają identyfikatora mapy, ale nie wymagają włączenia funkcji w chmurze.Atrybut HTML:
|
renderingType |
Typ:
RenderingType optional Domyślnie:
RenderingType.VECTOR Określa, czy mapa powinna być mapą rastrową lub wektorową. Po utworzeniu mapy nie można zmienić tego parametru. Jeśli nie jest ustawiony, typ renderowania (jeśli jest dostępny) będzie określany przez konfigurację w chmurze dla identyfikatora mapy. 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 Domyślnie:
false Określa, czy mapa ma umożliwiać użytkownikowi sterowanie pochyleniem kamery. Ta opcja jest dostępna tylko wtedy, gdy mapa jest mapą wektorową. Jeśli nie zostanie ustawiony w kodzie, zostanie użyta konfiguracja mapy w chmurze (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 |
addEventListener(type, listener[, options]) Parametry:
Zwracana wartość:
void Konfiguruje funkcję, która będzie wywoływana, gdy określone zdarzenie zostanie dostarczone do celu. Zobacz addEventListener |
removeEventListener |
removeEventListener(type, listener[, options]) Parametry:
Zwracana wartość:
void Usuwa z miejsca docelowego detektor zdarzeń zarejestrowany wcześniej za pomocą addEventListener. Patrz removeEventListener |
Wydarzenia | |
---|---|
gmp-zoomchange |
function(event) Argumenty:
To zdarzenie jest wywoływane, gdy zmienia 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 obiekcie 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 class
google.maps.ZoomChangeEvent
class
To zdarzenie jest tworzone na podstawie monitorowania zmiany powiększenia.
Ta klasa rozszerza zakres Event
.
Dostęp przez połączenie telefoniczne pod numer const {ZoomChangeEvent} = await google.maps.importLibrary("maps")
. Zobacz Biblioteki w Maps JavaScript API.
Interfejs MapTypeStyle
Interfejs
google.maps.MapTypeStyle
Element MapTypeStyle
to zbiór selektorów i stylizatorów, które określają styl mapy. Selektory określają funkcje lub elementy mapy, na które mają być nakładane efekty, a stylery określają, jak te funkcje i elementy mają być modyfikowane. Szczegółowe informacje znajdziesz w dokumentacji dotyczącej stylów.
Właściwości | |
---|---|
stylers |
Reguły stylu, które mają być stosowane do wybranych elementów i funkcji 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 przewodniku po stylach. |
elementType optional |
Typ:
string optional Element, do którego ma zostać zastosowany stylizator. Element to wizualny aspekt obiektu na mapie. Przykład: etykieta, ikona, obrys 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 użyciu i dozwolonych wartościach znajdziesz w dokumentacji dotyczącej stylów. |
featureType optional |
Typ:
string optional Funkcja lub grupa funkcji, do których ma zostać zastosowany stylizator. 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 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 natywne zdarzenie DOM. Deweloperzy nie powinni polegać na tym, że właściwości target , currentTarget , relatedTarget i path są zdefiniowane i spójnie używane. 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. |
interfejs IconMouseEvent
google.maps.IconMouseEvent
interfejs
Ten obiekt jest wysyłany w zdarzeniu, gdy użytkownik kliknie ikonę na mapie. Identyfikator miejsca jest przechowywany w elementzie placeId. Aby uniemożliwić wyświetlanie domyślnego okna z informacjami, wywołaj metodę stop() w tym zdarzeniu, aby zapobiec jego propagowaniu. Więcej informacji o identyfikatorach miejsc znajdziesz w Przewodniku dla deweloperów interfejsu Places API.
Ten interfejs rozszerza MapMouseEvent
.
Właściwości | |
---|---|
placeId optional |
Typ:
string optional Identyfikator miejsca, które zostało kliknięte. Za pomocą tego identyfikatora miejsca można uzyskać więcej informacji o klikniętej funkcji. Więcej informacji o identyfikatorach miejsc znajdziesz w Przewodniku dla deweloperów interfejsu Places API. |
Uzyskane:
domEvent ,
latLng
|
Metody | |
---|---|
Podane z poziomu klasy:
stop
|
ColorScheme stałe
google.maps.ColorScheme
stałe
Identyfikatory 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
.
Dostęp przez połączenie telefoniczne pod numer const {ColorScheme} = await google.maps.importLibrary("core")
. Zobacz Biblioteki w 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 dla starszej wersji biblioteki JS Map. |
MapTypeId stałe
google.maps.MapTypeId
stałe
Identyfikatory typów map. 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 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ę uliczną. |
SATELLITE |
Ten typ mapy wyświetla zdjęcia satelitarne. |
TERRAIN |
Ten typ mapy wyświetla mapy z elementami fizycznymi, takimi jak ukształtowanie terenu i roślinność. |
MapTypeRegistry class
google.maps.MapTypeRegistry
zajęcia
Rejestr wystąpień MapType, którego kluczem jest identyfikator MapType.
Te zajęcia trwają MVCObject
.
Dostęp przez połączenie telefoniczne pod numer const {MapTypeRegistry} = await google.maps.importLibrary("maps")
. Zobacz Biblioteki w Maps JavaScript API.
Zespół | |
---|---|
MapTypeRegistry |
MapTypeRegistry() Parametry: brak
Element MapTypeRegistry zawiera kolekcję niestandardowych typów map dostępnych dla mapy. Interfejs API korzysta z tego rejestru, aby na przykład podać listę dostępnych typów map w elementach sterujących. |
Metody | |
---|---|
set |
set(id, mapType) Parametry:
Zwracana wartość: brak
Ustawia rejestr, aby powiązać przekazany identyfikator ciągu znaków z przekazaną wartością MapType. |
Uzyskane:
addListener ,
bindTo ,
get ,
notify ,
setValues ,
unbind ,
unbindAll
|
Interfejs MapRestriction
google.maps.MapRestriction
interfejs
Ograniczenie, które można zastosować do mapy. Widok mapy nie może wykraczać poza te ograniczenia.
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 Granice można zawęzić, ustawiając flagę strictBounds na true . Zmniejsza to zasięg pomniejszenia użytkownika, 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 class
google.maps.TrafficLayer
class
Warstwa natężenia ruchu.
Te zajęcia trwają MVCObject
.
Dostęp przez połączenie telefoniczne pod numer const {TrafficLayer} = await google.maps.importLibrary("maps")
. Zobacz Biblioteki w Maps JavaScript API.
Zespół | |
---|---|
TrafficLayer |
TrafficLayer([opts]) Parametry:
Warstwa wyświetlająca bieżący ruch drogowy. |
Metody | |
---|---|
getMap |
getMap() Parametry: brak
Zwracana wartość:
Map|null Zwraca mapę, na której wyświetlana jest 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
|
Uzyskane:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Interfejs TrafficLayerOptions
Interfejs
google.maps.TrafficLayerOptions
Obiekt TrafficLayerOptions służy do definiowania właściwości, które można ustawić w obiekcie TrafficLayer.
Właściwości | |
---|---|
autoRefresh optional |
Typ:
boolean optional Domyślnie:
true Określa, czy warstwa danych o ruchu automatycznie odświeża informacje. |
map optional |
Typ:
Map optional Mapa, na której ma być wyświetlana warstwa z korkami. |
Klasa TransitLayer
google.maps.TransitLayer
class
warstwa danych o transporcie publicznym,
Ta klasa rozszerza zakres MVCObject
.
Dostęp przez połączenie telefoniczne pod numer const {TransitLayer} = await google.maps.importLibrary("maps")
. Zobacz Biblioteki w 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świetlana jest 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
|
klasa BicyclingLayer
google.maps.BicyclingLayer
class
Warstwę z ścieżkami rowerowymi i ścieżkami rowerowo-pieszymi.
Te zajęcia trwają MVCObject
.
Dostęp przez połączenie telefoniczne pod numer const {BicyclingLayer} = await google.maps.importLibrary("maps")
. Zobacz Biblioteki w Maps JavaScript API.
Zespół | |
---|---|
BicyclingLayer |
BicyclingLayer() Parametry: brak
Warstwa z pasami rowerowymi i ścieżkami rowerowymi, która degraduje duże drogi. |
Metody | |
---|---|
getMap |
getMap() Parametry: brak
Zwracana wartość:
Map|null Zwraca mapę, na której wyświetlana jest ta warstwa. |
setMap |
setMap(map) Parametry:
Zwracana wartość:
void Renderuje warstwę na określonej mapie. Jeśli mapa ma wartość null , warstwa zostanie usunięta. |
Uzyskane:
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
Zawiera 4 punkty określające 4-boczny wielokąt, który jest widocznym obszarem mapy. Na mapie wektorowej ten wielokąt może być trapezem zamiast prostokąta, jeśli ma ona nachylenie.
Właściwości | |
---|---|
farLeft |
Typ:
LatLng |
farRight |
Typ:
LatLng |
latLngBounds |
Typ:
LatLngBounds Najmniejsza ramka ograniczająca, która obejmuje widoczny obszar. |
nearLeft |
Typ:
LatLng |
nearRight |
Typ:
LatLng |
stałe RenderingType
google.maps.RenderingType
stałe
Dostęp przez połączenie telefoniczne pod numer const {RenderingType} = await google.maps.importLibrary("maps")
. Zobacz Biblioteki w Maps JavaScript API.
Stałe | |
---|---|
RASTER |
Wskazuje, że mapa jest rastrowa. |
UNINITIALIZED |
Wskazuje, że nie wiadomo jeszcze, czy mapa jest wektorowa czy rastrowa, ponieważ nie została jeszcze w pełni zainicjowana. |
VECTOR |
Wskazuje, że mapa jest mapą wektorową. |
Interfejs MapCapabilities
google.maps.MapCapabilities
interfejs
Obiekt zawierający zrzut, który pokazuje, jakie funkcje są obecnie dostępne dla mapy. Nie oznacza to koniecznie, że odpowiednie moduły są wczytane lub inicjowane, ale że bieżąca mapa ma uprawnienia do korzystania z tych interfejsów API. Właściwości zawierają listę możliwych funkcji.
Właściwości | |
---|---|
isAdvancedMarkersAvailable optional |
Typ:
boolean optional Jeśli ma wartość Prawda, mapa jest prawidłowo skonfigurowana, aby umożliwić używanie zaawansowanych znaczników. 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 to ustawienie ma wartość true, mapa jest prawidłowo skonfigurowana, aby umożliwić stosowanie stylizacji opartej na danych w przypadku co najmniej 1 warstwy FeatureLayer. 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 umożliwia korzystanie z WebGLOverlayView . |