沿线地铁

概述

查询公交与地铁的换乘关系。可以按一条公交线路列出沿途能换乘的地铁，也可以按出发地和目的地返回包含地铁的乘车方案。本接口免费，额度与实时公交相同。 ## 支持地区 城市名与实时公交使用同一套城市表，覆盖这套表里的城市。查询时认简称，也认带「市」「县」「区」的写法，例如福州、福州市、上海。 有地铁换乘标注的城市会返回换乘站和乘车方案。没有地铁，或所选公交线路沿途没有地铁站时，沿线换乘的 stops 为空数组。两地之间没有地铁方案时，plans 为空数组。 福州、上海已核对能返回地铁线路。北京、广州、深圳、杭州、天津、成都、重庆、青岛、郑州、武汉、东莞、苏州、南昌、沈阳、南京、宁波、无锡、大连、长春、长沙、西安、香港在城市资料里标了地铁。未列入这份标记的城市也可能返回换乘站，以实际返回为准。 ## 两种查询 同一地址用参数 `type` 切换。 - `along`：沿线换乘，默认值。传入城市和公交线路，返回该方向上带有地铁的站点。没有地铁的站不会出现。 - `plan`：两地乘车。传入城市、出发地和目的地，返回最多 5 条含地铁的方案。 `line`、`query` 与 `along` 相同。`route`、`ride` 与 `plan` 相同。 ## 沿线换乘 `city` 接受简称和带后缀的写法，例如福州、福州市、上海。`line` 传公交线路的路号或官方名称，例如 `1` 或 `1路`。`direction` 为 1 时走默认方向，为 2 时走返程。 每条地铁返回名称、线路编号和颜色。颜色是红、绿、蓝三个 0–255 的数字，用英文逗号分隔。站点 `lat`、`lng` 是 WGS-84；没有坐标时为 null。 回包里的 `first_time`、`last_time`、`price` 属于这条公交线路的首末班和票价，不是地铁票价。`start`、`end` 是该方向的公交起讫站。某站同时可换多条地铁时，这些地铁都列在该站的 `subways` 里。 请传公交线路。把 `line` 写成「地铁1号线」查不到地铁自身的全程站，接口会提示改传公交线路。 ## 两地乘车 `origin`、`dest` 是出发地和目的地名称。不传坐标时，按名称匹配地标。若要自己指定坐标，纬度和经度必须成对出现，坐标系为国测局 GCJ-02。 `strategy` 取 0、1、2。0 为推荐，1 为少换乘，2 为少步行。 每段地铁包含上车站 `board`、下车站 `alight`、中间站 `via`、线路两端终点 `from_terminal` 与 `to_terminal`、这一站的首末班、预计分钟数和距离。`via_count` 是上下车之间的站数。 同一方案如果还要乘坐公交，只返回 `bus_count`，不展开公交线路和车辆。全程只有地铁和步行时，`bus_count` 为 0。两地之间没有地铁方案时，`plans` 为空。 ## 不包含的数据 本接口不返回地铁线路自己的全程站点，不返回列车实时位置，也不返回到站倒计时。地图折线不返回。方案中的耗时是预计值。 沿线结果缓存 1 小时，两地方案缓存 10 分钟。命中缓存时 `msg` 为 cached。

鉴权

本接口免费，额度与实时公交相同。不带 Key 每天 500 次、QPS 5；登录后每天 1000 次、QPS 20。黄金会员每天 50000 次，钻石会员每天 100000 次，企业会员每天 1000000 次。可选携带 Authorization: Bearer <API Key>。

获取 API Key：获取 API Key/account/keys

沿线换乘

查询一条公交线路在指定方向上哪些站可以换乘地铁。城市名与实时公交相同。line 传公交路号，不要传地铁线名。没有地铁的站不出现。站点坐标是 WGS-84。首末班和票价属于这条公交。

https://v1.apizero.cn/api/metro-along?type=along&city=%E7%A6%8F%E5%B7%9E&line=1&direction=1

{
  "type": "along",
  "city": "福州",
  "line": "1",
  "direction": "1"
}

{
  "code": 0,
  "msg": "成功",
  "data": {
    "city": "福州",
    "line": "1",
    "direction": 1,
    "start": "则徐大道盖山路口",
    "end": "西门",
    "first_time": "05:00",
    "last_time": "23:00",
    "price": "1元",
    "subway_count": 2,
    "stop_count": 1,
    "stops": [
      {
        "order": 3,
        "name": "三叉街",
        "lat": 26.037656,
        "lng": 119.322126,
        "subways": [
          {
            "name": "地铁1号线",
            "line_no": "1",
            "color": "227,10,10"
          }
        ]
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

两地乘车

查询两地之间包含地铁的方案，最多 5 条。坐标为国测局 GCJ-02，纬度和经度须成对出现。同方案中的公交只返回段数。没有地铁方案时 plans 为空。

https://v1.apizero.cn/api/metro-along?type=plan&city=%E7%A6%8F%E5%B7%9E&origin=%E4%B8%89%E5%8F%89%E8%A1%97&dest=%E4%B8%9C%E8%A1%97%E5%8F%A3&strategy=0

{
  "type": "plan",
  "city": "福州",
  "origin": "三叉街",
  "dest": "东街口",
  "strategy": "0"
}

{
  "code": 0,
  "msg": "成功",
  "data": {
    "city": "福州",
    "origin": "三叉街",
    "dest": "东街口",
    "strategy": 0,
    "count": 1,
    "plans": [
      {
        "tag": "直达",
        "duration_minutes": 32,
        "bus_count": 0,
        "metro_count": 1,
        "metros": [
          {
            "name": "地铁1号线",
            "board": "三叉街",
            "alight": "东街口",
            "via": [
              "上藤",
              "达道",
              "茶亭",
              "南门兜"
            ],
            "first_time": "06:24",
            "last_time": "23:54",
            "duration_minutes": 16
          }
        ]
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

请求示例

示例都是服务端写法。Python / JavaScript 各有常规写法和官方库。

curl -sS -X POST "https://v1.apizero.cn/api/metro-along" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "along",
  "city": "福州",
  "line": "1",
  "direction": "1",
  "origin": "三叉街",
  "dest": "东街口",
  "strategy": "0"
}'

错误码

先看业务 code。HTTP 也可能不是 200。

调用限制

购买套餐、看评价请走商城详情。 购买 / 调试

更新日志

• v1.02026-10-24

  上线沿线换乘和两地乘车。额度与实时公交相同，不包含列车实时位置。

免责声明