路线路径

routePath

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

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

旧版	新版
`routePath`	`getRoute`

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

路线的路径现在已作为 recommended.path_plot 包含在 getRoute 响应中，因此不再需要单独的查询来获取它。

使用 routePath 查询获取先前计算的路线的路径。当您想在地图上渲染路线的折线时，此操作非常有用。

id· ID· required

ID of a route that you require for a route path segment

location· PointInput· required

The GeoJSON Point of a route path segment

alternativeId· ID

Optional alternative ID. By default we will retrieve the fastest route

location· Point

GeoJSON location of a route path segment.

elevation· Int

Elevation (altitude) in meters.

averageSpeed· Float

Average speed, in km/h, for this route path segment.

recommendedSpeed· Float

Recommended speed, in km/h for this route path segment to optimise the consumption.

consumption· Float

Consumption, in kWh, of a route path segment.

consumptionPerKm· Float

Consumption, in kWh per km, of a route path segment.

distance· Float

Distance, in meters, of a route path segment.

duration· Float

Duration, in seconds, of a route path segment.

stateOfCharge· Float

State of charge, in kWh, of a route path segment.

操作可能会失败。请考虑以下错误场景以正确处理。有关错误的更多信息 here.

error_forbidden_message: You are forbidden to execute this operation.
operation_not_allowed: You are not allowed to execute this operation. Enable it for the current application in the dashboard or reach out to customer support.
rate_limit_exceeded: Rate limit exceeded.
route_invalid_safe_risk_margin: Safe risk margin needs to be a value between 0 and 60.
route_not_found: No route was found with the provided ID.
route_path_invalid_point_coordinates: The coordinates provided are not valid.
route_path_location_not_found: No location was found with the provided input.
route_path_not_found: No route path was found with the provided ID or alternative ID.

此内容是否有帮助？