leafLetAPI中⽂⽂档翻译

L.Map

API各种类中的核⼼部分，⽤来在页⾯中创建地图并操纵地图。

Constructor（构造器）

通过div元素和带有地图选项的描述的⽂字对象来实例化⼀个地图对象，其中⽂字对象是可选的。

Options（选项）

Map State Options（地图状态选项）

centre（中⼼）：初始化地图的地理中⼼。

zoom（缩放）：初始化地图的缩放。

layers（图层）：初始化后加载到地图上的图层。

minZoom（最⼩视图）：地图的最⼩视图。可以重写地图图层的最⼩视图。

maxZoom（最⼤视图）：地图的最⼤视图。可以重写地图图层的最⼤视图。

maxBounds（最⼤边界）：当这个选项被设置后，地图被限制在给定的地理边界内，当⽤户平移将地图拖动到视图以外的范围时会出现弹        回的效果，并且也不允许缩⼩视图到给定范围以外的区域（这取决于地图的尺⼨）。使⽤setMaxBounds⽅法可以动态地设置这种约束。

crs（坐标参考系统）：使⽤的坐标系，当你不确定坐标系是什么时请不要更改。Interaction Options（交互操作）

dragging（拖动）：决定地图是否可被⿏标或触摸拖动。

touchZoom（触摸缩放）：决定地图是否可被两只⼿指触摸拖拽缩放。

scrollWheelZoom（滚轮缩放）：决定地图是否被被⿏标滚轮滚动缩放。

doubleClickZoom（双击缩放）：决定地图是否可被双击缩放。

boxZoom（多边形缩放）：决定地图是否可被缩放到⿏标拖拽出的矩形的视图，⿏标拖拽时需要同时按住shift键。

trackResize（追踪尺⼨改变）：确定地图在窗⼝尺⼨改变时是否可以⾃动处理浏览器以更新视图。

worldCopyJump（领域副本跳转）：当这个选项可⽤时，当你平移地图到其另⼀个领域时会被地图捕获到，并⽆缝地跳转到原始的领域以        保证所有标注、⽮量图层之类的覆盖物仍然可见。

closePopupOnClick（点击关闭消息弹出框）：当你不想⽤户点击地图关闭消息弹出框时，请将其设置为false。Keyboard Navigation Options（键盘操纵选项）

keyboard（键盘）：聚焦到地图且允许⽤户通过键盘的⽅向键和加减键来漫游地图。

keyboardPanOffset（键盘平移补偿）：确定按键盘⽅向键时地图平移的像素。

keyboardZoomOffset（键盘缩放补偿）：确定键盘加减键对于的缩放级数。Panning Inertia Options（平移惯性选项）

inertia（惯性）：如果该选项可⽤，在拖动和在某⼀时间段内持续朝同⼀⽅向移动建有动⼒的地图时，会有惯性的效果。

inertiaDeceleration（惯性减速）：确定惯性移动减速的速率，单位是像素每秒的⼆次⽅。

inertiaMaxSpeed（惯性最⼤速度）：惯性移动的最⼤速度，单位是像素每秒。inertiaThreshold（惯性阈值）：放开⿏标或是触摸来停⽌惯性移动与移动停⽌之间的毫秒数。Control options（控制选项）

zoomControl（缩放控制）：确定缩放控制是否默认加载在地图上。attributionControl（属性控制）：确定属性控制是否默认加载在地图上。Animation options（动画选项）

fadeAnimation（淡出动画）：确定⽡⽚淡出动画是否可⽤。通常默认在所有浏览器中都⽀持CSS3转场，android例外。

zoomAnimation（缩放动画）：确定⽡⽚缩放动画是否可⽤。通常默认在所有浏览器中都⽀持CSS3转场，android例外。

markerZoomAnimation（注记缩放动画）：确定注记的缩放是否随地图缩放动画⽽播放，如果被禁⽤，注记在动画中拉长时会消失。通        常默认在所有浏览器中都⽀持CSS3转场，android例外。                                                                                                                          Events（事件）

click（点击）：⽤户点击或触摸地图时触发。

dbclick（双击）：⽤户双击或连续两次触摸地图时触发。

mousedown（⿏标按下）：⽤户按下⿏标按键时触发。mouseup（⿏标抬起）：⽤户按下⿏标按键时触发。

mouseover（⿏标经过）：⿏标进⼊地图时触发。

mouseout（⿏标移出）：⿏标离开地图时触发。

mousemove（⿏标移动）：⿏标在地图上移动时触发。

contextmenu（情景菜单）：当⽤户在地图上按下⿏标右键时触发，如果有监听器在监听这个时间，则浏览器默认的情景菜单被禁⽤。

focus（聚焦）：当⽤户在地图上进⾏标引、点击或移动时进⾏聚焦。

blur（变暗）:当地图失去焦点时触发。

preclick（预先点击）：当⿏标在地图上点击之前触发。有时会在点击⿏标时，并在已存在的点击事件开始处理之前想要某件事情发⽣时⽤        得到。

load（载⼊）：当地图初始化时触发。（当地图的中⼼点和缩放初次设置时）

viewreset（视图重置）：当地图需要重绘内容时触发。（通常在地图缩放和载⼊时发⽣）这对于创建⽤户⾃定义的叠置图层⾮常有⽤。

movestart（移动开始）：地图视图开始改变时触发。（⽐如⽤户开始拖动地图）

move（移动）：所有的地图视图移动时触发。

moveend（移动结束）：当地图视图结束改变时触发。（⽐如⽤户停⽌拖动地图）

dragstart（拖动开始）：⽤户开始拖动地图时触发。

drag（拖动）：⽤户拖动地图时不断重复地触发。

dragend（拖动结束）：⽤户停⽌拖动时触发。

zoomstart（缩放开始）：当地图缩放即将发⽣时触发。（⽐如缩放动作开始前） zoomend（ 缩 放 结 束 ）： 当 地 图 缩 放 时 触 发 。                   autopanstart（⾃动平移开始）：打开弹出窗⼝时地图开始⾃动平移时触发。

layeradd（添加图层）：当⼀个新的图层添加到地图上时触发。

layerremove（图层移除）：当⼀些图层从地图上移除时触发。

baselayerchange（基础图层改变）：当通过图层控制台改变基础图层时触发。

locationfound（位置查找）：当地理寻址成功时触发（使⽤locate⽅法）。

locationerror（定位错误）：当地理寻址错误时触发（使⽤locate⽅法）。

popupopen（打开弹出框）：当弹出框打开时触发（使⽤openPopup⽅法）。

popupclose（关闭弹出框）：当弹出框关闭时触发（使⽤closePopup⽅法）。

Methods for Modifying Map State（地图状态修改）

setView(设定视图)：设定地图（设定其地理中⼼和缩放），如果forceReset设置的是true，即使移动和缩放动作是合理的，地图也会重载，其默认值是fault。

setZoom（ 设 定 缩 放 ）： 设 定 地 图 的 缩 放 。                             zoomIn（放⼤）：通过delta变量放⼤地图的级别，1是delta的默认值。zoomOut（缩⼩）：通过delta变量缩⼩地图的级别，1是delta的默认值。fitBounds（使适合边界）：将地图视图尽可能⼤地设定在给定的地理边界内。

fitWorld（使适合地域范围）：将地图视图尽可能⼤地设定在包含全部地域的级别上。                                       panTo（平移⾄中⼼点）：将地图平移到给定的中⼼。如果新的中⼼点在屏幕内与现有的中⼼点不同则产⽣平移动作。

