高德地图 API
  1. 路径规划
高德地图 API
  • 概述
  • 入门指南
  • 开发指南
    • 获取Key
    • 错误码说明
    • 流量限制说明
    • 天气对照表
    • 更新日志
    • 相关下载
    • 路径规划
      • 概述
      • 步行路径规划
        GET
      • 公交路径规划
        GET
      • 骑行路径规划
        GET
      • 驾车路径规划
        GET
      • 未来路径规划
        GET
      • 距离测量
        GET
    • 路径规划2.0
      • 概述
      • 驾车路线规划
      • 步行路线规划
      • 骑行路线规划
      • 电动车路线规划
      • 公交路线规划
    • 行政区域查询
      • 概述
      • 行政区域查询
    • 地理/逆地理编码
      • 地理编码
      • 逆地理编码
    • 搜索POI
      • 概述
      • 关键字搜索
      • 周边搜索
      • 多边形搜索
      • ID查询
      • AOI边界查询
    • 搜索POI 2.0
      • 概述
      • 关键字搜索
      • 周边搜索
      • 多边形区域搜索
      • ID搜索
    • 交通事件
      • 概述
      • 交通事件查询
    • IP定位
      • 概述
      • IP定位
    • 静态地图
      • 概述
      • 请求参数及用法
    • 坐标转换
      • 概述
      • 坐标转换
    • 天气查询
      • 概述
      • 天气查询
    • 输入提示
      • 概述
      • 输入提示
    • 交通态势
      • 概述
      • 矩形区域交通态势
      • 圆形区域交通态势
      • 指定线路交通态势
    • 轨迹纠偏
      • 概述
      • 轨迹纠偏
    • 三方数据空间检索接口
      • 概述
      • 关键字搜索
      • 多边形搜索
      • 周边搜索
      • 属性筛选
  1. 路径规划

公交路径规划

