如何用Python结合HERE路径匹配API与OSMnx获取道路属性？

要把带噪声的GPS坐标（元组列表）转换成OSM的U/V节点ID，需按照HERE路径匹配API的要求构造POST请求，核心要点如下：

• 将GPS元组(纬度, 经度)转成API要求的track数组格式，每个元素是{"lat": 纬度值, "lng": 经度值}
• 请求必须携带有效的HERE API密钥，指定transportMode=car（适配车辆行程），并通过attributes=osmid参数要求返回OSM节点ID

完整请求代码示例 #

import requests

# 替换成你的HERE API密钥
API_KEY = "your_here_api_key"
# 你的带噪声GPS坐标元组列表（示例）
gps_coords = [(39.9042, 116.4074), (39.9053, 116.4085), (39.9061, 116.4092)]

# 构造请求体
request_body = {
    "track": [{"lat": lat, "lng": lon} for lat, lon in gps_coords],
    "transportMode": "car",
    "attributes": "osmid",
    # 可选：如果GPS噪声大，扩大匹配半径（单位：米）
    "radius": 200
}

# 发送POST请求
api_url = f"https://router.hereapi.com/v8/match?apiKey={API_KEY}"
response = requests.post(api_url, json=request_body, headers={"Content-Type": "application/json"})

# 解析响应提取U/V ID
if response.status_code == 200:
    match_data = response.json()
    # 取第一个匹配结果（通常是最符合的路径）
    for segment in match_data["matches"][0]["segments"]:
        osm_u_id = segment["start"]["osmid"]
        osm_v_id = segment["end"]["osmid"]
        print(f"匹配路段OSM U ID: {osm_u_id}, V ID: {osm_v_id}")
else:
    print(f"请求失败：状态码{response.status_code}，详情：{response.text}")

常见问题排查 #

• 确认API密钥有权限访问路径匹配API，且未超出调用限额
• 检查GPS坐标顺序：HERE API要求纬度在前，经度在后，不要搞反
• 噪声过大时，调大radius参数，扩大坐标匹配的允许范围

拿到OSM U/V节点ID后，即可通过OSMnx加载对应道路数据，提取所需属性：

示例代码 #

import osmnx as ox

# 替换成你获取的U/V ID对
target_u = 1234567
target_v = 7654321

# 基于GPS大致位置加载车辆可通行道路网
# 这里用起点坐标和距离构建范围，也可以用graph_from_place指定城市/区域
center_point = (39.9042, 116.4074)
road_graph = ox.graph_from_point(center_point, dist=1500, network_type="drive")

# 查找U到V的道路边（OSM道路可能双向存储，需检查两个方向）
edges = ox.utils_graph.get_edges(road_graph, target_u, target_v)
edges = edges.append(ox.utils_graph.get_edges(road_graph, target_v, target_u))

# 提取并打印道路属性
for _, edge in edges.iterrows():
    print(f"道路类型: {edge.get('highway', '未知')}")
    print(f"车道数: {edge.get('lanes', '未知')}")
    print(f"路段长度(米): {edge.get('length', '未知')}")
    print(f"限速: {edge.get('maxspeed', '未知')}\n")

注意事项 #

• 尽量一次性加载较大范围的道路网，避免重复请求OSM数据
• 部分道路属性（如限速、车道数）可能缺失，用get方法并设置默认值避免报错
• 如果需要批量处理多个U/V对，可遍历所有匹配路段，统一处理

内容的提问来源于stack exchange，提问作者Mohammad Oshanreh