公交线路规划免费API接口详解

简介: 本接口提供基于起点和终点经纬度的公交线路规划功能,支持多种换乘方案,包含分段站点、线路名称、耗时等信息,适用于出行导航类应用开发。

一、接口简介

本接口提供基于起点和终点经纬度的公交线路规划功能,适用于各类出行导航应用开发。通过输入精确的地理坐标点,接口将返回包含多种换乘方案的公交路线数据,包括分段站点信息、站点坐标、线路名称及分段耗时等关键信息。


二、核心功能参数

请求地址

复制

https://cn.apihz.cn/api/jiaotong/gongjiao.php

请求方式

支持 GETPOST

请求参数

参数名称 参数类型 必填 说明
id 字符串 用户中心的数字ID(需注册获取)
key 字符串 用户中心通讯秘钥
starlon 浮点数 起点经度(示例:121.4279)
starlat 浮点数 起点纬度(示例:31.20872)
endlon 浮点数 终点经度(示例:121.313079)
endlat 浮点数 终点纬度(示例:31.195667)
linetype 整数 线路策略(1-15,默认1=标准策略)
type 整数 数据简化:0=简略数据(默认),1=详细导航数据

注意:经纬度可通过设备定位或坐标查询接口获取


三、返回数据结构

字段路径 说明
code 状态码(200成功,400失败)
msg 操作结果消息
datas 所有线路方案的集合(数组)
datas[i].lineName 换乘方案名称(竖杠分隔线路)
datas[i].segments 当前方案的分段数据集(数组)
segments[j].stationStart 分段起点信息(含名称、坐标)
segments[j].stationEnd 分段终点信息(含名称、坐标)
segments[j].segmentTimes 分段耗时(单位:分钟)

四、调用示例

🔹 PHP 调用示例

php

复制

<?php
$apiUrl = "https://cn.apihz.cn/api/jiaotong/gongjiao.php";
$params = [
    'id' => '10000000',         // 替换为您的实际ID
    'key' => '15he5h15ty854j5', // 替换为您的实际KEY
    'starlon' => 121.4279,
    'starlat' => 31.20872,
    'endlon' => 121.313079,
    'endlat' => 31.195667,
    'linetype' => 1,
    'type' => 0
];
// 构造请求URL
$requestUrl = $apiUrl . '?' . http_build_query($params);
// 发送GET请求
$response = file_get_contents($requestUrl);
// 处理JSON响应
$result = json_decode($response, true);
if ($result['code'] == 200) {
    foreach ($result['datas'] as $route) {
        echo "线路方案: " . $route['lineName'] . "\n";
        foreach ($route['segments'] as $segment) {
            echo "🚏 从 {$segment['stationStart']['name']} 到 {$segment['stationEnd']['name']} ";
            echo "⏱️ 耗时: {$segment['segmentTimes']}分钟\n";
        }
    }
} else {
    echo "错误: " . $result['msg'];
}
?>

🔹 Python 调用示例

python

运行

复制

import requests
params = {
    "id": "10000000",          # 替换为您的实际ID
    "key": "15he5h15ty854j5",  # 替换为您的实际KEY
    "starlon": 121.4279,
    "starlat": 31.20872,
    "endlon": 121.313079,
    "endlat": 31.195667,
    "linetype": 1,
    "type": 0
}
response = requests.get(
    "https://cn.apihz.cn/api/jiaotong/gongjiao.php",
    params=params
)
if response.status_code == 200:
    data = response.json()
    if data["code"] == 200:
        for route in data["datas"]:
            print(f"线路方案: {route['lineName']}")
            for segment in route["segments"]:
                start = segment["stationStart"]["name"] or "起点"
                end = segment["stationEnd"]["name"] or "终点"
                print(f"🚏 从 {start} 到 {end} ⏱️ 耗时: {segment['segmentTimes']}分钟")
    else:
        print("错误:", data["msg"])
else:
    print("HTTP请求失败,状态码:", response.status_code)

五、返回数据示例

成功响应(200)

json

复制

{
  "code": 200,
  "datas": [
    {
      "lineName": "地铁10号线 |",
      "segments": [
        {
          "stationStart": {
            "name": "",
            "uuid": "",
            "lonlat": "121.4279,31.2087"
          },
          "stationEnd": {
            "name": "交通大学站6号口",
            "uuid": "1429089",
            "lonlat": "121.429851,31.203733"
          },
          "segmentTimes": 14
        },
        {
          "stationStart": {
            "name": "交通大学站",
            "uuid": "1429089",
            "lonlat": "121.429851,31.203733"
          },
          "stationEnd": {
            "name": "虹桥火车站",
            "uuid": "1431250",
            "lonlat": "121.316195,31.195677"
          },
          "segmentTimes": 20
        }
      ]
    },
    {
      "lineName": "113路|地铁10号线 |",
      "segments": [
        {
          "stationStart": {
            "name": "",
            "uuid": "",
            "lonlat": "121.4279,31.2087"
          },
          "stationEnd": {
            "name": "华山路湖南路",
            "uuid": "1461336",
            "lonlat": "121.428817,31.20775"
          },
          "segmentTimes": 4
        }
      ]
    }
  ]
}

