Maps

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.

Map
Map(mapDiv[, opts])
Parametry: 
  • mapDivHTMLElement mapa zostanie wyrenderowana, aby wypełnić ten element.
  • optsMapOptions optional – opcje
Tworzy nową mapę w obrębie danego kontenera HTML, który zwykle jest elementem DIV.
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).
controls
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
Rejestr instancji (MapType) według identyfikatora ciągu znaków.
overlayMapTypes
Typ:  MVCArray<MapType optional>
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).
fitBounds
fitBounds(bounds[, padding])
Parametry: 
  • boundsLatLngBounds|LatLngBoundsLiteral Ograniczenia do pokazania.
  • paddingnumber|Padding optional dopełnienie w pikselach. Granice zostaną dopasowane do tej części mapy, która pozostanie po usunięciu dopełnienia. Wartość liczbowa spowoduje takie samo dopełnienie po wszystkich 4 stronach. Podaj tutaj 0, aby utworzyć funkcję FitBounds idempotentną w przypadku wyniku getBounds.
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
Zwraca pozycję wyświetlaną na środku mapy. Zauważ, że ten obiekt LatLng nie jest opakowany. Aby dowiedzieć się więcej, przeczytaj LatLng. Jeśli środek lub progi nie zostały ustawione, wynik to 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.
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
Parametry: 
  • datasetIdstring
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.
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.
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: 
  • xnumber liczba pikseli, o które można przesunąć mapę w kierunku X.
  • ynumber liczba pikseli, o które można przesunąć mapę w kierunku Y.
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: 
  • latLngLatLng|LatLngLiteral szerokość i długość geograficzna nowego obszaru na mapie.
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: 
  • latLngBoundsLatLngBounds|LatLngBoundsLiteral granice, do których można przesunąć mapę.
  • paddingnumber|Padding optional dopełnienie w pikselach. Wartość liczbowa spowoduje takie samo dopełnienie po wszystkich 4 stronach. Wartość domyślna to 0.
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: 
  • valueboolean
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: 
  • headingnumber
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.
setMapTypeId
setMapTypeId(mapTypeId)
Parametry: 
Zwracana wartość: brak
setOptions
setOptions(options)
Parametry: 
Zwracana wartość: brak
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: 
  • tiltnumber
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 działaniem automatycznego przełączania 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.
setZoom
setZoom(zoom)
Parametry: 
  • zoomnumber większe powiększenie oznacza wyższą rozdzielczość.
Zwracana wartość: brak
Ustawia powiększenie mapy.
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
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.
rightclick
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.

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 gestureHandling z ustawieniem jej "none".

draggable optional
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:
  • "cooperative": zdarzenia przewijania i gesty dotykowe 1 palcem umożliwiają przewijanie strony bez powiększania ani przesuwania mapy. Gesty dotykowe 2 palcami przesuwają i powiększają mapę. Powiększanie mapy przy użyciu klawisza Ctrl lub klawisza ⌘ powoduje zdarzenia przewijania.
    W tym trybie mapa współpracuje ze stroną.
  • "greedy": wszystkie gesty dotykowe i zdarzenia przewijania przesuwają lub powiększają mapę.
  • "none": mapy nie można przesuwać ani powiększać gestami użytkownika.
  • "auto" (ustawienie domyślne): obsługa gestów jest oparta na współpracy lub zachłanności, w zależności od tego, czy stronę można przewijać, czy w elemencie iframe.
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.
isFractionalZoomEnabled optional
Typ:  boolean optional
Wartość domyślna: true w przypadku map wektorowych i false dla map rastrowych
Okreś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ć.
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.
panControl optional
Typ:  boolean optional
Włączony/wyłączony stan elementu sterującego przesuwania.

panControlOptions optional
Typ:  PanControlOptions optional
Opcje wyświetlania elementu sterującego przesuwaniem

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 gestureHandling z ustawioną wartością "cooperative" lub "none".

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.
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.
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" map-id="string" 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.

MapElement
MapElement([options])
Parametry: 
center
Typ:  LatLng|LatLngLiteral optional
Długość i szerokość geograficzna środkowa na mapie.
Atrybut HTML:
  • <gmp-map center="lat,lng"></gmp-map>
innerMap
Typ:  Map
Odwołanie do obiektu Map używanego wewnętrznie przez element MapElement.
mapId
Typ:  string optional
Identyfikator mapy. Więcej informacji znajdziesz w dokumentacji identyfikatora mapy.
Atrybut HTML:
  • <gmp-map map-id="string"></gmp-map>
