浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。
简介
ETC费用计算服务是根据车辆的已行驶轨迹和车型信息计算ETC费用的接口,费用包含高速ETC费用和过桥费。目前车型支持货车和乘用车,使用范围覆盖中国境内(不含港澳台)。
模块 接口名称 功能说明
toll truck 计算货车ETC
car 计算乘用车ETC费用
功能简介

2020年1月1日,全国高速正式实行分段收费。百度地图鹰眼ETC费用计算服务支持根据行驶轨迹实时或事后进行ETC费用还原,目前支持计算货车和乘用车的ETC费用计算。
当轨迹已上传至鹰眼后,该服务一次请求可计算起止时间差在72小时内(3天)跨度的轨迹对应的ETC费用,并按大收费区间进行分段,可满足大部分货车、乘用车一次长途出行的ETC费用计算。在使用该服务时,开发者需要重点注意一下几点:

1. 由于ETC费用与车型相关,开发者需要针对车型选择货车或乘用车ETC费用计算API。对于货车,则需要输入准确的车型信息,包括:车辆高度、宽度、长度、总重、轴数。
2. 该服务原理是先根据行驶轨迹还原为道路,再计算道路对应的ETC费用。该服务将会利用鹰眼的轨迹纠偏绑路和补偿能力,开发者需要尽量保障原始轨迹的质量,并调试鹰眼轨迹纠偏参数使轨迹还原效果达到最佳,保障ETC费用尽量接近真实。


关于权限和配额的说明:ETC费用计算服务是鹰眼的付费高级服务,在试用阶段开发者可通过反馈平台申请短期试用,默认配额为:并发(5次/秒),日请求量(100次/日)。

货车ETC费用
请求URI
https://yingyan.baidu.com/api/v3/toll/truck   //GET请求
请求参数
参数名 参数含义 类型 是否必填 备注
ak 用户的AK string
service_id service的ID,service 的唯一标识。 int
在轨迹管理台创建鹰眼服务时,系统返回的 service_id
entity_name entity唯一标识 string
start_time 起始时间(起始的loc_time) UNIX时间戳
end_time 结束时间(结束的loc_time) UNIX时间戳 结束时间不超过当前时间,不能早于起始时间,且与起始时间差在(24*3)小时(即3天)之内。
height
车辆高度
double

单位:米,取值范围:[0,5.0]

width
车辆宽度
double

单位:米,取值范围:[0,3.0]

length
车辆长度
double

单位:米,取值范围:[0,20.0]

weight
车辆总重
double

车辆总重=车辆自身重量+货物重量
单位:吨,取值范围[0,100]

axle_count
轴数
double

取值范围[1,6]

coord_type_output 返回的坐标类型
string

默认值:bd09ll

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

gcj02:国测局加密坐标

bd09ll:百度经纬度坐标

该参数仅对国内(包含港、澳、台)轨迹有效。

返回参数
参数名
参数含义 类型 备注
status
状态码
message
响应信息 string 对status的中文描述
toll 总ETC费用 double
toll_section_num
收费区间数量 int 收费区间包括:

1. 一段以收费站入口开始和收费站出口结束的高速区间
2. 只在入口收费或只在出口收费的高速区间
3. 收费的桥梁

toll_sections
分段收费信息
array


toll 分段收费 double 单位:元

toll_type 收费类型 string

可选值:

TOLL_TYPE_ETC(高速ETC门架费)

TOLL_TYPE_BRIDGE(过桥费)

road_grade 道路等级 string 可选值:高速路;都市高速路;国道;省道;县道;乡镇道路;其他道路;九级路;轮渡;
road_name 道路名称 string
start_toll_station 区间起点收费站信息


coord 收费站坐标 string json子结构,格式为 {"longitude": 112.47137,"latitude": 34.77311}
name 收费站名称 string
若有实际收费站,则使用收费站名称。
若无实际收费站,则用收费结束点“行政区名称+道路名称”标识。
end_toll_station
区间结束收费站信息