panInsideBounds（平移到某边界内）：平移地图到坐落于给定边界最接近的视图内。

panBy（通过像素点平移）：通过给定的像素值对地图进⾏平移。

invalidateSize（⽆效的⼤⼩）：检查地图容器的⼤⼩是否改变并更新地图，如果是这样的话，在动态改变地图⼤⼩后调⽤，如果animate        是true的话，对地图进⾏更新。

setMaxBounds（设置最⼤边界）：将地图限定在给定的边界内。                                                                                                             locate（定位）：⽤地理定位接⼝获取⽤户位置信息，在成功定位或定位出错产⽣locationerror后解除location-found事件与定位数据，         且将地图视图设定到检测的确切的⽤户的位置（如果定位失败则回到地域视图）。在Location Options中有更多详细内容。stopLocation（停⽌定位）：开始map.locate⽅法时停⽌预先检测位置信息。

Methods for Getting Map State（获取地图状态）

getCenter（获取地图中⼼）：返回地图视图的地理中⼼。

getZoom（获取缩放级别）：获取地图视图现在所处的缩放级别。

getMixZoom（获取最⼩缩放级别）：返回地图最⼩的缩放级别。getMaxZoom（获取最⼤缩放级别）：返回地图最⼤的缩放级别。getBounds（获取边界）：返回地图视图的经纬度边界。

getBoundsZoom（获取边界缩放级别）：返回适应整个地图视图边界的最⼤缩放级别。如果inside的设置时true，这个⽅法返回适应整个地 图 视 图 边 界 的 最 ⼩ 缩 放 级 别 。                                                                                                                                                           getSize（获取⼤⼩）：返回现有地图容器的⼤⼩。

getPixelBounds（获取像素边界）：返回地图视图在像素投影坐标系下的边界。（很多时候对⽤户⾃定义图层和叠加很有⽤） getPixelOrigin（获取像素原点）：返回地图图层像素投影坐标系下的左上⾓的点。（很多时候对⽤户⾃定义图层和叠加很有⽤） Methods for Layers and Controls（图层控制）

addlayer（添加图层）：将图层添加到地图上。如果insertAtTheBottom的选项为true，图层添加时在所以图层之下。（在切换基底图时

⽐较有⽤）

removelayer（ 移 除 图 层 ）： 将 图 层 在 地 图 上 移 除 。 haslayer（是否有此图层）：如果添加的图层是当前图层则返回true。

openPopup（打开弹出框）：当关闭前⼀个弹出框时弹出指定的对话框。（确定在同⼀时间只有⼀个打开并可⽤）

closePopup（关闭弹出框）：关闭openPopup打开的弹出框。

addControl（添加控制）：在地图上添加控制选项。

removeControl（移除控制）：在地图上移除控制选项。Conversion Methods（转换⽅法）

latlngToLayerPoint（将经纬度添转变为图层上的点）：返回地图图层上与地理坐标相⼀致的点。（在地图上进⾏位置叠加时⽐较有⽤）

layerPointToLatLng（将图层上的点转换为经纬度点）：返回给定地图上点的地理坐标系。containerPointToLayerPoint（容器点到图层点）：将于地图容器相关的点转换为地图图层相关的点。

layerPointToContainerPoint（图层点到容器点）：将地图图层相关的点转换为地图容器相关的点。LatLngToContainerPoint（经纬度点到容器点）：返回与给定地理坐标系相符的地图容器的点。

containerPointToLatLng（容器点转换为经纬度点）：返回给定地理容器点的地理坐标。

project（投影）：将地理坐标投影到指定缩放级别的像素坐标系中。

unproject（反投影）：将像素坐标系投影到指定缩放级别的地理坐标系中。（默认为当前的缩放级别）

mouseEventToContainerPoint（⿏标点击事件到地图容器点）：返回⿏标点击事件对象的像素坐标（与地图左上⾓相关）。

mouseEventToLayerPoint（⿏标点击事件到地图容器点）：返回⿏标点击事件对象的像素坐标（与地图图层相关）。

mouseEventToLatLng（⿏标点击事件到经纬度点）：返回⿏标点击事件对象的地理坐标。Other Methods（其他⽅法）

getContainer（获取容器）：返回地图容器对象。

getPanes（获取地图边框）：返回不同地图对象的边框（叠加渲染)

whenReady（准备就绪）：当地图的位置和缩放初始化好或是时间发⽣之后，运⾏给定的回调⽅法，通常传递⼀个函数内容。Locate options（位置选项）

watch（监听）：如果该值为真，则开始利⽤W3C的watchPosition⽅法监听位置变化情况（⽽不是指监听⼀次）。你可以通过

map.stoplocate()⽅法来停⽌监听。

setView（设置视图）：如果该值为真，则通过⾃动将地图视图定位到⽤户⼀定精度范围内的位置，如果地理定位失败则显⽰全部地图。

maxZoom（最⼤级别）：在使⽤setView选项时视图缩放的最⼤级别。

timeout（超时）：在触发locationerror事件之前等待地理定位的毫秒为单位的时间。

maximumAge（最⼤⽣命周期）：位置监听的最⼤⽣命周期。如果⽐最后定位回复后毫秒⽤时短，则locate返回⼀个缓存位置。

enableHighAccuracy（开启⾼精度）：开启⾼精度，参加W3C SPEC的描述。

Properties（属性）

地图属性包括互动操作，允许你在运⾏环境中互动地控制地图⾏为，⽐如通过拖拽和点击缩放级别显⽰和不显⽰某要素。     你也可以通过地图属性来接受默认的地图控制项，⽐如属性控制。

dragging（拖拽）：地图拖拽处理程序，可以通过⿏标和触摸的形式。

touchZoom（触摸缩放按钮）：触摸地图缩放处理程序。

doubleClickZoom（双击缩放）：双击缩放处理程序。

scrollWheelZoom（滚动缩放）：滚动缩放处理程序。

boxZoom（矩形框缩放）：矩形框（利⽤⿏标拖动）缩放处理程序。

keyboard（键盘）：键盘导向处理程序。

zoomControl（缩放控制）：缩放控制。

attributionControl（属性控制）：属性控制。Map Panes（地图窗⼝）

望⽂思义，这是⼀个包括可以⽤来放置⾃定义图层的不同的地图窗⼝的对象。最⼤的区别是图层的叠置。

mapPane（地图窗⼝）：包含其他地图窗⼝的窗⼝。

tilePane（切⽚窗⼝）：切⽚图层的窗⼝。

objectsPane（对象窗⼝）：包含除切⽚窗⼝以外所有窗⼝的窗⼝。

shadowPane（隐含窗⼝）：⽤来隐藏图层的窗⼝（如标注的隐藏）。

overlayPane（图层窗⼝）：这线段和多边形⼀类图层的窗⼝。markerPane（ 标 注 窗 ⼝ ）： 标 注 图 标 的 窗 ⼝ 。 popupPane（弹出窗⼝）：弹出的窗⼝。

L.Marker

⽤来在地图中放置注记。

Constructor（构造函数）

L.Marker（）：通过给定⼀个地理点和⼀个具有选项的对象来实例化⼀个注记。

Options（选项）

icon（图标）：图标类⽤来表达注记。参加Icon documentation以了解⾃定义注记图标的详细信息。默认设置为new L.Icon.Default()。clickable（可点击）：如果是false，注记则不产⽣⿏标事件并表现为底层地图的⼀部分。                                                           draggable（可拖动）：决定注记是否可被⿏标或触摸拖动。

