开发 Web服务 API 开发指南 高级 API 文档 公交信息查询

公交信息查询 最后更新时间: 2024年07月18日

产品介绍

公交信息查询 API 一套以 HTTP 形式提供的包括:公交站 ID 查询、公交站关键字查询、公交路线 ID 查询、公交路线关键字查询,返回 JSON 或 XML 格式的查询数据,用于实现公交信息查询功能的开发。 

提示

公交信息查询接口属于高级服务接口,如需申请,可进行 商务咨询

适用场景

  • 公交站 ID 查询:通过公交站点 ID 查询公交线路的详细信息
  • 公交站关键字查询:通过站点名称查询公交线路的详细信息
  • 公交路线 ID 查询:通过公交路线 ID 查询该线路的详细信息
  • 公交路线关键字:通过公交线路名称查询该线路的详细信息

使用说明

1
第一步
申请 【Web服务API】密钥(Key)
2
第二步
拼接 HTTP 请求 URL,第一步申请的 Key 需作为必填参数一同发送
3
第三步
接收 HTTP 请求返回的数据(JSON 或 XML 格式),解析数据
如无特殊声明,接口的输入参数和输出数据编码全部统一为 UTF-8
成为开发者并创建 Key 

为了正常调用 Web 服务 API ,请先注册成为高德开放平台开发者,并申请 Web 服务的 key ,点击具体操作

公交站 ID 查询

公交站 ID 查询 API 服务地址

URL

请求方式

https://restapi.amap.com/v3/bus/stopid?parameters 

GET

parameters 代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。

请求参数

名称

含义

规则说明

是否必填

缺省值

key

用户唯一标识 

用户在高德地图官网 申请 Web 服务 API 类型Key

sig

签名

选择数字签名认证的付费用户必填,数字签名获取和使用方法

id

公交站 id

output 

返回数据格式类型 

可选:JSON、XML

JSON

extensions

控制返回内容

base:返回公交路线基本信息

否 

base 

服务示例

https://restapi.amap.com/v3/bus/stopid?key=<用户的key>&id=BV10006672&output=xml

参数

备注

必选

id

公交站 id

返回结果参数说明

关键字搜索的响应结果的格式由请求参数 output 指定。

名称

含义

说明

status

返回结果状态值

值为 0 或 1,0 表示失败;1 表示成功

info 

返回状态说明

访问状态值的说明,如果成功返回"ok",失败返回错误原因,具体见 错误码说明

infocode

返回状态说明

返回状态说明,10000 代表正确,详情参阅 info 状态表

busstops

公交车站信息列表

id

公交站 id

name

公交站名

location

经纬度

adcode

城市 adcode

citycode

城市 citycode

buslines

途径此站的公交路线列表

id

公交线路唯一 id

location

公交线路途径此站的经纬度

name

线路名称

start_stop

首发站

end_stop

末站

公交站关键字查询

公交站关键字查询 API 服务地址

URL

请求方式

https://restapi.amap.com/v3/bus/stopname?parameters 

GET

parameters 代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。

请求参数

名称

含义

规则说明

是否必填

缺省值

key

用户唯一标识 

用户在高德地图官网 申请 Web 服务 API 类型Key

sig

签名

选择数字签名认证的付费用户必填,数字签名获取和使用方法

keywords

查询关键字

只支持一个关键字

city

城市

支持 adcode、citycode

adcode 信息可参考城市编码表获取

offset

每页记录数据

最大 100

20

page

当前页面

最大 100

1

output 

返回数据格式类型 

可选:JSON、XML

JSON

extensions

控制返回内容

base:返回公交路线基本信息

否 

base 

服务示例

https://restapi.amap.com/v3/bus/stopname?key=<用户的key>&city=110000&keywords=来广营路口西

参数

备注

必选

keywords

查询关键字,只支持一个关键字

city

城市,支持 adcode、citycode
adcode 信息可参考城市编码表获取

返回结果参数说明

关键字搜索的响应结果的格式由请求参数 output 指定。

名称

含义

说明

status

返回结果状态值

值为 0 或 1,0 表示请求失败;1 表示请求成功

info 

返回状态说明

访问状态值的说明,如果成功返回"ok",失败返回错误原因,具体见 错误码说明

infocode

返回状态说明

返回状态说明,10000 代表正确,详情参阅 info 状态表

busstops

公交车站信息列表

id

公交站 id

name

公交站名

location

经纬度

adcode

城市 adcode

citycode

城市 citycode

buslines

途径此站的公交路线列表

id

