就近绑路
2021年04月12日

接口描述

请求路径:https://mapapi-routes.apigw-gz.didiyunapi.com/api/v1/nearestroads

请求方法:GET Content-Type=application/json

输入参数

参数名称 类型 必选 默认值 描述
points array<Points> 路线坐标点串,最多支持20个点

Points:

参数名称 类型 必选 默认值 描述
longitude float 经度,建议小数点不超过6位
latitude float 纬度,建议小数点不超过6位
radius int 10 搜索半径,0-1000米
road_levels array 道路等级,支持多个值,暂不支持此字段
road_func_classes array 道路功能等级,支持多个值,暂不支持此字段

输出参数

参数名称 类型 描述
status int 状态码
info string 状态说明
result Result 请求返回数据

Result:

参数名称 类型 描述
distance int 结果条数
points array<Points> 点json数组

Pois:

参数名称 类型 描述
longitude float 经度,建议小数点不超过6位
latitude float 纬度,建议小数点不超过6位

错误码

错误码

示例

请求:

  curl  -X GET 'https://mapapi-routes.apigw-gz.didiyunapi.com/api/v1/nearestroads' \
  --header 'Authorization: AppCode XXX' \
  --header 'Content-Type: application/json' \
  --data '{
   "points": [
       {"longitude": 116.454286, "latitude": 39.941051},
       {"longitude": 116.45402, "latitude": 39.94062}
   ]
}'

输出:

{
    "status":0,
    "info":"OK",
    "result":{
        "points":[
            [
                {
                    "longitude":116.45377,
                    "latitude":39.94113
                },
                {
                    "longitude":116.45424,
                    "latitude":39.94113
                },
                {
                    "longitude":116.45449,
                    "latitude":39.94113
                }
            ],
            [
                {
                    "longitude":116.45402,
                    "latitude":39.94062
                },
                {
                    "longitude":116.4543,
                    "latitude":39.94058
                },
                {
                    "longitude":116.45441,
                    "latitude":39.94051
                },
                {
                    "longitude":116.45443,
                    "latitude":39.94039
                },
                {
                    "longitude":116.45437,
                    "latitude":39.93978
                },
                {
                    "longitude":116.45433,
                    "latitude":39.9397
                },
                {
                    "longitude":116.45428,
                    "latitude":39.93965
                },
                {
                    "longitude":116.45416,
                    "latitude":39.93962
                },
                {
                    "longitude":116.45416,
                    "latitude":39.93962
                },
                {
                    "longitude":116.45428,
                    "latitude":39.93965
                },
                {
                    "longitude":116.45433,
                    "latitude":39.9397
                },
                {
                    "longitude":116.45437,
                    "latitude":39.93978
                },
                {
                    "longitude":116.45443,
                    "latitude":39.94039
                },
                {
                    "longitude":116.45441,
                    "latitude":39.94051
                },
                {
                    "longitude":116.4543,
                    "latitude":39.94058
                },
                {
                    "longitude":116.45402,
                    "latitude":39.94062
                },
                {
                    "longitude":116.45153,
                    "latitude":39.9406
                },
                {
                    "longitude":116.45211,
                    "latitude":39.94063
                },
                {
                    "longitude":116.45319,
                    "latitude":39.94061
                },
                {
                    "longitude":116.45402,
                    "latitude":39.94062
                },
                {
                    "longitude":116.45402,
                    "latitude":39.94062
                },
                {
                    "longitude":116.45319,
                    "latitude":39.94061
                },
                {
                    "longitude":116.45211,
                    "latitude":39.94063
                },
                {
                    "longitude":116.45153,
                    "latitude":39.9406
                }
            ]
        ]
    }
}

项搜索结果

    空空如也
    没有找到您要搜索的内容,请直接拨打服务热线400-0590-666