开发 地图小程序OPENAPI 开发指南 地图内容 地图路线

地图路线 最后更新时间: 2024年04月02日

1、路线创建

请求地址:

URL

https://restwia.amap.com/api/v1/wia/map/line/create?parameters

请求方式

POST

ContenType

application/json

url 请求参数

参数名

参数类型

含义

规则

示例值

是否必填

key

String

高德Key

用户在高德地图官网申请Web服务API类型Key

必填

bizToken

String

工作地图身份token

用户申请的工作地图身份token,一个企业一个token

必填

openId

String

当前操作人

高德用户的开放id

必填

sig

String

数字签名

请参考数字签名获取和使用方法

选填

bizSign

String

业务签名

签名参数openId,bizToken参考签名规则

必填

body请求参数

参数名

参数类型

含义

规则

示例值

是否必填

workMapId

String

工作地图id

P3AOnftSzq7bdMTxw057Sg

必填

title

String

路线标题

测试路线

必填

distance

Number

距离

1000

非必填

etaTime

Number

1111

非必填

pointInfoList

Array

途径点集合

[{"alias":"天通东苑一区14号楼","desc":"","imageList":[],"iconColorValue":"#7E97FF,#4265FF","sortOrder":1,"pointInfo":{"match_code":1,"cname":"北京市","poiid":"B000A9NUXQ","source_app":"MicroMessager","adcode":"110114","name":"天通东苑一区14号楼","dname":"昌平区","type":0,"version":"1","third_party_keywords":"天通苑东-一区14号楼","third_party":"微信","business_area":"东小口","data_source":"third_party","source_app_name":"微信","address":"来自微信的地点","lon":116.435903,"lat":40.06824,"x":221038630.49048936,"y":101557612.50828627,"cityCode":110000,"entranceList":[{"lon":116.435715,"lat":40.068197,"x":221038490.307529,"y":101557654.40560976}]},"pointId":"POINTID_1702001259218","poiName":"天通东苑一区14号楼","approvalStatus":1,"clientPointId":"TRACKPOI_1702001259218","match_code":1,"cname":"北京市","poiid":"B000A9NUXQ","source_app":"MicroMessager","adcode":"110114","name":"天通东苑一区14号楼","dname":"昌平区","type":0,"version":"1","third_party_keywords":"天通苑东-一区14号楼","third_party":"微信","business_area":"东小口","data_source":"third_party","source_app_name":"微信","address":"来自微信的地点","lon":116.435903,"lat":40.06824,"x":221038630.49048936,"y":101557612.50828627,"cityCode":110000,"entranceList":[{"lon":116.435715,"lat":40.068197,"x":221038490.307529,"y":101557654.40560976}],"distance":null,"etaTime":null},{"alias":"龙湖蓝海引擎产业园","imageList":[],"iconColorValue":"#7E97FF,#4265FF","sortOrder":2,"pointInfo":{"poiType":1,"parentID":"","isCoachPath":false,"childType":"","lon":116.43789857625963,"pathSourceType":0,"industry":"","poiid":"B0HB3D8CF0","new_type":"120201","isTrainPath":false,"name":"龙湖蓝海引擎产业园","parent":"","pathDataType":0,"adcode":"","phoneNumbers":"","x":221040118,"end_poi_extension":"29","y":101597255,"towards_angle":"","cityCode":"110000","lat":40.02754152541325,"isPlanePath":false,"entranceList":[{"y":101596073,"lat":40.02875534724493,"x":221040112,"lon":116.4378905296326}],"cp_id":"","f_nona":"","cityName":"北京市","address":"红军营东路6号"},"pointId":"POINTID_1702001268736","poiName":"龙湖蓝海引擎产业园","approvalStatus":1,"clientPointId":"TRACKPOI_1702001268736","poiType":1,"parentID":"","isCoachPath":false,"childType":"","lon":116.43789857625963,"pathSourceType":0,"industry":"","poiid":"B0HB3D8CF0","new_type":"120201","isTrainPath":false,"name":"龙湖蓝海引擎产业园","parent":"","pathDataType":0,"adcode":"","phoneNumbers":"","x":221040118,"end_poi_extension":"29","y":101597255,"towards_angle":"","cityCode":"110000","lat":40.02754152541325,"isPlanePath":false,"entranceList":[{"y":101596073,"lat":40.02875534724493,"x":221040112,"lon":116.4378905296326}],"cp_id":"","f_nona":"","cityName":"北京市","address":"红军营东路6号","distance":5914,"etaTime":1200}]

