5.1 线路优化服务

5.1.1 说明

请求方式:通过POST方式进行接口请求,以JSON格式返回结果。

接口名称:v1/optimize_delivery.php

简要描述:传入一批运货点,服务按最优路线和最短距离输出运货点顺序结果。单次传入的运货点数量限制为15个以内(不含出发地和回程地)。实际业务运货点超出限制数量,或需要自定义优化方式请调用“线路优化请求服务”接口。

错误编码:0,1001,1002,1003,1004,1005,1008,1900,2000

5.1.2 请求参数

参数名称格式描述参与签名必填
start String

出发地,对应返回结果中的“运货点唯一标识”为“start”。

(凯立德xy坐标,格式:x,y

Y Y
locations Json(Array)

运货点信息。JSON数组格式传参,格式如下:

[{"id":"运货点唯一标识","point":"x,y"}]

id为运货点的唯一标识[String];point为凯立德xy坐标[String],格式:x,y

Y Y
end String

回程地,可选参数,对应返回结果中的“运货点唯一标识”为“end”。

(凯立德xy坐标,格式:x,y

Y N
tht Float 货车参数,车高(取值范围0.1~5,单位米),不限制高度时为0。 Y N
twh Float 货车参数,车宽(取值范围0.1~15,单位米),不限制宽度时为0。 Y N
twt Float 货车参数,车重(取值范围0.1~160,单位吨),不限制重量时为0。 Y N
tad Float 货车参数,车轴重(取值范围0.1~60,单位吨),不限制轴重时为0。 Y N
tvt Integer 货车参数,车型,取值:16777216-微型货车; 33554432-轻型货车; 67108864-中型货车; 134217728-重型货车;0-小轿车。 Y N
tlnt Integer 货车参数,车牌类型,取值: 4-蓝牌车; 8-黄牌车。(注:蓝牌车不会避开限行,默认为蓝牌车 Y N
公共输入参数 详见公共请求参数

5.1.3 返回结果

参数名称格式描述
errcode Integer 错误编码(详见错误编码
errmsg String 错误提示
mapver String 系统数据版本号
data fd Object Integer 优化前总距离(按传参运货点顺序计算,单位:米)
ft Integer 优化前总时长(按传参运货点顺序计算,单位:分钟)
ad Integer 优化后总距离(按优化后运货点顺序计算,单位:米)
at Integer 优化后总时长(按优化后运货点顺序计算,单位:分钟)
locations Json(Array) 优化后的运货点信息。JSON数组格式,数组成员的先后顺序即优化路径顺序,格式如下:

[{
"sid":"开始运货点唯一标识",
"eid":"结束运货点唯一标识",
"d":"距离(单位:米)",
"t":"时长(单位:分钟)"
}]

5.2 线路优化请求服务

5.2.1 说明

请求方式:通过POST方式进行接口请求,以JSON格式返回结果。

接口名称:v1/optimize_delivery_req.php

简要描述:【请求计算】传入一批运货点,服务按最优路线+最短距离计算出运货点顺序、预计里程和时长结果。单次传入的运货点数量默认上限为15个(不含出发地和回程地),实际业务超出默认数量可联系我们。此接口作为计算请求调用,获取计算结果调用“线路优化结果服务”接口。taskkey已提交过请求计算则返回错误编码为2000,每分钟内单企业限制为10个优化计算任务。

错误编码:0,1001,1002,1003,1004,1005,1008,1900,2000

5.2.2 请求参数

参数名称格式描述参与签名必填
taskkey String

线路优化编码

(作为线路优化的唯一标识)

Y Y
start String

出发地,对应返回结果中的“运货点唯一标识”为“start”。

(凯立德xy坐标,格式:x,y

Y Y
locations Json(Array)

运货点信息。JSON数组格式传参,格式如下:

[{"id":"运货点唯一标识","point":"x,y","arrive":"start,end"}]

id为运货点的唯一标识[String];point为凯立德xy坐标[String],格式:x,y;arrive为要求送达时间段[String],空字符串值代表不限时间,时间段的开始与结束时间以半角逗号分隔,start,end格式为YYYY-MM-DD HH:mm:ss,例如:2018-06-01 08:10:02)

Y Y
end String

回程地,可选参数,对应返回结果中的“运货点唯一标识”为“end”。

(凯立德xy坐标,格式:x,y

Y N
tht Float 货车参数,车高(取值范围0.1~5,单位米),不限制高度时为0。 Y N
twh Float 货车参数,车宽(取值范围0.1~15,单位米),不限制宽度时为0。 Y N
twt Float 货车参数,车重(取值范围0.1~160,单位吨),不限制重量时为0。 Y N
tad Float 货车参数,车轴重(取值范围0.1~60,单位吨),不限制轴重时为0。 Y N
tvt Integer 货车参数,车型,取值:16777216-微型货车; 33554432-轻型货车; 67108864-中型货车; 134217728-重型货车;0-小轿车。 Y N
tlnt Integer 货车参数,车牌类型,取值: 4-蓝牌车; 8-黄牌车。(注:蓝牌车不会避开限行,默认为蓝牌车 Y N
p Integer 规划方式(取值: 1-系统推荐; 2-高速优先; 8-最短距离; 16-最少收费; 32-步行。 默认为系统推荐) Y N
atj Integer 是否躲避拥堵(取值:1-是; 0-否。默认为不躲避拥堵) Y N
ad String 避免条件参数, 1 表示避免收费,2表示避免渡轮,4表示避免收费站,8表示避免掉头,16表示避免拥堵,多个条件组合用"|"号间隔。默认避免轮渡。 Y N
fd String 回避条件参数,1表示回避高速,2表示回避轮渡,4表示回避收费站,8表示回避掉头,16表示回避高架,32表示回避施工封闭,多个条件组合用"|"号间隔。默认回避施工封闭。 Y N
公共输入参数 详见公共请求参数

5.2.3 返回结果

参数名称格式描述
errcode Integer 错误编码(详见错误编码
errmsg String 错误提示

5.3 线路优化结果服务

5.3.1 说明

请求方式:通过POST方式进行接口请求,以JSON格式返回结果。

接口名称:v1/optimize_delivery_get.php

简要描述:【获取结果】通过‘线路优化编码’获取优化计算结果。此接口作为计算结果获取,计算请求调用“线路优化请求服务”接口。单个taskkey的查询频率限制为每3秒一次。

错误编码:0,1001,1002,1003,1004,1005,1006,1007,1900,2000

5.3.2 请求参数

参数名称格式描述参与签名必填
taskkey String

线路优化编码

(作为线路优化的唯一标识)

Y Y
公共输入参数 详见公共请求参数

5.3.3 返回结果

参数名称格式描述
errcode Integer 错误编码(详见错误编码
errmsg String 错误提示
data fd Object Integer 优化前总距离(按传参运货点顺序计算,单位:米)
ft Integer 优化前总时长(按传参运货点顺序计算,单位:分钟)
ad Integer 优化后总距离(按优化后运货点顺序计算,单位:米)
at Integer 优化后总时长(按优化后运货点顺序计算,单位:分钟)
locations Json(Array) 优化后的运货点信息。JSON数组格式,数组成员的先后顺序即优化路径顺序,格式如下:

[{
"sid":"开始运货点唯一标识",
"eid":"结束运货点唯一标识",
"d":"距离(单位:米)",
"t":"时长(单位:分钟)"
}]

5.4 ETA服务

5.4.1 说明

请求方式:通过POST方式进行接口请求,以JSON格式返回结果。

接口名称:v1/navi_eta.php

简要描述:传入起点和一批经由点,服务按道路网和路况数据,计算需要行驶的里程和时长。(除起、终点外,经由点限制15个点内,实际业务超出限制数量可联系我们)

错误编码:0,1001,1002,1003,1004,1005,1008,1900,2000

5.4.2 请求参数

参数名称格式描述参与签名必填
start String

出发地

(凯立德xy坐标,格式:x,y

Y Y
locations Json(Array)

经由点信息。JSON数组格式传参,格式如下:

[{"time":"停留时长","point":"x,y"}]

time为经过点的预计停留时长[Integer],单位为分钟;point为凯立德xy坐标[String],格式:x,y

Y Y
end String

回程地,可选参数。

(凯立德xy坐标,格式:x,y

Y N
tht Float 货车参数,车高(取值范围0.1~5,单位米),不限制高度时为0。 Y N
twh Float 货车参数,车宽(取值范围0.1~15,单位米),不限制宽度时为0。 Y N
twt Float 货车参数,车重(取值范围0.1~160,单位吨),不限制重量时为0。 Y N
tad Float 货车参数,车轴重(取值范围0.1~60,单位吨),不限制轴重时为0。 Y N
tvt Integer 货车参数,车型,取值:16777216-微型货车; 33554432-轻型货车; 67108864-中型货车; 134217728-重型货车;0-小轿车。 Y N
tlnt Integer 货车参数,车牌类型,取值: 4-蓝牌车; 8-黄牌车。(注:蓝牌车不会避开限行,默认为蓝牌车 Y N
p Integer 规划方式(取值: 1-系统推荐; 2-高速优先; 8-最短距离; 16-最少收费; 32-步行。 默认为系统推荐) Y N
atj Integer 是否躲避拥堵(取值:1-是; 0-否。默认为不躲避拥堵) Y N
ad String 避免条件参数, 1 表示避免收费,2表示避免渡轮,4表示避免收费站,8表示避免掉头,16表示避免拥堵,多个条件组合用"|"号间隔。默认避免轮渡。 Y N
fd String 回避条件参数,1表示回避高速,2表示回避轮渡,4表示回避收费站,8表示回避掉头,16表示回避高架,32表示回避施工封闭,多个条件组合用"|"号间隔。默认回避施工封闭。 Y N
公共输入参数 详见公共请求参数

5.4.3 返回结果

参数名称格式描述
errcode Integer 错误编码(详见错误编码
errmsg String 错误提示
data distance Object Integer 总距离(单位:米)
time Integer 总时长(精确到分钟,单位:分钟)
mtime Float 总时长(精确到毫秒,单位:秒)

5.5 坐标转换

5.5.1 说明

请求方式:通过POST方式进行接口请求,以JSON格式返回结果。

接口名称:v1/location_convert.php

简要描述:用于将常用的非凯立德坐标(目前支持GPS设备获取的坐标、百度地图坐标、google地图坐标、soso地图坐标、amap地图坐标、mapbar地图坐标)转换成凯立德地图中使用的坐标,并可将转化后的坐标在凯立德地图JavaScript API、Android SDK、IOS SDK、web服务API等产品中使用。一次最多100个坐标点。

错误编码:0,1001,1002,1003,1004,1005,1008,1900,2000

5.5.2 请求参数

参数名称格式描述参与签名必填
type Integer

转换类型。目前支持的转换类型包括:

31为GPS设备获取的坐标转换为凯立德K码

32为GPS设备获取的坐标转换为凯立德xy坐标

41为google地图、soso地图、aliyun地图、mapabc地图和amap地图所用坐标,及国测局坐标转换为凯立德K码

42为google地图、soso地图、aliyun地图、mapabc地图和amap地图所用坐标,及国测局坐标转换为凯立德xy坐标

51为百度地图坐标转换为凯立德K码

52为百度地图坐标转换为凯立德xy坐标

15为凯立德K码转换为百度地图坐标

25为凯立德xy坐标转换为百度地图坐标

Y Y
locations String

源坐标。

格式:经度,纬度;经度,纬度…

限制:最多支持100个

格式举例:114.22,24.77;114.4561,22.9584

Y Y
公共输入参数 详见公共请求参数

5.5.3 返回结果

参数名称格式描述
errcode Integer 错误编码(详见错误编码
errmsg String 错误提示
datas loc Array String 源坐标
res String 转换后坐标
 
版权所有 ©马蹄圈,并保留所有权利。
粤ICP备16121480号