coord
收费站坐标 string
json子结构,格式为 {"longitude": 112.47137,"latitude": 34.77311}
name
收费站名称 string
若有实际收费站,则使用收费站名称。
若无实际收费站,则用收费结束点“行政区名称+道路名称”标识。


请求示例
https://yingyan.baidu.com/api/v3/toll/truck?ak=<你的AK>&service_id=<你的service_id>&entity_name=<你的entity_name>&start_time=1594207500&end_time=1594217520&height=1.8&width=1.9&weight=20&length=9&axle_count=2  //GET请求
返回结果示例
{
    status: 0,
    message: "成功",
    toll: 231.368,
    toll_section_num: 1,
    toll_sections: [{
        toll: 231.368,
        toll_type: "TOLL_TYPE_ETC",
        road_grade: "高速路",
        road_name: "连霍高速",
        start_toll_station: {
            name: "河南省洛阳市孟津县S243(洛吉快速路)",
            coord: {
                longitude: 112.47137,
                latitude: 34.77311
            }
        },
        end_toll_station: {
            name: "河南省郑州市管城回族区G4(京港澳高速)",
            coord: {
                longitude: 113.81392,
                latitude: 34.70144
            }
        }
    }]
}


乘用车ETC费用
请求URI
    https://yingyan.baidu.com/api/v3/toll/car   //GET请求
请求参数
参数名 参数含义 类型 是否必填 备注
ak 用户的AK string
service_id service的ID,service 的唯一标识。 int
在轨迹管理台创建鹰眼服务时,系统返回的 service_id
entity_name entity唯一标识 string
start_time 起始时间(起始的loc_time) UNIX时间戳
end_time 结束时间(结束的loc_time) UNIX时间戳 结束时间不超过当前时间,不能早于起始时间,且与起始时间差在(24*3)小时(即3天)之内。
coord_type_output 返回的坐标类型
string

默认值:bd09ll

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

gcj02:国测局加密坐标

bd09ll:百度经纬度坐标

该参数仅对国内(包含港、澳、台)轨迹有效。

返回参数
参数名
参数含义 类型 备注
status
状态码
message
响应信息 string 对status的中文描述
toll 总ETC费用 double
toll_section_num
收费区间数量 int
toll_sections
分段收费信息
array


toll 分段收费 double 单位:元

toll_type 收费类型 string

可选值:

TOLL_TYPE_ETC(高速ETC门架费)

TOLL_TYPE_BRIDGE(过桥费)

road_grade 道路等级 string 道路等级分为以下多种:高速路;都市高速路;国道;省道;县道;乡镇道路;其他道路;九级路;轮渡;行人道路;
road_name 道路名称 string
start_toll_station 区间起点收费站信息

name 收费站名称 string
若有实际收费站,则使用收费站名称。
若无实际收费站,则用收费结束点“行政区名称+道路名称”标识。

coord 收费站坐标 string json子结构,格式为 {"longitude": 112.47137,"latitude": 34.77311}
end_toll_station
区间结束收费站信息

name
收费站名称 string
若有实际收费站,则使用收费站名称。
若无实际收费站,则用收费结束点“行政区名称+道路名称”标识。

coord
收费站坐标 string
json子结构,格式为 {"longitude": 112.47137,"latitude": 34.77311}
请求示例
https://yingyan.baidu.com/api/v3/toll/car?ak=<你的AK>&service_id=<你的service_id>&entity_name=<你的entity_name>&start_time=1620119260&end_time=1620121300 //GET请求
返回结果示例
{
        status: 0,
        message: "成功",
        toll: 231.368,
        toll_section_num: 1,
        toll_sections: [{
            toll: 231.368,
            toll_type: "TOLL_TYPE_ETC",
            road_grade: "高速路",
            road_name: "连霍高速",
            start_toll_station: {
                name: "河南省洛阳市孟津县S243(洛吉快速路)",
                coord: {
                    longitude: 112.47137,
                    latitude: 34.77311
                }
            },
            end_toll_station: {
                name: "河南省郑州市管城回族区G4(京港澳高速)",
                coord: {
                    longitude: 113.81392,
                    latitude: 34.70144
                }
            }
        }]
    }
    
  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

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

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消