接口调用地址
线路类型一 [普通集群负载-IP接口]
说明：直接访问 https://api.apihz.cn/getapi.php 获取当前最优IP接口地址。由普通负载集群服务器组成，通过IP接口地址调用，如果单个服务器过载可自行切换IP接口地址尝试其他负载服务器。IP并非永久固定且容易遭受攻击，平台可能不定期更换。
线路类型二 [普通集群负载-域名接口]
说明：域名接口会自动分发请求到普通集群服务器均衡负载，该域名TTL值为60秒，表示你的请求会每60秒实现自动轮换负载服务器，但也可能因你的网络服务商存在DNS缓存造成短时间内无法自动切换负载。如果某个负载服务器出现故障，也可能会造成个别地区存在一定时间的故障期。
线路类型三 [VIP集群负载-VIP线路接口]
说明：VIP专线在普通集群组的基础上额外增加独享大带宽集群组，每次请求自动均衡负载，自动故障切换，抗攻击，全球智能CDN加速。超高稳定性！最低30¥/月，彩钻以上会员专属，登录后购买。注：VIP线路是指调用接口的线路更有保障以及每分钟拥有更高的调用频次等，并非收费接口包月使用。
请求示例
[GET]请求示例：(请登录后使用自己的KEY独享频次)
复制参数
复制全部
[POST]请求示例：(请根据开发语言自行POST，参考【GET/POST教程】，或下载【超级客户端】调试。)
请求参数说明
注意：请求编码为UTF8，否则带中文请求可能失败。一般参数不能带+号，会被自动替换为空格。参数内容较大的必须用POST，不能GET。
提示：如发现接口有BUG，可加服务QQ群及时向我们反馈。
提示：请求参数里的开发者ID与KEY，登录后台菜单【个人资料】里查看。
提示：如发现接口有BUG，可加服务QQ群及时向我们反馈。
提示：请求参数里的开发者ID与KEY，登录后台菜单【个人资料】里查看。
| 名称 | 参数 | 必填 | 说明 |
|---|---|---|---|
| 开发者ID | id | 是 | 用户中心的数字ID，例：id=10000000 |
| 开发者KEY | key | 是 | 用户中心通讯秘钥，例：key=15he5h15ty854j5sr152hs2 |
| 线路编号 | uuid | 是 | 公共交通线路编号，该编号全国唯一，可通过线路规划接口返回详细信息里获取，也可通过公交站点查询接口获取线路编号，注意线路编号和公交站点编号都称为uuid，这里是传线路的uuid。例：uuid=23212 |
| 简化数据 | type | 否 | 0=返回简略数据。1=返回详细数据，增加了更详细的路线步进坐标，适用于导航预览。默认0，如非必要建议保持默认返回简略数据。例：type=0 |
| 动态秘钥 | dkey | 否 | 开发者开启动态秘钥验证后需传此参数，主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例：dkey=0cd2a494831736587c33f30d1e544371 |
| 用户IP | uip | 否 | 接口调用者IP，用于后台统计IP地域分布，ISP运营商，时段IP数统计等，如不传该参数则默认为接口请求端IP，该参数主要用于使用后端服务器/中间件请求接口的方式使用。例：uip=123.123.123.123。该参数彩钻/炫钻/焱钻会员专享。 |
返回参数说明
| 名称 | 参数 | 说明 |
|---|---|---|
| 状态码 | code | 200成功，400错误 |
| 消息内容 | msg | 信息提示。 |
| 途径站点数据集 | station | 该线路途径站点数据集，包含各个站点名称，站点编号uuid，经纬度坐标。 |
| 计费模式 | ticketcal | 0=单一，1=按距离，2=按站。 |
| 人工售票 | ismanual | 0：有人，1：无人。 |
| 线路类型 | linetype | 1：公交，2：地铁，3：磁悬浮。 |
| 全程票价 | totalprice | 全程票价，单位分。 |
| 未知字段 | byuuid | 未知字段。 |
| 线路长度 | length | 线路长度，单位米。 |
| 月票 | ismonticket | 0：不支持，1： 支持。 |
| 末班车时间 | endtime | 末班车时间。 |
| 车站递增票价 | increasedstep | 车站递增票价，按站。 |
| 始发车时间 | starttime | 始发车时间。 |
| 起步票价 | startprice | 起步票价，单位分。 |
| 递增距离票价 | increasedprice | 递增距离票价，按千米。 |
| 全程站点数 | stationnum | 全程站点数。 |
| 全程时间 | totaltime | 单位分钟。 |
| 双向行驶 | isbidirectional | 0，单向；1， 双向。 |
| 线路名称 | linename | 线路名称。 |
| 发车间隔 | interval | 发车间隔。 |
| 公交公司 | company | 公交公司。 |
返回数据示例
示例：{"code":400,"msg":"查询失败，请重试。"}
示例：
{
"ticketcal": 1,
"ismanual": 1,
"linetype": 1,
"totalprice": 0,
"byuuid": 22133,
"length": 38719,
"ismonticket": 0,
"endtime": "22:00",
"increasedstep": 0,
"starttime": "05:30",
"startprice": 200,
"increasedprice": 0,
"stationnum": 39,
"totaltime": 0,
"station": [{
"name": "大北窑东",
"uuid": "120045",
"lonlat": "116.458358,39.906717"
}, {
"name": "八王坟东",
"uuid": "127984",
"lonlat": "116.47729,39.906558"
}, {
"name": "四惠枢纽站",
"uuid": "125838",
"lonlat": "116.490334,39.906508"
}, {
"name": "慈云寺桥",
"uuid": "119579",
"lonlat": "116.483869,39.912075"
}, {
"name": "慈云寺",
"uuid": "119760",
"lonlat": "116.487018,39.914085"
}, {
"name": "东八里庄",
"uuid": "138087",
"lonlat": "116.491698,39.914237"
}, {
"name": "十里堡",
"uuid": "120190",
"lonlat": "116.500327,39.914402"
}, {
"name": "青年路南口",
"uuid": "119957",
"lonlat": "116.509979,39.91508"
}, {
"name": "太平庄",
"uuid": "119753",
"lonlat": "116.519516,39.915782"
}, {
"name": "民航医院",
"uuid": "119754",
"lonlat": "116.524547,39.915466"
}, {
"name": "朝阳路高井",
"uuid": "121931",
"lonlat": "116.529153,39.915115"
}, {
"name": "大黄庄桥东",
"uuid": "119765",
"lonlat": "116.540388,39.914664"
}, {
"name": "定福庄",
"uuid": "128134",
"lonlat": "116.550401,39.914587"
}, {
"name": "第二外国语学院",
"uuid": "145962",
"lonlat": "116.558478,39.914675"
}, {
"name": "朝阳路三间房",
"uuid": "119766",
"lonlat": "116.56787,39.9137"
}, {
"name": "周家井",
"uuid": "119768",
"lonlat": "116.575605,39.912866"
}, {
"name": "管庄",
"uuid": "119959",
"lonlat": "116.582424,39.911505"
}, {
"name": "杨闸环岛西",
"uuid": "119961",
"lonlat": "116.591224,39.910648"
}, {
"name": "杨闸环岛东",
"uuid": "119963",
"lonlat": "116.595655,39.911032"
}, {
"name": "西军庄",
"uuid": "119965",
"lonlat": "116.60734,39.911919"
}, {
"name": "八里桥北站",
"uuid": "119967",
"lonlat": "116.612591,39.912255"
}, {
"name": "西马庄",
"uuid": "119969",
"lonlat": "116.624635,39.914082"
}, {
"name": "北京物资学院南站",
"uuid": "117848",
"lonlat": "116.633844,39.918991"
}, {
"name": "结研所",
"uuid": "117842",
"lonlat": "116.648032,39.920867"
}, {
"name": "皇木厂",
"uuid": "137262",
"lonlat": "116.6499,39.917386"
}, {
"name": "岳庄",
"uuid": "127985",
"lonlat": "116.65053,39.913392"
}, {
"name": "西大街路口东",
"uuid": "121979",
"lonlat": "116.653181,39.906881"
}, {
"name": "新华大街",
"uuid": "123939",
"lonlat": "116.659681,39.907135"
}, {
"name": "通州东关",
"uuid": "119786",
"lonlat": "116.670633,39.90777"
}, {
"name": "东关大桥",
"uuid": "120199",
"lonlat": "116.679647,39.911916"
}, {
"name": "耿庄桥南",
"uuid": "143087",
"lonlat": "116.683074,39.915954"
}, {
"name": "耿庄桥北",
"uuid": "138453",
"lonlat": "116.68025,39.926232"
}, {
"name": "小潞邑",
"uuid": "128176",
"lonlat": "116.683379,39.929779"
}, {
"name": "小潞邑北站",
"uuid": "119411",
"lonlat": "116.685891,39.93199"
}, {
"name": "潞邑西路",
"uuid": "126508",
"lonlat": "116.684933,39.938285"
}, {
"name": "疃里新村",
"uuid": "126927",
"lonlat": "116.686096,39.941901"
}, {
"name": "疃里一区",
"uuid": "122208",
"lonlat": "116.688629,39.948169"
}, {
"name": "疃里二区",
"uuid": "122209",
"lonlat": "116.691029,39.952132"
}, {
"name": "疃里三区",
"uuid": "128418",
"lonlat": "116.695928,39.956423"
}],
"isbidirectional": 1,
"linename": "648路(大北窑东-疃里三区)",
"interval": 600,
"company": "北京公共交通控股(集团)有限公司第五客运分公司",
"code": 200
}
更新记录