必填

planRoute

Boolean

true

必填

routePlanSnapshotStr

String

行点集合

非必填

createUserId

String

非必填

createUserNickName

String

非必填

navigationType

Number

导航方式

DRIVE(1, "驾车") 

0

必填

iconColorValue

String

颜色

颜色值十六进制,点之间用用逗号隔开,默认值蓝色

#FF6968,#F74746

非必填

iconColorId

String

自定义颜色id

使用自定义颜色必须同时携带iconColorId和iconColorValue

非必填

workItemEntityList

Array

任务指派信息集合

[{"workItemStatus":1,"assignedUserId":123,"assignedUserNickName":123,"assignedUserAvtar":123,"workItemId":123,"workTaskId":123,"workMissionId":123,"resourceId":123123},{"workItemStatus":1,"assignedUserId":123,"assignedUserNickName":123,"assignedUserAvtar":123,"workItemId":123,"workTaskId":123,"workMissionId":123,"resourceId":123123}]

非必填

categoryId

String

分组id

非必填

sceneType

Number

场景类型

0:默认场景

1:常用地图内置资源场景

非必填

principalIdListJsonString

String

负责人列表json数组

非必填

dimensionId

String

地图功能id(资源来源区分)

非必填

customFieldValueInfo

Array

自定义字段集合

jsonArray的字符串

[{"itemId":"123","itemType":1,"valueList":[{"value":"123","id":"123","remarkValue":"123123131"},{"value":"123","id":"123","remarkValue":"123123131"}]},{"itemId":"123","itemType":1,"valueList":[{"value":"123","id":"123","remarkValue":"123123131"},{"value":"123","id":"123","remarkValue":"123123131"}]}]

非必填

入参实例

