WebService API
    开发指南
示例中心
  • 更新日志
    • 常见问题
    WebService API
    开发指南
    路线服务
    等时等距可达圈

    概述

    等时等距可达圈服务，是通过起点坐标，根据指定路面距离或时间，结合街区面生成可达范围的服务，服务具备以下特点：
    1.支持驾车、电动自行车（即将开放）、自行车、公交车、步行多种交通方式。
    2.支持指定时间计算可达范围
    3.支持指定距离计算可达范围
    4.驾车方式支持针对节假日与工作日的路况特点分别计算到可达范围

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

    请求URL

    URL: https://apis.map.qq.com/ws/travel_range/v2/
    Method: POST
    Header: Content-Type:application/json

    请求参数

    参数 类型 必填 说明
    key string 是 开发秘钥
    mode string 是 出行方式：driving 驾车 walking 步行 bicycling 骑行 transit 公交
    location object 是 中心点坐标（等时等距出发点）
    lat number 是 纬度
    lng number 是 经度
    day_type number 否 工作日或节假日
    0 [默认]工作日
    1 节假日（只对汽车、公交有效）
    distance number 是 路面距离，按此距离生成可达范围
    单位：米，取值范围：50 - 30000（与duration二选一）
    duration number 是 耗时，按次时间生成可达范围
    单位：分钟 取值范围：10 - 60 （与distance二选一）

    响应结果

    名称 类型 必有 说明
    status number 是 状态码，0为正常，其它为异常，详细请参阅状态码说明
    message string 是 对status的描述
    result object 是 计算结果
    geometry array 是 可达圈范围
    type string 是 数据类型，取值：Polygon、MultiPolygon
    不同的类型对应的coordinates字段返回结构不一样,详见coordinates字段说明
    coordinates array 是 经纬度坐标信息，不同类型的type返回的结构有差异
    Polygon：[[[lng,lat],[lng,lat],…]]
    MultiPolygon：[[[[lng,lat],[lng,lat],…]],[[[lng,lat],[lng,lat],…]],…]

    调用示例

    {
    "key": "您的KEY",
    "mode": "walking",
    "location": {
        "lat": 39.984059,
        "lng": 116.307492
    },
    "distance": 2000
}

    响应示例

    {
    "status": 0,
    "message": "query ok",
    "request_id": "2b29292a8b592d5a22deb5f2b1670e",
    "result": {
        "geometry": { //可达圈计算结果，为GEOJSON格式
            "type": "Polygon",
            "coordinates": [
                [
                    [
                        116.281056,
                        39.990347
                    ],
                    [
                        116.292157,
                        39.990159
                    ],
                    [
                        116.292778,
                        39.990812
                    ]
                ]
            ]
        }
    }
}

    前往示例中心 在线体验 ➤

    本页内容