生活随笔
收集整理的這篇文章主要介紹了
【Leafletjs】4.L.Map 中文API
小編覺得挺不錯的,現(xiàn)在分享給大家,幫大家做個參考.
L.Map API各種類中的核心部分，用來在頁面中創(chuàng)建地圖并操縱地圖.
使用 example // initialize the map on the "map" div with a given center and zoom
var map = L.map('map', {center: [51.505, -0.09],zoom: 13
});
構(gòu)造器 構(gòu)造器使用描述 L.Map ( <HTMLElement|String> id, <Map options> options? ) new L.Map() 通過div元素和帶有地圖選項的描述的文字對象來實例化一個地圖對象，其中文字對象是可選的。
Options Map State Options 選項類型默認(rèn)值描述 center LatLng null 初始化地圖的地理中心. zoom Number null 初始化地圖的縮放. layers ILayer[] null 初始化后加載到地圖上的圖層. minZoom Number null 地圖的最小視圖。可以重寫地圖圖層的minZoom. maxZoom Number null 地圖的最大視圖。可以重寫地圖圖層的maxZoom. maxBounds LatLngBounds null 當(dāng)這個選項被設(shè)置后，地圖被限制在給定的地理邊界內(nèi)，當(dāng)用戶平移將地圖拖動到視圖以外的范圍時會出現(xiàn)彈回的效果， 并且也不允許縮小視圖到給定范圍以外的區(qū)域（這取決于地圖的尺寸）。 使用setMaxBounds方法可以動態(tài)地設(shè)置這種約束. crs CRS L.CRS. 使用的坐標(biāo)系，當(dāng)你不確定坐標(biāo)系是什么時請不要更改.
Interaction Options 選項類型默認(rèn)值描述 dragging Boolean true 決定地圖是否可被鼠標(biāo)或觸摸拖動. touchZoom Boolean true 決定地圖是否可被兩只手指觸摸拖拽縮放. scrollWheelZoom Boolean true 決定地圖是否被被鼠標(biāo)滾輪滾動縮放. doubleClickZoom Boolean true 決定地圖是否可被雙擊縮放. boxZoom Boolean true 決定地圖是否可被縮放到鼠標(biāo)拖拽出的矩形的視圖，鼠標(biāo)拖拽時需要同時按住shift鍵. tap Boolean true Enables mobile hacks for supporting instant taps (fixing 200ms click delay on iOS/Android) and touch holds (fired as contextmenu events). tapTolerance Number 15 The max number of pixels a user can shift his finger during touch for it to be considered a valid tap. trackResize Boolean true 確定地圖在窗口尺寸改變時是否可以自動處理瀏覽器以更新視圖. worldCopyJump Boolean false 當(dāng)這個選項可用時，當(dāng)你平移地圖到其另一個領(lǐng)域時會被地圖捕獲到，并無縫地跳轉(zhuǎn)到原始的領(lǐng)域以保證所有標(biāo)注、矢量圖層之類的覆蓋物仍然可見. closePopupOnClick Boolean true 當(dāng)你不想用戶點擊地圖關(guān)閉消息彈出框時，請將其設(shè)置為false .
Keyboard Navigation Options 選項類型默認(rèn)值描述 keyboard Boolean true 聚焦到地圖且允許用戶通過鍵盤的方向鍵和+/-鍵來漫游地圖. keyboardPanOffset Number 80 確定按鍵盤方向鍵時地圖平移的像素. keyboardZoomOffset Number 1 確定鍵盤+ or -鍵對于的縮放級數(shù).
Panning Inertia Options 選項類型默認(rèn)值描述 inertia Boolean true 如果該選項可用，在拖動和在某一時間段內(nèi)持續(xù)朝同一方向移動建有動力的地圖時，會有慣性的效果. inertiaDeceleration Number 3000 確定慣性移動減速的速率，單位是像素每秒的二次方2 . inertiaMaxSpeed Number 1500 慣性移動的最大速度，單位是像素每秒. inertiaThreshold Number depends 放開鼠標(biāo)或是觸摸來停止慣性移動與移動停止之間的毫秒數(shù).
Control options 選項類型默認(rèn)值描述 zoomControl Boolean true 確定zoom control是否默認(rèn)加載在地圖上 . attributionControl Boolean true 確定attribution control是否默認(rèn)加載在地圖上.
Animation options 選項類型默認(rèn)值描述 fadeAnimation Boolean depends 確定瓦片淡出動畫是否可用。通常默認(rèn)在所有瀏覽器中都支持CSS3轉(zhuǎn)場，android例外. zoomAnimation Boolean depends 確定瓦片縮放動畫是否可用。通常默認(rèn)在所有瀏覽器中都支持CSS3轉(zhuǎn)場，android例外. zoomAnimationThreshold Number 4 Won't animate zoom if the zoom difference exceeds this value. markerZoomAnimation Boolean depends 確定注記的縮放是否隨地圖縮放動畫而播放，如果被禁用，注記在動畫中拉長時會消失。通常默認(rèn)在所有瀏覽器中都支持CSS3轉(zhuǎn)場，android例外.
Events You can subscribe to the following events using these methods.
EventData描述 click MouseEvent 用戶點擊或觸摸地圖時觸發(fā). dblclick MouseEvent 用戶雙擊或連續(xù)兩次觸摸地圖時觸發(fā). mousedown MouseEvent 用戶按下鼠標(biāo)按鍵時觸發(fā). mouseup MouseEvent 用戶按下鼠標(biāo)按鍵時觸發(fā). mouseover MouseEvent 鼠標(biāo)進入地圖時觸發(fā). mouseout MouseEvent 鼠標(biāo)離開地圖時觸發(fā). mousemove MouseEvent 鼠標(biāo)在地圖上移動時觸發(fā). contextmenu MouseEvent 當(dāng)用戶在地圖上按下鼠標(biāo)右鍵時觸發(fā)，如果有監(jiān)聽器在監(jiān)聽這個時間，則瀏覽器默認(rèn)的情景菜單被禁用. focus Event 當(dāng)用戶在地圖上進行標(biāo)引、點擊或移動時進行聚焦. blur Event 當(dāng)?shù)貓D失去焦點時觸發(fā). preclick MouseEvent 當(dāng)鼠標(biāo)在地圖上點擊之前觸發(fā)。有時會在點擊鼠標(biāo)時，并在已存在的點擊事件開始處理之前想要某件事情發(fā)生時用得到. load Event 當(dāng)?shù)貓D初始化時觸發(fā)。（當(dāng)?shù)貓D的中心點和縮放初次設(shè)置時）. unload Event Fired when the map is destroyed with remove method. viewreset Event 當(dāng)?shù)貓D需要重繪內(nèi)容時觸發(fā)。（通常在地圖縮放和載入時發(fā)生）這對于創(chuàng)建用戶自定義的疊置圖層非常有用. movestart Event 地圖視圖開始改變時觸發(fā)。（比如用戶開始拖動地圖）. move Event 所有的地圖視圖移動時觸發(fā). moveend Event 當(dāng)?shù)貓D視圖結(jié)束改變時觸發(fā)。（比如用戶停止拖動地圖）. dragstart Event 用戶開始拖動地圖時觸發(fā). drag Event 用戶拖動地圖時不斷重復(fù)地觸發(fā). dragend Event 用戶停止拖動時觸發(fā). zoomstart Event 當(dāng)?shù)貓D縮放即將發(fā)生時觸發(fā)。（比如縮放動作開始前）. zoomend Event 當(dāng)?shù)貓D縮放時觸發(fā). zoomlevelschange Event Fired when the number of zoomlevels on the map is changed due to adding or removing a layer. resize ResizeEvent Fired when the map is resized. autopanstart Event 打開彈出窗口時地圖開始自動平移時觸發(fā). layeradd LayerEvent 當(dāng)一個新的圖層添加到地圖上時觸發(fā). layerremove LayerEvent 當(dāng)一些圖層從地圖上移除時觸發(fā). baselayerchange LayerEvent 當(dāng)通過layer control改變基礎(chǔ)圖層時觸發(fā). overlayadd LayerEvent Fired when an overlay is selected through the layer control. overlayremove LayerEvent Fired when an overlay is deselected through the layer control. locationfound LocationEvent 當(dāng)?shù)乩韺ぶ烦晒r觸發(fā)（使用locate方法） locationerror ErrorEvent 當(dāng)?shù)乩韺ぶ峰e誤時觸發(fā)（使用locate方法） popupopen PopupEvent 當(dāng)彈出框打開時觸發(fā)（使用openPopup方法） popupclose PopupEvent 當(dāng)彈出框關(guān)閉時觸發(fā)（使用closePopup方法）
地圖狀態(tài)修改 方法返回值描述 setView ( <LatLng> center, <Number> zoom, <zoom/pan options> options? ) this 設(shè)定地圖（設(shè)定其地理中心和縮放）. setZoom ( <Number> zoom, <zoom options> options? ) this 設(shè)定地圖的縮放. zoomIn ( <Number> delta?, <zoom options> options? ) this 通過delta變量放大地圖的級別，1是delta的默認(rèn)值. zoomOut ( <Number> delta?, <zoom options> options? ) this 通過delta變量縮小地圖的級別，1是delta的默認(rèn)值. setZoomAround ( <LatLng> latlng, <Number> zoom, <zoom options> options? ) this Zooms the map while keeping a specified point on the map stationary (e.g. used internally for scroll zoom and double-click zoom). fitBounds ( <LatLngBounds> bounds, <fitBounds options> options? ) this 將地圖視圖盡可能大地設(shè)定在給定的地理邊界內(nèi). fitWorld ( <fitBounds options> options? ) this 將地圖視圖盡可能大地設(shè)定在包含全部地域的級別上. panTo ( <LatLng> latlng, <pan options> options? ) this 將地圖平移到給定的中心。如果新的中心點在屏幕內(nèi)與現(xiàn)有的中心點不同則產(chǎn)生平移動作. panInsideBounds ( <LatLngBounds> bounds ) this 平移地圖到坐落于給定邊界最接近的視圖內(nèi). panBy ( <Point> point, <pan options> options? ) this 通過給定的像素值對地圖進行平移. invalidateSize ( <Boolean> options?, <zoom/pan options> options? ) this 檢查地圖容器的大小是否改變并更新地圖，如果是這樣的話，在動態(tài)改變地圖大小后調(diào)用，如果animate是true的話，對地圖進行更新. setMaxBounds ( <LatLngBounds> bounds, <zoom/pan options> options? ) this 將地圖限定在給定的邊界內(nèi) (map maxBounds). locate ( <Locate options> options? ) this 用地理定位接口Geolocation API獲取用戶位置信息，在成功定位或定位出錯產(chǎn)生locationerror后解除location-found事件與定位數(shù)據(jù)，且將地圖視圖設(shè)定到檢測的確切的用戶的位置（如果定位失敗則回到地域視圖）。在Locate options中有更多詳細(xì)內(nèi)容。 stopLocate ()this Stops watching location previously initiated by map.locate ({watch: true}) and aborts resetting the map view if map.locate was called with {setView: true}. remove ()this Destroys the map and clears all related event listeners.
獲取地圖狀態(tài) 方法返回值描述 getCenter ()LatLng 返回地圖視圖的地理中心. getZoom ()Number 獲取地圖視圖現(xiàn)在所處的縮放級別. getMinZoom ()Number 返回地圖最小的縮放級別. getMaxZoom ()Number 返回地圖最大的縮放級別. getBounds ()LatLngBounds 返回地圖視圖的經(jīng)緯度邊界. getBoundsZoom ( <LatLngBounds> bounds, <Boolean> inside? ) Number 返回適應(yīng)整個地圖視圖邊界的最大縮放級別。如果inside的設(shè)置時true，這個方法返回適應(yīng)整個地圖視圖邊界的最小縮放級別. getSize ()Point 返回現(xiàn)有地圖容器的大小. getPixelBounds ()Bounds 返回地圖視圖在像素投影坐標(biāo)系下的邊界。（很多時候?qū)τ脩糇远x圖層和疊加很有用）. getPixelOrigin ()Point 返回地圖圖層像素投影坐標(biāo)系下的左上角的點。（很多時候?qū)τ脩糇远x圖層和疊加很有用）.
圖層控制/h3> 方法返回值描述 addLayer ( <ILayer> layer, <Boolean> insertAtTheBottom? ) this 將圖層添加到地圖上。如果insertAtTheBottom的選項為true，圖層添加時在所以圖層之下。（在切換基底圖時比較有用）. removeLayer ( <ILayer> layer ) this 將圖層在地圖上移除. hasLayer ( <ILayer> layer ) Boolean 如果添加的圖層是當(dāng)前圖層則返回true. addControl ( <IControl> control ) this 在地圖上添加控制選項. removeControl ( <IControl> control ) this 在地圖上移除控制選項.
轉(zhuǎn)換方法 方法返回值描述 latLngToLayerPoint ( <LatLng> latlng ) Point 返回地圖圖層上與地理坐標(biāo)相一致的點。（在地圖上進行位置疊加時比較有用）. layerPointToLatLng ( <Point> point ) LatLng 返回給定地圖上點的地理坐標(biāo)系. containerPointToLayerPoint ( <Point> point ) Point 將于地圖容器相關(guān)的點轉(zhuǎn)換為地圖圖層相關(guān)的點. layerPointToContainerPoint ( <Point> point ) Point 將地圖圖層相關(guān)的點轉(zhuǎn)換為地圖容器相關(guān)的點. latLngToContainerPoint ( <LatLng> latlng ) Point 返回與給定地理坐標(biāo)系相符的地圖容器的點. containerPointToLatLng ( <Point> point ) LatLng 返回給定地理容器點的地理坐標(biāo). project ( <LatLng> latlng, <Number> zoom? ) Point 將地理坐標(biāo)投影到指定縮放級別的像素坐標(biāo)系中. unproject ( <Point> point, <Number> zoom? ) LatLng 將像素坐標(biāo)系投影到指定縮放級別的地理坐標(biāo)系中。（默認(rèn)為當(dāng)前的縮放級別）. mouseEventToContainerPoint ( <MouseEvent> event ) Point 返回鼠標(biāo)點擊事件對象的像素坐標(biāo)（與地圖左上角相關(guān)）. mouseEventToLayerPoint ( <MouseEvent> event ) Point 返回鼠標(biāo)點擊事件對象的像素坐標(biāo)（與地圖圖層相關(guān)）. mouseEventToLatLng ( <MouseEvent> event ) LatLng 返回鼠標(biāo)點擊事件對象的地理坐標(biāo).
其他方法 方法返回值描述 getContainer ()HTMLElement 返回地圖容器對象. getPanes ()MapPanes 返回不同地圖對象的邊框（疊加渲染). whenReady ( <Function> fn, <Object> context? )this 當(dāng)?shù)貓D的位置和縮放初始化好或是時間發(fā)生之后，運行給定的回調(diào)方法，通常傳遞一個函數(shù)內(nèi)容.
位置選項 選項類型默認(rèn)值描述 watch Boolean false 如果該值為真，則開始利用W3C的watchPosition方法監(jiān)聽位置變化情況（而不是指監(jiān)聽一次）。你可以通過map.stoplocate()方法來停止監(jiān)聽. setView Boolean false 如果該值為真，則通過自動將地圖視圖定位到用戶一定精度范圍內(nèi)的位置，如果地理定位失敗則顯示全部地圖. maxZoom Number Infinity 在使用setView選項時視圖縮放的最大級別. timeout Number 10000 在觸發(fā)locationerror事件之前等待地理定位的毫秒為單位的時間. maximumAge Number 0 位置監(jiān)聽的最大生命周期。如果比最后定位回復(fù)后毫秒用時短，則locate返回一個緩存位置. enableHighAccuracy Boolean false 開啟高精度，參加 W3C SPEC的描述.
Zoom/pan options 選項類型默認(rèn)值描述 reset Boolean false If true , the map view will be completely reset (without any animations). pan pan options - Sets the options for the panning (without the zoom change) if it occurs. zoom zoom options - Sets the options for the zoom change if it occurs. animate Boolean - An equivalent of passing animate to both zoom and pan options (see below).
Pan options 選項類型默認(rèn)值描述 animate Boolean - If true , panning will always be animated if possible. If false , it will not animate panning, either resetting the map view if panning more than a screen away, or just setting a new offset for the map pane (except for `panBy` which always does the latter). duration Number 0.25 Duration of animated panning. easeLinearity Number 0.25 The curvature factor of panning animation easing (third parameter of the Cubic Bezier curve). 1.0 means linear animation, the less the more bowed the curve. noMoveStart Boolean false If true , panning won't fire movestart event on start (used internally for panning inertia).
Zoom options 選項類型默認(rèn)值描述 animate Boolean - If not specified, zoom animation will happen if the zoom origin is inside the current view. If true , the map will attempt animating zoom disregarding where zoom origin is. Setting false will make it always reset the view completely without animation.
fitBounds options The same as zoom/pan options and additionally:
選項類型默認(rèn)值描述 paddingTopLeft Point [0 , 0 ] Sets the amount of padding in the top left corner of a map container that shouldn't be accounted for when setting the view to fit bounds. Useful if you have some control overlays on the map like a sidebar and you don't want them to obscure objects you're zooming to. paddingBottomRight Point [0 , 0 ] The same for bottom right corner of the map. padding Point [0 , 0 ] Equivalent of setting both top left and bottom right padding to the same value.
Properties M地圖屬性包括互動操作，允許你在運行環(huán)境中互動地控制地圖行為，比如通過拖拽和點擊縮放級別顯示和不顯示某要素. Example:
map.doubleClickZoom.disable();
You can also access default map controls like attribution control through map properties:
map.attributionControl.addAttribution("Earthquake data © GeoNames");
Property類型描述 dragging IHandler 地圖拖拽處理程序，可以通過鼠標(biāo)和觸摸的形式. touchZoom IHandler 觸摸地圖縮放處理程序. doubleClickZoom IHandler 雙擊縮放處理程序. scrollWheelZoom IHandler 滾動縮放處理程序. boxZoom IHandler 矩形框（利用鼠標(biāo)拖動）縮放處理程序. keyboard IHandler 鍵盤導(dǎo)向處理程序. tap IHandler Mobile touch hacks (quick tap and touch hold) handler. zoomControl Control.Zoom 縮放控制. attributionControl Control.Attribution 屬性控制.
地圖窗口 望文思義，這是一個包括可以用來放置自定義圖層的不同的地圖窗口的對象。最大的區(qū)別是圖層的疊置.
Property類型描述 mapPane HTMLElement 包含其他地圖窗口的窗口. tilePane HTMLElement 切片圖層的窗口. objectsPane HTMLElement 包含除切片窗口以外所有窗口的窗口. shadowPane HTMLElement 用來隱藏圖層的窗口（如標(biāo)注的隱藏）. overlayPane HTMLElement 這線段和多邊形一類圖層的窗口. markerPane HTMLElement 標(biāo)注圖標(biāo)的窗口. popupPane HTMLElement 彈出的窗口.
轉(zhuǎn)載于:https://www.cnblogs.com/shitao/p/3566598.html
總結(jié)
以上是生活随笔 為你收集整理的【Leafletjs】4.L.Map 中文API 的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。
如果覺得生活随笔 網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔 推薦給好友。