title（标题）：注记旁边显⽰浏览器提⽰的⽂本信息。

zIndexOffset（）：默认情况下，注记图⽚的叠置顺序由纬度⾃动设置。如果你想将某⼀注记放置于其他之上可⽤这个选项，设置⼀个较

⼤的值即可，⽐如1000（或是相反地设置⼀个较⼤的负值）。

opacity（ 不 透 明 度 ）： 决 定 注 记 的 不 透 明 度 。                                                           riseOnHover（凸显）：如果此值为true，则当把⿏标放置于注记之上时，注记会显⽰与其他注记之上。

riseOffset（凸显补偿）：riseOnHover要素凸显时⾼度的补偿值。

Events（事件）

click（点击）：当⿏标点击注记时触发。dbclick（双击）：当⿏标双击注记时触发。

mousedown（⿏标按下）：当⿏标按下⿏标键时触发。

mouseover（⿏标置于其上）：当⿏标在注记上时触发。

mouseout（⿏标移出）：当⿏标离开注记时触发。

contextmenu（⽂本菜单）：当⿏标右击注记时触发。

dragstrat（拖动开始）：当⽤户拖动注记时触发。

drag（拖动）：当⽤户拖动注记时不断触发。dragend（拖动结束）：当⽤户停⽌拖动注记时触发。

move（移动）：当注记通过定义经纬度⽽移动时触发。新的坐标包含事件参数。

remove（删除）：当注记在地图上被删除时触发。

Methods（⽅法）

addTo()：在地图上添加注记。

getLatLng()：返回当前注记的地理位置。

setLatLng()：将注记位置更改到给定点。

setIcon()：更改注记的图标。setZIndexOffset()：更改注记的zIndex offset。

setOpacity()：更改注记的透明度。

update()：更新注记的位置，在直接更改经纬度对象的坐标时⽐较有⽤。

bindPopup()：当点击⼀个注记时绑定⼀个特定的HTML内容的弹出窗⼝。你也可以⽤Marker中的openPopup⽅法打开绑定的弹出窗⼝。

unbindPopup()：将先前⽤bindPopup⽅法绑定的注记取消。

openPopup()：打开先前⽤bindPopup⽅法绑定的弹出框。

closePopup()：关闭已打开的注记的弹出框。Interaction handlers（互操作处理程序）

dragging（拖动）：注记拖动处理程序（包括⿏标和触摸）。

L.Popup

Constructor（函数构造器）

L.Popup()：通过给定⼀些选项构造⼀个弹出框对象，对象⽤来描述出现形式和位置还有⼀个可选对象来根据指向的资源对象标注弹出框。maxWidth（最⼤宽度）：弹出框的最⼤宽度。

minWidth（最⼩宽度）：弹出框的最⼩宽度。

maxHeight（最⼤⾼度）：设置后，如果内容超过弹出窗⼝的给定⾼度则产⽣⼀个可以滚动的容器。

autoPan（⾃动平移）：如果你不想地图⾃动平移来适应打开的弹出框，就设置其为false。

closeButton（关闭按钮）：控制弹出窗⼝中出现的关闭按钮。

offset（补偿值）：弹出窗⼝位置的补偿值。在同⼀图层中打开弹出窗⼝时对于控制锚点⽐较有⽤。

autoPanPadding（⾃动平移填补）：在地图视图⾃动平移产⽣后弹出窗⼝和地图视图之间的边缘。

zoomAnimation：决定是否在所在级别上弹出窗⼝。如果你在弹出窗⼝中有flash内容的最好将其设置为不可⽤。

Methods（⽅法）

addTo：将弹出窗⼝添加到地图上。

openOn：将弹出窗⼝添加到地图上并将之前的⼀个关闭。与map.oenPopup(popup)⽅法相同。

setLatLng：设置弹出窗⼝打开的地理上的点位。

setContent：设置弹出窗⼝的HTML内容。

L.TileLayer L.TileLayer.WMS

⽤来显⽰地图上切⽚图层的WMS服务，继承⾃TileLayer。

Constructor（函数构造器）

L.TileLayer.WMS()： 通过给定⼀个基本的WMS服务的URL和WMS参数或选项对象来实例化⼀个WMS切⽚图层对象。

Options（选项）

layers：WMS图层以逗号分隔符隔开的列表。

styles：WMS样式以逗号分隔符隔开的列表。

format：WMS图像格式（⽤“image/png”来显⽰透明图层）。

transparent：如果该项为true，WMS服务返回透明图⽚。

version：WMS服务的版本。

Methods（⽅法）

setParams()：融合新的参数和在当前屏幕中重申请的切⽚（除⾮noRedraw设置为true）。

L.TileLayer.Canvas

⽤来创建浏览器端绘制的切⽚图层的底层画布。

Constructor（ 函 数 构 造 器 ）                                             L.TileLayer.Canvas()：通过⼀个具有选项的对象来实例化⼀个切⽚图层画布对象。Options（选项）

async：在实例化时可以异步地绘制切⽚。在全部绘制完后，tileDrawn⽅法需要在每个切⽚上使⽤。

Methods（⽅法）

drawTile()：在创建实例来绘制切⽚后你需要定义此⽅法；canvas是你可以绘制的实际上的切⽚画布，tilePoint反应了切⽚的数⽬，zoom         是当前的缩放级别。

tileDrawn()：如果async选项被定义，在全部绘制完后，这个函数需要在每个切⽚上使⽤。canvas与画布对象相同，传递参数给

drawTile。

L.ImageOverlay

⽤来在地图上规定范围内载⼊和显⽰单幅图像，继承⾃ILayer。

Constructor（ 函 数 构 造 器 ）                                                               L.ImageOverlay()：通过给定图像的URL和相关的地理范围来实例化⼀个图像叠加层对象。

Options（选项）

opacity：图像叠加层的透明度。

Methods（⽅法）

addTo()：将图像叠加层添加到地图上。

setOpacity()：设置叠加层的透明度。

bringToFront()：将叠加层置于所有层的顶层。bringToBack()：将叠加层置于所有层的底层。

L.Path

是包含选项和与适量叠加层共享常量的抽象类。不可以接使⽤。Options（选项）

stroke：路径是否描边。设置为false时，多边形和圆的边界将不可见。color： 描 边 颜 ⾊ 。                                                                      weight：描边的像素级别的宽度。

opacity：描边透明度。

fill：路径是否填充颜⾊。设置为false时，多边形和圆的填充内容不可见。

fillColor：填充颜⾊。

fillOpacity：填充透明度。

dashArray：定义描边线型的字符串。这在画布上不起作⽤。（⽐如android 2） clickable：如果此项为false，则⽮量不产⽣⿏标事件并表现为底图的⼀部分。

Events（事件）

click：⽤户点击或点触对象时触发。

dbclick：⽤户双击或连续两次点触对象时触发。

mousedown：当⽤户在对象上按下⿏标时触发。

mouseover：当⿏标置于对象上⽅时触发。

mouseout： 当 ⿏ 标 离 开 对 象 时 触 发 。                                                                                          contextmenu：当⽤户在对象上点击⿏标右键时触发，当此事件被监听时，会阻⽌弹出浏览器本⾝的右键菜单。

add：当路径被添加在地图上时触发。

remove：当路径在地图上移除时触发。

