您现在的位置: 开发 > Web服务 API > 开发指南 > API文档 > 抓路服务 >

高德 开发 Web服务 API 开发指南 API文档 抓路服务

更新时间:2018年01月15日

产品介绍

根据坐标点抓取道路,即根据给定的坐标点、车辆的方位角以及行驶速度,抓取就近的道路,抓取的道路条数与上传坐标点的数量无关, 若多个坐标点在一条路上,也仅返回一条路 。

使用API前您需先申请Key,若无高德地图API账号需要先申请账号。

适用场景

用户手中含有多个坐标点,希望能够将该坐标点匹配到道路之上。

使用限制

服务调用量的限制请点击这里查阅。  

使用说明

第一步,申请”web服务 API”密钥(Key);

第二步,拼接HTTP请求URL,第一步申请的Key需作为必填参数一同发送;

第三步,接收HTTP请求返回的数据(JSON或XML格式),解析数据。

如无特殊声明,接口的输入参数和输出数据编码全部统一为UTF-8。

抓路服务

抓路服务API服务地址:

http://restapi.amap.com/v3/autograsp?parameters

parameters代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。

 

  • 请求参数

参数名称

含义

规则说明

是否必填

默认值

key

用户唯一标识

用户在高德地图官网申请

必填

carid

车辆唯一标识

填写key的后四位+企业车辆唯一编号,如“abcd123456”

必填

locations

经纬度

用于抓路的经纬度坐标,要求每次传入按utc时间排列的三个或三个以上经纬度坐标对,

且相邻经纬度gps时间间隔小于300s,距离小于1km。

坐标的经纬度之间用","间隔,坐标对之间用"|"间隔

必填

time

gps时间

gps时间,要求为utc时间,与参数locations指定的坐标点一一对应,gps时间个数与坐标点数量一致

必填

direction

行驶方向

车辆的方位角,与参数locations指定的坐标点一一对应,方位角个数与坐标点数量一致

以正北方向为0度,沿顺时针方向为正值,取值范围[0,360),精确到小数点后一位

必填

speed

行驶速度

车辆行驶速度,与参数locations指定的坐标点一一对应,速度值个数与坐标点数量一致,单位:km/h

必填

  • 返回结果参数说明

抓路服务的响应结果的格式由请求参数output指定。

名称

含义

规则说明

status



返回结果状态值

值为0或1,0表示请求失败;1表示请求成功

count



返回结果数目

返回道路结果数量同输入坐标点个数一致

roads



返回道路信息列表



road


道路信息




crosspoint

交叉点坐标

查询点与匹配道路的正切且最短距离匹配点



roadname

道路名称




ployline

道路经纬度坐标




roadlevel

道路等级

详细等级见下述道路等级分类



maxspeed

道路最高限速




intersection

临近路口




intersectiondistance

距离临近路口距离


  • 道路等级列表

道路等级

道路等级描述

41000

高速公路

42000

国道

43000

主要大街、城市快速路

51000

省道

44000

主要道路

45000

次要道路

52000

乡公路

53000

县乡村内部道路

54000

县乡村内部道路

47000

普通道路

49

非导航道路

  • 服务示例
http://restapi.amap.com/v3/autograsp?carid=abcd123456&locations=116.496167,39.917066|116.496149,39.917205|116.496149,39.917326&time=1434077500,1434077501,1434077510&direction=1,1,2&speed=1,1,2&output=xml&key=<用户key>
参数 备注 必选
carid
locations
time
direction
speed
移动端
示例中心
功能
在线体验
常见问题