{
    "workMapId": "B70bByvTOEPY0effRRsMuA",
    "title": "路线规划-阳阳",
    "pointInfoList": [
        {
            "alias":"浏阳市淳口镇长丰商店",
            "pointInfo": {
                "address": "湖南省长沙市浏阳市淳口镇鸭头村楼古集镇",
                "lon": "113.5042160000613",
                "name": "浏阳市淳口镇长丰商店",
                "lat": "28.357623000019746"
            }
        },
        {
            "alias":"浏阳市淳口镇蕾蕾商店",
            "pointInfo": {
                "address": "湖南省长沙市浏阳市淳口镇鸭头村金盆组318号",
                "lon": "113.50536575002431",
                "name": "浏阳市淳口镇蕾蕾商店",
                "lat": "28.359188500029557"
            }
        },
        {
            "alias":"浏阳市淳口镇胖哥商店",
            "pointInfo": {
                "address": "湖南省长沙市浏阳市淳口镇鸭头村新园组40号",
                "lon": "113.50136333336512",
                "name": "浏阳市淳口镇胖哥商店",
                "lat": "28.365254333357832"
            }
        },
        {
            "alias":"浏阳市淳口镇熊家商店",
            "pointInfo": {
                "address": "湖南省长沙市浏阳市淳口镇鸭头村代新组30号",
                "lon": "113.50141000004889",
                "name": "浏阳市淳口镇熊家商店",
                "lat": "28.365203666694605"
            }
        },
        {
            "alias":"浏阳市淳口镇鸭头村友友商店",
            "pointInfo": {
                "address": "湖南省长沙市浏阳市淳口镇鸭头村杉山组",
                "lon": "113.50135933335014",
                "name": "浏阳市淳口镇鸭头村友友商店",
                "lat": "28.365211333350036"
            }
        },
        {
            "alias":"浏阳市淳口镇利民商店",
            "pointInfo": {
                "address": "湖南省长沙市浏阳市淳口镇鸭头村培上组53号",
                "lon": "113.48869166665028",
                "name": "浏阳市淳口镇利民商店",
                "lat": "28.364809333344816"
            }
        },
        {
            "alias":"浏阳市淳口镇真好商店",
            "pointInfo": {
                "address": "湖南省长沙市浏阳市淳口镇鸭头村楼古集镇",
                "lon": "113.48183933333078",
                "name": "浏阳市淳口镇真好商店",
                "lat": "28.36485133333542"
            }
        },
        {
            "alias":"浏阳市淳口镇周周商店",
            "pointInfo": {
                "address": "湖南省长沙市浏阳市淳口镇鸭头村永清组",
                "lon": "113.48877699999574",
                "name": "浏阳市淳口镇周周商店",
                "lat": "28.36485533334698"
            }
        },
        {
            "alias":"浏阳市淳口镇大路商店",
            "pointInfo": {
                "address": "湖南省长沙市浏阳市淳口镇鸭头村肖家组",
                "lon": "113.49237774999565",
                "name": "浏阳市淳口镇大路商店",
                "lat": "28.365811500008274"
            }
        },
        {
             "alias":"罗刚—湖南省浏阳市",
            "pointInfo": {
                "address": "湖南省长沙市浏阳市淳口镇鸭头村省埠片",
                "lon": "113.49576524999868",
                "name": "罗刚—湖南省浏阳市",
                "lat": "28.364602000000392"
            }
        },
        {
            "alias":"浏阳市淳口镇长兴商店",
            "pointInfo": {
                "address": "湖南省长沙市浏阳市淳口镇鸭头村培元片",
                "lon": "113.49378333337403",
                "name": "浏阳市淳口镇长兴商店",
                "lat": "28.371749666690363"
            }
        },
        {
            "alias":"浏阳市淳口镇卫秀商店",
            "pointInfo": {
                "address": "湖南省长沙市浏阳市淳口镇鸭头村",
                "lon": "113.49371700000268",
                "name": "浏阳市淳口镇卫秀商店",
                "lat": "28.371795666667484"
            }
        },
        {
            "alias":"浏阳市淳口镇清支商店",
            "pointInfo": {
                "address": "湖南省长沙市浏阳市淳口镇鸭头村向荣组",
                "lon": "113.49317933337858",
                "name": "浏阳市淳口镇清支商店",
                "lat": "28.372481000009657"
            }
        },
        {
            "alias":"浏阳市龙伏镇卫记商店",
            "pointInfo": {
                "address": "湖南省长沙市浏阳市龙伏镇坪上村",
                "lon": "113.49319000000023",
                "name": "浏阳市龙伏镇卫记商店",
                "lat": "28.372436000000235"
            }
        },
        {
            "alias":"浏阳市龙伏镇晟旺商店",
            "pointInfo": {
                "address": "湖南省长沙市浏阳市龙伏镇焦桥村江边组",
                "lon": "113.4914703333364",
                "name": "浏阳市龙伏镇晟旺商店",
                "lat": "28.384381000003916"
            }
        }
    ],
    "planRoute": true,
    "navigationType": 1,
    "iconColorValue": "#7E97FF,#4265FF"
}

返回参数

响应结果的格式为 JSON 形式,以下是参数说明

参数名

含义

参数类型

规则说明

data

返回结果数据

Object

workMapId

工作地图id

String

resourceId

路线id

String

code

返回结果状态值

Number

message

返回状态说明

String

成功时返回Successful,否则返回错误原因

result

结果

Boolean

true或false

version

版本信息

String

timestamp

时间戳

Number

requestId

请求id

String

返回示例

{
    "data": {
        "workMapId": "P3AOnftSzq7bdMTxw057Sg",
        "resourceId": "2003003712473160"
    },
    "code": 1,
    "message": "Successful",
    "result": true,
    "version": "1.0",
    "timestamp": 1702451349548,
    "requestId": "1eb5d13017024513445691002d1aec"
}

2、路线修改

请求地址:

URL