Methods（⽅法）

addTo()：将图层添加到地图上。

bindPopup()：将具有特定HTML内容的弹出框与点击路径绑定起来。

unbindPopup()：将之前的弹出框绑定解除。

openPopup()：打开之前通过bindPopup⽅法与路径上指定点或未指定情况下某⼀点绑定的弹出框。

closePopup()：如果与路径绑定的弹出框是打开状态的，则将其关闭。

setStyle()：更改给予对象选项对象的路径的表现形式。

getBounds()：返回路径的经纬度绑定信息。

bringToFront()：将此层移⾄所以路径层的最上层。

bringToBack()：将此层移⾄所以路径层的最底层。

redraw()：重绘图层。在更改了路径的坐标时⽐较有⽤。Static properties（静态属性）

SVG：如果⽤SVG来表达⽮量，则此值为true（在当前⼤多数浏览器中是true）。

VML：如果VML⽤来表达⽮量，则此值为true（在IE 6-8中适⽤）。

CANVAS：如果canvas⽤来表达⽮量，则此值为true（在android 2中适⽤）。你也可以在页⾯中载⼊leaflet之前通过设置全局变量

L_PREFER_CANVAS为true来强制使⽤此项——有时在表达上千上万相同的注记时会显著地提⾼性能，但⽬前由于漏洞导致移除图层⾮常慢。

CLIP_PADDING：决定地图视图周围裁剪区域延展的⼤⼩（与⼤⼩相关，⽐如0.5在每个⽅向上是屏幕的⼀半）。较⼩的值意味着在拖动地        图时你会看到被裁剪路径的末端，较⼤值会降低绘制性能。

L.Polyline

绘制叠加在地图上线段的类。继承⾃Path。⽤Map#addLayer来添加到地图上。Constructor（ 函 数 构 造 器 ）                                                        L.Polyline()：通过给定的地理点组成的数组和任意的选项对象实例化⼀个线段。

Options（选项）

smoothFactor：决定每⼀个缩放级别上线段简化程度。如果⼤的话意味着更好的表现和看起来更光滑，⼩的话意味更准确地表⽰。

noClip：：不允许线段裁剪。

Methods（⽅法）

addLatLng()：向线段添加⼀个点。

setLatLngs()：⽤所给的地理点的数组替代线段上的点。

getLatLngs()：返回路径上的点组成的数组。

spliceLatLngs()：允许添加、移除和更改线段上的点。同Array#splice的语法⼀致。返回移除点组成的数组。

getBounds()：返回线段的经纬度边界。L.MultiPolyline

是FeatureGroup的扩展，⽤来创建多线（在同⼀图层中由多个共享样式和弹出框的线段组成）。

Constructor（函数构造器）

L.MultiPolyline()：通过给定的地理点的⼆维数组（其中每个⼀维数组表⽰⼀个线段）和选项对象来实例化⼀个多线对象。

L.Polygon

在地图上绘制多边形的类。是Polyline的扩展。⽤Map#addLayer添加到地图上。创建多边形时经过的点没有传统意义上的起点和终点——最好将这种点指出来。Constructor（函数构造器）

L.Polygon()：通过给定地理点组成的数组和选项对象来实例化⼀个多边形（同线段构造⽅法相同）。你也可以通过传递经纬度的⼆维数组        来创建⼀个带有洞的多边形，第⼀个经纬度数组表⽰外环，剩下的表⽰⾥⾯的洞。

L.MultiPolygon

是FeatureGroup的扩展，⽤来创建多多边形（在同⼀图层上由共享样式和弹出框的多个多边形组成）。

Constructor（函数构造器）

L.MultiPolygon()：通过给定的经纬度的⼆维数组（每个⼀维数组表⽰⼀个多边形）和选项对象实例化多多边形（同多线相同）。

L.Rectangle

在地图上绘制矩形的类。是多边形的扩展。⽤Map#addLayer添加到地图上。

Constructor（函数构造器）

L.Rectangle()：通过给定的地理边界和选项对象来实例化⼀个矩形对象。

Methods（⽅法）

setBounds()：根据传递的边界重绘矩形。

L.Circle

在地图上绘制圆形叠加物的类。是Path的延伸。⽤Map#addLayer来添加到地图上。

Constructor（函数构造器）

L.Circle()：通过给定的地理点和以⽶为单位的半径和选项对象来实例化⼀个圆对象。

Methods（⽅法）

getLatLng()：返回圆当前的地理位置。

getRadius()：返回圆的半径，以⽶为单位。setLatLng()：将圆放置到⼀个新的位置。

setRadius()：设置圆的半径，以⽶为单位。

L.CircleMarker

是⼀个特定半径的圆，半径单位是像素。是Circle的延伸。通过Map#addLayer添加到地图上。

Constructor（函数构造器）

1. 1. ircleMarker()：通过给定的地理点和选项对象来实例化⼀个圆注记。默认的半径是10像素，并且可以通过在路径选项中传递⼀个半径参数来修改半径。

Methods（⽅法）

setLatLng()：将圆注记放置于⼀个新的位置。

setRadius()：设置圆注记的半径，以像素为单位。

L.LayerGroup

⽤来将⼏个图层组成⼀个组并作为⼀个图层来处理。如果你将其添加到地图上，组中任何图层的添加或移除都将使其同样在地图添加或删      除。继承⾃ILayer接⼝。

Constructor（函数构造器）

L.LayerGroup()：创建⼀个组，视情况指定⼀组初始的图层。

Methods（⽅法）

addTo()：将图组添加到地图上。

addLayer()：将给定的图层添加到组中。

removeLayer()：将给定的图层从组中移除：

clearLayer()：将组中的图层清空。

eachLayer()：遍历组中的图层，需选择⼀个符合情况的迭代函数。

L.FeatureGroup

是LayerGroup的扩展，但多了⿏标事件和共享的弹出框⽅法。继承⾃ILayer接⼝。

Constructor（函数构造器）

L.FeatureGroup()：创建⼀个图组，视情况指定⼀组初始图层。

Methods（⽅法）

具 有 LayerGroup 所 以 的 ⽅ 法 ， 还 有 下 ⾯ 多 出 的 ⽅ 法 ：                          bindPopup()：在组中任意具有bindPopup⽅法的图层上绑定⼀个具有具体HTML内容的弹出框。getBounds()：返回要素组的经纬度边界（通过他⼦图层的边界和坐标获得）。

setStyle()：设置组中具有setStyle⽅法的图层的路径选项。

bringToFront()：将图组置于顶层。

bringToBack()：将图组置于底层。

Events（事件）

click：⽤户点击或触摸组是触发。

dbclick：⽤户双击或连续两次触摸组时触发。

mouseover：当⿏标置于组上⽅时触发。

mouseout：当⿏标离开组时触发。

mousemove：当⿏标经过组时触发。

contextmenu：当⽤户右击图层时触发。

layeradd：当图层被加⼊到组时触发。

layerremove：当图层从组中移除时触发。

L.GeoJSON

展⽰⼀个GeoJSON的图层。允许你在地图上解析并显⽰GeoJSON数据。是FeatureGroup的延伸。由此创建的每个要素层获取要素与之关联的GeoJSON数据属性（因此你随后可以传递它的属性）。

Constructor（函数构造器）

L.GeoJSON()：创建⼀个GeoJSON图层。可以任意地接受GeoJSON格式的对象和选项对象并显⽰在地图上（随后可以选择⽤addData⽅法添加）。