zoom
Typ:  number optional
Poziom powiększenia mapy.
Atrybut HTML:
  • <gmp-map zoom="number"></gmp-map>
control-block-end-inline-center
Umieszcza element z boksem w pozycji ControlPosition.BLOCK_END_INLINE_CENTER.
control-block-end-inline-end
Umieszcza element z boksem w pozycji ControlPosition.BLOCK_END_INLINE_END.
control-block-end-inline-start
Umieszcza element z boksem w pozycji ControlPosition.BLOCK_END_INLINE_START.
control-block-start-inline-center
Umieszcza element z boksem w pozycji ControlPosition.BLOCK_START_INLINE_CENTER.
control-block-start-inline-end
Umieszcza element z boksem w pozycji ControlPosition.BLOCK_START_INLINE_END.
control-block-start-inline-start
Umieszcza element z boksem w pozycji ControlPosition.BLOCK_START_INLINE_START.
control-inline-end-block-center
Umieszcza element z boksem w pozycji ControlPosition.INLINE_END_BLOCK_CENTER.
control-inline-end-block-end
Umieszcza element z boksem w pozycji ControlPosition.INLINE_END_BLOCK_END.
control-inline-end-block-start
Umieszcza element z boksem w pozycji ControlPosition.INLINE_END_BLOCK_START.
control-inline-start-block-center
Umieszcza element z boksem w pozycji ControlPosition.INLINE_START_BLOCK_CENTER.
control-inline-start-block-end
Umieszcza element z boksem w pozycji ControlPosition.INLINE_START_BLOCK_END.
control-inline-start-block-start
Umieszcza element z boksem w pozycji ControlPosition.INLINE_START_BLOCK_START.
default
Korzystając z elementów niestandardowych, wokół komponentów sieciowych JavaScript, np. AdvancedMarkerElement, możesz tworzyć komponenty wielokrotnego użytku. Domyślnie wszystkie elementy niestandardowe dodane bezpośrednio do interfejsu MapElement będą umieszczane w boksach i renderowane w formacie MapPanes.overlayMouseTarget. Możliwe jednak, że komponenty sieciowe interfejsu Maps JavaScript API mogą zostać umieszczone ponownie w boksach wewnętrznych MapElement.
BetaaddEventListener
addEventListener(type, listener[, options])
Parametry: 
  • typestring ciąg znaków reprezentujący typ nasłuchiwanego zdarzenia (z rozróżnianiem wielkości liter).
  • listenerEventListener|EventListenerObject obiekt, który otrzymuje powiadomienie. Musi to być funkcja lub obiekt z metodą handleEvent
  • optionsboolean|AddEventListenerOptions optional Zobacz opcje. Zdarzenia niestandardowe obsługują tylko zdarzenia capture i passive.
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.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametry: 
  • typestring ciąg tekstowy określający typ zdarzenia, z którego ma zostać usunięty detektor zdarzeń.
  • listenerEventListener|EventListenerObject detektor modułu obsługi zdarzeń, który ma zostać usunięty z celu zdarzenia.
  • optionsboolean|EventListenerOptions optional Zobacz opcje
Wartość zwrotu:  void
Usuwa z celu detektor zdarzeń zarejestrowany wcześniej w addEventListener. Zobacz removeEventListener.
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.

center optional
Typ:  LatLng|LatLngLiteral optional
Początkowe centrum mapy.
mapId optional
Typ:  string optional
Identyfikator mapy. Po utworzeniu instancji mapy tego parametru nie można ustawić ani zmienić.
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ść.

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.

stylers
Typ:  Array<Object>
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.

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.
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.

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
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.

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.

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.
set
set(id, mapType)
Parametry: 
  • idstring Identyfikator obiektu MapType, który ma zostać dodany do rejestru.
  • mapTypeMapType|* obiekt MapType, który ma zostać dodany do rejestru.
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ń.

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.

TrafficLayer
TrafficLayer([opts])
Parametry: 
Warstwa, która wyświetla bieżący ruch na drodze.
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.

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.

TransitLayer
TransitLayer()
Parametry: brak
Warstwa, na której wyświetlane są linie transportu publicznego.
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.

BicyclingLayer
BicyclingLayer()
Parametry: brak
Warstwa, która wyświetla pasy i ścieżki rowerowe oraz przesuwa duże drogi w dół.
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.

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.

farLeft
Typ:  LatLng
farRight
Typ:  LatLng
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.

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.

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.