# @geoapify/route-planner-sdk 中文文档

规范地址：https://npmcn.com/package/%40geoapify/route-planner-sdk/

版本：2\.0\.0
npm 元数据更新时间：2026-03-30T12:20:15.756Z
中文译文更新时间：2026-11-16T04:24:29.413Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40geoapify/route-planner-sdk
原文对照：https://npmcn.com/package/%40geoapify/route-planner-sdk/?lang=original
项目主页：https://geoapify.github.io/route-planner-sdk/
源码仓库：https://github.com/geoapify/route-planner-sdk

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：2.2 MB，212 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2025-03-24T08:47:51.085Z
- 最新版本发布：2026-03-30T12:20:15.644Z
- 近 30 天下载量：2515（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：26（近 12 个月 1 个）

## 中文简介

TypeScript SDK for the Geoapify Route Planner API. 互联网档案馆的存檔,存档日期2013-10-02. 支持浏览器和节点.js中的路由优化、交付规划和时间表可视化

## 安装

```sh
npm install @geoapify/route-planner-sdk
```

也可以使用：`pnpm add @geoapify/route-planner-sdk`、`yarn add @geoapify/route-planner-sdk`、`bun add @geoapify/route-planner-sdk`

## README

# 地理化路线优化 SDK

[![Docs](https://img.shields.io/badge/Docs-View%20Documentation-blue)](https://geoapify.github.io/route-planner-sdk/) [![npm version](https://img.shields.io/npm/v/@geoapify/route-planner-sdk)](https://www.npmjs.com/package/@geoapify/route-planner-sdk) [![MIT License](https://img.shields.io/badge/license-MIT-green.svg)](https://npmcn.com/package/%40geoapify/route-planner-sdk/LICENSE) [![Migration V1→V2](https://img.shields.io/badge/Migration-V1%E2%86%92V2-orange)](https://geoapify.github.io/route-planner-sdk/migration-from-v1/)

这个 **地理化路线优化 SDK** 是一个轻量级、无依赖性 TypeScript 库,用于简化构建、执行请求并修改结果 [地理化路线规划器 API](https://www.geoapify.com/route-planner-api/)。它帮助您轻松地执行高级 **路线优化** 以及前端(浏览器)和后端(节点.js)环境中的交付规划.

> 移徙说明:采用V2时改进了方法签名并扩大了路由编辑能力.  
> 如果您正在从 V1 升级, 请遵循迁移指南 :  
> [从V1到V2的迁移](https://geoapify.github.io/route-planner-sdk/migration-from-v1/)

![Delivery Routes Optimization](https://github.com/geoapify/route-planner-sdk/blob/main/img/delivery-routes-optimization.png?raw=true)

## 目录

-   [特征](https://npmcn.com/package/%40geoapify/route-planner-sdk/#readme-features)
-   [安装](https://npmcn.com/package/%40geoapify/route-planner-sdk/#readme-installation)
-   [快速启动](https://npmcn.com/package/%40geoapify/route-planner-sdk/#readme-quick-start)
    -   [获取 API 密钥](https://npmcn.com/package/%40geoapify/route-planner-sdk/#readme-getting-api-key)
    -   [导入 SDK](https://npmcn.com/package/%40geoapify/route-planner-sdk/#readme-import-the-sdk)
    -   [示例: 创建发货/ 交付任务](https://npmcn.com/package/%40geoapify/route-planner-sdk/#readme-example-create-shipment--delivery-task)
    -   [示例:创建工作优化任务](https://npmcn.com/package/%40geoapify/route-planner-sdk/#readme-example-create-job-optimization-task)
-   [完整文档](https://npmcn.com/package/%40geoapify/route-planner-sdk/#readme-full-documentation)
-   [修改路由结果](https://npmcn.com/package/%40geoapify/route-planner-sdk/#readme-modifying-route-results)
    -   [示例: 指派任务给代理](https://npmcn.com/package/%40geoapify/route-planner-sdk/#readme-example-assign-jobs-to-the-agent)
    -   [示例:向代理人转让货物](https://npmcn.com/package/%40geoapify/route-planner-sdk/#readme-example-assign-shipments-to-the-agent)
    -   [示例: 删除工作](https://npmcn.com/package/%40geoapify/route-planner-sdk/#readme-example-remove-jobs)
    -   [示例: 删除货运](https://npmcn.com/package/%40geoapify/route-planner-sdk/#readme-example-remove-shipments)
    -   [示例:添加新工作](https://npmcn.com/package/%40geoapify/route-planner-sdk/#readme-example-add-new-jobs)
    -   [示例:添加新发货](https://npmcn.com/package/%40geoapify/route-planner-sdk/#readme-example-add-new-shipments)
-   [时间线生成](https://npmcn.com/package/%40geoapify/route-planner-sdk/#readme-timeline-generation)
    -   [示例: 生成没有 Waypoint 的占位符时间线](https://npmcn.com/package/%40geoapify/route-planner-sdk/#readme-example-generate-placeholder-timeline-without-waypoints)
    -   [示例: 以优化路线生成时间线](https://npmcn.com/package/%40geoapify/route-planner-sdk/#readme-example-generate-timeline-with-optimized-routes)
    -   [示例:带有自定义弹出和代理动作的时间线](https://npmcn.com/package/%40geoapify/route-planner-sdk/#readme-example-timeline-with-custom-popup-and-agent-actions)
    -   [时间线设置要求](https://npmcn.com/package/%40geoapify/route-planner-sdk/#readme-timeline-setup-requirements)
-   [有用链接](https://npmcn.com/package/%40geoapify/route-planner-sdk/#readme-useful-links)
-   [何时使用](https://npmcn.com/package/%40geoapify/route-planner-sdk/#readme-when-to-use)

## 特征

Geoapify Route Optimation SDK提供了一种现代的,无依赖性的方法,可以与Geoapify Route Optimation SDK进行互动 [地理化路线规划器 API](https://apidocs.geoapify.com/docs/route-planner/),使得在浏览器和后端环境都易于执行复杂的物流工作流程.

**支持使用实例**数字 :

-   路线优化
-   交付规划
-   接发/投放时间表
-   时间限制和多代理后勤

**开发者方便**数字 :

-   构建和发送优化请求
-   解释结果(如代理时限、任务序列)
-   重新分派工作或代理人之间的货物
-   动态修改计划路线

**可视化支持**数字 :

-   提取每个代理人的结构化时间表和状态数据
-   使用图表分析并显示路线和时间表

### 路由编辑能力

| 人能读取的行动 | 编辑器方法 | 典型使用案例 |
| --- | --- | --- |
| 将已有任务移至其他代理 | `assignJobs()` | 
-   司机请病假,必须重新安排工作.
-   紧急工作被转移到附近的一个特工.
-   白天的工作负荷由两个代理人平衡.
-   调度器在优化后应用手动覆盖.

 |
| 将已有的运出( 提取+ 交付) 移至另一个代理 | `assignShipments()` | 

-   车辆延误时重新下达全程订单.
-   将体温敏感的货物运入装备齐全的车辆.
-   从线路中断中恢复.

 |
| 从活动计划中删除工作 | `removeJobs()` | 

-   客户取消预约.
-   停站延期至第二天.

 |
| 从现行计划中去除货运 | `removeShipments()` | 

-   规划后取消秩序 .
-   接车还没准备好.
-   货运被移至后一批.

 |
| 在现有路由中添加新任务 | `addNewJobs()` | 

-   同日点播请求到来.
-   调度员创建人工任务.
-   检查/服务站改为中班.

 |
| 在现有路由中添加新货运 | `addNewShipments()` | 

-   新接车+落地请求生效.
-   优先排序被插入到运行中的路由中.

 |
| 路径点后添加或删除调度延迟 | `addDelayAfterWaypoint()` | 

-   交通堵塞造成线路延误.
-   装入码头队列增加了等待时间 .
-   服务完成时间早于预期(负延迟).

 |
| 手动重排一个路由中的一站 | `moveWaypoint()` | 

-   调度员拖放重排.
-   早点把要人停站列为优先事项.

 |
| 重新优化一个代理路线 | `reoptimizeAgentPlan()` | 

-   在许多手动编辑后清理路由 .
-   包含一个代理的未指定任务 .
-   运行严格的再优化 `allowViolations: false`。 。 。 .
-   运行轻松的再优化 `allowViolations: true`。 。 。 .

 |
| 读取当前已编辑快照 | `getModifiedResult()` | 

-   坚持不懈地编辑计划.
-   每次编辑后修改地图/时间线.
-   在 UI 中执行撤销/重写历史 .

 |

## 安装

从国家预防机制安装 SDK:

```bash
npm install @geoapify/route-planner-sdk
```

## 快速启动

### 获取 API 密钥

要使用路由优化 SDK, 您需要有效的 **地理化 API 密钥**。 。 。 .

1.  转到 [地理化页面](https://www.geoapify.com/)。 。 。 .
2.  注册一个Geoapify账户。 不需要信用卡.
3.  使用默认创建的或创建新的 API 密钥 .

你可以从 **免费计划** 包括适合测试和小型项目的使用限制. 对于商业用途和更高的请求量,考虑更新你的计划.

### 导入 SDK

```ts
import { RoutePlanner, Agent, Job } from "@geoapify/route-planner-sdk";
const planner = new RoutePlanner({ apiKey: "YOUR_API_KEY" });
```

或在 HTML 中使用:

```html
<script src="./node_modules/@geoapify/route-planner-sdk/dist/index.min.js"></script>
<script>
  const planner = new RoutePlannerSDK.RoutePlanner({ apiKey: "YOUR_API_KEY" });
</script>
```

### 示例: 创建发货/ 交付任务

```ts
import { RoutePlanner, Agent, Location, Shipment, ShipmentStep, Avoid } from "@geoapify/route-planner-sdk";

const planner = new RoutePlanner({apiKey: API_KEY});

planner.setMode("drive");

planner.addAgent(new Agent().setStartLocation(44.50485912329202, 40.177547000000004).addTimeWindow(0, 7200));
planner.addAgent(new Agent().setStartLocation(44.50485912329202, 40.177547000000004).addTimeWindow(0, 7200));
planner.addAgent(new Agent().setStartLocation(44.50485912329202, 40.177547000000004).addTimeWindow(0, 7200));

planner.addLocation(new Location().setId("warehouse-0").setLocation(44.5130974, 40.1766863));

planner.addShipment(new Shipment().setId("order-1")
    .setDelivery(new ShipmentStep().setDuration(120).setLocation(44.50932929564537, 40.18686625))
    .setPickup(new ShipmentStep().setDuration(120).setLocationIndex(0)));

planner.addShipment(new Shipment().setId("order-2")
    .setDelivery(new ShipmentStep().setDuration(120).setLocation(44.511160727462574, 40.1816037))
    .setPickup(new ShipmentStep().setDuration(120).setLocationIndex(0)));

planner.addAvoid(new Avoid().setType("tolls"));
planner.addAvoid(new Avoid().addValue(40.50485912329202, 42.177547000000004).setType("locations"));

planner.setTraffic("approximated")
planner.setType("short")
planner.setUnits("metric");
planner.setMaxSpeed(10)

const result = await planner.plan();
```

### 示例:创建工作优化任务

```js
import { RoutePlanner, Agent, Job } from "@geoapify/route-planner-sdk";

const planner = new RoutePlanner({apiKey: API_KEY});

planner.setMode("drive");

planner.addAgent(new Agent().setStartLocation(44.52566026661482, 40.1877687).addTimeWindow(0, 10800).setEndLocation(44.486653350000005, 40.18298485).setPickupCapacity(10000));
planner.addAgent(new Agent().setStartLocation(44.52244306971864, 40.1877687).addTimeWindow(0, 10800));
planner.addAgent(new Agent().setStartLocation(44.505007387303756, 40.1877687).addTimeWindow(0, 10800).setEndLocation(44.486653350000005, 40.18298485).setPickupCapacity(10000));

planner.addJob(new Job().setDuration(300).setPickupAmount(60).setLocation(44.50932929564537, 40.18686625));
planner.addJob(new Job().setDuration(200).setPickupAmount(20000).setLocation(44.50932929564537, 40.18686625));
planner.addJob(new Job().setDuration(300).setPickupAmount(10).setLocation(44.50932929564537, 40.18686625));
planner.addJob(new Job().setDuration(300).setPickupAmount(0).setLocation(44.50932929564537, 40.18686625));

const result = await planner.plan();
```

## 完整文档

寻找完整的API参考文献,使用示例,以及SDK架构细节?

👉 **在此探索全部文档:**  
[https://geoapify.github.io/route-planner-sdk/ 互联网档案馆的存檔,存档日期2014-12-21](https://geoapify.github.io/route-planner-sdk/)

## 修改路由结果

您可以轻松编辑计划中的路由 `RoutePlannerResultEditor`。 。 。 .

### 战略

编辑器支持修改路线的两个主要策略:

| 战略 | 说明 | API 调用 |
| --- | --- | --- |
| `reoptimize` | 完整路由再优化(默认). 最佳结果. | 路由规划器 API |
| `preserveOrder` | 插入时不重排已有的站名 。 快速而灵活. | 路由矩阵 API( 如果没有指定位置) 或 无 |

所有正则编辑操作( I)`assign*`, (中文(简体) ), `addNew*`, (中文(简体) ), `remove*`, (中文(简体) ), `moveWaypoint`, (中文(简体) ), `addDelayAfterWaypoint`)为软: 要求的修改被应用,任何限制问题都被作为违反规定行为储存. 严格路线改进,使用 `reoptimizeAgentPlan(agentIdOrIndex, { allowViolations: false })`。 。 。 .

**`preserveOrder` 策略行为 :**

-   **无职位参数** − 使用路由矩阵 API 找到最佳插入点
-   **使用 Waypoint Index 之后的图像** + 使用路由矩阵 API 优化该位置后的插入
-   **与 Waypoint Index + 附录相接: 真** — 直接在该位置后插入( 无 API 呼叫)
-   **带有附件:真实** + 路由结束的附录( 无 API 呼叫)

### 示例: 指派任务给代理

```ts
const routeEditor = new RoutePlannerResultEditor(result);

// Default: full reoptimization (Route Planner API)
await routeEditor.assignJobs('agent-a', ['job-2']);

// Find optimal insertion point (Route Matrix API)
await routeEditor.assignJobs('agent-a', ['job-2'], { strategy: 'preserveOrder' });

// Append to end of route (no API call)
await routeEditor.assignJobs('agent-a', ['job-2'], { 
  strategy: 'preserveOrder', 
  append: true
});

// Optimize insertion after a specific job by ID (Route Matrix API)
await routeEditor.assignJobs('agent-a', ['job-2'], { 
  strategy: 'preserveOrder', 
  afterId: 'job-1' 
});

// Optimize insertion after a specific waypoint by index (Route Matrix API)
await routeEditor.assignJobs('agent-a', ['job-2'], { 
  strategy: 'preserveOrder', 
  afterWaypointIndex: 1  // After first stop
});

let modifiedResult = routeEditor.getModifiedResult();
```

### 示例:向代理人发运货物

```ts
const routeEditor = new RoutePlannerResultEditor(result);
await routeEditor.assignShipments('agent-b', ['shipment-2']);

// Or with strategy
await routeEditor.assignShipments('agent-b', ['shipment-2'], { 
  strategy: 'preserveOrder', 
  append: true
});

let modifiedResult = routeEditor.getModifiedResult();
```

### 示例:删除任务

```ts
const routeEditor = new RoutePlannerResultEditor(plannerResult);

// Default: reoptimize remaining route
await routeEditor.removeJobs(['job-2']);

// Remove without reordering remaining jobs
await routeEditor.removeJobs(['job-2'], { strategy: 'preserveOrder' });

let modifiedResult = routeEditor.getModifiedResult();
```

### 示例:删除运出

```ts
const routeEditor = new RoutePlannerResultEditor(plannerResult);
await routeEditor.removeShipments(['shipment-4']);

// Or with preserveOrder strategy
await routeEditor.removeShipments(['shipment-4'], { strategy: 'preserveOrder' });

let modifiedResult = routeEditor.getModifiedResult();
```

### 示例:添加新任务

```ts
let newJob = new Job()
    .setLocation(44.50932929564537, 40.18686625)
    .setPickupAmount(10)
    .setId("job-5");

// Default: reoptimize
await routeEditor.addNewJobs('agent-A', [newJob]);

// Or append to end of route
await routeEditor.addNewJobs('agent-A', [newJob], { 
  strategy: 'preserveOrder', 
  append: true
});

let modifiedResult = routeEditor.getModifiedResult();
```

### 示例: 添加新运出

```ts
let newShipment = new Shipment()
    .setPickup(new ShipmentStep().setLocation(44.50932929564537, 40.18686625).setDuration(1000))
    .setDelivery(new ShipmentStep().setLocation(44.50932929564537, 40.18686625))
    .addRequirement('heavy-items')
    .setId("shipment-5");

await routeEditor.addNewShipments('agent-A', [newShipment]);

// Or with strategy
await routeEditor.addNewShipments('agent-A', [newShipment], { strategy: 'preserveOrder' });

let modifiedResult = routeEditor.getModifiedResult();
```

## 时间线生成

`RoutePlannerTimeline` 生成传送路线、代理、出入口和工作的可视时间表。 它既可以显示计划中的输入数据,也可以显示计算出来的解决方案,支持基于时间和远程的视图.

![Timeline example](https://github.com/geoapify/route-planner-sdk/blob/main/img/timeline.png?raw=true)

### 特征

-   可视化代理交付或接货任务的时间表
-   支持“ 时间” 或“ 距离” 模式
-   可定制的代理颜色、标签和能力单位
-   可选的弹出点细节和 三点代理菜单

### 示例: 生成没有 Waypoint 的占位符时间线

仅根据输入数据创建空占位符时间线——不计算出路由解决方案,也不包括出处: 1

```ts

const container = document.getElementById('timeline-container');

new RoutePlannerTimeline(container, inputData, undefined, {
      timelineType: 'time',
      hasLargeDescription: false,
      capacityUnit: 'liters',
      agentLabel: 'Truck',
      label: "Simple delivery route planner",
      description: "Deliver ordered items to customers within defined timeframe",
      agentColors: ["#ff4d4d", "#1a8cff", "#00cc66", "#b300b3", "#e6b800", "#ff3385",
        "#0039e6", "#408000", "#ffa31a", "#990073", "#cccc00", "#cc5200", "#6666ff", "#009999"],
    }
);
```

您可以先生成一个空占位符时长, 然后再使用 `setResult()` 函数与路由结果数据

### 示例: 以优化路线生成时间线

显示包含计算出路由结果的完整时间表,以及每站的交互式路由点弹出.

```ts
const container = document.getElementById('timeline-container');

new RoutePlannerTimeline(container, inputData, result, {
        timelineType: 'time',
        hasLargeDescription: false,
        capacityUnit: 'liters',
        agentLabel: 'Truck',
        label: "Simple delivery route planner",
        description: "Deliver ordered items to customers within defined timeframe",
        showWaypointPopup: true,
        agentColors: ["#ff4d4d", "#1a8cff", "#00cc66", "#b300b3", "#e6b800", "#ff3385",
          "#0039e6", "#408000", "#ffa31a", "#990073", "#cccc00", "#cc5200", "#6666ff", "#009999"],
      }
);
```

### 示例:带有自定义弹出和代理动作的时间线

```ts
import {
  RoutePlannerTimeline,
  Waypoint,
  TimelineMenuItem
} from "@geoapify/route-planner-sdk";

const toPrettyTime = (seconds: number): string => `${Math.floor(seconds / 60)} min`;
const timeLabels = [
  { position: "25%", label: "1h" },
  { position: "50%", label: "2h" },
  { position: "75%", label: "3h" }
];
const agentVisibilityState: boolean[] = [];

const customWaypointPopupGenerator = (waypoint: Waypoint): HTMLElement => {
  const popupDiv = document.createElement('div');
  popupDiv.innerHTML = `
    <div style="display: flex; flex-direction: column; gap: 5px;">
      <h4 style="margin: 0">${[...new Set(waypoint.getActions().map(
        action => action.getType().charAt(0).toUpperCase() + action.getType().slice(1))
      )].join(' / ')}</h4>
      <p style="margin: 0">Duration: ${toPrettyTime(waypoint.getDuration()) || 'N/A'}</p>
      <p style="margin: 0">Time Before: ${toPrettyTime(waypoint.getStartTime()) || 'N/A'}</p>
      <p style="margin: 0">Time After: ${toPrettyTime(waypoint.getStartTime() + waypoint.getDuration()) || 'N/A'}</p>
    </div>`;
  return popupDiv;
};

const agentActions: TimelineMenuItem[] = [
  {
    key: 'show-hide-agent',
    label: 'Hide Route',
    callback: (agentIndex: number) => {
      console.log(`Agent ${agentIndex} visibility toggled`);
    }
  },
  {
    key: 'second-button',
    label: 'Test Button',
    disabled: false,
    hidden: false,
    callback: (agentIndex: number) => {
      console.log(`Agent ${agentIndex} test button clicked`);
    }
  }
];

const container = document.getElementById('timeline-container');

const timeline = new RoutePlannerTimeline(container, inputData, undefined, {
  timelineType: 'time',
  hasLargeDescription: false,
  capacityUnit: 'liters',
  agentLabel: 'Truck',
  label: 'Simple delivery route planner',
  description: 'Deliver ordered items to customers within defined timeframe',
  timeLabels, // optional
  showWaypointPopup: true,
  waypointPopupGenerator: customWaypointPopupGenerator,
  agentMenuItems: agentActions,
  agentColors: ['#ff4d4d', '#1a8cff', '#00cc66', '#b300b3']
});

// Optional: Listen to hover events
timeline.on('onWaypointHover', (waypoint: Waypoint, agentIndex: number) => {
  console.log('Hovered waypoint:', waypoint, 'Agent:', agentIndex);
});

// Optional: Listen to click events
timeline.on('onWaypointClick', (waypoint: Waypoint, agentIndex: number) => {
  console.log('Clicked waypoint:', waypoint, 'Agent:', agentIndex);
});

// Optional: Modify menu items dynamically before they are shown
timeline.on('beforeAgentMenuShow', (agentIndex: number, actions: TimelineMenuItem[]) => {
  return actions.map(action => {
    if (action.key === 'show-hide-agent') {
      return {
        ...action,
        label: agentVisibilityState[agentIndex] ? 'Show Route' : 'Hide Route'
      };
    }
    return action;
  });
});
```

### 时间线设置要求

-   包含特定时间段 CSS : `./node_modules/@geoapify/route-planner-sdk/styles/timeline-minimal.css`
-   确保您的 HTML 容器 (`'timeline-container'`)在场,并准备提出时间表
-   导入时间轴特性的必要类型, 如 : `RoutePlannerInputData` 财务报告和审定财务报表 `RoutePlannerResult`

## 有用链接

-   [地理化路线规划器 API 概览](https://www.geoapify.com/route-planner-api/)
-   [API 游戏场](https://apidocs.geoapify.com/playground/route-planner/)
-   [API 文档](https://apidocs.geoapify.com/docs/route-planner/)

## 何时使用

这个 **地理化路线优化 SDK** 为:

-   交付和后勤平台
-   多代理工作调度
-   货运规划和优化
-   互动路线编辑和可视化

以自动化和灵活路由优化的方式简化物流和快递业务.

## 常见问题

### @geoapify/route-planner-sdk 是什么？

TypeScript SDK for the Geoapify Route Planner API\. 互联网档案馆的存檔,存档日期2013-10-02\. 支持浏览器和节点\.js中的路由优化、交付规划和时间表可视化

### 如何安装 @geoapify/route-planner-sdk？

在项目目录运行 npm install @geoapify/route-planner-sdk，或使用 pnpm add / yarn add / bun add。

### @geoapify/route-planner-sdk 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @geoapify/route-planner-sdk 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @geoapify/route-planner-sdk 可以商用吗？

@geoapify/route-planner-sdk 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @geoapify/route-planner-sdk 的下载量有多少？

根据 npm 官方下载统计，@geoapify/route-planner-sdk 在 2026/10/16 – 2026/11/14 这 30 天内被下载 2,515 次，日均约 84 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @geoapify/route-planner-sdk 还在维护吗？

最新版本 2\.0\.0 发布于 2026/03/30（7 个月前）；至今共发布 26 个版本，其中过去 12 个月发布了 1 个；首次发布于 2025/03/24。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