Options（ 选 项 ）                                                                                                          pointToLayer()：在创建GeoJSON点图层时所⽤到的函数（如果不特意说明，会创建简单的注记）。

style()：在获取⽤来创建GeoJSON要素的⽮量图层的样式选项时可以⽤到。

onEachFeature()：在每个创建的图层上都会调⽤此函数。对于向要素添加事件和弹出框⽐较有⽤。

filter()：⽤来决定是否显⽰某要素的函数。

Methods（⽅法）

addData()：在图层中添加GeoJSON对象。

setStyle()：通过给定的样式函数改变GeoJSON⽮量图层的样式。

resetStyle()：将⽮量图层样式重置为初始GeoJSON样式，对于hover事件之后的重置⽐较有⽤。Static methods（静态⽅法）

geometryToLayer():通过给定的GeoJSON要素创建图层。

coordsToLatlng():通过在GeoJSON中表⽰点的两个数字组成（分别表⽰纬度和经度）的数组来创建经纬度对象。如果reverse设置为

true，那么这两个数字被颠倒，表经度和纬度。

coordsToLatlngs():通过GeoJSON坐标坐标的数组创建多维数组。leversDeep指定具体的嵌套级别（0表⽰点的数组，1表⽰点数组的数组等等，0为默认值）。如果reverse设置为true，这些数组变为经度和纬度。

L.LatLng

表⽰通过某⼀经度和纬度确定的地理上的点。

所以leaflet接受的经纬度对象也接受他们的单⼀数组的形式（除⾮在其他⽅⾯表明不可以）。

Constructor（函数构造器）

L.LatLng()：通过给定的纬度和经度创建表⽰地理点的对象。

Options（选项）

lat：以度数表⽰的纬度。

lng：以度数表⽰的经度。

Methods（⽅法）

distanceTo()：返回到通过半正⽮公式计算的经纬度的距离（⽤⽶表⽰）。

equals()：如果给定的经纬度在相同的位置（具有较⼩的容差）则返回true。

toString()：返回点的描述信息（⽤来调试⽤）。

wrap()：返回在经度上left和right边界覆盖范围内（默认为0180到180）的⼼的经纬度对象。

Constants（常量）

DEG_TO_RAD:度数转换为弧度的乘⼦。

RAD_TO_DEG:弧度转换为度数的乘⼦。

MAX_MARGIN:判断相等的容差。

L.LatLngBounds

表⽰地图上⼀个矩形的区域。

所有接受LatLngBounds对象的leaflet⽅法也接受他们简单数组的形式（除⾮另⾏说明）。

Constructor（函数构造器）

L.LatLngBounds(西南⾓点,东北⾓点)：通过定义矩形西南⾓点和东北⾓点来创建经纬度的矩形框。

L.LatLngBounds()：通过定义内在点来创建经纬度的矩形框。当⽤fitBounds把地图放到适合某些位置的缩放级别时是⽐较有⽤的。

Methods（⽅法）

extend()：将边界延伸到包含给定点和边界的范围。geSouthWest()：返回边界的西南⾓点。

getNorthEast()：返回边界的东北⾓点。

getNorthWest()：返回边界的西北⾓点。

getSouthEast()：返回边界的东南⾓点。getWest()：返回边界的西点。

getSouth()：返回边界的南⾓点。

getEast()：返回边界的东⾓点。

getNorth()：返回边界的北⾓点。

getCenter()：返回边界的中⼼点。

containg(otherBounds)：如果矩形框包含给定的边界则返回true。

contains(latlng)：如果矩形框包含给定的点则返回true。intersects()：如果矩形框与给定的边界相交则返回true。

equals()：如果矩形框与给定的范围相等（在⼀定容差范围内）则返回true。

toBBoxString()：返回“西南经度，西南纬度，东北经度，东北纬度”形式的外接矩形的坐标。在向⽹络服务器提交请求返回地理数据时

⽐较有⽤。

pad()：返回当前范围扩⼤⼀定百分⽐后的边界。

isValid()：如果边界可被初始化则返回true。

L.Point

显⽰以像素为单位的点的x，y坐标。

所以接受点对象的leaflet⽅法和选项都也接受他们简单数组的形式。

Constructor（函数构造器）

L.Point()：⽤给定点的x和y坐标来创建点对象。如果round设置为true，则将x和y的值转换为圆中。？

Properties（属性）

x：x坐标。

y：y坐标。

Methods（⽅法）

add()：返回当前点和给定点的和。subtract()：返回当前点和给定点的差。multiplyBy()：返回当前点和给定值的积。

divideBy()：返回当前点和给定值的商。如果round设置为true，则返回⼀个圆的结果。

distanceTo()：返回当前点与给定的的距离。clone()： 返 回 当 前 的 副 本 。     round()：返回当前的在圆上的坐标的副本。equals()：如果点坐标相同则返回true。toString()：在调试时显⽰点的字符串的形式。

L.Bounds

⽤像素坐标表⽰的矩形的区域。

所以接受边界对象的leaflet⽅法和选项都也接受他们简单数组的形式。

Constructor（函数构造器）

L.Bounds(左上⾓点，右下⾓点)：⽤两个坐标（通常是左上⾓的点和右下⾓的点）来创建边界对象。

L.Bounds(点集)：⽤包含的点创建边界对象。

Properties（属性）

min：矩形左上⾓点。

max：矩形右下⾓点。

Methods（⽅法）

extend()：将包含给定点的边界延伸。

getCenter()：返回边界的中⼼点。

contains()：如果矩形包含给定的边界则返回true。

contains()：如果矩形包含给定点则返回true。

intersects()：如果矩形与给定边界相交则返回true。

isValid()：如果边界可以被初始化则返回true。

getSize()：返回边界的⼤⼩。

L.Icon

创建注记时显⽰的图标。Constructor（函数构造器）

L.Icon()：通过给定的选项创建图标实例。

Options（ 选 项 ）                                                          iconUrl：请求图标图⽚的URL（脚本中的绝对或相对路径）。

iconRetinaUrl：图标图⽚视⽹膜视图下的尺⼨的URL。⽤于视⽹膜屏幕的设备。                                                                               iconSize： 图 标 图 ⽚ 的 像 素 ⼤ ⼩ 。                                                                                                                                                  iconAnchor：图标提⽰的坐标（在左上⾓）。图标是对其的，所以这个点是注记的地理位置。如果⼤⼩是指定的则位于中⼼处，也可以在

CSS中设置负边界。

shadowUrl：图标阴影图的URL。如果没有指定，图标没有阴影。

shadowRetinaUrl：图标在视⽹膜视图下的尺⼨的URL。如果没有指定，图标没有阴影。⽤于视⽹膜屏幕的设备。

shadowAnchor：阴影的提⽰坐标（在左上⾓）（如果没有指定则与iconAnchor相同）。

popupAnchor：与图标锚相关的打开弹出框的点的坐标。

className：图标和阴影图⽚的⾃定义的类名。默认为空。

1. 1. ivIcon

⽤div要素⽽⾮图⽚来轻量级地显⽰注记的图标。

默认情况下，阴影会有⼀个⼩的⽩⾊的⽅形作为leaflet-div-icon类和样式。

Constructor（函数构造器）

L.DivIcon()：⽤给定的选项实例化图标。

Options（选项）

iconSize：图标的像素⼤⼩。也可以通过CSS设置。