失败响应(400)

json

复制

{
  "code": 400,
  "msg": "查询失败,请重试。"
}

六、使用须知

  1. 身份认证:必须使用接口盒子平台注册获取专属ID和KEY
  2. 频次限制:公共ID共享频次限制,正式项目务必使用私有KEY
  3. 坐标精度:经纬度建议保留6位小数以保证定位准确性
  4. 策略说明linetype参数需根据文档调试选择(如2=时间最少、3=地铁优先等)
相关文章
vue3 wangEditor富文本自定义上传本地图片
Vue3和WangEditor都提供了上传本地图片的功能,可以结合使用实现自定义上传本地图片。
1691 0
|
移动开发 前端开发 JavaScript
前端摸鱼神器,设计稿一键导出 「小程序/Vue/Uni-app」代码
这款神器就是「CodeFun」,它号称“UI 设计稿智能生成源代码,10 分钟完成 8 小时工作量”,让我们做前端,不搬砖
2073 0
前端摸鱼神器,设计稿一键导出 「小程序/Vue/Uni-app」代码
|
2月前
|
NoSQL Redis UED
redis数据迁移、数据导出和导入用什么工具
用户体验好的客户端,我建议使用yunedit-redis来做数据迁移,因为它支持图形化,还支持多种导出方式。 yunedit-redis它支持全库导出,也支持选择部分key导出,还支持用*号表达式导出。
|
2月前
|
存储 缓存 NoSQL
mybatisplus一二级缓存
MyBatis-Plus 继承并优化了 MyBatis 的一级与二级缓存机制。一级缓存默认开启,作用于 SqlSession,适用于单次会话内的重复查询;二级缓存需手动开启,跨 SqlSession 共享,适合提升多用户并发性能。支持集成 Redis 等外部存储,增强缓存能力。
|
24天前
|
存储 关系型数据库 MySQL
MySQL数据库中的 char 与 varchar的区别是什么
MySQL中的char和varchar均用于存储字符串,但有显著区别。char为定长类型,固定长度,存储空间始终为设定值,适合长度固定的数据如手机号。varchar为变长类型,仅占用实际数据所需空间,适合长度不固定的内容如用户名。二者在性能与空间利用上各有优劣,应根据实际场景合理选择。
188 0
|
2月前
|
安全 关系型数据库 MySQL
mysql事务隔离级别
事务隔离级别用于解决脏读、不可重复读和幻读问题。不同级别在安全与性能间权衡,如SERIALIZABLE最安全但性能差,READ_UNCOMMITTED性能高但易导致数据不一致。了解各级别特性有助于合理选择以平衡并发性与数据一致性需求。
142 1
|
7月前
|
机器学习/深度学习 人工智能 云计算
2025年2月阿里云服务器价格与选购指南
随着云计算技术的普及,阿里云在2025年推出了多款高性价比的云服务器产品。本文基于《2025年阿里云服务器收费价格表》,从配置选择、适用场景到优惠活动,为您提供全面的购买参考。涵盖入门级轻量应用服务器、经济型e实例、企业级通用算力型u1实例、高性能服务器及GPU服务器等,适合个人开发者到大型企业的不同需求。详细对比各类配置的价格与性能,并提供抢购秒杀、续费优惠及代金券组合使用等省钱策略,助您降低上云成本。立即访问云小站活动页面领取最新折扣,开启高效云端之旅!
|
10月前
|
数据采集 存储 数据可视化
Python数据分析:揭秘"黑神话:悟空"Steam用户评论趋势
Python数据分析:揭秘"黑神话:悟空"Steam用户评论趋势
|
12月前
|
Linux
银河麒麟桌面操作系统中获取硬盘序列号
银河麒麟桌面操作系统中获取硬盘序列号
|
11月前
|
SQL 监控 关系型数据库
如何查看MySQL使用的内存
综合运用上述方法,您可以全方位地监控和管理MySQL的内存使用。从简单查看配置到深入分析实时内存占用,每种方法都有其适用场景和优势。定期检查和调整MySQL的内存配置,对于维持数据库性能和稳定性至关重要。
1454 0