WebService API
    开发指南
示例中心
  • 更新日志
    • 常见问题
    WebService API
    开发指南
    室内服务
    室内外一体化步行路线规划

    概述

    提供室内外步行路线计算能力，支持基于起、终点的室内外步行路径规划。

    注：
    本服务属于高级付费服务，如需试用请提交商务合作开通服务试用。

    请求URL

    该请求为GET请求

    https://apis.map.qq.com/ws/indoor/direction/walking
    Method：GET

    请求参数

    参数 必填 类型 说明 示例
    key 是 string 开发密钥（Key） key=OB4BZ-D4W3U-***
    from 是 string 起点
    from(lat<纬度，必填>,lng<经度，必填>,buildingID<室内建筑唯一标识，室内点必填>)，floorName<楼层，室内点必填>，poiName<点位名称，非必填>）    		 from=39.85587320963542,116.6810045030382,4401000195,4
    to 是 string 终点
    to(lat<纬度，必填>,lng<经度，必填>,buildingID<室内建筑唯一标识，室内点必填>)，floorName<楼层，室内点必填>，poiName<点位名称，非必填>）    		 to=39.85597162839535,116.68059291079602
    policy 否 number 步行路线偏好设置（默认为1）：
    1.推荐
    2.扶梯优先
    3.直梯优先
    4.楼梯优先    		 policy=1
    output 否 string 返回格式：支持JSON/JSONP，默认JSON output=json

    响应结果

    名称 类型 必有 说明
    status number 是 状态码，0为正常，其它为异常，详细请参阅状态码说明
    message string 是 状态说明
    result object 是 结果
    routes array 是 路线结果集合
    mode string 是 交通方式，固定值：WALKING
    distance number 是 路线总距离，单位：米
    duration number 是 路线的总时长，单位：分钟
    kcal number 否 估算整体消耗卡路里，单位：千卡
    polyline array 是 方案路线坐标点串（该点串经过压缩，解压请参考：polyline 坐标解压）
    steps array 是 路线步骤
    instruction string 是 阶段路线描述
    polyline_idx array 是 阶段路线坐标点串在方案路线坐标点串的位置
    road_name string 否 阶段路线路名
    dir_desc string 否 阶段路线方向
    distance number 是 阶段路线距离，单位：米
    act_desc string 否 阶段路线末尾动作
    building_id string 否 室内建筑物唯一标识
    start_floor_name string 否 起点楼层名称
    end_floor_name string 否 终点楼层名称
    connection_type number 否 连接类型：
    0：普通道路
    1：电梯
    2：扶梯
    3：直梯_客梯
    4：直梯_货梯
    5：楼梯
    6：内部楼梯
    7：链接两个building的虚线
    land_markers array 否 室内标记点数据
    act_type number 否 下一个机动链接类型
    door string 否 出入口门
    building_id string 否 出入口门对应建筑物ID
    building_name string 否 出入口门对应建筑物名称
    floor_name string 否 门对应楼层信息
    name string 否 出入口门名称
    x string 否 出入口门对应纬度
    y string 否 出入口门对应经度

    阶段路线方向（dir_desc）列表

    • 东
    • 东北
    • 北
    • 西北
    • 西
    • 西南
    • 南
    • 东南
    • “” 空（为空时，代表导航段有转弯且方向发生变化）

    阶段路线末尾动作（act_desc）列表

    • 左转
    • 右转
    • 偏左转
    • 偏右转
    • 左后转
    • 右后转
    • 左转掉头
    • 直行
    • 靠左
    • 靠右
    • 进入环岛
    • 空

    下一个机动链接类型（act_type）列表

    • 0: 表示无机动连接类型
    • 1: 表示直行
    • 2: 表示左前方转弯
    • 3: 表示左转
    • 4: 表示左后方转弯
    • 5: 表示掉头
    • 6: 表示右后方转弯
    • 7: 表示右转
    • 8: 表示右前方转弯
    • 9: 表示电梯
    • 10: 表示扶梯
    • 11: 表示客梯
    • 12: 表示货梯
    • 13: 表示楼梯
    • 14: 表示跨楼虚线
    • 15: 表示空中走廊

    调用示例

    // GET请求，注意参数值要进行URL编码
    https://apis.map.qq.com/ws/indoor/direction/walking?key=QRUBZ*********KOBFT&to=39.85597162839535,116.68059291079602&from=39.85587320963542,116.6810045030382

    响应示例

    {
    "status": 0,
    "message": "query ok",
    "result": {
        "routes": [
            {
                "mode": "WALKING",
                "distance": 31,
                "duration": 0,
                "kcal": 1,
                "polyline": [
                    39.855848,
                    116.680971,
                    192,
                    -243,
                    0,
                    0,
                    9,
                    -9
                ],
                "steps": [
                    {
                        "instruction": "从起点朝西北,行进31米,到达终点",
                        "polyline_idx": [
                            0,
                            7
                        ],
                        "road_name": "",
                        "dir_desc": "西北",
                        "distance": 31,
                        "act_desc": "",
                        "building_id": "",
                        "start_floor_name": "",
                        "end_floor_name": "",
                        "connection_type": 0,
                        "land_markers": [],
                        "door": {
                            "building_id": "",
                            "builidng_name": "",
                            "floor_name": "",
                            "name": "",
                            "x": "",
                            "y": ""
                        }
                    }
                ]
            }
        ]
    }
}

    本页内容