OpenRouteService API文档中WayCategory示例错误修正

在OpenRouteService方向服务API文档中，关于额外信息(extra-info)中道路类别(WayCategory)的说明部分存在一个示例错误。本文将详细解析该问题并提供正确的技术说明。

问题背景

OpenRouteService的方向服务API提供了一个extra-info参数，允许用户请求额外的道路信息。其中，WayCategory用于标识道路的类型特征，采用位掩码(bitmask)方式表示多种道路属性的组合。

错误内容

文档中给出的示例存在技术性错误：

"一个值为97的WayCategory表示属于Paved road(64)、Tunnel(32)和Highway(1)的组合(64 + 32 + 1)"

问题在于"Tunnel"并不是一个有效的WayCategory类别，这会导致开发者误解API的实际行为。

正确的WayCategory位掩码值

OpenRouteService实际支持的WayCategory位掩码值如下：

1. Highway (1)
2. Steps (2)
3. Ferry (4)
4. Unpaved road (8)
5. Track (16)
6. 保留值(文档错误地标记为Tunnel)
7. Paved road (64)

正确示例解析

因此，值97的正确解释应该是：

• 64 (Paved road)
• 32 (当前保留未使用)
• 1 (Highway)

但需要注意32这个位当前没有实际意义，不应该被解释为任何特定道路类型。

开发者建议

在使用WayCategory时，开发者应当：

1. 只使用文档中明确列出的有效类别
2. 注意位掩码的组合计算方式
3. 避免对保留位(如32)做出任何功能性假设
4. 查阅最新API文档确认有效值

结论

API文档的准确性对开发者体验至关重要。OpenRouteService团队已经及时修正了这个文档错误，确保开发者能够正确理解和使用WayCategory参数。对于类似位掩码参数，建议开发者仔细核对每个位的实际含义，避免因文档示例错误导致实现偏差。