车辆路径问题(vrp) - kqgis server v8.5

请求参数

Path 参数

servicename

string

必需

Body 参数application/json

startPt

string

必需

设置起始点(配送中心)

clientInfos

object

必需

货物配送点和配送重量信息，参考clientInfo参数说明

clientPt

string

必需

设置的停靠点（客户点），即将货物送到哪里

weight

number

可选

货物的重量(单位kg)，默认为10kg

impedanceMode

enum<string>

可选

阻抗模式，支持时间和距离：
1. ImpedanceLen 长度（最短）
2. ImpedanceTime 时间（最快，需要在加载数据的时候指定速度相关参数

枚举值:

ImpedanceLenImpedanceTime

defaultVehicleWeight

integer

可选

设置默认的车辆负重（单位kg)，默认400kg

vehicleInfo

object

可选

车辆运输过程中的车辆数量及对应负重，底层默认有四辆车

number

integer

必需

车辆个数，底层默认有四辆车。

weight

array[number]

可选

车辆的对应负重（单位kg）数组，格式如[200, 300, 400, 200]。如果没有设置，则每辆车使用默认负重（400kg）。

defaultPackageWeight

number

可选

要运输的货物的默认重量，默认为10kg

barrierPt

string

可选

障碍点，可以有多个，以英文分号隔开。

attributeFilterOfImpassableRoad

string

可选

属性过滤条件，设置后面分析中不能通行的道路，简单的sql数据支持：
比如需要限高限宽的时候

avoid

object

可选

规避区域，通用
{
"type": "FeatureCollection",
"features": [{
"type": "Feature",
"properties": {
"name": "规避面1",
"radius":0
},
"geometry": {
"type": "Polygon",
"coordinates": [[[116.256, 32.685, 52.365],[116.256, 32.885, 52.023],[116.556, 32.885, 52.023]]]
}
}, {
"type": "Feature",
"properties": {
"name": "规避面2"
"radius":0
},
"geometry": {
"type": "Polygon",
"coordinates": [[[116.256, 32.685, 52.365],[116.256, 32.885, 52.023],[116.556, 32.885,52.023]]]
}
}]
}

asyn

boolean

可选

是否异步执行分析方法，如果是异步，则直接返回分析任务的ID，后续可通过该分析任务ID，取消分析或查询分析结果。默认为同步执行;默认未false。目前均为同步执行，暂时保留，后续看是否需要设计分析任务管理。

示例

{
    "asyn":false,
    "startPt": "36368261.08958941700000,2954008.61473527500000",
    "defaultVehicleWeight":400.0,
    "impedanceMode":"ImpedanceLen",
    "defaultPackageWeight":10.0,
    "clientInfos":[ 
        {"clientPt":"36369790.15018076400000,2947701.23979597450000", "weight":10},
        {"clientPt":"36377626.58571140500000,2943193.69659440360000", "weight":10}
    ],
    "vehicleInfo":{
        "number": 4,
        "weight": [200,300,400,500]
    }
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/rest/services//networkanalysis/vrp' \
--header 'Content-Type: application/json' \
--data-raw '{
    "asyn":false,
    "startPt": "36368261.08958941700000,2954008.61473527500000",
    "defaultVehicleWeight":400.0,
    "impedanceMode":"ImpedanceLen",
    "defaultPackageWeight":10.0,
    "clientInfos":[ 
        {"clientPt":"36369790.15018076400000,2947701.23979597450000", "weight":10},
        {"clientPt":"36377626.58571140500000,2943193.69659440360000", "weight":10}
    ],
    "vehicleInfo":{
        "number": 4,
        "weight": [200,300,400,500]
    }
}'

返回响应

🟢200成功

application/json

Body

errorstr

string

必需

resultcode

string

必需

results

object

必需

paths

array [object {4}]

必需

示例

{
   "resultcode":"success" or "error",
   "cppErrCode":  111, // error的情况下c++层产生的错误码"
   "message": "结果产生过程中可能发生的错误信息" or "正常的情况下返回的是100开头的字符串",
   "result": {
   "paths": [{
      // 参照paths的输出
   }]
   }
  }

 // 矢量数据的分析输出
 "paths": [{
   "distance": "全长",
   "duration": "行驶总时间（单位：秒）",
   "count": "路段总数",
   "segments": {
     "type": "FeatureCollection",
     "features": [
       {
           "具体见下面features数组中单个元素的导出部分"
       },
       {
           "具体见下面features数组中单个元素的导出部分"
       }
     ]
    }
 }]

  // 栅格数据的分析数据
  "rasterPaths": [{
    "dataSourceName": "tianditu", // 代表结果来源于tianditu
    // "dataSourceName": "栅格数据2", 代表结果来源于栅格数据2
    "distance": "全长",
    "duration": "行驶总时间（单位：秒）",
    "count": "路段总数",
    "segments": {
      "type": "FeatureCollection",
      "features": [
        {
            "具体见下面features数组中单个元素的导出部分"
        },
        {
            "具体见下面features数组中单个元素的导出部分"
        }
      ]
    }
  }],

 // features数组中的单个元素
 {
    "type": "Feature",
    "properties": {
      "name": "xxx路",
      "level":-1, 是加载数据的时候设置的
      "length": 400,
      "maxspeed": 80, 最高限速，
      "duration": 10, 时间 根据length和maxspeed计算而来
      "direction": 参照 KQNetworkNaviDirection
    },
    "reservedfield": { // 对应 m_otherFields
     "field1":"value1", "field2":"value2"
    },
    "geometry": {
      "type": "LineString",
      "coordinates": [
        [
          116.32051706314085,
          39.875690072077596
        ],
        [
          116.31907939910889,
          39.87499843708809
        ]
      ]
    }
  }