Maps

MapElement class

google.maps.MapElement zajęcia

MapElement to podklasa HTMLElement służąca do renderowania map. Po wczytaniu biblioteki maps można utworzyć mapę w HTML-u. 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 Map, do którego można uzyskać dostęp za pomocą właściwości MapElement.innerMap.

Element niestandardowy:
<gmp-map center="lat,lng" heading-interaction-disabled internal-usage-attribution-ids="id1 id2" map-id="string" rendering-type="vector" tilt-interaction-disabled zoom="number"></gmp-map>

Ta klasa rozszerza klasę HTMLElement.

Ta klasa implementuje interfejs MapElementOptions.

Dostęp przez połączenie pod numer const {MapElement} = await google.maps.importLibrary("maps").
 Zobacz Biblioteki w Maps JavaScript API.

MapElement
MapElement([options])
Parametry: 
center
Typ:  LatLng|LatLngLiteral optional
Szerokość i długość geograficzna środka mapy.
Atrybut HTML:
  • <gmp-map center="lat,lng"></gmp-map>
headingInteractionDisabled
Typ:  boolean optional
Domyślnie: false
Określa, czy mapa powinna zezwalać użytkownikowi na sterowanie kierunkiem kamery (obrotem). Ta opcja działa tylko wtedy, gdy mapa jest mapą wektorową. Jeśli nie zostanie ustawiony w kodzie, użyta zostanie konfiguracja w chmurze dla identyfikatora mapy (jeśli jest dostępna).
Atrybut HTML:
  • <gmp-map heading-interaction-disabled></gmp-map>
innerMap
Typ:  Map
Odwołanie do elementu Map, którego MapElement używa wewnętrznie.
internalUsageAttributionIds
Typ:  Iterable<string> optional
Domyślnie: null
Dodaje do inicjatora identyfikator atrybucji użycia, który pomaga Google określić, które biblioteki i przykłady są przydatne dla deweloperów, np. użycie biblioteki klastrowania znaczników. Aby zrezygnować z wysyłania identyfikatora atrybucji użytkowania, możesz usunąć tę właściwość lub zastąpić jej wartość pustym ciągiem. Wysyłane będą tylko unikalne wartości. Zmiany tej wartości po utworzeniu instancji mogą być ignorowane.
Atrybut HTML:
  • <gmp-map internal-usage-attribution-ids="id1 id2"></gmp-map>
mapId
Typ:  string optional
Identyfikator mapy. Tego parametru nie można ustawić ani zmienić po utworzeniu instancji mapy. Map.DEMO_MAP_ID można używać do wypróbowywania funkcji, które wymagają identyfikatora mapy, ale nie wymagają włączenia w chmurze.
Atrybut HTML:
  • <gmp-map map-id="string"></gmp-map>
renderingType
Typ:  RenderingType optional
Określa, czy mapa ma być rastrowa, czy wektorowa. Tego parametru nie można ustawić ani zmienić po utworzeniu instancji mapy. Jeśli nie zostanie ustawiony, typ renderowania (jeśli jest dostępny) zostanie określony przez konfigurację w chmurze dla identyfikatora mapy. Pamiętaj, że mapy wektorowe mogą nie być dostępne na wszystkich urządzeniach i w przeglądarkach. W razie potrzeby mapa zostanie zastąpiona rastrową.
Atrybut HTML:
  • <gmp-map rendering-type="vector"></gmp-map>
  • <gmp-map rendering-type="raster"></gmp-map>
tiltInteractionDisabled
Typ:  boolean optional
Domyślnie: false
Określa, czy mapa powinna zezwalać użytkownikowi na sterowanie pochyleniem kamery. Ta opcja działa tylko wtedy, gdy mapa jest mapą wektorową. Jeśli nie zostanie ustawiony w kodzie, użyta zostanie konfiguracja w chmurze dla identyfikatora mapy (jeśli jest dostępna).
Atrybut HTML:
  • <gmp-map tilt-interaction-disabled></gmp-map>
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 wartości powiększenia odpowiadają wyższej rozdzielczości.
Atrybut HTML:
  • <gmp-map zoom="number"></gmp-map>