https://restwia.amap.com/api/v1/wia/map/line/update?parameters

请求方式

POST

ContenType

application/json

url 请求参数

参数名

参数类型

含义

规则

示例值

是否必填

key

String

高德Key

用户在高德地图官网申请Web服务API类型Key

必填

bizToken

String

工作地图身份token

用户申请的工作地图身份token,一个企业一个token

必填

openId

String

当前操作人

高德用户的开放id

必填

sig

String

数字签名

请参考数字签名获取和使用方法

选填

bizSign

String

业务签名

签名参数openId,bizToken参考签名规则

必填

body请求参数

参数名

参数类型

含义

规则

示例值

是否必填

workMapId

String

工作地图id

P3AOnftSzq7bdMTxw057Sg

必填

resourceId

String

路线资源Id

测试路线

必填

title

String

路线标题

1000

必填

distance

Number

距离

1111

非必填

etaTime

Number

subPointListStr

String

routePlanSnapshotStr

String

planRoute

Boolean

pointInfoList

Array

[{"alias":"天通东苑一区14号楼","desc":"","imageList":[],"iconColorValue":"#7E97FF,#4265FF","sortOrder":1,"pointInfo":{"match_code":1,"cname":"北京市","poiid":"B000A9NUXQ","source_app":"MicroMessager","adcode":"110114","name":"天通东苑一区14号楼","dname":"昌平区","type":0,"version":"1","third_party_keywords":"天通苑东-一区14号楼","third_party":"微信","business_area":"东小口","data_source":"third_party","source_app_name":"微信","address":"来自微信的地点","lon":116.435903,"lat":40.06824,"x":221038630.49048936,"y":101557612.50828627,"cityCode":110000,"entranceList":[{"lon":116.435715,"lat":40.068197,"x":221038490.307529,"y":101557654.40560976}]},"pointId":"POINTID_1702001259218","poiName":"天通东苑一区14号楼","approvalStatus":1,"clientPointId":"TRACKPOI_1702001259218","match_code":1,"cname":"北京市","poiid":"B000A9NUXQ","source_app":"MicroMessager","adcode":"110114","name":"天通东苑一区14号楼","dname":"昌平区","type":0,"version":"1","third_party_keywords":"天通苑东-一区14号楼","third_party":"微信","business_area":"东小口","data_source":"third_party","source_app_name":"微信","address":"来自微信的地点","lon":116.435903,"lat":40.06824,"x":221038630.49048936,"y":101557612.50828627,"cityCode":110000,"entranceList":[{"lon":116.435715,"lat":40.068197,"x":221038490.307529,"y":101557654.40560976}],"distance":null,"etaTime":null},{"alias":"龙湖蓝海引擎产业园","imageList":[],"iconColorValue":"#7E97FF,#4265FF","sortOrder":2,"pointInfo":{"poiType":1,"parentID":"","isCoachPath":false,"childType":"","lon":116.43789857625963,"pathSourceType":0,"industry":"","poiid":"B0HB3D8CF0","new_type":"120201","isTrainPath":false,"name":"龙湖蓝海引擎产业园","parent":"","pathDataType":0,"adcode":"","phoneNumbers":"","x":221040118,"end_poi_extension":"29","y":101597255,"towards_angle":"","cityCode":"110000","lat":40.02754152541325,"isPlanePath":false,"entranceList":[{"y":101596073,"lat":40.02875534724493,"x":221040112,"lon":116.4378905296326}],"cp_id":"","f_nona":"","cityName":"北京市","address":"红军营东路6号"},"pointId":"POINTID_1702001268736","poiName":"龙湖蓝海引擎产业园","approvalStatus":1,"clientPointId":"TRACKPOI_1702001268736","poiType":1,"parentID":"","isCoachPath":false,"childType":"","lon":116.43789857625963,"pathSourceType":0,"industry":"","poiid":"B0HB3D8CF0","new_type":"120201","isTrainPath":false,"name":"龙湖蓝海引擎产业园","parent":"","pathDataType":0,"adcode":"","phoneNumbers":"","x":221040118,"end_poi_extension":"29","y":101597255,"towards_angle":"","cityCode":"110000","lat":40.02754152541325,"isPlanePath":false,"entranceList":[{"y":101596073,"lat":40.02875534724493,"x":221040112,"lon":116.4378905296326}],"cp_id":"","f_nona":"","cityName":"北京市","address":"红军营东路6号","distance":5914,"etaTime":1200}]

