高德未支持工具封装

安装

npm install amap-toolkit

使用

import AMapToolkit from "amap-toolkit";

const mapIns = new AMap.Map("container");

const polygonRangingIns = new AMapToolkit.PolygonRanging(mapIns);

// 或者直接使用部分功能
import { PolygonRanging } from "amap-toolkit";

const mapIns = new AMap.Map("container");

const polygonRangingIns = new PolygonRanging(mapIns);

polygonRangingIns.open(); // .start() 也可以

本地运行

git clone https://github.com/MeetTheBest/amap-toolkit.git

cd amap-toolkit

npm install

npm run dev

# node 版本需要大于 v16.19.1
# 已安装 nvm 情况下，根目录下执行 nvm use 切换 node 版本

通用 API

参数	说明	类型
start	启用相应能力	instance.start(arg?)
stop	停止相应能力	instance.stop()
destroy	销毁相应能力	instance.destroy()

多边形类工具

多边形测距 PolygonRanging

示例

import { PolygonRanging } from "amap-toolkit";

const mapIns = new AMap.Map("container");

const polygonRangingIns = new PolygonRanging(mapIns);

const polygon = new AMap.Polygon({});

// 开启测距
polygonRangingIns.start(polygon);

// 适当时机销毁测距（如组件的 destroy 生命周期）
polygonRangingIns.destroy();

多边形绘制时测距 PolygonRangingInDrawing

示例

import { PolygonRangingInDrawing } from "amap-toolkit";

const mapIns = new AMap.Map("container");

const polygonRangingIns = new PolygonRangingInDrawing(mapIns);

const mouseTool = new AMap.MouseTool({});

mouseTool.on("draw", () => {
    // 绘制完成后，需要停止
    polygonRangingIns.stop();
});

// 开始绘制多边形
mouseTool.polygon();

// 开启测距
polygonRangingIns.start();

// 适当时机销毁测距（如组件的 destroy 生命周期）
polygonRangingIns.destroy();

多边形编辑器测距 PolygonEditorRanging

示例

import { PolygonEditorRanging } from "amap-toolkit";

const mapIns = new AMap.Map("container");

const polygon = new AMap.Polygon({});

const editor = new AMap.PolygonEditor(mapIns, polygon);

const polygonEditorRangingIns = new PolygonEditorRanging(mapIns);

// 开启测距
polygonEditorRangingIns.start(editor);

// 适当时机停止测距
polygonEditorRangingIns.stop();

// 适当时机销毁测距（如组件的 destroy 生命周期）
polygonEditorRangingIns.destroy();

PolygonEditorEvent 多边形编辑器操作点事件

为什么要做这个？因为高德的 PolygonEditor 的 adjust 事件，只支持在操作点位结束后响应，并且响应的内容是当前编辑的多边形。

示例

import { PolygonEditorEvent } from "amap-toolkit";

const mapIns = new AMap.Map("container");

const polygon = new AMap.Polygon({});

const editor = new AMap.PolygonEditor(mapIns, polygon);
editor.open();

const polygonEditorEventIns = new PolygonEditorEvent(editor);

polygonEditorEventIns.on("mousedown", (target) => {
    console.log("当前鼠标按下点位", target);
});

polygonEditorEventIns.on("mousemove", (target) => {
    console.log("当前移动点位", target);
});

polygonEditorEventIns.on("mouseup", (target) => {
    console.log("当前鼠标松开点位", target);
});

// 适当时机销毁测距（如组件的 destroy 生命周期）
polygonEditorEventIns.clearAll();

API

参数	说明	类型
on	监听指定事件	on(eventName: mousedown | mousemove | mouseup, callback: (target: AMap.CircleMarker) => void)
off	移除指定事件	off(eventName: mousedown | mousemove | mouseup, callback: (target: AMap.CircleMarker) => void)
once	监听指定事件行为，触发一次后自动移除	once(eventName: mousedown | mousemove | mouseup, callback: (target: AMap.CircleMarker) => void)
clearAll	移除指定事件监听，eventName 不传则移除全部	clearAll(eventName?: mousedown | mousemove | mouseup)

类矩形

为什么要做这个？因为高德的 Rectangle 是通过2点（西南点和东北点）创建矩形，所以无法创建出非水平方向的矩形，且不支持旋转功能；

示例

import { LikeRectangle } from "amap-toolkit";

const mapIns = new AMap.Map("container");

const likeRectangleOptions = {
    map: mapIns,
    center: [116.400274, 39.905812] as [number, number],
    width: 200,
    height: 50,
    draggable: true,
    cursor: "pointer",
    fillOpacity: 0.3,
    strokeOpacity: 0.8,
    rotatable: true,
    bubble: true, // 事件穿透
};

// 使用 ts 时，地图会校验没有 LikeRectangle 类型
polygon = new LikeRectangle(likeRectangleOptions)! as unknown as AMap.Polygon;

mapIns.add([polygon]);

API

参数	说明	类型
path	矩形的 4 个点经纬度	[LngLat, LngLat, LngLat, LngLat]
center	中心点（宽+高+中心点创建必传）	LngLat
width	宽度（使用中心点创建必传）	number
height	高度（使用中心点创建必传）	number

类矩形编辑

示例

import { LikeRectangle, LikeRectangleEditor } from "amap-toolkit";

const mapIns = new AMap.Map("container");

const likeRectangleOptions = {
    map: mapIns,
    center: [116.400274, 39.905812] as [number, number],
    width: 200,
    height: 50,
    draggable: true,
    cursor: "pointer",
    fillOpacity: 0.3,
    strokeOpacity: 0.8,
    rotatable: true,
    bubble: true, // 事件穿透
};

// 使用 ts 时，地图会校验没有 LikeRectangle 类型
polygon = new LikeRectangle(likeRectangleOptions)! as unknown as AMap.Polygon;

mapIns.add([polygon]);

likeRectangleEditorIns = new LikeRectangleEditor(
    mapIns!,
    likeRectangleIns as LikeRectangle,
    options, // options 配置如下
);
likeRectangleEditorIns.open();

options API

参数	说明	类型
onChange	编辑器变化事件	(type: string, data: any) => void;
isMobile	是否为移动端（默认false）	boolean