点面关系计算工具类。
模型约束: 此接口仅可在Stage模型下使用。
元服务API: 从版本5.0.0(12)开始,该接口支持在元服务中使用。
系统能力: SystemCapability.Map.Core
起始版本: 5.0.0(12)
static isPointContainedInPolygon(points: Array<mapCommon.LatLng>, point: mapCommon.LatLng): boolean
判断点是否在多边形区域内。
模型约束: 此接口仅可在Stage模型下使用。
元服务API: 从版本5.0.0(12)开始,该接口支持在元服务中使用。
系统能力: SystemCapability.Map.Core
起始版本: 5.0.0(12)
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| points | Array<mapCommon.LatLng> | 是 | 多边形区域坐标。 |
| point | mapCommon.LatLng | 是 | 需要判断的点坐标。 |
返回值:
| 类型 | 说明 |
|---|---|
| boolean | 点是否在多边形区域内。 - true:在区域内 - false:不在区域内 |
错误码:
以下错误码的详细介绍请参见ArkTS API错误码。
| 错误码ID | 错误信息 |
|---|---|
| 401 | Invalid input parameter. |
示例:
let points: Array<mapCommon.LatLng> = [
{
latitude: 31.693478,
longitude: 118.434595
}, {
latitude: 31.693478,
longitude: 118.534595
}, {
latitude: 32.993478,
longitude: 118.734595
}, {
latitude: 32.993478,
longitude: 118.934595
}
];
let point: mapCommon.LatLng = {
latitude: 31.984,
longitude: 118.766
};
let result: boolean = map.SpatialRelationUtil.isPointContainedInPolygon(points, point);