创建路线

迁移截止时间：2027 年第一季度

从旧版路线服务迁移到最新版本。新服务提供了重新组织的 schema、按国家设置的运营商偏好、更快的路线计算以及更好的可维护性。

操作

通用 schema 变更

• 显式类型：以前灵活的 JSON 字段现在在 schema 中有了明确的类型，以改进结构和验证。
• 命名约定：字段现在使用 snake_case，而不是 camelCase。
• 单位支持：数值输入现在支持不同的单位类型，以包含 value、type 和可选 source（manual、telemetry 或 default）的对象表示。

Mutation 变更

createRoute 上的 input 参数已被重新组织并简化。

routeRequest

在根层级，以下字段已被移除。与运营商相关的字段现在由运营商偏好涵盖，与设施相关的字段已移至其专用的设施查询。

EV

在 EV 层级，大多数顶层字段已移入专用的 vehicle 对象。

车辆负载

车辆负载属性不再在单一位置设置。现在它们按每个 origin 和 via 点分别指定，从而可以按路段更精细地控制乘员和载货重量。它们位于每个位置的 properties.vehicle 下，字段名称变更如下：

遥测

以下遥测数据已从根层级移入 vehicle 对象。

重点变更

input 参数上的一些字段现在具有新的、结构更清晰的形态。下文将更详细地介绍。

运营商偏好

运营商偏好被简化为三个级别：high、medium 和 low。每个条目（无论是排名、排除还是避开）都可以通过 countries 字段限定到特定国家。如果省略，则会考虑所有国家。

input: {  operators: {    ranking: {      type: preferred      levels: {        high: [          {            id: "op1"            countries: [NL]          }        ]        low: [          {            id: "op3"          }        ]      }    }  }}

乘员总重量

新的 total_occupant_weight 字段允许您覆盖默认的乘员重量，使用新的单位对象表示。

input: {  origin: {    properties: {      vehicle: {        occupants: 3        total_occupant_weight: {          value: 160          type: kilogram          source: manual        }      }    }  }}