leaflet-Map Methods—map方法

leaflet-Map Methods—map方法

方法返回描述
getRenderer(<Pathlayer)Renderer返回应该用于渲染给定路径的渲染器实例。它将确保地图和路径的渲染器选项受到尊重,并且渲染器确实存在于地图上。

Methods for Layers and Controls

图层和控件的方法

Method 方法 Returns 返回 Description 描述
addControl(<Controlcontrol)this将给定控件添加到地图
removeControl(<Controlcontrol)this从地图中删除给定的控件
addLayer(<Layerlayer)this将给定图层添加到地图
removeLayer(<Layerlayer)this从地图中删除给定的图层。
hasLayer(<Layerlayer)Boolean如果给定图层当前已添加到地图,则返回 true
eachLayer(<Function> fn, <Object> context?)this迭代地图的图层,可选择指定迭代器函数的上下文.map.eachLayer(function(layer){ layer.bindPopup('Hello'); });
openPopup(<Popuppopup)this在关闭先前打开的窗口的同时打开指定的弹出窗口(以确保一次只打开一个以方便使用)。
openPopup(<String|HTMLElement> content, <LatLnglatlng, <Popup optionsoptions?)this使用指定的内容和选项创建一个弹出窗口,并在地图上的给定点打开它。
closePopup(<Popuppopup?)this关闭之前使用 openPopup(或给定的)打开的弹出窗口。
openTooltip(<Tooltiptooltip)this打开指定的工具提示。
openTooltip(<String|HTMLElement> content, <LatLnglatlng, <Tooltip optionsoptions?)this创建具有指定内容和选项的工具提示并将其打开。
closeTooltip(<Tooltiptooltip)this关闭作为参数给出的工具提示。

Methods for modifying map state

修改地图状态的方法

Method方法Returns返回Description描述
setView(<LatLngcenter, <Number> zoom, <Zoom/pan optionsoptions?)this使用给定的动画选项设置地图的视图(地理中心和缩放)。
setZoom(<Number> zoom, <Zoom/pan optionsoptions?)this设置地图的缩放。
zoomIn(<Number> delta?, <Zoom optionsoptions?)this将地图的缩放比例增加 delta(默认为 zoomDelta)。
zoomOut(<Number> delta?, <Zoom optionsoptions?)this将地图的缩放比例减小 delta(默认为 zoomDelta)。
setZoomAround(<LatLnglatlng, <Number> zoom, <Zoom optionsoptions)this缩放地图,同时保持地图上指定的地理点静止(例如,在内部用于滚动缩放和双击缩放)。
setZoomAround(<Pointoffset, <Number> zoom, <Zoom optionsoptions)this缩放地图,同时保持地图上的指定像素(相对于左上角)静止。
fitBounds(<LatLngBoundsbounds, <fitBounds optionsoptions?)this设置一个地图视图,该视图包含给定的地理范围,并具有可能的最大缩放级别。
fitWorld(<fitBounds optionsoptions?)this设置一个地图视图,该视图主要包含整个世界,并具有可能的最大缩放级别。
panTo(<LatLnglatlng, <Pan optionsoptions?)this将地图平移到给定的中心。
panBy(<Pointoffset, <Pan optionsoptions?)this将地图平移给定数量的像素(动画)。
flyTo(<LatLnglatlng, <Number> zoom?, <Zoom/pan optionsoptions?)this设置执行平滑平移缩放动画的地图视图(地理中心和缩放)。
flyToBounds(<LatLngBoundsbounds, <fitBounds optionsoptions?)this使用像 flyTo 这样的平滑动画设置地图的视图,但需要像 fitBounds 这样的边界参数。
setMaxBounds(<LatLngBoundsbounds)this将地图视图限制在给定的范围内(请参阅 maxBounds 选项)。
setMinZoom(<Number> zoom)this设置可用缩放级别的下限(请参阅 minZoom 选项)。
setMaxZoom(<Number> zoom)this设置可用缩放级别的上限(请参阅 maxZoom 选项)。
panInsideBounds(<LatLngBoundsbounds, <Pan optionsoptions?)this将地图平移到位于给定边界内的最近视图(如果还没有),使用特定选项控制动画(如果有)。
panInside(<LatLnglatlng, <padding optionsoptions?)this将地图平移到最小量以使 latlng 可见。使用填充选项使显示适应更受限制的范围。如果 latlng 已经在(可选填充的)显示范围内,则不会平移地图。
invalidateSize(<Zoom/pan optionsoptions)this检查地图容器大小是否发生变化并更新地图 – 在您动态更改地图大小后调用它,默认情况下也会为平移设置动画。如果 options.pan 为 false,则不会发生平移。如果 options.debounceMoveend 为 true,它会延迟 moveend 事件,这样即使连续多次调用该方法也不会经常发生。
invalidateSize(<Boolean> animate)this检查地图容器大小是否发生变化并更新地图 – 在您动态更改地图大小后调用它,默认情况下也会为平移设置动画。
stop()this停止当前正在运行的 panTo 或 flyTo 动画(如果有)。

Geolocation methods

地理定位方法

Method方法Returns返回Description描述
locate(<Locate optionsoptions?)this尝试使用 Geolocation API 定位用户,触发 locationfound 事件,成功时使用位置数据,失败时触发 locationerror 事件,并可选择将地图视图设置为相对于检测精度的用户位置(如果地理定位失败,则设置为世界视图)。请注意,如果您的页面不使用 HTTPS,则此方法将在现代浏览器(Chrome 50 和更高版本)中失败,请参阅定位选项了解更多详细信息。
stopLocate()this如果使用 {setView: true} 调用了 map.locate,则停止查看之前由 map.locate({watch: true}) 启动的位置并中止重置地图视图。