非必填

createUserId

String

创建人openid

非必填

createUserNickName

String

创建人昵称

非必填

navigationType

Number

导航方式

DRIVE(1, "驾车")

必填

iconColorValue

String

颜色

十六进制颜色

必填

iconColorId

String

自定义颜色id

使用自定义颜色必须同时携带iconColorId和iconColorValue

非必填

workItemEntityList

Array

指派信息集合

[{"workItemStatus":1,"assignedUserId":123,"assignedUserNickName":123,"assignedUserAvtar":123,"workItemId":123,"workTaskId":123,"workMissionId":123,"resourceId":123123},{"workItemStatus":1,"assignedUserId":123,"assignedUserNickName":123,"assignedUserAvtar":123,"workItemId":123,"workTaskId":123,"workMissionId":123,"resourceId":123123}]

非必填

categoryId

String

分组id

0:默认场景

1:常用地图内置资源场景

非必填

principalIdListJsonString

String

负责人列表json数组

非必填

dimensionId

String

地图功能id(资源来源区分)

非必填

customFieldValueInfoList

Array

自定义字段集合

[{"itemId":"123","itemType":1,"valueList":[{"value":"123","id":"123","remarkValue":"123123131"},{"value":"123","id":"123","remarkValue":"123123131"}]},{"itemId":"123","itemType":1,"valueList":[{"value":"123","id":"123","remarkValue":"123123131"},{"value":"123","id":"123","remarkValue":"123123131"}]}]

非必填

workTaskRuleRecordId

String

任务规则记录id

customFieldEditFlag

Boolean

自定义字段编辑标识

返回参数

响应结果的格式为 JSON 形式,以下是参数说明

参数名

含义

参数类型

规则说明

data

返回结果数据

Object

code

返回结果状态值

Number

message

返回状态说明

String

成功时返回Successful,否则返回错误原因

result

结果

Boolean

true或false

version

版本信息

String

timestamp

时间戳

Number

requestId

请求id

String

返回示例

{
    "data": tue,
    "code": 1,
    "message": "Successful",
    "result": true,
    "version": "1.0",
    "timestamp": 1701142286019,
    "requestId": "1eb5d12017011422856761177d14ca"
}

3、路线删除

请求地址:

URL

https://restwia.amap.com/api/v1/wia/map/line/delete?parameters

请求方式

POST

ContenType

application/json

url 请求参数

参数名

参数类型

含义

规则

示例值

是否必填

key

String

高德Key

用户在高德地图官网申请Web服务API类型Key

必填

bizToken

String

工作地图身份token

用户申请的工作地图身份token,一个企业一个token

必填

openId

String

当前操作人

高德用户的开放id

必填

sig

String

数字签名

请参考数字签名获取和使用方法

选填

bizSign

String

业务签名

签名参数openId,bizToken参考签名规则

必填

body请求参数

参数名

参数类型

含义

规则

示例值

是否必填

workMapId

String

工作地图id

P3AOnftSzq7bdMTxw057Sg

必填

resourceId

String

路线id

返回参数

响应结果的格式为 JSON 形式,以下是参数说明

参数名

含义

参数类型

规则说明

data

返回结果数据

Boolean

成功返回true

code

返回结果状态值

Number

message

返回状态说明

String

成功时返回Successful,否则返回错误原因

result

结果

Boolean

version

版本信息

String

timestamp

时间戳

Number

requestId

请求id

String

返回示例

{
    "data": true,
    "code": 1,
    "message": "Successful",
    "result": true,
    "version": "1.0",
    "timestamp": 1708511483526,
    "requestId": "1eb5d11517085114640361002d38a4"
}

返回顶部 示例中心 常见问题 智能客服 公众号
二维码