Klasa Map
google.maps.Map
class
Te zajęcia trwają MVCObject
.
Dostęp przez połączenie telefoniczne 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 do dołączenia do mapy; Aby dodać element sterujący do mapy, dodaj jego <div> do MVCArray odpowiadającego ControlPosition , w którym ma być renderowany. |
data |
Typ:
Data Wystąpienie Data powiązane 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 pochylenie i kierunek mapy na domyślne wartości zerowe. Wywołanie tej metody może spowodować płynną animację, gdy mapa przesuwa się i powiększa, aby dopasować się 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
Wartość zwracana:
LatLng|undefined |
getClickableIcons |
getClickableIcons() Parametry: brak
Wartość zwracana:
boolean|undefined Zwraca możliwość kliknięcia ikon na mapie. Ikona mapy symbolizuje punkt zainteresowania, zwany też punktem POI. Jeśli zwrócona wartość to true , ikony są klikalne na mapie. |
getDatasetFeatureLayer |
getDatasetFeatureLayer(datasetId) Parametry:
Wartość zwracana:
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 Element mapDiv mapy. |
getFeatureLayer |
getFeatureLayer(featureType) Parametry:
Wartość zwracana:
FeatureLayer Zwraca FeatureLayer określonego elementu FeatureType . W konsoli Google Cloud musisz włączyć usługę FeatureLayer . Jeśli na mapie nie ma FeatureLayer określonego FeatureType lub styl oparty na danych jest niedostępny (brak identyfikatora mapy, brak elementów mozaiki wektorowej i brak FeatureLayer włączonych w styl mapy), zostanie zarejestrowany błąd, a wartość FeatureLayer.isAvailable będzie miała wartość fałsz. |
getHeading |
getHeading() Parametry: brak
Wartość zwracana:
number|undefined Zwraca na kompasie kierunek, w którym zwrócona jest mapa. Wartość kierunku jest mierzona w stopniach (zgodnie z kierunkiem ruchu wskazówek zegara) od kierunku północnego. Jeśli mapa nie została jeszcze zainicjowana, wynik to undefined . |
getHeadingInteractionEnabled |
getHeadingInteractionEnabled() Parametry: brak
Wartość zwracana:
boolean|null Zwraca informacje o tym, czy interakcje z nagłówkiem są włączone. Ta opcja jest aktywna 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
Wartość zwracana:
MapCapabilities Informuje wywołującego o dostępnych obecnie funkcjach mapy na podstawie podawanego identyfikatora mapy. |
getMapTypeId |
getMapTypeId() Parametry: brak
Wartość zwracana:
MapTypeId|string|undefined |
getProjection |
getProjection() Parametry: brak
Wartość zwracana:
Projection|undefined Zwraca bieżącą wartość Projection . Jeśli mapa nie została jeszcze zainicjowana, wynik to undefined . Odsłuchaj zdarzenia projection_changed i sprawdź jego wartość, aby upewnić się, że nie jest to undefined . |
getRenderingType |
getRenderingType() Parametry: brak
Wartość zwracana:
RenderingType Zwraca bieżący typ renderowania mapy. |
getStreetView |
getStreetView() Parametry: brak
Wartość zwracana:
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
Wartość zwracana:
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
Wartość zwracana:
boolean|null Zwraca informacje o tym, czy interakcje z użyciem przechylania są włączone. Ta opcja jest skuteczna 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
Wartość zwracana:
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 gwarantujemy, gdzie na mapie będą się znajdować granice, z wyjątkiem tego, że mapa będzie przesuwana, aby pokazać jak najwięcej granic w ramach {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 symbolizuje punkt zainteresowania, zwany też punktem POI. 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 zostanie ustawiony w kodzie, zostanie użyta konfiguracja mapy w chmurze (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 wartości null wiąże domyślną wbudowaną panoramę z mapą. |
setTilt |
setTilt(tilt) Parametry:
Zwracana wartość: brak
W przypadku map wektorowych ustawia kąt padania mapy. Dozwolone wartości są ograniczone w zależności od poziomu 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 używa widoku z lotu ptaka pod kątem 0° niezależnie od poziomu powiększenia i widocznego obszaru. setTilt(45) powoduje automatyczne przełączenie kąta nachylenia na 45°, gdy obrazy w tej perspektywie są dostępne dla bieżącego poziomu powiększenia i widocznego obszaru, oraz przełączenie z powrotem na 0°, gdy obrazy w tej perspektywie są niedostępne (jest to zachowanie domyślne). 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: funkcja getTilt zwraca bieżący kąt nachylenia, a nie wartość ustawioną przez funkcję setTilt . Ponieważ właściwości getTilt i setTilt odnoszą się do różnych rzeczy, nie bind() właściwości tilt , ponieważ może to spowodować nieprzewidziane skutki. |
setTiltInteractionEnabled |
setTiltInteractionEnabled(tiltInteractionEnabled) Parametry:
Zwracana wartość: brak
Określa, czy interakcje z przechylaniem są włączone. 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). |
setZoom |
setZoom(zoom) Parametry:
Zwracana wartość: brak
Ustawia powiększenie mapy. |
Uzyskane:
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:
To zdarzenie 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. Zdarzenia IconMouseEvent i MapMouseEvent są identyczne, z tym że pierwsze ma 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:
To zdarzenie jest wywoływane, gdy użytkownik kliknie mapę dwukrotnie. Pamiętaj, że zdarzenie kliknięcia może być wywoływane raz lub 2 razy tuż przed tym zdarzeniem. |
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ę właściwość 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
google.maps.MapOptions
interfejs
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 po zainicjowaniu mapy. |
cameraControl optional |
Typ:
boolean optional Włączony lub wyłączony stan kontroli aparatu. |
cameraControlOptions optional |
Typ:
CameraControlOptions optional Opcje wyświetlania sterowania 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. Ta wartość musi być podawana bezpośrednio podczas tworzenia mapy. Zmiana tej wartości w późniejszym czasie może spowodować przejście elementów sterujących w stan undefined . Dotyczy tylko ustawień wprowadzonych przez interfejs API Map. Nie skaluje elementów sterujących 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 klawiatury, które są sterowane oddzielnie przez opcję MapOptions.keyboardShortcuts . Nie wyłącza gestów sterujących, które są sterowane oddzielnie przez opcję MapOptions.gestureHandling . |
disableDoubleClickZoom optional |
Typ:
boolean optional Włącza lub wyłącza powiększanie i wyśrodkowywanie po kliknięciu dwukrotnie. Ta opcja jest domyślnie włączona. Uwaga: tej właściwości nie zalecamy. 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, który ma być wyświetlany, gdy wskaźnik myszy znajduje się nad mapą przeciąganą. 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, który ma się wyświetlać 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 1 kursor zastępczy, który nie jest adresem URL. Na przykład: draggingCursor: 'url(http://www.example.com/icon.png), auto;' . |
fullscreenControl optional |
Typ:
boolean optional Włączony lub wyłączony stan kontrolki Pełny ekran. |
fullscreenControlOptions optional |
Typ:
FullscreenControlOptions optional Opcje wyświetlania elementu sterującego trybem pełnoekranowym. |
gestureHandling optional |
Typ:
string optional To ustawienie określa, jak interfejs API obsługuje gesty na mapie. Dozwolone wartości:
|
heading optional |
Typ:
number optional Kierunek lotu w obrazach lotniczych w stopniach mierzonych zgodnie z kierunkiem wskazówek zegara od kierunku północnego. Nagłówki są dopasowywane 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 jest skuteczna 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ślny:
true w przypadku map wektorowych i false w przypadku map rastrowych.Okreś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 utworzeniu mapy nie można zmienić tego parametru. Map.DEMO_MAP_ID można używać do testowania funkcji, które wymagają identyfikatora mapy, ale nie wymagają włączenia funkcji w chmurze. |
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 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 mapy. |
|
Typ:
boolean optional Włączony lub wyłączony stan elementu sterującego Przesunięcie. |
|
Typ:
PanControlOptions optional Opcje wyświetlania sterowania 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 w ramach wyznaczonej granicy. |
rotateControl optional |
Typ:
boolean optional Włączony lub wyłączony stan elementu sterującego Obróć. |
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: tej właściwości nie zalecamy. 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ą miały zastosowanie tylko do etykiet i geometrii. Ta funkcja nie jest dostępna w przypadku używania identyfikatora mapy lub 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 automatyczne przełączanie kąta padania mapy. Jedynymi dozwolonymi wartościami są 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 automatycznie zmienia się na 45°, gdy dla bieżącego poziomu powiększenia i widowiska są dostępne obrazy o kącie 45°, i zmienia się z powrotem na 0°, gdy obrazy o tym kącie są niedostępne (to zachowanie domyślne). 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: funkcja getTilt zwraca bieżący kąt nachylenia, a nie wartość określoną przez tę opcję. Ponieważ getTilt i ta opcja odnoszą się do różnych rzeczy, nie bind() właściwości tilt . Może to mieć nieprzewidziane skutki. |
tiltInteractionEnabled optional |
Typ:
boolean optional Domyślnie:
false Określa, czy mapa ma umożliwiać użytkownikowi sterowanie pochyleniem kamery. Ta opcja jest skuteczna 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 zoomu odpowiadają wyższej rozdzielczości. |
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żna utworzyć mapę w 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>
Te zajęcia trwają HTMLElement
.
Ta klasa implementuje MapElementOptions
.
Dostęp przez połączenie telefoniczne 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 ma być rastrowa, czy wektorowa. 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 takim przypadku mapa zostanie automatycznie przekształcona w mapę rastrową.
Atrybut HTML:
|
tiltInteractionDisabled |
Typ:
boolean optional Domyślnie:
false Określa, czy mapa ma umożliwiać użytkownikowi sterowanie pochyleniem kamery. Ta opcja jest skuteczna 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 zoomu odpowiadają wyższej rozdzielczości.
Atrybut HTML:
|
Metody | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) Parametry:
Wartość zwracana:
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:
Wartość zwracana:
void Usuwa z docelowego elementu detektor zdarzeń zarejestrowany wcześniej za pomocą metody 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.
Te zajęcia trwają Event
.
Dostęp przez połączenie telefoniczne const {ZoomChangeEvent} = await google.maps.importLibrary("maps")
. Zobacz Biblioteki w Maps JavaScript API.
Interfejs MapTypeStyle
google.maps.MapTypeStyle
interfejs
Element MapTypeStyle
to zbiór selektorów i stylizatorów, które określają styl mapy. Selektory określają funkcje lub elementy mapy, które mają zostać zmienione, 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 stylów, które mają być stosowane do wybranych elementów i funkcji mapy; Reguły są stosowane w kolejności podanej 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 użyciu i dozwolonych wartościach znajdziesz w dokumentacji dotyczącej stylów. |
Interfejs MapMouseEvent
google.maps.MapMouseEvent
interfejs
Ten obiekt jest zwracany z różnych zdarzeń myszy na mapie i na 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ń domEvent może mieć inną semantykę niż MapMouseEvent (np. zdarzenie MapMouseEvent „kliknięcie” może mieć domEvent typu KeyboardEvent ). |
latLng optional |
Typ:
LatLng optional Szerokość i długość geograficzna, które były pod kursorem w momencie wystąpienia zdarzenia. |
Metody | |
---|---|
stop |
stop() Parametry: brak
Wartość zwracana:
void Zapobiega dalszemu rozprzestrzenianiu się 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 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 ustawień systemu. |
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
.
Dostęp przez połączenie telefoniczne const {MapTypeId} = await google.maps.importLibrary("maps")
. Zobacz Biblioteki w Maps JavaScript API.
Stałe | |
---|---|
HYBRID |
Ten typ mapy wyświetla przezroczystą warstwę głównych ulic na zdjęciach satelitarnych. |
ROADMAP |
Ten typ mapy wyświetla normalną mapę 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
class
Rejestr wystąpień MapType, którego kluczem jest identyfikator MapType.
Te zajęcia trwają MVCObject
.
Dostęp przez połączenie telefoniczne 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 przekraczać tych ograniczeń.
Właściwości | |
---|---|
latLngBounds |
Po ustawieniu użytkownik może przesuwać i powiększać tylko w określonych granicach. Granice mogą ograniczać zarówno długość, jak i szerokość geograficzną, lub tylko szerokość geograficzną. W przypadku granic wyznaczonych tylko przez szerokość geograficzną użyj odpowiednio długości geograficznej zachodniej i wschodniej odpowiednio -180 i 180, np. 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 . Ogranicza to możliwość oddalania przez użytkownika, dzięki czemu wszystko poza ograniczonym obszarem pozostaje ukryte. Domyślnie jest to false , co oznacza, że użytkownik może oddalać widok, aż do momentu, gdy cały obszar ograniczony jest widoczny, łącznie z obszarami poza obszarem ograniczonym. |
TrafficLayer class
google.maps.TrafficLayer
class
Warstwa danych o natężeniu ruchu.
Te zajęcia trwają MVCObject
.
Dostęp przez połączenie telefoniczne 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
Wartość zwracana:
Map|null 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 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
google.maps.TrafficLayerOptions
interfejs
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 się odświeża, gdy pojawią się nowe 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,
Te zajęcia trwają MVCObject
.
Dostęp przez połączenie telefoniczne 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
Wartość zwracana:
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 ma wartość null , warstwa zostanie usunięta. |
Uzyskane:
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 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
Wartość zwracana:
Map|null Zwraca mapę, na której wyświetla się ta warstwa. |
setMap |
setMap(map) Parametry:
Wartość zwracana:
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 wielokąt czteroboku, 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 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. Pamiętaj, że aby korzystać z 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 wartość to Prawda, mapa jest prawidłowo skonfigurowana i umożliwia korzystanie z elementu WebGLOverlayView . |