GET
https://restapi.amap.com/v3/direction/transit/integrated
接口简介:
公交路径规划 API 可以规划综合各类公共(火车、公交、地铁)交通方式的通勤方案,并且返回通勤方案的数据。
parameters 代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。
步行方案信息列表
名称含义规则说明
origin起点坐标
destination终点坐标
distance每段线路步行距离单位:米
duration步行预计时间单位:秒
steps步行路段列表
instruction此段路的行走介绍
road路的名字
distance此段路的距离
duration此段路预计消耗时间单位:秒
polyline此段路的坐标
action步行主要动作
assistant_action步行辅助动作
公交方案信息列表
名称含义规则说明
buslines步行路段列表
departure_stop此段起乘站信息格式如:中关村
name站点名字
id站点id
location站点经纬度
arrival_stop此段下车站格式如:中关村
name站点名字
id站点id
location站点经纬度
name公交路线名称格式如:445路(南十里居--地铁望京西站)
id公交路线id
type公交类型格式如:地铁线路
distance公交行驶距离单位:米
duration公交预计行驶时间单位:秒
polyline此路段坐标集格式为坐标串,如:116.481247,39.990704;116.481270,39.990726
start_time首班车时间格式如:0600,代表06:00
end_time末班车时间格式如:2300,代表23:00
via_num此段途经公交站数
via_stops此段途经公交站点列表
name途径公交站点信息
id公交站点编号
location公交站点经纬度
出入口信息列表
name入口名称
location入口经纬度
火车换乘信息列表
名称说明
id线路id编号
time该线路车段耗时
name线路名称
trip线路车次号
distance该item换乘段的行车总距离
type线路车次类型
departure_stop火车始发站信息
id上车站点ID
name上车站点名称
location上车站点经纬度
adcode上车站点所在城市的adcode
time上车点发车时间
start是否始发站,1表示为始发站,0表示非始发站
arrival_stop火车到站信息
id下车站点ID
name下车站点名称
location下车站点经纬度
adcode下车站点所在城市的adcode
time到站时间,如大于24:00,则表示跨天
end是否为终点站,1表示为终点站,0表示非终点站
via_stop途径站点信息,extensions=all时返回
name途径站点的名称
id途径站点的ID
location途径站点的坐标点
time途径站点的进站时间,如大于24:00,则表示跨天
wait途径站点的停靠时间,单位:分钟
alters聚合的备选方案,extensions=all时返回
id备选方案ID
name备选线路名称
spaces仓位及价格信息
code仓位编码
cost仓位费用
火车路线类型表
线路类型代码公共交通工具备注线路类型代码公共交通工具备注
2010普客火车2015T字头的特快火车
2011G字头的高铁火车2016K字头的快车火车
2012D字头的动车火车2017L字头,Y字头的临时火车
2013C字头的城际火车2018S字头的郊区线火车
2014Z字头的直达特快火车
仓位级别表
仓位级别仓位备注仓位级别仓位备注
0不分仓位级别20火车高级软卧下铺
9特等座21火车商务座
10火车硬座22长途汽车座席
11火车软座23长途汽车卧席上铺
12火车软座1等座24长途汽车卧席中铺
13火车软座2等座25长途汽车卧席下铺
14火车硬卧上铺30飞机经济舱
15火车硬卧中铺31飞机商务舱
16火车硬卧下铺40客轮经济舱
17火车软卧上铺41客轮3等舱
18火车软卧下铺42客轮2等舱
19火车高级软卧上铺43客轮豪华舱
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://restapi.amap.com/v3/direction/transit/integrated?origin&destination&city&Key='
响应示例响应示例
{
    "status": "1",
    "info": "OK",
    "infocode": "10000",
    "count": "5",
    "route": {
        "origin": "116.481028,39.989643",
        "destination": "116.434446,39.90816",
        "distance": "14248",
        "taxi_cost": "39",
        "transits": [
            {
                "cost": "5.0",
                "duration": "2695",
                "nightflag": "0",
                "walking_distance": "1326",
                "distance": "14184",
                "missed": "0",
                "segments": [
                    {
                        "taxi": [],
                        "walking": {
                            "origin": "116.480888,39.989372",
                            "destination": "116.481880,39.984676",
                            "distance": "795",
                            "duration": "681",
                            "steps": [
                                {
                                    "instruction": "步行16米左转",
                                    "road": [],
                                    "distance": "16",
                                    "duration": [],
                                    "polyline": "116.480888,39.989372;116.480904,39.989353;116.480888,39.989227",
                                    "action": "左转",
                                    "assistant_action": []
                                },
                                {
                                    "instruction": "步行59米右转",
                                    "road": [],
                                    "distance": "59",
                                    "duration": [],
                                    "polyline": "116.480888,39.989223;116.480934,39.989201;116.480957,39.989185;116.481155,39.989059;116.481430,39.988880",
                                    "action": "右转",
                                    "assistant_action": []
                                },
                                {
                                    "instruction": "步行202米右转",
                                    "road": [],
                                    "distance": "202",
                                    "duration": [],
                                    "polyline": "116.481430,39.988876;116.481377,39.988808;116.481308,39.988720;116.481270,39.988636;116.481201,39.988499;116.481194,39.988468;116.481163,39.988415;116.480080,39.987389",
                                    "action": "右转",
                                    "assistant_action": []
                                },
                                {
                                    "instruction": "步行96米左转",
                                    "road": [],
                                    "distance": "96",
                                    "duration": [],
                                    "polyline": "116.480080,39.987381;116.479889,39.987400;116.479843,39.987408;116.479820,39.987423;116.479790,39.987442;116.479645,39.987556;116.479591,39.987583;116.479568,39.987587;116.479561,39.987587;116.479370,39.987408;116.479218,39.987278",
                                    "action": "左转",
                                    "assistant_action": []
                                },
                                {
                                    "instruction": "步行29米右转",
                                    "road": [],
                                    "distance": "29",
                                    "duration": [],
                                    "polyline": "116.479218,39.987274;116.479301,39.987240;116.479362,39.987202;116.479385,39.987175;116.479477,39.987110",
                                    "action": "右转",
                                    "assistant_action": []
                                },
                                {
                                    "instruction": "步行19米左转",
                                    "road": [],
                                    "distance": "19",
                                    "duration": [],
                                    "polyline": "116.479477,39.987106;116.479393,39.986946",
                                    "action": "左转",
                                    "assistant_action": []
                                },
                                {
                                    "instruction": "步行100米向左后方行走",
                                    "road": [],
                                    "distance": "100",
                                    "duration": [],
                                    "polyline": "116.479393,39.986938;116.479607,39.986801;116.479897,39.986607;116.480019,39.986519;116.480064,39.986485;116.480293,39.986328",
                                    "action": "向左后方行走",
                                    "assistant_action": []
                                },
                                {
                                    "instruction": "步行274米到达望京南",
                                    "road"

请求参数

Query 参数
parameters
string 
可选
origin
string 
必需
规则: lon,lat(经度,纬度), “,”分割,如117.500244, 40.417801 经纬度小数点不超过6位
destination
string 
必需
规则: lon,lat(经度,纬度), “,”分割,如117.500244, 40.417801 经纬度小数点不超过6位
city
string 
必需
目前支持市内公交换乘/跨城公交的起点城市。 可选值:城市名称/citycode
cityd
string 
可选
跨城公交规划必填参数。 可选值:城市名称/citycode
extensions
string 
可选
可选值:base(default)/all base:返回基本信息;all:返回全部信息
示例值:
base
strategy
string 
可选
可选值: 0:最快捷模式 1:最经济模式 2:最少换乘模式 3:最少步行模式 5:不乘地铁模式
nightflag
string 
可选
可选值:0:不计算夜班车 1:计算夜班车
date
string 
可选
根据出发时间和日期,筛选可乘坐的公交路线,格式示例:date=2014-3-19。在无需设置预计出发时间时,请不要在请求之中携带此参数。
time
string 
可选
根据出发时间和日期,筛选可乘坐的公交路线,格式示例:time=22:34。在无需设置预计出发时间时,请不要在请求之中携带此参数。
sig
string 
可选
数字签名获取和使用方法
output
string 
可选
可选值:JSON,XML
示例值:
JSON
callback
string 
可选
callback值是用户定义的函数名称,此参数只在output=JSON时有效
Key
string 
必需
用户在高德地图官网申请Web服务API类型Key
默认值:
{{Key}}

返回响应

🟢200成功
application/json
Body
status
string 
返回状态
必需
值为0或1 1:成功;0:失败
info
string 
返回的状态信息
必需
status为0时,info返回错误原;否则返回“OK”。详情参阅info状态表
infocode
string 
必需
count
string 
公交换乘方案数目
必需
route
object 
公交换乘信息列表
必需
origin
string 
起点坐标
必需
destination
string 
终点坐标
必需
distance
string 
起点和终点的步行距离
必需
单位:米
taxi_cost
string 
出租车费用
必需
单位:元
transits
array [object {7}] 
公交换乘方案列表
必需

【高德地图】API开发者 微信交流群

用微信扫右侧二维码,加入【高德地图】API开发者 交流群,互助沟通

扫码加入交流群
修改于 2022-12-13 06:56:54
上一页
步行路径规划
下一页
骑行路径规划
Built with