iconAnchor：图标提⽰的坐标（在左上⾓）。图标是对其的，所以这个点是注记的地理位置。如果⼤⼩是指定的则位于中⼼处，也可以在

CSS中设置负边界。

className：⽤于对其图标的⾃定义的类名，默认为leaflet-div-icon。

html：在div要素中⾃定义的HTML代码，默认为空。

L.Control

所有leaflet控制的基础类。继承⾃IControl接⼝。

Constructor（函数构造器）

L.Control()：通过给定的选项创建⼀个控制。

Options（选项）

position：控制初始的位置（在地图的某⼀⾓）。参见control positions。

Methods（⽅法）

setPosition()：设置控制的位置。参见control positions。

getPosition0()：返回控制的当前位置。

addTo()：将控制添加到地图上。

removeFrom()：将控制从地图上移除。Control Positions（控制的位置）

topleft：地图的左上⾓。

topright：地图的右上⾓。

bottomleft：地图的左下⾓。

bottomright：地图的右下⾓。

L.Control.Zoom

拥有两个按钮（放⼤和缩⼩）的级别的缩放控制。默认地图上是有的，除⾮设置zoomControl选项为false。

Constructor（函数构造器）

L.Control.Zoom()：创建缩放控制。

Options（选项）

position：控制的位置（在地图的某⼀⾓）。参见control positions。

L.Control.Attribution

可以在地图上⼀个⼩的⽂本盒⼦中显⽰属性数据的属性控制。默认地图上是有的，除⾮设置attributionControl选项为false，并且它⾃动地         通过getAttribution⽅法获取图层的属性⽂本。继承⾃Control。

Constructor（函数构造器）

L.Control.Attribution()：创建属性控制。

Options（选项）

position：控制的位置（在地图的某⼀⾓）。参见control positions。

prefix：在属性之前显⽰的HTML⽂本。传递false来使其不显⽰。

Methods（⽅法）

setPrefix()：在属性之前设置⽂本。

addAttribution()：添加属性⽂本。

removeAttribution()：移除属性⽂本。

L.Control.Layers

图层控制使⽤户可以在不同的底图之间切换，并可以控制覆盖物的开关。继承⾃Control。Constructor（函数构造器）

L.Control.Layers()：通过给定的图层创建数据控制。基础图层通过单选项进⾏切换，覆盖物通过复选框切换显⽰。

Methods（⽅法）

addBaseLayer()：通过给定的控制名称添加基础层（通过单选按钮实体）。

addOverlay()：凸显给定的控制名称添加覆盖物（通过复选框实体）。

removeLayer()： 将 图 层 从 控 制 中 移 除 。                   Options（ 选 项 ）                                                                  position：控制的位置（在地图的某⼀⾓）。参见control positions。

collapsed：如果为true，控制可以收缩为⼀个图标，在⿏标置于上⽅或点触时展开。

autoZIndex：如果为true，控制的图层升序地叠置对齐，在切换图层打开或关闭时，顺便不变。

Events（事件）

baselayerchange：当基层层通过控制更改时触发。L.Control.Scale

显⽰在⼗进制或公制的屏幕当前中⼼的⽐例的简单⽐例尺控制。继承⾃IControl接⼝。

Constructor（函数构造器）

L.Control.Scale()：通过选项创建⽐例控制。

Options（选项）

position： 控 制 的 位 置 （ 在 地 图 的 某 ⼀ ⾓ ） 。 参 见 control         positions 。maxWidth：控制最⼤的像素宽度。宽度可以围绕⼏个值动态设置。                                       metric： 是 否 显 ⽰ ⼗ 进 制 ⽐ 例 线 。                                                                                    imperial： 是 否 显 ⽰ 公 制 ⽐ 例 线 。                                                                      updateWhenIdle：如果设置为true，控制由moveend更新，否则它总是最新的（由move更新）。Events methods

⼀系列事件驱动的类（⽐如map）之间共享的⽅法。通常，事件允许你在⼀个对象发⽣某些事情时执⾏⼀些函数。

leaflet通过引⽤来处理事件监听器，所以如果你想咬添加或移除⼀个监听器时，可以⽤函数的⽅法。

Methods（⽅法）

addEventListener(类型,函数,内容)：向某⼀类型的事件中添加监听器函数。你可以选择性地指定监听器的内容（对象中this关键字会被使

⽤）。你也可以传递⼏个空格间隔的类型（如"click dbclick"）。

addEventListener(发⽣事件的地图,内容)：添加⼀系列的类型/监听器对，如{click:Onclick,mousenove:onMouseMove}

removeEventListener(类型,函数,内容)：移除之前添加的监听器函数。如果没有指定具体的函数，则所以的都会被移除。

removeEventListener(发⽣事件的地图,内容)：移除⼀系列类型/监听器对。

hasEventListener()：如果某⼀事件类型有附属的监听器则返回true。

fireEvent()：触发指定类型的事件。你可以提供⼀个数据对象——监听器对象的第⼀个参数应该包含它的属性。

on()：addEventListener的别称。

off()：removeEventListener的别称。

fire()：fireEvent()的别称。

Event objects

当⼀些事件触发时接受监听器函数参数的事件对象，它包含了事件⼀些有⽤的信息。

Events（事件）

type：事件的类型。

target：触发事件的对象。

MouseEvent（⿏标事件）

latlng：⿏标事件发⽣的地理点。

layerPoint：⿏标事件发⽣的与地图图层相关的点的像素坐标。

containerPoint：⿏标事件发⽣的与地图容器相关的点的像素坐标。

originalEvent：由浏览器触发的原始的DOM⿏标事件。

LocationEvent（位置事件）

latlng：监测到的⽤户的地理位置。

bounds：⽤户坐落的区域的地理边界（考虑位置精度问题）。

accuracy：⽶为单位的位置的精度。

ErrorEvent（错误事件）

message：错误信息。

code：错误代码（若可⽤）。

LayerEvent（图层事件）

layer：添加或移除的图层。

TileEvent（切⽚事件）

tile：切⽚要素（图⽚）。

url：切⽚的url资源。

GeoJSON event（GeoJSON事件）

layer：将要添加到地图上的GeoJSON要素的图层。

properties：要素的GeoJSON的属性。

geometryType：要素的GeoJSON的⼏何类型。

id：要素的GeoJSON的ID（如果出现）。Popup event（弹出框事件）

popup：打开或关闭的弹出框。

L.Class

L.Class强化了leaflet的⾯向对象的设备并被⽤于创建⼏乎所哟这⾥提到的leaflet类。

除了执⾏⼀个简单的类接⼝模型，它还引⼊了⽅便代码组织的⼀下特殊的属性——options，includes和statics。

Inheritance（继承）

可以⽤L.Class.extend来定义新的类，但可以在任何⼀个类上⽤同样的⽅法来继承它。

这会创建⼀个继承⽗类所有⽅法和属性的类（由规范所约束），添加或重构你⽤来扩展的类。这也对instanceof做出反应。       你可以通过⽗类的规范和javascript的call与apply来调⽤⽗类的⽅法来响应⼦类的⽅法（就像你在其他语⾔中调⽤超类）。

Options（选项）

options是⼀个与其他对象不同的特殊的属性，其他你⽤来扩展的对象会被⽗类合并⽽⾮完全重构，这使管理对象的结构和默认值更加⽅       便。

选项中还有L.Util.setOptions⽅法，可以⽅便地合并传递给函数构造器的选项和类中默认的定义。

