主题
MeasureFacade — 量算子门面
通过 app.measure 访问量算功能。
distance(options)
量算距离。
ts
distance(options?: { geodesic?: boolean; unit?: string; onUpdate?: (value: number) => void }): number| 参数 | 类型 | 描述 |
|---|---|---|
| geodesic | boolean | 是否使用大地测量(考虑地球曲率) |
| unit | string | 距离单位(如 'meters'、'kilometers') |
| onUpdate | (value: number) => void | 量算过程中的实时回调 |
返回值:距离值。
ts
const dist = app.measure.distance();
// dist: number (meters)
const distKm = app.measure.distance({ geodesic: true, unit: 'kilometers' });
// 实时更新
app.measure.distance({
onUpdate: (v) => {
document.getElementById('dist').textContent = `${v} m`;
},
});area(options)
量算面积。
ts
area(options?: { unit?: string; onUpdate?: (value: number) => void }): number| 参数 | 类型 | 描述 |
|---|---|---|
| unit | string | 面积单位(如 'sqmeters'、'sqkilometers') |
| onUpdate | (value: number) => void | 量算过程中的实时回调 |
返回值:面积值。
ts
const area = app.measure.area();
// area: number (sqmeters)
const areaKm2 = app.measure.area({ unit: 'sqkilometers' });height(options)
量算高度。
ts
height(options?: { unit?: string }): number| 参数 | 类型 | 描述 |
|---|---|---|
| unit | string | 高度单位(如 'meters') |
返回值:高度值。
ts
const h = app.measure.height();
const hMeters = app.measure.height({ unit: 'meters' });bearing()
量算方位角。
ts
bearing(): number返回值:方位角(度)。
ts
const b = app.measure.bearing();
// b: number (degrees)clear()
清除量算结果。
ts
clear(): voidts
app.measure.clear();