浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。
服务介绍
服务文档
使用指南
更新日志
道路信息查询服务
道路信息查询服务(又名Roadinfo API)是一类Web API接口服务,开发者可利用该服务坐标对应道路以及道路前方的信息,包括:道路名称、道路等级、道路限速、前方路口信息等。可应用于驾驶场景下为司机提供超速、前方路口提醒等安全预警,提升行车安全。

注:道路信息查询API是高级付费服务,需申请权限后开通试用或正式使用。
产品优势
1. 支持传入10个以内的轨迹序列,轨迹点绑路准确性高

2. 准确的道路等级分段道路限速等道路信息

3. 多策略保障路口播报率高,播报路口类型包括普通路口、高速匝道、丁字路口、复杂多路口交汇等场景

功能介绍
道路信息查询

查询轨迹点对应的道路限速、前方路口等道路信息


overview%2Fcrossing1.png

接口功能介绍
道路信息查询
http://api.map.baidu.com/roadinfo/v1/track?point_list=[{"height":1,"loc_time":1556162073,"coord_type_input":"bd09ll","latitude":39.950124,"longitude":115.799985}]&range=500&ak=你的AK //GET请求
请求参数
参数名称 参数含义 类型 是否必填 备注
ak 用户的AK,授权使用
string
开发者访问密钥
point_list 轨迹点序列 string

可传入1-10 个顺序轨迹点,轨迹里程不超过500 米。point_list 格式为json, 其中每个point 必须包含:latitude,longitude,coord_type_input,loc_time 这4 个字段,可选speed,direction,height,radius 这4 个字段,其他字段会被舍弃。

取值规则:

latitude:纬度,支持小数点后6 位

longitude:经度,支持小数点后6 位

coord_type_input:轨迹点的坐标系,支持以下值:bd09ll

(百度经纬度坐标)、gcj02(国测局加密坐标)、wgs84( GPS 所采用的坐标系)

loc_time:轨迹点的定位时间,使用UNIX 时间戳

speed:轨迹点的速度,单位:公里/小时

direction:轨迹点的方向,单位:范围为[0,359], 0 度为正北方向,顺时针方向递增

height:轨迹点的高度,单位:米

radius:定位时返回的定位精度,单位:米

range 前探范围 string

向前方探测的距离,单位:米,取值范围(0-2000),默认

值:range=1000

示例:

range= 500

coord_type_output

返回的坐标类型

string

默认值:bd09ll

该字段用于控制返回结果中的坐标类型。可选值为:

gcj02:国测局加密坐标

bd09ll:百度经纬度坐标

返回结果参数
参数名称 参数含义 类型 备注
status 状态码 int 本次API访问状态,如果成功返回0,如果失败返回其他数字。
message 响应信息 string 对status的中文描述

latest_point

绑路后最新的轨迹点坐标

string

格式:经度,纬度

示例:118.634229,39.836494

road_base_info

道路基础属性


speed_limit 道路限速 double

当前位置的道路限速

单位:千米/小时

road_name 道路名称 string 当前位置的道路限速名称

road_grade 道路等级 string

道路等级可选值包括:

高速路

都市高速路

国道

省道

县道

乡镇道路

其他道路

九级路

轮渡

行人道路

crossing 前方路口信息 array

如前探范围内有路口,则返回与车辆最近的一个路口信息


distance
路口与车辆的距离 double 最近路口昱车辆的距离,单位“米”
crossing_road_info
除当前形式道路外,交汇道路(可能有多条道路)信息 array 若道路上有拥堵路段,则返回该字段。
若无拥堵路段,则不返回该字段
注意:拥堵路段是依据拥堵情况、车流量、拥堵距离等因素综合计算得到,并不完全参考拥堵情况

road_name
交汇道路名称 string 如:人民路
road_grade 交汇道路等级 string

道路等级可选值包括:

高速路

都市高速路

国道

省道

县道

乡镇道路

其他道路

九级路

轮渡

行人道路

speed_limit 交汇道路限速 double 单位:千米/小时
返回结果示例
 
{
    status: 0,
    message: "ok",
    latest_point: "115.79995514737978,39.95011256776354",
    road_base_info: {
        road_name: "军红路",
        road_grade: "县道",
        speed_limit: 60
    },
    crossings: [
        {
            distance: 14,
            location: "115.8000823613897,39.95002379612574",
            crossing_road_info: [
                {
                    road_name: "X209",
                    road_grade: "县道",
                    speed_limit: 60
                },
                {
                    road_name: "张家村路",
                    road_grade: "其他道路",
                    speed_limit: 30
                },
                {
                    road_name: "军红路",
                    road_grade: "县道",
                    speed_limit: 60
                }
            ]
        }
    ]
}


使用方法
编码说明

API请求中需要用到中文或一些特殊字符的参数,如query、region等,为了避免提交到后台乱码,需要对这几个参数值进行编码处理,转换成UTF-8字符的二字符十六进制值,凡是不在下表中的字符都需要进行编码。

字符集合 字符
URL非保留字
a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 - _ . ~
URL保留字
 ! * ' ( ) ; : @ & = + $ , / ? % # [ ]

如果中文参数中使用URL保留字字符的字面意思,例如:region关键字取值为"?北京",检索关键字包含一个问号,此问号也必须进行编码。

附注:

javascript中一般采用encodeURIComponent函数对特殊字符进行编码。

Java中可以使用函数URLEncoder.encode对特殊字符进行编码。

C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。

php中可以使用函数urlencode对特殊字符进行编码。

坐标系说明

WGS84:为一种大地坐标系,也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。

GCJ02:是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。

BD09:为百度坐标系,在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标。

地点输入提示服务默认输入输出坐标类型为百度坐标(bd09ll),同时可通过参数("coord_type","ret_coordtype")控制输入输出坐标类型。输入坐标支持以上三种坐标系,输出坐标支持-国测局坐标(GCJ02)和百度坐标(BD09)。

注意:不同类型坐标如需转换,请使用百度地图开放平台提供的标准坐标转换接口。请勿使用其他渠道提供的坐标转换方法,以免影响坐标转换精度。

服务使用限制

服务相关配额及并发请求限制请访问开发者权益页面查看。

2020年7月21日

V1.0

产品发布
发布道路信息查询服务V1.0,支持查询当前位置对应的道路名称、道路等级、小客车限速、前方一定范围内的路口信息。
产品发布
  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

如发现文档错误,或对此文档有更好的建议,请在下方反馈。问题咨询请前往反馈平台提交工单咨询。

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消