Map Class

addControl

(controlposition)

向地图中添加一个Control控件,

Example:

control.addTo(this);

Parameters:

• control Control

  要添加的Control控件。

• position Position

  控件在地图中的位置。可选值有 'top-right', 'top-left', 'bottom-right', 和 'bottom-left'.

Returns:

resize

()

根据自己的容器调整地图尺寸，当它的容器已经发生了变化之后或者地图通过css从隐藏改变为显示后才能调用该方法，

Returns:

getBounds

()

返回地图的地理边界框。

Returns:

setMaxBounds

(lnglatbounds)

设置或清除地图地理边界框。
平移和缩放将会严格限制在该边界框之内，如果用户进行了平移或缩放操作，地图将会尽量匹配用户操作的结果，但是还是限制在该边界框内。

Parameters:

• lnglatbounds LngLatBoundsLike | null | undefined

  设置地图的最大边界框 如果设定为 null 或者 undefined，地图最大边界框将会被删除。

Returns:

setMinZoom

(minZoom)

设置地图的最小缩放级别 如果当前的缩放级别小于最新设定的最小缩放级别，那么地图将会将当前的缩放级别进行改变并与之匹配。

Parameters:

• minZoom ?number

  最小缩放级别 (0-20). 如果设定为null 或 undefined，地图将会设定最小缩放级别为0。(i.e. sets it to 0).

Returns:

setMaxZoom

(setMaxZoom)

设置地图的最小缩放级别 如果当前的缩放级别大于最新设定的最大缩放级别，那么地图将会将当前的缩放级别进行改变并与之匹配。

Parameters:

• setMaxZoom ?number

  最小缩放级别 (0-20). 如果设定为null 或 undefined，地图将会设定最大缩放级别为20。(i.e. sets it to 20).

Returns:

project

(lnglat)

依据经纬度返回的相对于当前容器坐标点Point

Parameters:

• lnglat LngLatLike

  要转化为屏幕坐标点的经纬度。

Returns:

unproject

(point)

依据屏幕中的坐标点返回经纬度坐标LngLat。

Parameters:

• point PointLike

  像素点坐标。

Returns:

queryRenderedFeatures

(geometryparameters)

返回GeoJSON对象 Feature objects 查询可见的几何数据信息 在鼠标点上查询所有可见地图数据信息

Example:

 var features = map.queryRenderedFeatures(
   [20, 35],
   { layers: ['my-layer-name'] }
 );

用一个给定的边界框查询地图数据信息

 var features = map.queryRenderedFeatures(
   [[10, 20], [30, 50]],
   { layers: ['my-layer-name'] }
 );

通过制定鼠标点为中心定制一个边界框并查询边界框内的地图数据信息

 var width = 10;
 var height = 20;
 var features = map.queryRenderedFeatures([
     [point.x - width / 2, point.y - height / 2],
     [point.x + width / 2, point.y + height / 2]
 ], { layers: ['my-layer-name'] });

查询一个图层内的所有地图数据信息

 var features = map.queryRenderedFeatures({ layers: ['my-layer-name'] });

Parameters:

• geometry PointLike | Array(PointLike)
• parameters Object (optional)

Returns:

querySourceFeatures

(sourceIDparams)

获取数据源的地图数据信息。

Parameters:

• sourceID String

  数据源的id。

• params Object

Returns:

setStyle

(style)

设置地图的样式

Parameters:

• style Object | String

  指向一个可访问的地图样式描述的json文件

Returns:

getStyle

()

返回当前的地图样式。

Returns:

addSource

(idsource)

向地图样式中添加一个数据源。

Parameters:

• id String

  添加一个唯一的字符串id，不能与其它数据源id冲突。

• source Object

Returns:

removeSource

(id)

删除地图样式中的一个数据源

Parameters:

• id String

  数据源id

Returns:

getSource

(id)

返回一个指定的地图样式数据源。

Parameters:

