Klasa Map
google.maps.Map
zajęcia
Te zajęcia są rozszerzone na MVCObject
.
Aby uzyskać dostęp, zadzwoń 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 obrębie danego kontenera HTML, który zwykle jest elementem DIV . |
Stałe | |
---|---|
DEMO_MAP_ID |
Identyfikator mapy, który może być używany w przypadku przykładów kodu wymagających identyfikatora mapy. Ten identyfikator mapy nie jest przeznaczony do aplikacji produkcyjnych i nie można go używać w przypadku funkcji wymagających konfiguracji w chmurze (takich jak styl Cloud). |
Właściwości | |
---|---|
controls |
Typ:
Array<MVCArray<HTMLElement>> Dodatkowe elementy sterujące do dołączenia do mapy. Aby dodać element sterujący do mapy, dodaj <div> elementu sterującego do elementu MVCArray odpowiadającego elementowi ControlPosition , w którym ma być renderowany. |
data |
Typ:
Data Wystąpienie obszaru Data powiązanego z mapą. Dodaj obiekty do tego obiektu Data , aby wygodnie wyświetlać je na tej mapie. |
mapTypes |
Typ:
MapTypeRegistry Rejestr instancji ( MapType ) według identyfikatora ciągu znaków. |
overlayMapTypes |
Dodatkowe typy map do nałożenia. Typy nakładek map są wyświetlane nad mapą podstawową, do której są dołączone w takiej kolejności, w jakiej występują w tablicy overlayMapTypes (nakładki z wyższymi wartościami indeksu są wyświetlane przed nakładkami z niższymi wartościami indeksu). |
Metody | |
---|---|
fitBounds |
fitBounds(bounds[, padding]) Parametry:
Zwracana wartość: brak
Określa widoczny obszar tak, aby zawierał podane granice. Uwaga: gdy mapa jest ustawiona na display: none , funkcja fitBounds odczytuje rozmiar mapy jako 0 x 0 i dlatego nic nie robi. Aby zmienić widoczny obszar, gdy mapa jest ukryta, ustaw mapę na visibility: hidden . Dzięki temu jej element div będzie miał rzeczywisty rozmiar. W przypadku map wektorowych ta metoda ustawia domyślne wartości zerowego nachylenia i kierunku mapy. Wywołanie tej metody może spowodować płynną animację podczas przesuwania i powiększania mapy w celu dopasowania do wyznaczonych granic. Użycie tej metody 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ż 1 kopia świata, granica długości geograficznej to od -180 do 180 stopni włącznie. Jeśli mapa nie została jeszcze zainicjowana lub nie ustawiono powiększenia i powiększenia, wynik to undefined . W przypadku map wektorowych z niezerowym przechyleniem lub kierunkiem zwracane granice szerokości i długości geograficznej odpowiadają najmniejszej ramce ograniczającej obejmującej widoczny obszar widocznego obszaru mapy. Aby sprawdzić dokładny obszar widocznego obszaru mapy, zobacz MapCanvasProjection.getVisibleRegion . |
getCenter |
getCenter() Parametry: brak
Wartość zwrotu:
LatLng|undefined |
getClickableIcons |
getClickableIcons() Parametry: brak
Wartość zwrotu:
boolean|undefined Zwraca klikalność ikon mapy. Ikona mapy symbolizuje ciekawe miejsce, nazywane również ważnym miejscem. Jeśli zwrócona wartość to true , można kliknąć te ikony na mapie. |
getDatasetFeatureLayer |
getDatasetFeatureLayer(datasetId) Parametry:
Wartość zwrotu:
FeatureLayer Zwraca wartość FeatureLayer w przypadku określonej wartości datasetId . Identyfikatory zbiorów danych trzeba 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, kafelków wektorów, brak warstw cech stylu opartego na danych lub zbiorów danych skonfigurowanych w stylu mapy), zostanie zarejestrowany błąd, a wynik FeatureLayer.isAvailable będzie mieć wartość fałsz. |
getDiv |
getDiv() Parametry: brak
Zwracana wartość:
HTMLElement parametr mapDiv mapy. |
getFeatureLayer |
getFeatureLayer(featureType) Parametry:
Wartość zwrotu:
FeatureLayer Zwraca FeatureLayer dla FeatureType . W konsoli Google Cloud musi być włączony FeatureLayer . Jeśli FeatureLayer o określonym standardzie FeatureType nie istnieje na tej mapie lub styl oparty na danych jest niedostępny (brak identyfikatora mapy, kafelków wektorów i brak włączonego FeatureLayer w stylu mapy), zostanie zarejestrowany błąd, a wynik FeatureLayer.isAvailable będzie miał wartość fałsz. |
getHeading |
getHeading() Parametry: brak
Wartość zwrotu:
number|undefined Zwraca na mapie kierunek kompasu. Wartość nagłówka 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
Wartość zwrotu:
boolean|null Wskazuje, czy interakcje z nagłówkami są włączone. Ta opcja działa tylko wtedy, gdy mapa jest mapą wektorową. Jeśli nie jest ustawiony w kodzie, używana jest konfiguracja chmury dla identyfikatora mapy (jeśli jest dostępna). |
getMapCapabilities |
getMapCapabilities() Parametry: brak
Wartość zwrotu:
MapCapabilities Informuje wywołującego o bieżących możliwościach dostępnych na mapie na podstawie podanego identyfikatora mapy. |
getMapTypeId |
getMapTypeId() Parametry: brak
Wartość zwrotu:
MapTypeId|string|undefined |
getProjection |
getProjection() Parametry: brak
Wartość zwrotu:
Projection|undefined Zwraca bieżącą wartość Projection . Jeśli mapa nie została jeszcze zainicjowana, wynik to undefined . Odsłuchaj zdarzenie projection_changed i sprawdź jego wartość, aby upewnić się, że nie jest to zdarzenie undefined . |
getRenderingType |
getRenderingType() Parametry: brak
Wartość zwrotu:
RenderingType Zwraca bieżący obiekt RenderingType mapy. |
getStreetView |
getStreetView() Parametry: brak
Zwracana wartość:
StreetViewPanorama Panorama powiązana z mapą.Zwraca domyślne ( StreetViewPanorama ) powiązane z mapą, czyli domyślną panoramę osadzoną w mapie lub panoramę ustawioną za pomocą funkcji setStreetView() . Zmiany w streetViewControl mapy będą widoczne podczas wyświetlania takiej powiązanej panoramy. |
getTilt |
getTilt() Parametry: brak
Wartość zwrotu:
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ęć wykonanych pod kątem 45°. Ta metoda nie zwraca wartości ustawionej przez setTilt . Aby dowiedzieć się więcej, wejdź na setTilt . |
getTiltInteractionEnabled |
getTiltInteractionEnabled() Parametry: brak
Wartość zwrotu:
boolean|null Wskazuje, czy interakcje z przechylaniem są włączone. Ta opcja działa tylko wtedy, gdy mapa jest mapą wektorową. Jeśli nie jest ustawiony w kodzie, używana jest konfiguracja chmury dla identyfikatora mapy (jeśli jest dostępna). |
getZoom |
getZoom() Parametry: brak
Wartość zwrotu:
number|undefined Zwraca powiększenie mapy. Jeśli powiększenie nie zostało ustawione, wynik będzie undefined . |
moveCamera |
moveCamera(cameraOptions) Parametry:
Zwracana wartość: brak
Natychmiast ustawia kamerę mapy na opcje kamery docelowej (bez animacji). |
panBy |
panBy(x, y) Parametry:
Zwracana wartość: brak
Zmienia środek mapy o podaną odległość w pikselach. Jeśli odległość jest mniejsza niż szerokość i wysokość mapy, przejście będzie płynnie animowane. Zwróć uwagę, że układ współrzędnych mapy rośnie z zachodu na wschód (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 obiekt 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ą ilość wymaganą do umieszczenia na mapie obiektu LatLngBounds . Nie daje to żadnej gwarancji, w którym miejscu na mapie znajdą się granice. Jedynym wyjątkiem jest to, że mapa zostanie przesunięta w taki sposób, aby jak najlepiej odsłonić granice w elemencie {currentMapSizeInPx} - {padding} . Zarówno w przypadku map rastrowych, jak i wektorowych zmiana powiększenia, pochylenia i kierunku mapy nie ulegną zmianie. |
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 symbolizuje 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
Ustawia kierunek na mapie na kompasie mierzony w stopniach od kierunku północnego. W przypadku map rastrowych ta metoda ma zastosowanie tylko do zdjęć lotniczych. |
setHeadingInteractionEnabled |
setHeadingInteractionEnabled(headingInteractionEnabled) Parametry:
Zwracana wartość: brak
Określa, czy interakcje z nagłówkami są włączone. Ta opcja działa tylko wtedy, gdy mapa jest mapą wektorową. Jeśli nie jest ustawiony 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ą panoramę (StreetViewPanorama ), dzięki czemu mapa może zostać powiązana z zewnętrzną panoramą, która nie znajduje się poza nią. 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 padania mapy. Dozwolone wartości są ograniczone w zależności od powiększenia mapy. W przypadku map rastrowych steruje automatycznym przełączaniem kąta padania mapy. Jedyne dozwolone wartości to 0 i 45 . setTilt(0) powoduje, że mapa zawsze korzysta z widoku z powietrza 0°, niezależnie od poziomu powiększenia i widocznego obszaru. Funkcja setTilt(45) automatycznie przełącza kąt nachylenia na 45, gdy dostępne są zdjęcia 45° dla bieżącego poziomu powiększenia i widocznego obszaru, oraz przełącza się na 0, gdy zdjęcia pod kątem 45° są niedostępne (jest to zachowanie domyślne). Zdjęcia pod kątem 45° są dostępne tylko dla typów map satellite i hybrid , w niektórych lokalizacjach i przy niektórych poziomach powiększenia. Uwaga: getTilt zwraca bieżący kąt nachylenia, a nie wartość ustawioną przez setTilt . Atrybuty getTilt i setTilt odnoszą się do różnych rzeczy, dlatego nie używaj właściwości bind() tilt , ponieważ może to spowodować nieprzewidywalne skutki. |
setTiltInteractionEnabled |
setTiltInteractionEnabled(tiltInteractionEnabled) Parametry:
Zwracana wartość: brak
Określa, czy interakcje z przechylaniem są włączone. Ta opcja działa tylko wtedy, gdy mapa jest mapą wektorową. Jeśli nie jest ustawiony 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
Zdarzenie to 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 uruchamiane, gdy użytkownik kliknie mapę. Parametr MapMouseEvent z właściwościami klikniętej lokalizacji jest zwracany, o ile nie zostanie kliknięta ikona miejsca. W takim przypadku zwracane jest zdarzenie IconMouseEvent z identyfikatorem miejsca. IconMouseEvent i MapMouseEvent są identyczne z tą różnicą, że IconMouseEvent mają pole identyfikatora miejsca. Jeśli identyfikator miejsca nie jest ważny, to zdarzenie może być zawsze traktowane jako zdarzenie MapMouseEvent. Zdarzenie kliknięcia nie jest wywoływane po kliknięciu znacznika lub okna informacyjnego. |
contextmenu |
function(event) Argumenty:
To zdarzenie jest wywoływane po wywołaniu zdarzenia menu kontekstowego DOM w kontenerze mapy. |
dblclick |
function(event) Argumenty:
Zdarzenie to jest wywoływane, gdy użytkownik dwukrotnie kliknie mapę. Pamiętaj, że zdarzenie kliknięcia może się czasami uruchomić raz, a czasem 2 razy, tuż przed tym zdarzeniem. |
drag |
function() Argumenty: brak
To zdarzenie jest uruchamiane wielokrotnie, gdy użytkownik przeciąga mapę. |
dragend |
function() Argumenty: brak
Zdarzenie to jest uruchamiane, gdy użytkownik przestaje przeciągać mapę. |
dragstart |
function() Argumenty: brak
Zdarzenie to jest uruchamiane, gdy użytkownik zacznie 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 po przesunięciu lub powiększeniu mapa stanie się bezczynna. |
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 uruchamiane, 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:
Zdarzenie to jest wywoływane za każdym razem, gdy użytkownik przesunie kursor nad kontenerem mapy. |
mouseout |
function(event) Argumenty:
Zdarzenie jest uruchamiane, gdy użytkownik zamknie kontener mapy. |
mouseover |
function(event) Argumenty:
Zdarzenie jest uruchamiane, gdy użytkownik najedzie myszą na kontener mapy. |
projection_changed |
function() Argumenty: brak
Zdarzenie to jest wywoływane po zmianie prognozy. |
renderingtype_changed |
function() Argumenty: brak
To zdarzenie jest wywoływane po zmianie obiektu renderType. |
tilesloaded |
function() Argumenty: brak
Zdarzenie jest uruchamiane po zakończeniu ładowania widocznych kafelków. |
tilt_changed |
function() Argumenty: brak
To zdarzenie jest wywoływane, gdy zmienia się właściwość 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. |
Interfejs MapOptions
google.maps.MapOptions
interfejs
Obiekt MapOptions używany do definiowania właściwości, które można ustawić w mapie.
Właściwości | |
---|---|
backgroundColor optional |
Typ:
string optional Kolor używany jako tło elementu div mapy. Będzie on widoczny, jeśli kafelki nie zostały jeszcze wczytane jako przesunięcia użytkownika. Tę opcję można ustawić tylko podczas zainicjowania mapy. |
center optional |
Typ:
LatLng|LatLngLiteral optional Początkowe centrum mapy. |
clickableIcons optional |
Typ:
boolean optional Wartość domyślna:
true Gdy ustawiona jest opcja false , nie można klikać ikon mapy. Ikona mapy symbolizuje ciekawe miejsce, nazywane również ważnym miejscem. |
controlSize optional |
Typ:
number optional Rozmiar w pikselach elementów sterujących wyświetlanych na mapie. Ta wartość musi zostać podana bezpośrednio podczas tworzenia mapy. Późniejsza zmiana tej wartości może spowodować, że elementy sterujące przyjmą stan undefined . Reguluje tylko ustawienia utworzone przez interfejs API Map Google. Nie skaluje elementów sterujących utworzonych przez dewelopera. |
disableDefaultUI optional |
Typ:
boolean optional Włącza/wyłącza wszystkie przyciski domyślnego interfejsu użytkownika. Można zastąpić je pojedynczo. Nie wyłącza sterowania za pomocą klawiatury, którymi oddzielnie steruje opcja MapOptions.keyboardShortcuts . Nie wyłącza sterowania gestami, którymi oddzielnie steruje opcja MapOptions.gestureHandling . |
disableDoubleClickZoom optional |
Typ:
boolean optional Włącza lub wyłącza powiększenie i wyśrodkowanie po podwójnym 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ąganie mapy. Przeciąganie jest domyślnie włączone. |
draggableCursor optional |
Typ:
string optional Nazwa lub adres URL kursora, które są wyświetlane po najechaniu kursorem na mapę, którą można przeciągnąć. Ta właściwość używa atrybutu CSS cursor do zmiany ikony. Tak jak w przypadku właściwości CSS, musisz określić co najmniej jeden kursor zastępczy, 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 wyświetlane podczas przeciągania mapy. Ta właściwość używa atrybutu CSS cursor do zmiany ikony. Tak jak w przypadku właściwości CSS, musisz określić co najmniej jeden kursor zastępczy, 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 stan elementu sterującego pełnego ekranu. |
fullscreenControlOptions optional |
Typ:
FullscreenControlOptions optional Opcje wyświetlania elementu sterującego w trybie pełnoekranowym. |
gestureHandling optional |
Typ:
string optional To ustawienie określa, jak interfejs API obsługuje gesty na mapie. Dozwolone wartości:
|
heading optional |
Typ:
number optional Nagłówek zdjęć lotniczych w stopniach, mierzony w prawo od kierunku północnego. Nagłówki są przyciągane pod najbliższym dostępnym kątem, pod którym są dostępne zdjęcia. |
headingInteractionEnabled optional |
Typ:
boolean optional Wartość domyślna:
false Określa, czy mapa ma umożliwiać użytkownikowi sterowanie kierunkiem kamery (obrótem). Ta opcja działa tylko wtedy, gdy mapa jest mapą wektorową. Jeśli nie jest ustawiony w kodzie, używana jest konfiguracja chmury dla identyfikatora mapy (jeśli jest dostępna). |
isFractionalZoomEnabled optional |
Typ:
boolean optional Wartość domyślna:
true w przypadku map wektorowych i false dla map rastrowychOkreśla, czy mapa ma zezwalać na częściowe powiększenie. Słuchaj aplikacji isfractionalzoomenabled_changed , aby wiedzieć, kiedy została ustawiona wartość domyślna. |
keyboardShortcuts optional |
Typ:
boolean optional Jeśli false , nie pozwala na sterowanie mapą z klawiatury. Skróty klawiszowe są domyślnie włączone. |
mapId optional |
Typ:
string optional Identyfikator mapy. Po utworzeniu instancji mapy tego parametru nie można ustawić ani 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 opcji typu Mapa. |
mapTypeControlOptions optional |
Typ:
MapTypeControlOptions optional Początkowe opcje wyświetlania elementów sterujących typem mapy. |
mapTypeId optional |
Typ:
MapTypeId|string optional Początkowy identyfikator typu mapy. Domyślna wartość to ROADMAP . |
maxZoom optional |
Typ:
number optional Maksymalny poziom powiększenia wyświetlany na mapie. Jeśli zostanie pominięty lub ustawiony na wartość null , stosowane będzie maksymalne powiększenie z 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 ten parametr zostanie pominięty lub ustawiony na wartość null , stosowane będzie minimalne powiększenie aktualnego 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 ustawiona jest wartość true , nie usuwaj zawartości elementu div mapy. |
|
Typ:
boolean optional Włączony/wyłączony stan elementu sterującego przesuwania. |
|
Typ:
PanControlOptions optional Opcje wyświetlania elementu sterującego przesuwaniem |
renderingType optional |
Typ:
RenderingType optional Wartość domyślna:
RenderingType.RASTER Określa, czy mapa ma być mapą rastrową czy wektorową. Po utworzeniu instancji mapy tego parametru nie można ustawić ani zmienić. Jeśli jej nie skonfigurujesz, typ renderowania będzie zależny od konfiguracji chmury na potrzeby identyfikatora mapy (jeśli jest dostępny). Pamiętaj, że mapy wektorowe mogą nie być dostępne dla wszystkich urządzeń i przeglądarek, a w razie potrzeby mapa zostanie przełączona na mapę rastrową. |
restriction optional |
Typ:
MapRestriction optional Definiuje granicę ograniczającą obszar mapy dostępny dla użytkowników. Po ustawieniu tego ustawienia użytkownik może przesuwać i powiększać tylko widok z kamery w granicach ustalonej granicy. |
rotateControl optional |
Typ:
boolean optional Stan włączenia/wyłączenia elementu sterującego obracaniem. |
rotateControlOptions optional |
Typ:
RotateControlOptions optional Opcje wyświetlania elementu sterującego Obróć. |
scaleControl optional |
Typ:
boolean optional Początkowy stan włączenia/wyłączenia ustawienia Skala. |
scaleControlOptions optional |
Typ:
ScaleControlOptions optional Początkowe opcje wyświetlania elementu sterującego Skalowanie. |
scrollwheel optional |
Typ:
boolean optional Jeśli false , wyłącza powiększanie mapy za pomocą kółka myszy. Kółko myszy jest domyślnie włączone. Uwaga: ta właściwość nie jest zalecana. Aby wyłączyć powiększanie za pomocą kółka przewijania, możesz użyć właściwości |
streetView optional |
Typ:
StreetViewPanorama optional StreetViewPanorama , który wyświetla się, gdy Pegman Street View zostanie umieszczony na mapie. Jeśli nie podasz panoramy, po uniesieniu Pegmana na mapie w polu div będzie wyświetlany domyślny StreetViewPanorama . |
streetViewControl optional |
Typ:
boolean optional Początkowy stan włączenia/wyłączenia kontroli Pegmana w Street View. Ten element jest częścią domyślnego interfejsu i powinien mieć wartość false podczas wyświetlania typu mapy, na której nie powinna być wyświetlana nakładka drogowa Street View (np. mapy innego typu niż Earth). |
streetViewControlOptions optional |
Typ:
StreetViewControlOptions optional Początkowe opcje wyświetlania elementu sterującego Pegmana w Street View. |
styles optional |
Typ:
Array<MapTypeStyle> optional Style stosowane do każdego z domyślnych typów map. Pamiętaj, że w przypadku trybów 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żywaj stylów map w chmurze). |
tilt optional |
Typ:
number optional W przypadku map wektorowych określa kąt padania mapy. Dozwolone wartości są ograniczone w zależności od powiększenia mapy. W przypadku map rastrowych steruje działaniem automatycznego przełączania kąta padania mapy. Jedyne dozwolone wartości to 0 i 45 . Wartość 0 powoduje, że mapa zawsze korzysta z widoku z góry 0°, niezależnie od poziomu powiększenia i widocznego obszaru. Wartość 45 powoduje automatyczne przełączanie kąta nachylenia na 45, gdy dostępne są zdjęcia 45° dla bieżącego poziomu powiększenia i widocznego obszaru, oraz powrót do 0, gdy zdjęcia pod kątem 45° są niedostępne (jest to zachowanie domyślne). Zdjęcia pod kątem 45° są dostępne tylko dla typów map satellite i hybrid , w niektórych lokalizacjach i przy niektórych poziomach powiększenia. Uwaga: getTilt zwraca bieżący kąt nachylenia, a nie wartość określoną przez tę opcję. Ponieważ właściwość getTilt i ta opcja odnoszą się do różnych rzeczy, nie używaj właściwości bind() do właściwości tilt , ponieważ może to spowodować nieprzewidywalne skutki. |
tiltInteractionEnabled optional |
Typ:
boolean optional Wartość domyślna:
false Określa, czy mapa ma umożliwiać użytkownikowi sterowanie przechylaniem kamery. Ta opcja działa tylko wtedy, gdy mapa jest mapą wektorową. Jeśli nie jest ustawiony 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 zera do obsługiwanego maksymalnego poziomu powiększenia. Większe powiększenie oznacza wyższą rozdzielczość. |
zoomControl optional |
Typ:
boolean optional Włączony/wyłączony stan elementu sterującego powiększenia. |
zoomControlOptions optional |
Typ:
ZoomControlOptions optional Opcje wyświetlania elementu sterującego powiększeniem. |
Klasa MapElement
google.maps.MapElement
zajęcia
MapElement to podklasa HTMLElement
służąca do renderowania map. Po wczytaniu biblioteki maps
można utworzyć mapę w kodzie HTML. Na przykład:
<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID">
<button slot="control-block-start-inline-end">Custom Control</button>
</gmp-map>
Wewnętrznie używany jest interfejs
Map
, do którego można uzyskać dostęp za pomocą właściwości innerMap
.
Element niestandardowy:
<gmp-map center="lat,lng" heading-interaction-disabled map-id="string" rendering-type="vector" tilt-interaction-disabled zoom="number"></gmp-map>
Te zajęcia są rozszerzone na HTMLElement
.
Ta klasa implementuje MapElementOptions
.
Aby uzyskać dostęp, zadzwoń 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 na mapie.
Atrybut HTML:
|
headingInteractionDisabled |
Typ:
boolean optional Wartość domyślna:
false Określa, czy mapa ma umożliwiać użytkownikowi sterowanie kierunkiem kamery (obrótem). Ta opcja działa tylko wtedy, gdy mapa jest mapą wektorową. Jeśli nie jest ustawiony 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 używanego wewnętrznie przez element MapElement. |
mapId |
Typ:
string optional Identyfikator mapy. Po utworzeniu instancji mapy tego parametru nie można ustawić ani zmienić. 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 ma być mapą rastrową czy wektorową. Po utworzeniu instancji mapy tego parametru nie można ustawić ani zmienić. Jeśli jej nie skonfigurujesz, typ renderowania będzie zależny od konfiguracji chmury na potrzeby identyfikatora mapy (jeśli jest dostępny). Pamiętaj, że mapy wektorowe mogą nie być dostępne dla wszystkich urządzeń i przeglądarek, a w razie potrzeby mapa zostanie przełączona na mapę rastrową.
Atrybut HTML:
|
tiltInteractionDisabled |
Typ:
boolean optional Wartość domyślna:
false Określa, czy mapa ma umożliwiać użytkownikowi sterowanie przechylaniem kamery. Ta opcja działa tylko wtedy, gdy mapa jest mapą wektorową. Jeśli nie jest ustawiony 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 zera do obsługiwanego maksymalnego poziomu powiększenia. Większe powiększenie oznacza wyższą rozdzielczość.
Atrybut HTML:
|
Metody | |
---|---|
addEventListener |
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 środowiska docelowego. Zobacz addEventListener. |
removeEventListener |
removeEventListener(type, listener[, options]) Parametry:
Wartość zwrotu:
void Usuwa z celu detektor zdarzeń zarejestrowany wcześniej w addEventListener. Zobacz removeEventListener. |
Wydarzenia | |
---|---|
gmp-zoomchange |
function(event) Argumenty:
To zdarzenie jest wywoływane po zmianie właściwości powiększenia mapy. |
Interfejs MapElementOptions
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 . |
Klasa ZoomChangeEvent
google.maps.ZoomChangeEvent
zajęcia
To zdarzenie jest tworzone na podstawie monitorowania zmiany powiększenia.
Te zajęcia są rozszerzone na Event
.
Aby uzyskać dostęp, zadzwoń pod numer const {ZoomChangeEvent} = await google.maps.importLibrary("maps")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Interfejs MapTypeStyle
google.maps.MapTypeStyle
interfejs
MapTypeStyle
to zbiór selektorów i stylów, które określają styl mapy. Selektory określają obiekty lub elementy mapy, na które ma to wpływ, a style wyznaczają sposób modyfikowania tych obiektów i elementów. Szczegółowe informacje znajdziesz w dokumentacji stylu.
Właściwości | |
---|---|
stylers |
Reguły stylów stosowane do wybranych funkcji i elementów mapy. Reguły zostaną zastosowane w kolejności określonej w tej tablicy. Wskazówki dotyczące użycia i dozwolonych wartości znajdziesz w 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, kontur lub wypełnienie zastosowane do geometrii i inne. Opcjonalnie. Jeśli elementType nie jest określony, przyjmuje się, że wartość to 'all' . Szczegółowe informacje o używaniu i dozwolonych wartościach znajdziesz w dokumentacji stylu. |
featureType optional |
Typ:
string optional Funkcja lub grupa obiektów, do których ma zostać zastosowany stylizator. Opcjonalnie. Jeśli featureType nie jest określony, przyjmuje się, że wartość to 'all' . Szczegółowe informacje o używaniu i dozwolonych wartościach znajdziesz w dokumentacji stylu. |
Interfejs MapMouseEvent
google.maps.MapMouseEvent
interfejs
Ten obiekt jest zwracany z różnych zdarzeń myszy na mapie i nakładkach oraz zawiera wszystkie widoczne poniżej pola.
Właściwości | |
---|---|
domEvent |
Odpowiednie natywne zdarzenie DOM. Deweloperzy nie powinni polegać na tym, że właściwości target , currentTarget , relatedTarget i path są zdefiniowane i spójne. Programiści nie powinni również polegać na strukturze DOM w wewnętrznej implementacji interfejsu API Map Google. Ze względu na mapowanie zdarzeń wewnętrznych element domEvent może mieć inną semantykę niż element MapMouseEvent (np. „kliknięcie” MapMouseEvent może mieć domEvent typu KeyboardEvent ). |
latLng optional |
Typ:
LatLng optional Szerokość/długość geograficzna, która znajdowała się pod kursorem w momencie wystąpienia zdarzenia. |
Metody | |
---|---|
stop |
stop() Parametry: brak
Wartość zwrotu:
void Uniemożliwia dalsze rozpowszechnianie tego zdarzenia. |
Interfejs IconMouseEvent
google.maps.IconMouseEvent
interfejs
Ten obiekt jest wysyłany w zdarzeniu, gdy użytkownik kliknie ikonę na mapie. Identyfikator miejsca tego miejsca jest przechowywany w elemencie identyfikator miejsca. Aby zapobiec wyświetlaniu domyślnego okna informacyjnego, wywołaj w tym zdarzeniu metodę stop(), co uniemożliwi jego rozpowszechnianie. Więcej informacji o identyfikatorach miejsc znajdziesz w przewodniku dla programistów interfejsu Places API.
Ten interfejs rozszerza zakres MapMouseEvent
.
Właściwości | |
---|---|
placeId optional |
Typ:
string optional Identyfikator miejsca klikniętego miejsca. Może on służyć do uzyskiwania dodatkowych informacji na temat klikniętego obiektu. Więcej informacji o identyfikatorach miejsc znajdziesz w przewodniku dla programistów interfejsu Places API. |
Odziedziczone:
domEvent , latLng
|
Metody | |
---|---|
Odziedziczone:
stop
|
Stałe MapTypeId
google.maps.MapTypeId
stałe
Identyfikatory typowych obiektów MapType. Określ je według wartości lub nazwy stałej. np. 'satellite'
lub google.maps.MapTypeId.SATELLITE
.
Aby uzyskać dostęp, zadzwoń 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ę ulic. |
SATELLITE |
Ten typ mapy wyświetla zdjęcia satelitarne. |
TERRAIN |
Ten typ mapy wyświetla mapy z obiektami fizycznymi, takimi jak ukształtowanie terenu i roślinność. |
Klasa MapTypeRegistry
google.maps.MapTypeRegistry
zajęcia
Rejestr instancji MapType z kluczem MapType o identyfikatorze.
Te zajęcia są rozszerzone na MVCObject
.
Aby uzyskać dostęp, zadzwoń pod numer const {MapTypeRegistry} = await google.maps.importLibrary("maps")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Zespół | |
---|---|
MapTypeRegistry |
MapTypeRegistry() Parametry: brak
MapTypeRegistry zawiera zbiór niestandardowych typów map dostępnych dla mapy, z których można korzystać. Interfejs API sprawdza ten rejestr, na przykład podczas dostarczania listy dostępnych typów map w ramach funkcji. |
Metody | |
---|---|
set |
set(id, mapType) Parametry:
Zwracana wartość: brak
Ustawia rejestr, aby kojarzył przekazany identyfikator ciągu z przekazanym obiektem MapType. |
Dziedziczone:
addListener , bindTo , get , notify , setValues , unbind , unbindAll
|
Interfejs MapRestriction
google.maps.MapRestriction
interfejs
Ograniczenie, które może zostać zastosowane do mapy. Widoczny obszar mapy nie przekroczy tych ograniczeń.
Właściwości | |
---|---|
latLngBounds |
Po ustawieniu tego ustawienia użytkownik może tylko przesuwać i powiększać w obrębie określonych granic. 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, która wynosi odpowiednio -180 i 180, np. 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 . Ogranicza to możliwość pomniejszania obrazu przez użytkownika, a w rezultacie ukryte są wszystkie elementy znajdujące się poza ograniczeniem. Wartość domyślna to false , co oznacza, że użytkownik może oddalać widok, aż znajdzie się cały ograniczony obszar, z uwzględnieniem obszarów spoza niego. |
Klasa TrafficLayer
google.maps.TrafficLayer
zajęcia
Warstwa natężenia ruchu.
Te zajęcia są rozszerzone na MVCObject
.
Aby uzyskać dostęp, zadzwoń 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
Wartość zwrotu:
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 ustawienie mapy to 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 służący do definiowania właściwości, które można ustawić w warstwie TrafficLayer.
Właściwości | |
---|---|
autoRefresh optional |
Typ:
boolean optional Wartość domyślna:
true Określa, czy warstwa ruchu jest automatycznie odświeżana na podstawie aktualnych informacji. |
map optional |
Typ:
Map optional Mapa, na której ma być wyświetlana warstwa natężenia ruchu. |
Klasa TransitLayer
google.maps.TransitLayer
zajęcia
Warstwa transportu publicznego.
Te zajęcia są rozszerzone na MVCObject
.
Aby uzyskać dostęp, zadzwoń pod numer const {TransitLayer} = await google.maps.importLibrary("maps")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Zespół | |
---|---|
TransitLayer |
TransitLayer() Parametry: brak
Warstwa, na której wyświetlane są linie transportu publicznego. |
Metody | |
---|---|
getMap |
getMap() Parametry: brak
Wartość zwrotu:
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 ustawienie mapy to null , warstwa zostanie usunięta. |
Dziedziczone:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Klasa BicyclingLayer
google.maps.BicyclingLayer
zajęcia
Warstwa ze ścieżkami i ścieżkami rowerowymi.
Te zajęcia są rozszerzone na MVCObject
.
Aby uzyskać dostęp, zadzwoń 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 pasy i ścieżki rowerowe oraz przesuwa duże drogi w dół. |
Metody | |
---|---|
getMap |
getMap() Parametry: brak
Wartość zwrotu:
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 ustawienie mapy to null , warstwa zostanie usunięta. |
Dziedziczone:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Interfejs CameraOptions
google.maps.CameraOptions
interfejs
Służy do konfigurowania 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 cztery punkty wyznaczające czterokątny wielokąt, który jest widoczny na mapie. Na mapie wektorowej ten wielokąt może mieć postać trapezu, a nie prostokąta, jeśli mapa wektorowa ma przechylenie.
Właściwości | |
---|---|
farLeft |
Typ:
LatLng |
farRight |
Typ:
LatLng |
latLngBounds |
Typ:
LatLngBounds Najmniejsza ramka ograniczająca obejmująca widoczny obszar. |
nearLeft |
Typ:
LatLng |
nearRight |
Typ:
LatLng |
Stałe RenderingType.
google.maps.RenderingType
stałe
Aby uzyskać dostęp, zadzwoń 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 wiemy jeszcze, czy mapa jest wektorowa czy rastrowa, bo inicjowanie mapy nie zostało jeszcze zakończone. |
VECTOR |
Wskazuje, że mapa jest mapą wektorową. |
Interfejs MapCapabilities
google.maps.MapCapabilities
interfejs
Obiekt zawierający podsumowanie możliwości dostępnych obecnie w przypadku mapy. 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ę możliwych funkcji znajdziesz we właściwościach.
Właściwości | |
---|---|
isAdvancedMarkersAvailable optional |
Typ:
boolean optional Jeśli ma wartość prawda, ta mapa jest skonfigurowana prawidłowo i umożliwia korzystanie ze znaczników zaawansowanych. Pamiętaj, że aby używać znaczników zaawansowanych, musisz jeszcze 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ć korzystanie ze stylu opartego na danych w przypadku co najmniej jednej warstwy cech. 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 mapy WebGLOverlayView . |