Leaflet中⽂⽂档【转载】
L.Map
API各种类中的核⼼部分，⽤来在页⾯中创建地图并操纵地图。
使⽤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
});
构造器
|构造器|使⽤ |描述|
|L.Map( <HTMLElement|String> id,
options? )| options> options? ) new L.Map(…)
L.map(…) |通过div元素和带有地图选项的描述的⽂字对象来实例化⼀个地图对象，其中⽂字对象是可选的。 |构造器使⽤描述
L.Map( <HTMLElement|String> id, < Map
options> options? )new L.Map(…)
L.map(…)
通过div元素和带有地图选项的描述的⽂字对象来实例化⼀个地图对象，其
中⽂字对象是可选的。
Options
Map State Options
选项类型默认值描述
center LatLng null初始化地图的地理中⼼.
zoom Number null初始化地图的缩放.
layers I.Layer[]null初始化后加载到地图上的图层.
minZoom Number null地图的最⼩视图。可以重写地图图层的minZoom.
maxZoom Number null地图的最⼤视图。可以重写地图图层的maxZoom.
maxBounds LatLngBounds null 当这个选项被设置后，地图被限制在给定的地理边界内，当⽤户平移将地图拖动到视图以外的范围时会出现弹回的效果， 并且也不允许缩⼩视图到给定范围以外的区域（这取决于地图的尺⼨）。
使⽤tMaxBounds⽅法可以动态地设置这种约束.
crs CRS L.CRS.EPSG3857使⽤的坐标系，当你不确定坐标系是什么时请不要更改. Interaction Options
选项类型默认
值
描述
dragging Boolean true决定地图是否可被⿏标或触摸拖动.
touchZoom Boolean true决定地图是否可被两只⼿指触摸拖拽缩放.
scrollWheelZoom Boolean true决定地图是否被被⿏标滚轮滚动缩放.
doubleClickZoom Boolean true决定地图是否可被双击缩放.
boxZoom Boolean true决定地图是否可被缩放到⿏标拖拽出的矩形的视图，⿏标拖拽时需要同时按住shift键.
Enables mobile hacks for supporting instant taps (fixing 200ms click delay on iOS/Android) and
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 ur can shift his finger during touch for it to be considered a valid
tap.
trackResize Boolean true
确定地图在窗⼝尺⼨改变时是否可以⾃动处理浏览器以更新视图.
worldCopyJump Boolean fal
当这个选项可⽤时，当你平移地图到其另⼀个领域时会被地图捕获到，并⽆缝地跳转到原始的领域以保证所有标
注、⽮量图层之类的覆盖物仍然可见.
cloPopupOnClick Boolean true
当你不想⽤户点击地图关闭消息弹出框时，请将其设置为fal .
选项类型默认值描述
Keyboard Navigation Options
选项类型默认值描述
keyboard Boolean true 聚焦到地图且允许⽤户通过键盘的⽅向键和+/-键来漫游地图.
keyboardPanOfft Number 80确定按键盘⽅向键时地图平移的像素.keyboardZoomOfft
Number
1
确定键盘+ or -键对于的缩放级数.全球化的影响
Panning Inertia Options
选项类型默认值描述
inertia
Boolean true 如果该选项可⽤，在拖动和在某⼀时间段内持续朝同⼀⽅向移动建有动⼒的地图时，会有惯性的效果.
inertiaDeceleration Number 3000确定惯性移动减速的速率，单位是像素每秒的⼆次⽅2.
inertiaMaxSpeed Number 1500惯性移动的最⼤速度，单位是像素每秒.
inertiaThreshold
二十一世纪教育Number
depends
放开⿏标或是触摸来停⽌惯性移动与移动停⽌之间的毫秒数.
Control options
选项类型默认值描述
避孕套保质期一般是多久zoomControl Boolean true 确定zoom control是否默认加载在地图上 .attributionControl
Boolean
true
确定attribution control是否默认加载在地图上.
Animation options
选项类型默认值描述
fadeAnimation Boolean depends 确定⽡⽚淡出动画是否可⽤。通常默认在所有浏览器中都⽀持CSS3转场，android例外.zoomAnimation Boolean depends
确定⽡⽚缩放动画是否可⽤。通常默认在所有浏览器中都⽀持CSS3转场，android例外.
zoomAnimationThreshold
Number
4
Won’t animate zoom if the zoom difference exceeds this value.
markerZoomAnimation Boolean depends
确定注记的缩放是否随地图缩放动画⽽播放，如果被禁⽤，注记在动画中拉长时会消失。通常默认在
所有浏览器中都⽀持CSS3转场，android例外.
Events
You can subscribe to the following events using the methods.
Event Data 描述
click MouEvent ⽤户点击或触摸地图时触发.dblclick
河东狮吼的意思MouEvent
⽤户双击或连续两次触摸地图时触发.
moudown MouEvent⽤户按下⿏标按键时触发.
mouup MouEvent⽤户按下⿏标按键时触发.
mouover MouEvent⿏标进⼊地图时触发.
mouout MouEvent⿏标离开地图时触发.
moumove MouEvent⿏标在地图上移动时触发.
contextmenu MouEvent当⽤户在地图上按下⿏标右键时触发，如果有监听器在监听这个时间，则浏览器默认的情景菜单被禁⽤.
focus Event当⽤户在地图上进⾏标引、点击或移动时进⾏聚焦.
blur Event当地图失去焦点时触发.
preclick MouEvent 当⿏标在地图上点击之前触发。有时会在点击⿏标时，并在已存在的点击事件开始处理之前想要某件事情发⽣时⽤
得到.
load Event当地图初始化时触发。（当地图的中⼼点和缩放初次设置时）.
unload Event Fired when the map is destroyed with remove method.
viewret Event当地图需要重绘内容时触发。（通常在地图缩放和载⼊时发⽣）这对于创建⽤户⾃定义的叠置图层⾮常有⽤.
movestart Event地图视图开始改变时触发。（⽐如⽤户开始拖动地图）.
move Event所有的地图视图移动时触发.
moveend Event当地图视图结束改变时触发。（⽐如⽤户停⽌拖动地图）.
dragstart Event⽤户开始拖动地图时触发.
如何保护文化遗产
drag Event⽤户拖动地图时不断重复地触发.
dragend Event⽤户停⽌拖动时触发.
zoomstart Event当地图缩放即将发⽣时触发。（⽐如缩放动作开始前）.
zoomend Event当地图缩放时触发.
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打开弹出窗⼝时地图开始⾃动平移时触发.
layeradd LayerEvent当⼀个新的图层添加到地图上时触发.
layerremove LayerEvent当⼀些图层从地图上移除时触发.
balayerchange LayerEvent当通过layer control改变基础图层时触发.
overlayadd LayerEvent Fired when an overlay is lected through the layer control.
overlayremove LayerEvent Fired when an overlay is delected through the layer control.
locationfound LocationEvent当地理寻址成功时触发（使⽤locate⽅法）
locationerror ErrorEvent当地理寻址错误时触发（使⽤locate⽅法）
popupopen PopupEvent当弹出框打开时触发（使⽤openPopup⽅法）
popupclo PopupEvent当弹出框关闭时触发（使⽤cloPopup⽅法）
Event Data描述
地图状态修改
⽅法返
回
值
描述
tView( < LatLng> center, <
tView( < LatLng> center, <Number> zoom, <zoom/pan
options> options? )this
设定地图（设定其地理中⼼和缩放）.
tZoom( < Number> zoom, <zoom options> options? )this
设定地图的缩放.
zoomIn( < Number> delta?, <zoom options> options? )this 通过delta变量放⼤地图的级别，1是delta的默认值.
zoomOut( < Number> delta?, <zoom options> options? )this 通过delta变量缩⼩地图的级别，1是delta的默认值.
tZoomAround( < LatLng>latlng, < Number> zoom, < zoom
options> options? )this Zooms the map while keeping a specified point on the map stationary (e.g. ud internally for
scroll zoom and double-click zoom).
fitBounds( < LatLngBounds>bounds, < fitBounds options>
options? )
this
将地图视图尽可能⼤地设定在给定的地理边界内.
fitWorld( < fitBounds options>
options? )
this 将地图视图尽可能⼤地设定在包含全部地域的级别上.
panTo( < LatLng> latlng, < pan
两笔画的字options> options? )this 将地图平移到给定的中⼼。如果新的中⼼点在屏幕内与现有的中⼼点不同则产⽣平移动作.
panInsideBounds( <LatLngBounds> bounds )this 平移地图到坐落于给定边界最接近的视图内.
panBy( < Point> point, < pan
options> options? )this 通过给定的像素值对地图进⾏平移.
invalidateSize( < Boolean>options?, <zoom/pan options>
options? )this 检查地图容器的⼤⼩是否改变并更新地图，如果是这样的话，在动态改变地图⼤⼩后调⽤，如果animate是
true的话，对地图进⾏更新.
tMaxBounds( <LatLngBounds> bounds,<zoom/pan options> options? )
this
将地图限定在给定的边界内 (map maxBounds).
locate( < Locate options>
options? )
this
⽤地理定位接⼝Geolocation API获取⽤户位置信息，在成功定位或定位出错产⽣locationerror后解除
location-found事件与定位数据，且将地图视图设定到检测的确切的⽤户的位置（如果定位失败则回到地域
视图）。在Locate options中有更多详细内容。
stopLocate()
this
Stops watching location previously initiated by map.locate({watch: true}) and aborts retting
the map view if map.locate was called with {tView: true}.
remove()
this
Destroys the map and clears all related event listeners.
⽅法返回值描述
三年级语文课本获取地图状态
⽅法返回值描述
getCenter()LatLng 返回地图视图的地理中⼼.getZoom()Number 获取地图视图现在所处的缩放级别.
getMinZoom()Number 返回地图最⼩的缩放级别.getMaxZoom()Number 返回地图最⼤的缩放级别.getBounds()
LatLngBounds
返回地图视图的经纬度边界.
getBoundsZoom( < LatLngBounds> bounds,
< Boolean> inside? )
Number
返回适应整个地图视图边界的最⼤缩放级别。如果inside的设置时true，这个⽅法
返回适应整个地图视图边界的最⼩缩放级别.
getSize()
Point
返回现有地图容器的⼤⼩.
getPixelBounds()Bounds
返回地图视图在像素投影坐标系下的边界。（很多时候对⽤户⾃定义图层和叠加很
getPixelBounds()Bounds 返回地图视图在像素投影坐标系下的边界。（很多时候对⽤户⾃定义图层和叠加很
有⽤）.
getPixelOrigin()Point 返回地图图层像素投影坐标系下的左上⾓的点。（很多时候对⽤户⾃定义图层和叠
加很有⽤）.
⽅法返回值描述
图层控制/h3>
⽅法返回值描述
addLayer( < ILayer> layer, < Boolean> inrtAtTheBottom? )this
将图层添加到地图上。如果inrtAtTheBottom的选项为true，图层
添加时在所以图层之下。（在切换基底图时⽐较有⽤）.
removeLayer( < ILayer> layer )this将图层在地图上移除. hasLayer( < ILayer> layer )Boolean如果添加的图层是当前图层则返回true.
openPopup( < Popup> popup )this 当关闭前⼀个弹出框时弹出指定的对话框。（确定在同⼀时间只有⼀个
打开并可⽤）.
openPopup( < String> html < HTMLElement> el, < LatLng> latlng,
< Popup options> options? )
专业技术报告
this
cloPopup( < Popup> popup? )this关闭openPopup打开的弹出框.
addControl( < IControl> control )this在地图上添加控制选项.
removeControl( < IControl>
control )
this在地图上移除控制选项.
转换⽅法
⽅法返回值描述
latLngToLayerPoint( < LatLng> latlng )Point返回地图图层上与地理坐标相⼀致的点。（在地图上进⾏位置叠加时⽐较有⽤）.
layerPointToLatLng( < Point> point )LatLng返回给定地图上点的地理坐标系.
containerPointToLayerPoint( < Point> point )Point将于地图容器相关的点转换为地图图层相关的点.
layerPointToContainerPoint( < Point> point )Point将地图图层相关的点转换为地图容器相关的点.
latLngToContainerPoint( < LatLng> latlng )Point返回与给定地理坐标系相符的地图容器的点.
containerPointToLatLng( < Point> point )LatLng返回给定地理容器点的地理坐标.
project( < LatLng> latlng, < Number> zoom? )Point将地理坐标投影到指定缩放级别的像素坐标系中.
unproject( < Point> point, < Number> zoom? )LatLng将像素坐标系投影到指定缩放级别的地理坐标系中。（默认为当前的缩放级别）. mouEventToContainerPoint( < MouEvent> event )Point返回⿏标点击事件对象的像素坐标（与地图左上⾓相关）.
mouEventToLayerPoint( < MouEvent> event )Point返回⿏标点击事件对象的像素坐标（与地图图层相关）.
mouEventToLatLng( < MouEvent> event )LatLng返回⿏标点击事件对象的地理坐标.
其他⽅法
⽅法返回值描述
getContainer()HTMLElement返回地图容器对象.
getPanes()MapPanes返回不同地图对象的边框（叠加渲染).
whenReady( < Function> fn, < Object>
context? )this
当地图的位置和缩放初始化好或是时间发⽣之后，运⾏给定的回调⽅法，通常传递⼀
个函数内容.
