# Map
# 创建
| 工厂 | 描述 |
|---|---|
L.map(<String> _id_, <Map options> _options?_) | 在给定<div>元素的 DOM ID 和可选的对象字面量的情况下实例化地图对象Map options。 |
L.map(<HTMLElement> _el_, <Map options> _options?_) | 在给定<div>HTML 元素实例和可选的对象字面量的情况下实例化地图对象Map options。 |
# 选项
| 选项 | 类型 | 默认 | 描述 |
|---|---|---|---|
| preferCanvas | Boolean | false | s是否Path (opens new window)应该在渲染器上Canvas (opens new window)渲染。默认情况下，所有Path (opens new window)s 都在渲染器中SVG (opens new window)渲染。 |
# 控制选项
| 选项 | 类型 | 默认 | 描述 |
|---|---|---|---|
| attributionControl | Boolean | true | 默认情况下是否将归因控件 (opens new window)添加到地图中。 |
| zoomControl | Boolean | true | 默认情况下是否将缩放控件 (opens new window)添加到地图中。 |
# 交互选项
| 选项 | 类型 | 默认 | 描述 |
|---|---|---|---|
| closePopupOnClick | Boolean | true | false如果您不想在用户单击地图时关闭弹出窗口，请将其设置为。 |
| zoomSnap | Number | 1 | 强制地图的缩放级别始终是这个的倍数，尤其是在fitBounds()缩放缩放之后。默认情况下，缩放级别捕捉到最接近的整数；较低的值（例如0.5或0.1）允许更大的粒度。值0 表示缩放级别不会在fitBounds或捏缩放之后捕捉。 |
| zoomDelta | Number | 1 | 控制在键盘上按zoomIn() (opens new window) 或使用缩放控件 (opens new window)后地图的缩放级别将更改多少 。小于（例如）的值允许更大的粒度。zoomOut() (opens new window) +- 10.5 |
| trackResize | Boolean | true | 地图是否自动处理浏览器窗口调整大小以更新自身。 |
| boxZoom | Boolean | true | 地图是否可以缩放到按住shift键的同时拖动鼠标指定的矩形区域。 |
| doubleClickZoom | Boolean|String | true | 地图是否可以双击放大和按住shift键双击缩小。如果通过'center'，无论鼠标在哪里，双击缩放都会缩放到视图的中心。 |
| dragging | Boolean | true | 地图是否可以用鼠标/触摸拖动。 |
# 地图状态选项
| 选项 | 类型 | 默认 | 描述 |
|---|---|---|---|
| crs | CRS | L.CRS.EPSG3857 | 要使用的坐标参考系。如果您不确定它的含义，请不要更改它。 |
| center | LatLng | undefined | 地图的初始地理中心 |
| zoom | Number | undefined | 初始地图缩放级别 |
| minZoom | Number | * | 地图的最小缩放级别。如果未指定且地图中至少有一个GridLayer或，则将使用TileLayer其minZoom选项中最低的一个。 |
| maxZoom | Number | * | 地图的最大缩放级别。如果未指定且地图中至少有一个GridLayer或，则将使用其选项TileLayer中的最高值。maxZoom |
| layers | Layer[] | [] | 最初将添加到地图的图层数组 |
| maxBounds | LatLngBounds | null | 设置此选项后，地图会将视图限制在给定的地理范围内，如果用户试图在视图之外平移，则将用户弹回。要动态设置限制，请使用 setMaxBounds方法。 |
| renderer | Renderer | * | 在地图上绘制矢量图层的默认方法。L.SVG 或L.Canvas默认情况下取决于浏览器支持。 |
# 动画选项
| 选项 | 类型 | 默认 | 描述 |
|---|---|---|---|
| zoomAnimation | Boolean | true | 地图缩放动画是否开启。默认情况下，它在所有支持 CSS3 过渡的浏览器中启用，除了 Android。 |
| zoomAnimationThreshold | Number | 4 | 如果缩放差异超过此值，则不会为缩放设置动画。 |
| fadeAnimation | Boolean | true | 是否启用平铺淡入淡出动画。默认情况下，它在所有支持CSS3 过渡的浏览器中启用，除了 Android。 |
| markerZoomAnimation | Boolean | true | 标记是否使用缩放动画对其缩放进行动画处理，如果禁用，它们将在动画长度内消失。默认情况下，它在所有支持 CSS3 过渡的浏览器中启用，除了 Android。 |
| transform3DLimit | Number | 2^23 | 定义 CSS 转换变换的最大尺寸。默认值不应更改，除非 Web 浏览器在执行大型panBy. |
# 平移惯性选项
| 选项 | 类型 | 默认 | 描述 |
|---|---|---|---|
| inertia | Boolean | * | 如果启用，地图的平移将产生惯性效应，其中地图在拖动时会产生动量并继续沿同一方向移动一段时间。在触摸设备上感觉特别好。默认启用。 |
| inertiaDeceleration | Number | 3000 | 惯性运动减速的速率，以像素/秒²为单位。 |
| inertiaMaxSpeed | Number | Infinity | 惯性运动的最大速度，以像素/秒为单位。 |
| easeLinearity | Number | 0.2 | |
| worldCopyJump | Boolean | false | 启用此选项后，当您平移到世界的另一个“副本”时，地图会跟踪并无缝跳转到原始副本，以便标记和矢量图层等所有叠加层仍然可见。 |
| maxBoundsViscosity | Number | 0.0 | 如果maxBounds设置，此选项将控制拖动地图时边界的实心程度。默认值0.0允许用户以正常速度拖出边界，较高的值会减慢地图拖出边界的速度，1.0并使边界完全实心，防止用户拖出边界。 |
# 键盘导航选项
| 选项 | 类型 | 默认 | 描述 |
|---|---|---|---|
| keyboard | Boolean | true | 使地图具有焦点并允许用户使用键盘箭头和+/-键导航地图。 |
| keyboardPanDelta | Number | 80 | 按下箭头键时要平移的像素量。 |
# 鼠标滚轮选项
| 选项 | 类型 | 默认 | 描述 |
|---|---|---|---|
| scrollWheelZoom | Boolean|String | true | 是否可以使用鼠标滚轮缩放地图。如果通过'center'，无论鼠标在哪里，它都会缩放到视图的中心。 |
| wheelDebounceTime | Number | 40 | 限制轮子可以发射的速率（以毫秒为单位）。默认情况下，用户每 40 毫秒不能多次通过滚轮进行缩放。 |
| wheelPxPerZoomLevel | Number | 60 | 多少滚动像素（由L.DomEvent.getWheelDelta (opens new window)报告）意味着一个完整缩放级别的变化。较小的值将使滚轮缩放更快（反之亦然）。 |
# 触控交互选项
| 选项 | 类型 | 默认 | 描述 |
|---|---|---|---|
| tapHold | Boolean | 启用事件模拟contextmenu，默认true用于移动 Safari。 | |
| tapTolerance | Number | 15 | 用户在触摸期间可以移动手指的最大像素数，以使其被视为有效点击。 |
| touchZoom | Boolean|String | * | 是否可以用两根手指触摸拖动来缩放地图。如果通过'center'，无论触摸事件（手指）在哪里，它都会缩放到视图的中心。为具有触摸功能的 Web 浏览器启用。 |
| bounceAtZoomLimits | Boolean | true | 如果您不希望地图缩放到最小/最大缩放范围之外，然后在捏缩放时反弹回来，请将其设置为 false。 |