Other Methods

Method方法Returns返回Description描述
addHandler(<String> name, <Function> HandlerClass)thisAdds a new Handler to the map, given its name and constructor function.
remove()this销毁地图并清除所有相关的事件侦听器。
createPane(<String> name, <HTMLElement> container?)HTMLElement如果该名称尚不存在,则使用给定名称创建一个新的地图窗格,然后将其返回。该窗格创建为容器的子级,如果未设置,则创建为主地图窗格的子级。
getPane(<String|HTMLElement> pane)HTMLElement根据名称或 HTML 元素(其标识)返回地图窗格。
getPanes()Object返回一个普通对象,其中包含所有窗格的名称作为键,窗格的名称作为值。
getContainer()HTMLElement返回包含映射的 HTML 元素。
whenReady(<Function> fn, <Object> context?)this当地图使用视图(居中和缩放)和至少一个图层进行初始化时,或者如果地图已初始化,则立即运行给定函数 fn,可以选择传递函数上下文。

Methods for Getting Map State

获取地图状态的方法

Method方法Returns返回Description描述
getCenter()LatLng返回地图视图的地理中心
getZoom()Number返回地图视图的当前缩放级别
getBounds()LatLngBounds返回当前地图视图中可见的地理边界
getMinZoom()Number返回地图的最小缩放级别(如果在地图或任何图层的 minZoom 选项中设置),默认情况下返回 0。
getMaxZoom()Number返回地图的最大缩放级别(如果在地图或任何图层的 maxZoom 选项中设置)。
getBoundsZoom(<LatLngBoundsbounds, <Boolean> inside?, <Pointpadding?)Number返回给定边界适合整个地图视图的最大缩放级别。如果 inside(可选)设置为 true,则该方法将返回地图视图完全适合给定边界的最小缩放级别。
getSize()Point返回地图容器的当前大小(以像素为单位)。
getPixelBounds()Bounds以投影像素坐标返回当前地图视图的边界(有时在图层和叠加实现中很有用)。
getPixelOrigin()Point返回地图图层左上角的投影像素坐标(在自定义图层和叠加实现中很有用)。
getPixelWorldBounds(<Number> zoom?)Bounds返回缩放级别缩放的以像素坐标表示的世界边界。如果省略缩放,则使用地图的当前缩放级别。

Conversion Methods

转换方法

MethodReturnsDescription
getZoomScale(<Number> toZoom, <Number> fromZoom)Number返回要应用于从缩放级别从Zoom到ToZoom的地图过渡的比例因子。在内部用于帮助缩放动画。
getScaleZoom(<Number> scale, <Number> fromZoom)Number返回地图最终的缩放级别(如果地图处于“从Zoom”级别,并且所有内容都按比例因子缩放。与 getZoomScale 相反。
project(<LatLnglatlng, <Number> zoom)Point根据地图的 CRS 投影地理坐标 LatLng,然后根据缩放和 CRS 的变换对其进行缩放。结果是相对于 CRS 原点的像素坐标。
unproject(<Pointpoint, <Number> zoom)LatLng与项目相反。
layerPointToLatLng(<Pointpoint)LatLng给定相对于原点像素的像素坐标,返回相应的地理坐标(对于当前缩放级别)。
latLngToLayerPoint(<LatLnglatlng)Point给定地理坐标,返回相对于原点像素的相应像素坐标。
wrapLatLng(<LatLnglatlng)LatLng返回一个 LatLng,其中 lat 和 lng 已根据地图的 CRS 的 wrapLat 和 wrapLng 属性(如果它们超出 CRS 的边界)进行包装。默认情况下,这意味着经度环绕在日期变更线上,因此其值介于 -180 和 +180 度之间。
wrapLatLngBounds(<LatLngBoundsbounds)LatLngBounds返回与给定 LatLngBounds 大小相同的 LatLngBounds,确保其中心在 CRS 的边界内。默认情况下,这意味着中心经度环绕在日期变更线上,因此其值介于 -180 和 +180 度之间,并且大多数边界与 CRS 的边界重叠。
distance(<LatLnglatlng1, <LatLnglatlng2)Number根据地图的 CRS 返回两个地理坐标之间的距离。默认情况下,此值以米为单位测量距离。
containerPointToLayerPoint(<Pointpoint)Point给定相对于地图容器的像素坐标,返回相对于原点像素的相应像素坐标。
layerPointToContainerPoint(<Pointpoint)Point给定相对于原点像素的像素坐标,返回相对于地图容器的相应像素坐标。
containerPointToLatLng(<Pointpoint)LatLng给定相对于地图容器的像素坐标,返回相应的地理坐标(对于当前缩放级别)。
latLngToContainerPoint(<LatLnglatlng)Point给定地理坐标,返回相对于地图容器的相应像素坐标。
mouseEventToContainerPoint(<MouseEventev)Point给定一个 MouseEvent 对象,返回相对于事件发生的地图容器的像素坐标。
mouseEventToLayerPoint(<MouseEventev)Point给定一个 MouseEvent 对象,返回相对于事件发生的原点像素的像素坐标。
mouseEventToLatLng(<MouseEventev)LatLng给定一个 MouseEvent 对象,返回事件发生的地理坐标。
0 0 投票数
文章评分
订阅评论
提醒
0 评论
最旧
最新 最多投票
内联反馈
查看所有评论
0
希望看到您的想法,请您发表评论x