可视化车辆续航里程

等值线显示 EV 以其车载能量从给定地点出发可到达的区域。它回答了一个简单的问题：这辆车从这里出发能走多远，并将答案绘制成可放置在地图上的形状。

典型用途包括：以某个城市为中心的续航地图、“我不充电能到那里吗？”的检查，或仅显示车辆实际可到达充电站的筛选。

等值线以真实的道路网络为参照。计算会找出车辆通过道路可到达的最远点，轮廓则将这些点相互连接。结果是一个填充的区域，而不是沿着道路延伸的线，因此道路之间的区域（例如森林或田野）也可能落在其中。河流、山脉、单行系统和路网中的缺口仍会影响轮廓，因为它们决定了道路能让车辆走多远。

工作原理

与路线一样，等值线也以异步方式计算，遵循整个 API 通用的异步模式。创建等值线和获取等值线分为不同的步骤进行。

1. 创建等值线调用 createIsoline 变更，至少提供 vehicle_id 和 origin。该变更会立即返回等值线 id，您将在下一步中使用它。电池电量或天气等可选输入请参阅自定义等值线。
2. 打开订阅使用上一步得到的 id 订阅 isoline 订阅。在等值线计算期间，状态为 pending。可据此在界面中驱动加载状态。
3. 呈现结果当 status 变为 done 或 error 时，呈现相应的界面。状态为 done 的等值线包含要绘制在地图上的 polygons。
4. 按需重新获取已完成的等值线会连同其完整详情一并存储。如需之后再次显示，请使用相同 id 的 isoline 查询，而不是打开新的订阅。

多边形

结果是一个多边形列表。它们共同分步描述了可到达的区域，从靠近起点处一直到车辆可行驶的最远点。

使用 polygon_count 选择获得多少个多边形，最多 20 个。

• 较少的多边形让您得到车辆可达范围的简单、粗略的概览。它们绘制更快，也更便于一目了然地阅读。
• 较多的多边形在起点与最大续航里程之间提供更精细的层级，适用于渐变效果或更详细的续航地图。

每个多边形的 properties 中都有一个 index 用于区分它们，而 maximum_distance 给出从起点到最远可达点的距离。

创建您的第一条等值线

只需 vehicle_id 和 origin 即可创建等值线。此示例还设置了电池电量、多边形数量和天气，以便您了解主要选项是如何配合使用的。

mutation CreateIsoline {  createIsoline(    input: {      vehicle_id: "607823b2c246f9001b97b1a2"      origin: {        type: Feature        geometry: { type: Point, coordinates: [4.895168, 52.370216] }      }      state_of_charge: { value: 80, type: percentage }      polygon_count: 5      weather: { type: winter }    }  )}

该变更会返回等值线 id。将其传给 isoline 订阅，即可跟踪计算进度并接收结果：

subscription Isoline {  isoline(id: "65f1a2b3c4d5e6f7a8b9c0d1") {    id    status    maximum_distance    polygons {      properties {        index      }      geometry {        type        coordinates      }    }  }}

在此请求中：

• state_of_charge 让车辆以 80% 的电量出发。如果不设置，等值线将使用车辆的全部可用电池容量。
• polygon_count 返回五个多边形，从靠近起点处到最大续航里程。
• weather 使用 winter 预设，它假定为寒冷条件，通常得到的可达区域比默认的实时天气更小。

自定义等值线

createIsoline 接受一系列可选输入，用于微调计算。有关每个字段的更多详情，请参阅 API 参考。