control-block-end-inline-center
Umieszcza element w pozycji ControlPosition.BLOCK_END_INLINE_CENTER.
control-block-end-inline-end
Umieszcza element w pozycji ControlPosition.BLOCK_END_INLINE_END.
control-block-end-inline-start
Umieszcza element w pozycji ControlPosition.BLOCK_END_INLINE_START.
control-block-start-inline-center
Umieszcza element w pozycji ControlPosition.BLOCK_START_INLINE_CENTER.
control-block-start-inline-end
Umieszcza element w pozycji ControlPosition.BLOCK_START_INLINE_END.
control-block-start-inline-start
Umieszcza element w pozycji ControlPosition.BLOCK_START_INLINE_START.
control-inline-end-block-center
Umieszcza element w pozycji ControlPosition.INLINE_END_BLOCK_CENTER.
control-inline-end-block-end
Umieszcza element w pozycji ControlPosition.INLINE_END_BLOCK_END.
control-inline-end-block-start
Umieszcza element w pozycji ControlPosition.INLINE_END_BLOCK_START.
control-inline-start-block-center
Umieszcza element w pozycji ControlPosition.INLINE_START_BLOCK_CENTER.
control-inline-start-block-end
Umieszcza element w pozycji ControlPosition.INLINE_START_BLOCK_END.
control-inline-start-block-start
Umieszcza element w pozycji ControlPosition.INLINE_START_BLOCK_START.
default
Za pomocą elementów niestandardowych możesz tworzyć komponenty wielokrotnego użytku na podstawie komponentów internetowych interfejsu Maps JavaScript API, takich jak AdvancedMarkerElement. Domyślnie wszystkie elementy niestandardowe dodane bezpośrednio do elementu MapElement będą umieszczane i renderowane w elemencie MapPanes.overlayMouseTarget. Komponenty internetowe interfejsu Maps JavaScript API mogą jednak zostać ponownie umieszczone w wewnętrznych slotach elementu MapElement.
BetaaddEventListener
addEventListener(type, listener[, options])
Parametry: 
  • typestring Ciąg znaków z uwzględnieniem wielkości liter reprezentujący typ zdarzenia, którego chcesz nasłuchiwać.
  • 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 capturepassive.
Zwracana wartość:  void
Konfiguruje funkcję, która będzie wywoływana za każdym razem, gdy określone zdarzenie zostanie dostarczone do celu. Zobacz addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametry: 
  • typestring ciąg znaków określający typ zdarzenia, dla którego ma zostać usunięty detektor zdarzeń.
  • listenerEventListener|EventListenerObject Detektor zdarzeń modułu obsługi zdarzeń, który ma zostać usunięty z obiektu docelowego zdarzenia.
  • optionsboolean|EventListenerOptions optional zobacz opcje.
Zwracana wartość:  void
Usuwa z obiektu docelowego detektor zdarzeń zarejestrowany wcześniej za pomocą metody addEventListener. Zobacz removeEventListener.
gmp-zoomchange
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy zmienia się właściwość powiększenia mapy.

MapElementOptions interfejs

google.maps.MapElementOptionsinterfejs

Obiekt MapElementOptions służący do definiowania właściwości, które można ustawić w obiekcie MapElement.

center optional
Typ:  LatLng|LatLngLiteral optional
headingInteractionDisabled optional
Typ:  boolean optional
internalUsageAttributionIds optional
Typ:  Iterable<string> optional
mapId optional
Typ:  string optional
renderingType optional
Typ:  RenderingType optional
tiltInteractionDisabled optional
Typ:  boolean optional
zoom optional
Typ:  number optional

ZoomChangeEvent class

google.maps.ZoomChangeEvent zajęcia

To zdarzenie jest tworzone na podstawie monitorowania zmiany powiększenia.