Includes（包含）

includes是⼀个特殊的类，它将所有对象合并到⼀个类中。⼀个较好的例⼦是L.Mixin.Event，它是具有on、off和fire这些鱼事件相关的⽅法的类。

Statics（静态）

statics是⼀种⽅便的属性，将类中指定对象的属性变为静态属性，对于定义常量⽐较有⽤。Class Factories（类⼯⼚）

你可以⽤个两种⽅式来创建leaflet的实例——⽤new关键字和⽤⼩写的factory⽅法。Constructor Hooks（构造函数钩⼦）

如果你是⼀个插件开发者，你通常需要在现有的类中加⼊附件的初始化代码（⽐如因L.Polyline⽽编辑钩⼦）。leaflet可以⽤addInitHook

⽅法来简化它。

L.Browser

leaflet内部监测浏览器或要素的带有属性的命名空间。

ie：如果是IE浏览器则返回true。

ie6：如果是IE6浏览器则返回true。

ie7：如果是IE7浏览器则返回true。

webkit：如果是类似chrome和safari的基于webkit的浏览器（包括移动版）则返回true。

webkit3d：如果基于webkit的浏览器⽀持CSS的3D转换则返回true。

android：如果是安卓移动版的浏览器则返回true。

android23：如果是安卓2或3的股票浏览器则返回true。

mobile：如果是流⾏的移动版的浏览器（包括iOS下的safari和其他各种安卓浏览器）则返回true。

mobileWebkit：如果是移动版的基于webkit的浏览器则返回true。

mobileOpera：如果是移动版的opera浏览器则返回true。

touch：对于所有触摸设备上的浏览器返回true。

msTouch：对于微软的触摸模式的浏览器（⽐如IE10）返回true。

retina：如果是视⽹膜屏幕的设备则返回true。

L.Util

在leaflet内部使⽤的多种实⽤的函数。

Methods（⽅法）

extend()：将src对象（或多个对象）的属性合并到dest对象中并将其返回。具有⼀个L.extend的快捷⽅式。

bind()：返回由给定范围的obj执⾏fn函数的函数（所以关键字this可以表⽰函数代码⾥的obj）。具有⼀个L.bind快捷⽅式。

stamp()：在对象上应⽤⼀个主键并返回这个键。具有L.stamp快捷⽅式。

limitExecByInterval()：返回调⽤尽量快的但不会⽐间隔时间还要频繁的fn函数的包装器（对于拖动地图时检验和请求信的切⽚⽐较有

⽤），可以通过context选择函数调⽤的范围。

falseFn()：返回总是返回false的函数。

formatNum()：返回digits位数的num的数⽬。

splitWords()：根据空格和空⽩来截取分割字符串并返回数组。

setOptions()：将所给的属性合并到obj的options中，返回最终的选项。参加Class options。具有L.setOptions 快捷⽅式。

getParamString()：将对象转换为带有参数的URL字符串，⽐如{a:“foo”,b:“bar”}转换为’?a=foo&b=bar’。

template()：是⼀个简单的模板，⽤通过将{a:‘foo’,b:‘bar’,…}形式的data对象应⽤到’Hello{a},{b}‘形式的模板字符串来创建字符串——在上述⽰例中可以得到’Hello foo,bar’。

isArray()：如果对象为数组则返回true。

Properties（属性）

emptyImageUrl：包含64位编码的空的GIF图像的数据URL字符串。在webkit驱动的移动设备的上，⽤来作为清空没⽤图像的存储的钩

⼦。

L.Transformation

表⽰仿射变换：⽤⼀系列a、b、c、d的系数来将（x，y）形式转换为（ax+b，cy+d）的形式并进⾏反转。在leaflet的投影代码中可以⽤         得到。

Constructor（函数构造器）

L.Transformation()：通过给定的系数创建转换对象。

Methods（⽅法）

transform()：返回转换后的点，可以选择扩⼤⼀定的倍数。只接受真实的L.Point实例，⽽不是数组。

untransform()：返回反转变换后的点，可以选择搜索⼀定倍数。只接受真实的L.Point实例，⽽不是数组。

L.LineUtil

⼀些处理线段点的应⽤函数，在leaflet内部⽤来使线段显⽰更快。

Methods（⽅法）

simplify()：       在保持形状的同时动态地减少线上点的数⽬并返回简化后点的数组。在每⼀缩放级别处理和显⽰leaflet线段时可以⼤幅提升效率并可以减少视觉噪声。 tolerance影像简化的量（较⼩的值意味着更⾼的质量，但效率会地因为有更多的点）。这也是微型类库

Simplify.js中的⼀部分。

pointToSegmentDistance()：返回点p到p1和p2组成的线段之间的距离。

closesPointOnSegment()：返回p1和p2线段上与p点最接近的点。

clipSegment()：⽤矩形边界裁剪点a到点b之间的折线段（直接修改折线段上的点）。在leaflet中⽤来显⽰屏幕内或边缘的线段上的点，可         以因此⽽提⾼效率。

L.PolyUtil

多边形⼏何体的⼀些应⽤函数。

Methods（⽅法）

clipPolygon()：通过矩形边界来裁剪给定点定义的多边形⼏何体。在leaflet中⽤来显⽰屏幕内或边缘的线段上的多边形上的点，可以因此

⽽提⾼效率。多边形点需要不同的算法来裁剪折线段，因此这个⽅法也有不同的分⽀。

L.DomEvent

在leaflet内部⽤来处理DOM事件的应⽤函数。

Methods（⽅法）

addListener()：向指定类型的DOM事件元素添加监听器fn。监听器中的this关键字指向context，或是在没有说明的情况下指向要素。

removeListener()：在元素中移除事件监听器。

stopPropagation()：停⽌事件向⽗元素传播。

preventDefault()：阻⽌事件默认的动作发⽣（⽐如追踪元素href中的链接，或是当form提交时页⾯重载的POST请求）。

stop()：在同⼀时刻发起stopPropagation和preventDefault。

disableClickPropagation()：将stopPropagation添加到元素的’click’,‘doubleclick’,'mousedown’和’touchstart’事件中。

getMousePosition()：如果没有特意说明则获取与容器或整个页⾯相关的DOM事件的标准的⿏标位置。

getWheelDelta()：从mousewheel的DOM事件中获取标准的滚轮区域。

L.DomUtil

在leaflet内部⽤来处理DOM树的应⽤函数。

Methods（⽅法）

get()：如果传递字符串则返回⼀个带有指定id的元素，或是只是返回这个元素。

getStyle()：返回元素中特定样式属性的值，包括计算后的值和CSS中设置的值。

getViewprotOffset()：返回请求元素视图的偏移量。

create()：通过tagName创建元素，设置className并选择性地将其附加到container元素中。

disableTextSelection()：使⽂本不能被选择，⽐如拖动的时候。

enableTextSelection()：使⽂本选择重新可⽤。

hasClass()：如果元素类属性包含name则返回true。

addClass()：将name添加到元素类的属性中。

removeClass()：在元素类属性中移除name。

setOpacity()：设置元素的透明度（包括⽼的IE也⽀持）。值应当处于0到1之间。

testProp()：检索样式名称的数组并返回第⼀个元素可⽤样式的名称。如果没有找到，那么返回false。

getTranslateString()：返回CSS转换字符串来通过给定点提供的偏移量来移动元素。

getScaleString()：返回CSS转换字符串来缩放元素（通过给定的⽐例原点）。

