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.