Ta klasa rozszerza klasę Event.

Dostęp przez połączenie pod numer const {ZoomChangeEvent} = await google.maps.importLibrary("maps").
 Zobacz Biblioteki w Maps JavaScript API.

Map class

google.maps.Map zajęcia

Ta klasa rozszerza klasę MVCObject.

Dostęp przez połączenie pod numer const {Map} = await google.maps.importLibrary("maps").
 Zobacz Biblioteki w Maps JavaScript API.

Map
Map(mapDiv[, opts])
Parametry: 
  • mapDivHTMLElement Mapa zostanie wyrenderowana, aby wypełnić ten element.
  • optsMapOptions optional Opcje
Tworzy nową mapę w danym kontenerze HTML, który jest zwykle elementem DIV.
DEMO_MAP_ID Identyfikator mapy, którego można używać w przykładowych kodach wymagających identyfikatora mapy. Ten identyfikator mapy nie jest przeznaczony do użytku w aplikacjach produkcyjnych i nie można go używać w przypadku funkcji, które wymagają konfiguracji w chmurze (np. dostosowywania stylu przez konsolę Cloud).
controls
Dodatkowe elementy sterujące dołączane 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
Instancja Data powiązana z mapą. Dodaj do tego obiektu Data funkcje, aby wygodnie wyświetlać je na tej mapie.
mapTypes
Rejestr instancji MapType według identyfikatora ciągu.
overlayMapTypes
Typ:  MVCArray<MapType optional>
Dodatkowe typy map do nałożenia. Typy map nakładkowych będą wyświetlane na mapie bazowej, do której są dołączone, w kolejności, w jakiej występują w tablicy overlayMapTypes (nakładki o wyższych wartościach indeksu są wyświetlane przed nakładkami o niższych wartościach indeksu).
fitBounds
fitBounds(bounds[, padding])
Parametry: 
  • boundsLatLngBounds|LatLngBoundsLiteral granice do wyświetlenia.
  • paddingnumber|Padding optional Dopełnienie w pikselach. Granice zostaną dopasowane do części mapy, która pozostanie po usunięciu dopełnienia. Wartość liczbowa spowoduje zastosowanie tego samego dopełnienia po wszystkich 4 stronach. Wpisz tu 0, aby funkcja fitBounds była idempotentna w stosunku do wyniku funkcji getBounds.
Zwracana wartość: brak
Ustawia widoczny obszar tak, aby obejmował podane granice.
Uwaga: gdy mapa jest ustawiona na display: none, funkcja fitBounds odczytuje rozmiar mapy jako 0x0, a więc nie wykonuje żadnych działań. Aby zmienić widoczny obszar, gdy mapa jest ukryta, ustaw mapę na visibility: hidden, dzięki czemu element div 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ę podczas przesuwania i powiększania mapy w celu dopasowania jej do granic. To, czy ta metoda animuje, zależy od wewnętrznej heurystyki.
getBounds
getBounds()
Parametry: brak
Wartość zwracana:  LatLngBounds|undefined granice szerokości i długości geograficznej bieżącego widocznego obszaru.
Zwraca granice bieżącego widoku w postaci współrzędnych geograficznych. Jeśli widocznych jest więcej niż 1 kopia świata, zakres granic w długości geograficznej wynosi od -180 do 180 stopni włącznie. Jeśli mapa nie została jeszcze zainicjowana lub nie ustawiono środka i poziomu powiększenia, wynikiem jest undefined. W przypadku map wektorowych z niezerowym nachyleniem lub kierunkiem zwrócone granice szerokości i długości geograficznej reprezentują najmniejsze pole ograniczenia, które obejmuje widoczny region obszaru wyświetlania mapy. Więcej informacji o uzyskiwaniu dokładnego widocznego regionu obszaru wyświetlania mapy znajdziesz w sekcji MapCanvasProjection.getVisibleRegion.
getCenter
getCenter()
Parametry: brak
Zwracana wartość:  LatLng|undefined
Zwraca pozycję wyświetlaną na środku mapy. Pamiętaj, że ten obiekt LatLng nie jest opakowany. Aby dowiedzieć się więcej, przeczytaj LatLng. Jeśli środek lub granice nie zostały ustawione, wynikiem jest undefined.
getClickableIcons
getClickableIcons()
Parametry: brak
Zwracana wartość:  boolean|undefined
Zwraca klikalność ikon mapy. Ikona mapy reprezentuje ciekawe miejsce. Jeśli zwrócona wartość to true, ikony na mapie można kliknąć.
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
Parametry: 
  • datasetIdstring