• id String

  数据源id

Returns:

moveLayer

(IdbeforeId)

图层移动层级

调整不同图层的前后位置顺序

Parameters:

• Id String

  要移动的图层Id.

• beforeId String (optional)

  目标图层Id，即移动到该图层之上，如果忽略该参数，要移动的图层将会移动到最上层。

Returns:

addLayer

(layerbefore)

向地图样式中添加一个图层

图层中定义了一个具体数据源的绘制描述。

Parameters:

• layer Object

  图层对象

• before String (optional)

  已经存在图层的id，如果忽略该项，图层将会添加到最末尾。

Returns:

removeLayer

(id)

删除地图样式中的一个图层。

Parameters:

• id String

  要删除的图层id

Returns:

Throws:

getLayer

(id)

返回一个地图样式中的图层

Parameters:

• id String

  图层id。

Returns:

setFilter

(layerfilter)

设置一个具体图层的过滤器。

map.setFilter('my-layer', ['==', 'name', 'USA']);

Example:

Parameters:

• layer String

  图层的id

• filter Array

Returns:

setLayerZoomRange

(layerIdminzoommaxzoom)

设置一个图层的缩放区间如下：

map.setLayerZoomRange('my-layer', 2, 5);

Parameters:

• layerId String

  图层id

• minzoom Number

  最小缩放级别 (0-20).

• maxzoom Number

  最大缩放级别 (0-20).

Returns:

getFilter

(layer)

返回一个图层的过滤器

Parameters:

• layer String

  图层id

Returns:

setPaintProperty

(layernamevalue)

设置图层的绘制样式

Example:

map.setPaintProperty('my-layer', 'fill-color', '#faafee');

Parameters:

• layer String

  图层id

• name String

  绘制样式的名称

• value

  绘制样式的值

Returns:

getPaintProperty

(layername)

返回一个图层的绘制样式值。

Parameters:

• layer String

  图层id

• name String

  图层绘制样式的名称。

Returns:

setLayoutProperty

(layername)

设置图层的一个具体样式值。

Example:

map.setLayoutProperty('my-layer', 'visibility', 'none');

Parameters:

• layer String

  图层id

• name String

  图层布局名称。

Returns:

getLayoutProperty

(layername)

返回一个图层中的具体布局样式值。

Parameters:

• layer String

  图层id

• name String

  图层中布局样式名称。

Returns:

getContainer

()

返回地图的HTML容器。

Returns:

getCanvasContainer

()

返回地图的 <canvas> 元素.

如果用户想添加非opengl的覆盖物，需要添加到该元素上面。

Returns:

getCanvas

()

返回一个<canvas> 元素.

Returns:

loaded

()

返回地图是否完全加载完成的状态。

Returns:

remove

()

清空所有的地图资源，包含web worker和dom元素。

addImage

(nameimageoptions)

向地图的样式中添加icon，该icon可用于 icon-image, background-pattern, fill-pattern line-pattern。

Parameters:

• name String

  图片名称。

• image HTMLImageElement | ArrayBufferView

  图片

• options Object (optional)

  如果image参数为 ArrayBufferView的时候，option为必须值

removeImage

(name)

删除用户添加的sprite图标

Parameters:

• name String

  图标名称

loadImage

(urlcallback)

通过url加载一个外部的图片，用于Map#addImage，对应的地址需要支持跨域

Parameters:

• url String

  图片路径，图片格式一般为png、jpg、webp

• callback Function

  类型为 callback(error, data). 当地图加载完成之后会触发该回调.

map.setCenter([-74, 38]);

将地图旋转60度
map.setBearing(60);

// 采用默认的方式进行飞行。
map.flyTo({center: [0, 0], zoom: 9});
// 采用flyTo选项进行飞行。
map.flyTo({
  center: [0, 0],
  zoom: 9,
  speed: 0.2,
  curve: 1,
  easing: function(t) {
    return t;
  }
});