更新记录

1.3.5（2026-02-03） 下载此版本

优化

1.3.4（2026-02-03） 下载此版本

fix bug

1.3.3（2026-02-03） 下载此版本

增加折线工具-测距

平台兼容性

uni-app(4.86)

uni-app x(4.86)

xwp-tianditu

基本使用方法

<xwp-tianditu ref="map" @loaded="mapLoaded" @mapClick="mapClick" :mapKey="mapKey" :zIndex="0" :mapOptions="mapOptions">

• mapOptions，初始化地图配置
• zIndex web需要，控制ui在地图上层
• mapKey：天地图key
• @loaded 监听地图是否加载完成
• @mapClick 监听地图的点击，返回参数{longitude,latitude}结构
• @markertap 监听标记点点击

// 初始化定位地图。
centerAndZoom(lnglat:LngLat, zoom:number)

// 将地图的中心点变换到指定的地理坐标
panTo(lnglat:LngLat, zoom?:number)

// 将地图在水平位置上移动x像素，垂直位置上移动y像素
planBy(point:Point)

// 将视图缩放到指定的缩放等级，中心点坐标不变。
setZoom(zoom:number)

// 放大一级视图。
zoomIn()

// 缩小一级视图。
zoomOut()

// 通知地图其容器大小已更改。在更改了容器对象的大小后调用此方法，以便地图能够调整自己适合于新的大小。
checkResize()

// 设置地图最小显示级别。
setMinZoom(level:Number)

// 设置地图最大显示级别。
setMaxZoom(level:Number)

// 设置地图的显示范围。
setMaxBounds(options:LngLatBounds|null)

// 根据提供的坐标点数组设置地图视野，调整后的视野会保证包含提供的坐标点。
setViewport(view:Array<LngLat>)

// 是否放缩，默认可放缩
enableZoom(v:boolean)

// 是否可拖拽，默认可拖拽
enableDrag(v:boolean)

// 添加自定义图层
addTileLayer(url:string,options?:TileLayerOptions)

// 叠加其他WMS服务图层
addWMSTileLayer(url:string,options?:WMSTileLayerOptions)

// 移除图层
removeTileLayer(layerId:number)

// 设置地图样式
setStyle(style:string)

// 移除地图样式
removeStyle()

// 设置标记点
setMarkers(v:Array<MarkerOptions>)

// 逆地理编码
geocode_getLocation(lnglat:LngLat,callback:(data:UTSJSONObject)=>void)

// 地理编码
geocode_getPoint(address:string,callback:(data:UTSJSONObject)=>void)

// 根据关键字搜索
search(params:SearchOptions,callback:(data:UTSJSONObject)=>void)

// 根据范围和检索词发起范围检索
searchInBounds(params:SearchInBoundsOptions,callback:(data:UTSJSONObject)=>void)

// 根据中心点、半径与检索词发起周边检索。
searchNearby(params:SearchNearByOptions,callback:(data:UTSJSONObject)=>void)

// 添加缩放控件
addZoomControl(options?:ControlZoomOptions)

// 添加比列尺控件
addScaleControl(options?:ControlScaleOptions)

// 添加鹰眼控件
addOverviewControl(options?:ControlOverviewOptions)

// 添加地图类型控件
addMapTypeControl(options?:ControlMapTypeOptions)

// 添加地图版权控件
addCopyRightControl(options?:ControlBaseOptions,copyRight?:CopyrightOptions)

// 移除控件
removeControl(id:number)

// 获取地图投影类型信息。
getCode(callback:(data:string)=>void)

// 获取地图可视区域，以地理坐标表示。
getBounds(callback:(data:LngLatBounds)=>void)

// 获取地图当前中心点。
getCenter(callback:(data:LngLat)=>void)

// 获取地图视图的大小，以像素表示。
getSize(callback:(data:Point)=>void)

// 获取地图当前缩放级别。
getZoom(callback:(data:number)=>void)

// 获取地图视图的大小，以像素表示。
getDistance(start:LngLat,end:LngLat,callback:(data:number)=>void)

// 根据提供的地理区域或坐标获得最佳的地图视野，返回的对象中包含center和zoom属性，分别表示地图的中心点和级别。
getViewport(view:LngLat[],callback:(data:UTSJSONObject)=>void)

// 设置天地图标记的显隐
setCopyRightShow(show:boolean)

// 清除所有覆盖物
clearOverLays()

// 清除某个覆盖物
removeOverlay(id:number)

// 添加图像标注
addMarker(options:MarkerOptions)

// 添加文字标注
addLabel(options:LabelOptions)

// 添加线
addPolyline(options:PolylineOptions)

// 添加多边形
addPolygon(options:PolygonOptions)

// 添加矩形
addRectangle(options:RectangleOptions)

// 添加圆
addCircle(options:CircleOptions)

// 添加图片覆盖物
addImageOverlay(options:ImageOverlayOptions)

// 添加热力图
addHeatmap(options:HeatmapOptions)

// 显示覆盖物
showOverlay(id:number)

// 隐藏覆盖物
hideOverlay(id:number)

//是否支持canvas 
isSupportCanvas(callback:(data:boolean)=>void)

// 添加聚合点
addMarkerClusterer(options:MarkerClustererOptions)

// 移除聚合点
removeMarkerClusterer(id:number)

// 开启折线工具
openPolylineTool(options:PolylineToolOptions)

// 关闭折线工具
closePolylineTool()

// 清空折线工具绘制的所有线
clearPolylineTool()

// 完成一个折线的绘制，运行此方法相当于用户点击双击(app相当于长按)结束当前折线的绘制。
endDrawPolylineTool()

示例可查看插件中tianditu-example组件