# cpRPA

**Repository Path**: linux19920212/cpRPA

## Basic Information

- **Project Name**: cpRPA
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-11-07
- **Last Updated**: 2024-11-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# cpRPA
植保无人机凸多边形地块工作路线规划  
> ![航线规划](https://upload-images.jianshu.io/upload_images/2812131-8c4999d889a4d4ab.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

## 快速使用
1. 通过普通script标签引入，也支持cmd amd引入
2. 根据所使用的地图类型不同，需要在使用前传入当前地图框架的一些计算方法：  
```javascript
/**@method 设置距离计算方法
 * @param {Function} 传入计算的函数
 * @param {Object} p1 该函数接收的第一个点，格式为{lat,lng} lat为纬度，lng为经度
 * @param {Object} p2 同上，第二个点
 */
cpRPA.setDistanceFn(function(p1,p2){
    /**以百度地图为例子，百度地图获取两经纬度点距离的方法：*/
    return new BMap.Map().getDistance(new BMap.Point(p1.lng, p1.lat), new BMap.Point(p2.lng, p2.lat));

    /** 
    * 高德地图获取两经纬度点距离的方法：
    return new AMap.LngLat(p1.lng, p1.lat).distance(new AMap.LngLat(p2.lng, p2.lat));

    * leaflet框架获取两经纬度点距离的方法
    return L.latLng(p1.lat, p1.lng).distanceTo(L.latLng(p2.lat, p2.lng))
    */
});

/**@method 设置经纬度转换成页面像素坐标的方法*/
cpRPA.setLatlng2PxFn(function(latlng){
    /**百度，map为 new BMap.Map() 对象*/
    return map.pointToPixel(new BMap.Point(latlng.lng, latlng.lat))

    /**
    * 高德，map为 new AMap.Map() 对象
    * return map.lngLatToContainer(new AMap.LngLat(latlng.lng, latlng.lat))
    *
    * leaflet map 为 L.map对象
    * return map.latLngToLayerPoint(L.latLng(latlng.lat, latlng.lng)) 
    */
});

/**@method 设置像素坐标转换成经纬度点的方法*/
cpRPA.setPx2LatlngFn(function(px){
     /**百度，map为 new BMap.Map() 对象*/
    return map.pixelToPoint(new BMap.Pixel(px[0], px[1]))

    /**
    * 高德，map为 new AMap.Map() 对象
    * return map.containerToLngLat(new AMap.Pixel(px[0], px[1]))
    * 
    * leaflet map 为 L.map对象
    *  return map.layerPointToLatLng(L.point(px[0], px[1]))
    */
});
```
3. 执行`.setOptions`方法，获得计算完的点集  
```javascript
var polylineLatlngs=cpRPA.setOptions({
    polygon:[/*凸多边形顶点点集*/],
    rotate:0,
    space: 5
});
console.log(polylineLatlngs)
```

---
## 方法：
* `setDistanceFn`   
设置距离计算方法
，接收一个函数"`function(p1,p2){return /**具体地图类型的距离计算方法*/}`"，必须在第一个`.setOptions`方法前设置。  
该传参函数的参数`p1,p2`为形如`{lat,lng}`的经纬度对象

* `setLatlng2PxFn`  
设置经纬度转地图像素坐标的方法，
接收一个函数"`function(latlng){return /**具体地图类型的转换方法*/}`"，必须在第一个`.setOptions`方法前设置。  
该传参函数的参数`latlng`为形如`{lat,lng}`的经纬度对象

* `setPx2LatlngFn`
设置地图像素转地图像素坐标的方法，
接收一个函数"`function(px){return /**具体地图类型的转换方法*/}`"，必须在第一个`.setOptions`方法前设置。  
该传参函数的参数`px`为形如`[x,y]`的像素坐标数组

* `setOptions`  
设置输入参数，返回航线点集
    <table>
        <tr>
            <th>参数</th><th>类型</th><th>说明</th>
        </tr>
        <tr>
            <td>polygon</td>
            <td>Array</td>
            <td>凸多边形的顶点集</td>
        </tr>
        <tr>
            <td>rotate</td>
            <td>Number</td>
            <td>航线围绕地块中心点的旋转角度，顺时针为+，逆时针为-</td>
        </tr>
        <tr>
            <td>space</td>
            <td>Number</td>
            <td>无人机飞行相邻两条航线距离的一半。比如说，无人机翼展为5米，则两条航线之间的合理距离为10米，则space的值为5</td>
        </tr>
    </table>

* `getPolygonArea` 获取地块的初略面积，传入多边形地块的顶点经纬度数组，返回数值型面积值，这个面积值不是一个精确值。  
   * 参数： `latlngs.<Array>`
   * 返回： `{Number}` 
* `getPolylineArea` 获取航线扫过的面积
   * 参数： `(latlngs.<Array>,space.<Number>)`
   * 返回：`{Number}` 

## demo
* [百度地图demo](https://char-ten.github.io/cpRPA/test/index.baidu.html)
* [高德地图demo](https://char-ten.github.io/cpRPA/test/index.lbs.html)
* [leaflet地图demo](https://char-ten.github.io/cpRPA/test/index.leaflet.html)