免费导航规划API接口详解：调用指南与实战示例

json复制{
  "code": 200,  // 状态码（200成功，400失败）
  "msg": "提示信息",
  "route_summary": {  // 路线概览
    "origin": "起点坐标",
    "destination": "终点坐标",
    "waypoints": [],   // 途经点
    "total_distance_km": 16.25,  // 总距离（公里）
    "total_duration_sec": 1167   // 总耗时（秒）
  },
  "detailed_steps": [  // 详细导航步骤（type=1时返回）
    {
      "step_id": 0,
      "instruction": "导航指令",
      "turn_point": [121.42864, 31.20855]  // 转向点坐标
    }
  ],
  "simplified_steps": [  // 简化导航步骤（type=0时返回）
    {
      "step_id": 0,
      "distance_meters": 526  // 分段距离（米）
    }
  ]
}

bash复制# 基本调用（简略数据）
https://cn.apihz.cn/api/jiaotong/daohang.php?id=88888888&key=your_key&starlon=121.4279&starlat=31.20872&endlon=121.313079&endlat=31.195667

# 带途经点+避开高速
https://cn.apihz.cn/api/jiaotong/...&mid=116.36506,39.91277;116.37506,39.92077&linetype=2

php复制<?php
$url = "https://cn.apihz.cn/api/jiaotong/daohang.php";
$params = [
    'id' => '10000000',        // 替换为您的ID
    'key' => 'your_key',       // 替换为您的KEY
    'starlon' => 121.4279,
    'starlat' => 31.20872,
    'endlon' => 121.313079,
    'endlat' => 31.195667,
    'linetype' => 0,           // 用时最少
    'type' => 0                // 简略数据
];

// 构建GET请求URL
$requestUrl = $url . '?' . http_build_query($params);

// 发送请求
$response = file_get_contents($requestUrl);
$data = json_decode($response, true);

// 处理结果
if ($data['code'] == 200) {
    echo "总距离：" . $data['route_summary']['total_distance_km'] . "公里";
} else {
    echo "错误：" . $data['msg'];
}
?>

python运行复制import requests

url = "https://cn.apihz.cn/api/jiaotong/daohang.php"
params = {
    "id": "10000000",       # 替换为您的ID
    "key": "your_key",      # 替换为您的KEY
    "starlon": 121.4279,
    "starlat": 31.20872,
    "endlon": 121.313079,
    "endlat": 31.195667,
    "linetype": 3,          # 步行导航
    "type": 0               # 简略数据
}

# 发送GET请求
response = requests.get(url, params=params)
data = response.json()

if data["code"] == 200:
    steps = data["simplified_steps"]
    for step in steps:
        print(f"步骤{step['step_id']}: {step['instruction']} ({step['distance_meters']}米)")
else:
    print("请求失败:", data["msg"])