setPosition()：⽤CSS转换或屏幕左上⾓位置设置给定点的坐标系下的元素位置（leaflet内在地定位图层）。如果disable3D设置为true那么强制为左上⾓位置。

getPosition()：返回之前⽤setPosition定位的元素的坐标。

Properties（属性）

TRANSITION：带前缀的转换样式名称（如’webkitTransition’⽤来表⽰WebKit）。

TRANSFORM：带前缀的变换样式名称。

L.PosAnimation

在内部⽤来平移动画镜头，利⽤CSS3转换在现代浏览器中实现，在IE6到9中⽤时间降速的功能实现。

Constructor（函数构造器）

L.PosAnimation()：创建动画对象。

Methods（⽅法）

run()：在新的位置运⾏指定元素，可以选择性地设置持续的秒数（默认是0.25秒）和线性效果（通过cubic bezier curve的第三个参数， 默认是0.5）。

Events（事件）

start：当动画开始时触发。

step：在动画过程中持续触发。

end：动画结束时触发。

L.Draggable

使DOM元素可以拖动的类。在内部被⽤来拖动地图和注记。

Constructor（函数构造器）

L.Draggable()：创建可拖动对象，这样在你开始移动dragHandle元素时就可以移动给定元素了（默认同元素⾃⾝是同⼀个）。

Events（事件）

dragstart：拖动开始时触发。

predrag：在拖动过程中相应元素位置更新之前持续触发。

drag：拖动过程中持续触发。

dragend：拖动结束后触发。

Methods（⽅法）

enable()：使拖动功能可⽤。

disable()：使拖动功能不可⽤。

IHandler

继承⾃interaction handlers接⼝。

enable()：使处理程序可⽤。

disable()：使处理程序不可⽤。

enabled()：如果处理程序可⽤则返回true。

ILayer

显⽰地图上附属于某⼀位置（或⼀系列位置）的对象。被tile layers，markers，popups，image，overlays，vector layers和layer

groups所继承。

Methods（⽅法）

onAdd()：需要包含创建覆盖物的DOM元素的代码，将他们加⼊到所属的map panes中并在相关地图时间中放⼊监听器。调⽤

map.addLayer(map)。

onRemove()：包含从DOM移除覆盖物元素和移除之前onAdd⽅法添加的监听器的所有的清除代码。调⽤map.removeLayer(layer)。Implementing Custom Layers（实例化⾃定义图层）

何时实例化⾃定义图层最重要的是地图的viewset事件和latLngToLayerPoint⽅法。viewset在地图需要重新定位图层时（⽐如缩放时）触发，latLngToLayerPoint在获取图层新的位置时使⽤。

在实例化图层时还有⼀个经常⽤到的事件是moveend，在地图移动之后触发（⽐如平移和缩放等）。

还        有⼀个需要注意的事情是你需要经常向你在图层中创建的DOM元素中添加leaflet-zoom-hide类，它会在缩放动画中隐藏。实例化⾃定义图层的       缩放动画师⼀个复杂的话题，在以后的章节中会讲到，但你可以在leaflet的图层代码（⽐如ImageOverlay）中看⼀下它是如何⼯作的。

IControl

在地图的某个⾓上显⽰UI元素。被zoom，attribution，scale和layers controls所继承。

Methods（⽅法）

onAdd()：包含所有⽤于在相关地图事件上控制、添加监听器的创建必要DOM要素的代码，并返回包含控制的元素。调⽤

map.addControl(control)或control.addTo(map)。

onRemove()：包含所有清除代码（⽐如0移除控制事件监听器）。调⽤map.removeControl(control)或control.removeFrom(map)。 控制的DOM容器⾃动移除。

IProjection

具有将地理坐标投影到平⾯（和后⽅）的⽅法的对象。参加Map projection。

Methods（⽅法）

project()：将地理坐标投影为⼆维点。

unproject()：将⼆维的点反投影为地理位置。Defined Projections（定义的投影）

L.Projection.SphericalMercator：球⾯墨卡托投影——⽹上地图最常⽤的投影，⼏乎所有的免费和商业的切⽚提供者都会使⽤。假设地球是⼀个规则球体。被EPSG:3857坐标参考系统使⽤。

L.Projection.Mercator：椭圆墨卡托投影——⽐球⾯墨卡托投影更为复杂，这个投影考虑到地球是椭球⽽⾮规则球体。在EPSG:3395坐标参考系统中使⽤。

L.Projection.LonLat：正交矩形或圆柱投影——最简单的投影，⼏乎只被GIS专家使⽤。将地图的x⽅向作为经度，y⽅向作为纬度。对于平⾯的世界也适⽤，⽐如游戏地图。在EPSG:3395和Simple坐标参考系统中使⽤。

ICRS

为将地理点投影到像素坐标或屏幕坐标和反向投影（投影到⽤于WMS服务的其他单位的坐标）⽽定义坐标参考系统。参加Spatial reference system。

Methods（⽅法）

latLngToPoint()：将给定缩放级别的地理坐标投影为像素坐标。

pointToLatLng()：是latLngToPoint的反转。将给定缩放级别的像素坐标投影为地理坐标。

project()：将地理坐标投影为CRS可接受单位的坐标（⽐如EPSG:3857中的⽶，传递给WMS服务）。

scale()：返回转换投影坐标为特定级别的像素坐标所⽤到的缩放级别。⽐如，在基于墨卡托投影的CRS中返回256*2^zoom。

Properties（属性）

projection：CRS使⽤的投影。

transformation：CRS使⽤的⽤来将投影坐标转换为特定切⽚服务的屏幕坐标的转换⽅式。

code：向WMS服务传递的标准CRS的标准代码名称（⽐如’EPSG:3857’）。Defined CRS（定义的坐标参考系统）

L.CRS.EPSG3857：在线地图最常⽤的CRS，⼏乎所有的免费喝商业切⽚服务都会使⽤。使⽤球⾯墨卡托投影。是地图的crs选项的开始 默认值。

L.CRS.EPSG4326：在GIS专家中常见的CRS。使⽤简单的圆柱投影。

L.CRS.EPSG3395：较少地被商业切⽚服务使⽤。使⽤椭圆墨卡托投影。

L.CR.Simple：直接将经纬和纬度映射为x和y的简单的CRS。可能会在平⾯地图中⽤到（⽐如游戏地图）。y轴始终是反向的（由下⽽上）。

如果你想⽤其他此处未列出的不常⽤的CRS，请查询Proj4Leaflet插件。

Global Switches

⽤来在少数情况并且基本都是即使某个特别的浏览器要素存在，也使leaflet不监测的全局设置开关。需要在leaflet包含于页⾯之前将全局变        量开关设置为true。

L_PREFER_CANVAS：对于⽮量图层，强制leaflet在后台使⽤画布⽽⾮SVG。这在某些情况下可以适当提⾼性能（⽐如在地图上有成千上万的圆注记时）。

L_NO_TOUCH：即使监测到触摸事件，也强制leaflet不去使⽤触摸事件。

L_DISABLE_3D：即使可⽤，也强制leaflet在定位时不使⽤硬件加速来进⾏CSS 3D变换（在少数情况下会发⽣偶然故障）。

L.noConflict()

这个⽅法⽤来将L全局变量恢复到leaflet包含的初始值，并返回leaflet真实的命名空间，所以你可以将它放到任何地⽅。

L.version

显⽰当前使⽤的leaflet版本的常量。