公交线路唯一 id

location

公交线路途径此站的经纬度

name

线路名称

start_stop

首发站

end_stop

末站

公交路线 ID 查询

公交路线 ID 查询 API 服务地址

URL

请求方式

https://restapi.amap.com/v3/bus/lineid?parameters 

GET

parameters 代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。

请求参数

参数名

含义

规则说明

必填

默认值

key

用户唯一标识

用户在高德地图官网 申请 Web 服务 API 类型Key

id

公交线路 id

有效的高德公交线路 id

output

返回数据格式类型 

可选:JSON、XML

JSON

extensions

控制返回结果

可选:base,all

base:返回公交路线基本信息

all:返回基本+详细信息(详细信息包含途径站点,首末班车时间等)

base

服务示例

https://restapi.amap.com/v3/bus/lineid?key=<用户的key>&id=131000010042

参数

备注

必选

id

有效的高德公交线路 id

返回结果参数说明

关键字搜索的响应结果的格式由请求参数 output 指定。

名称

含义

规则

status

返回结果状态值

值为 0 或 1,0 表示失败;1 表示成功

info 

返回状态说明

访问状态值的说明,如果成功返回"ok",失败返回错误原因,具体见 错误码说明

infocode

返回状态说明

返回状态说明,10000 代表正确,详情参阅 info 状态表

count

结果数

buslines

公交线路信息

id

公交线路 id

type

公交类型

普通公交 地铁 轻轨 有轨电车 无轨电车 旅游专线 机场大巴 社区专车 磁悬浮列车 轮渡 索道交通 其他

name

线路名称

polyline

坐标串

citycode

城市的 citycode

start_stop

首发站

end_stop

末站

start_time

首班车时间

end_time

末班车时间

uicolor

线路 ui 颜色

部分线路返回颜色

timedesc

线路详细时间

 内容为 JSON 串,需要解码并做内容解析

distance

全程里程,单位:公里

loop

是否环线

0:否

1:是

status

线路状态

0:停运

1:正常

2:规划中

3:在建

direc

反向线路 id

如果有反向线路,则记录对向线路,如果没有反向线路,则记录自身。

company

所属公司

distance

线路长度

单位:公里

basic_price

起步价,单位:元

total_price

全程票价,单位:元

bounds

矩形区域

busstops

途径站

id

公交站 ID

name

公交站名

location

公交站经纬度

sequence

公交站序号

公交路线关键字查询

公交路线关键字查询 API 服务地址

URL

请求方式

https://restapi.amap.com/v3/bus/linename?parameters 

GET

parameters 代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。

请求参数

名称

含义

规则说明

是否必填

缺省值

key

用户唯一标识 

用户在高德地图官网 申请 Web 服务 API 类型Key

sig

签名

选择数字签名认证的付费用户必填,数字签名获取和使用方法

keywords

查询关键字

只支持一个关键字

city

城市

可选值:cityname(中文或中文全拼)、citycode、adcode 默认值:"全国”

adcode 信息可参考城市编码表获取

offset

每页记录数据

规则:大于 100 按默认值 默认值:20

20

page

当前页数

规则:最大翻页数 10 默认值:1

否 

1

extensions

控制返回内容

可选:

base:返回公交路线基本信息

all:返回基本+详细信息(详细信息包含途径站点,首末班车时间等)

base

output 

返回数据格式类型

可选:JSON、XML

JSON

服务示例

https://restapi.amap.com/v3/bus/linename?
extensions=base&keywords=451&offset=20&city=110000&page=1&key=<用户的key>

参数

备注

必选

keywords

查询关键字,只支持一个关键字

city

城市,支持 adcode、citycode
adcode 信息可参考城市编码表获取

返回结果参数说明

关键字搜索的响应结果的格式由请求参数 output 指定。

名称

含义

说明

extensions何值值显示

status

返回结果状态值

值为 0 或 1,0 表示失败;1 表示成功

base/all

info 

返回状态说明

访问状态值的说明,如果成功返回"ok",失败返回错误原因,具体见 错误码说明

base/all 

infocode

返回状态说明

返回状态说明,10000 代表正确,详情参阅 info 状态表

base/all 

buslines

公交路线的集合

base/all 

id

唯一 id

base/all 

type

公交类型

base/all 

name

线路名称

base/all 

polyline

线路的坐标串

base/all 

citycode

城市的 adcode

base/all 

start_stop

始发站

base/all 

end_stop

终点站

base/all 

返回顶部 示例中心 常见问题 智能客服 公众号
二维码