Zwracana wartość:  FeatureLayer
Zwraca FeatureLayer dla określonego datasetId. Identyfikatory zbiorów danych muszą być skonfigurowane w konsoli Google Cloud. Jeśli identyfikator zbioru danych nie jest powiązany ze stylem mapy lub jeśli styl oparty na danych jest niedostępny (brak identyfikatora mapy, brak kafelków wektorowych, brak warstw funkcji stylu opartego na danych lub zbiorów danych skonfigurowanych w stylu mapy), zostanie zarejestrowany błąd, a wynikowa wartość FeatureLayer.isAvailable będzie fałszywa.
getDiv
getDiv()
Parametry: brak
Zwracana wartość:  HTMLElement element mapDiv mapy.
getFeatureLayer
getFeatureLayer(featureType)
Parametry: 
Zwracana wartość:  FeatureLayer
Zwraca FeatureLayer określonego FeatureType. FeatureLayer musi być włączony w konsoli Google Cloud. Jeśli na tej mapie nie ma FeatureLayer o podanym FeatureType lub jeśli styl oparty na danych jest niedostępny (brak identyfikatora mapy, brak kafelków wektorowych i brak FeatureLayer włączonego w stylu mapy), rejestrowany jest błąd, a wynikowy FeatureLayer.isAvailable ma wartość false.
getHeading
getHeading()
Parametry: brak
Zwracana wartość:  number|undefined
Zwraca kierunek mapy na kompasie. Wartość kierunku jest mierzona w stopniach (zgodnie z ruchem wskazówek zegara) od kierunku północnego. Jeśli mapa nie została jeszcze zainicjowana, wynikiem jest undefined.
getHeadingInteractionEnabled
getHeadingInteractionEnabled()
Parametry: brak
Zwracana wartość:  boolean|null
Zwraca informację, czy interakcje z nagłówkami są włączone. Ta opcja działa tylko wtedy, gdy mapa jest mapą wektorową. Jeśli nie zostanie ustawiony w kodzie, użyta zostanie konfiguracja w chmurze dla identyfikatora mapy (jeśli jest dostępna).
getInternalUsageAttributionIds
getInternalUsageAttributionIds()
Parametry: brak
Zwracana wartość:  Iterable<string>|null
Zwraca listę identyfikatorów atrybucji użycia, które pomagają Google określić, które biblioteki i przykłady są przydatne dla deweloperów, np. użycie biblioteki klastrowania znaczników.
getMapCapabilities
getMapCapabilities()
Parametry: brak
Zwracana wartość:  MapCapabilities
Informuje wywołującego o bieżących możliwościach dostępnych na mapie na podstawie podanego identyfikatora mapy.
getMapTypeId
getMapTypeId()
Parametry: brak
Zwracana wartość:  MapTypeId|string|undefined
getProjection
getProjection()
Parametry: brak
Zwracana wartość:  Projection|undefined
Zwraca bieżące urządzenie Projection. Jeśli mapa nie została jeszcze zainicjowana, wynikiem jest undefined. Nasłuchuj zdarzenia projection_changed i sprawdź jego wartość, aby upewnić się, że nie jest to undefined.
getRenderingType
getRenderingType()
Parametry: brak
Zwracana wartość:  RenderingType
Zwraca bieżący RenderingType mapy.
getStreetView
getStreetView()
Parametry: brak
Wartość zwracana: