第 8 章 手动配置和运行 OptaWeb Vehicle Routing

流程

1. 下载路由数据。

   路由引擎需要地理数据来计算在位置间传输所需时间。在运行 OptaWeb Vehicle Routing 前，您必须将 OpenStreetMap (OSM)数据文件下载到本地文件系统中。

   注意

   OSM 数据文件通常介于 100 MB 到 1 GB 之间，需要时间来下载文件，以便在构建或启动 OptaWeb Vehicle Routing 应用程序前下载文件。

   1. 在网页浏览器中打开 http://download.geofabrik.de/。
   2. 单击 Sub Region 列表中的区域，如 Europe。此时会打开 subregion 页面。
   3. 在 Sub Regions 表中，下载国家的 OSM 文件(.osm.pbf)，如 Belgium。

2. 创建数据结构。

   optaweb Vehicle Routing 读取和写入文件系统中多种数据。它从 openstreetmap 目录中读取 OSM (OpenStreetMap)文件，将 road 网络图写入 图形 跃点目录，并在名为 db 的目录中保留用户数据。创建一个用于存储所有数据的新目录，以便更轻松地升级到 OptaWeb Vehicle Routing 的较新版本，并继续使用之前创建的数据。

   1. 创建 $HOME/{VRP-DATA-DIR} 目录。

   2. 在 $HOME/{VRP-DATA-DIR} 目录中创建 openstreetmap 目录：

      $HOME/{VRP-DATA-DIR}
      └── openstreetmap

   3. 将所有下载的 OSM 文件（扩展为 .osm.pbf的文件）移到 openstreetmap 目录中。

      目录结构的其余部分由 OptaWeb Vehicle Routing 应用程序首次运行时创建。之后，您的目录结构类似以下示例：

      $HOME/{VRP-DATA-DIR}
      
      ├── db
      │   └── vrp.mv.db
      ├── graphhopper
      │   └── belgium-latest
      └── openstreetmap
          └── belgium-latest.osm.pbf

3. 将目录更改为 optaweb-vehicle-routing-distribution-7.48.0.Final-redhat-00004/sources/optaweb-vehicle-routing-standalone/target。

4. 要运行 OptaWeb Vehicle Routing，请输入以下命令：

   java -jar optaweb-vehicle-routing-standalone-7.48.0.Final-redhat-00004.jar \
   --app.persistence.h2-dir=$HOME/{VRP-DATA-DIR}/db \
   --app.routing.gh-dir=$HOME/{VRP-DATA-DIR}/graphhopper \
   --app.routing.osm-dir=$HOME/{VRP-DATA-DIR}/openstreetmap \
   --app.routing.osm-file=<OSM_FILE_NAME> \
   --app.region.country-codes=<COUNTRY_CODE_LIST> \

   在这个命令中，替换以下变量：

   • <OSM_FILE_NAME > ：您要使用的区域的 OSM 文件以及之前下载的区域

   • <COUNTRY_CODE_LIST > ：用于过滤 geosearch 查询的国家代码的逗号分隔列表。有关国家代码列表，请参阅 ISO 3166 国家代码。

     应用程序在下载 OSM 文件后启动。

     在以下示例中，OptaWeb Vehicle Routing 下载 Central 美国的 OSM 映射(central-america-latest.osm.pbf)，并在国家 Belize (BZ)和 Guatemala (GT)中搜索。

     java -jar optaweb-vehicle-routing-standalone-7.48.0.Final-redhat-00004.jar \
     --app.persistence.h2-dir=/home/user/.optaweb-vehicle-routing/db \
     --app.routing.osm-dir=/home/user/.optaweb-vehicle-routing/openstreetmap \
     --app.routing.gh-dir=/home/user/.optaweb-vehicle-routing/graphhopper \
     --app.routing.osm-file=central-america-latest.osm.pbf \
     --app.region.country-codes=BZ,GT

5. 要打开 OptaWeb Vehicle Routing 用户界面，请在网页浏览器中输入以下 URL：

   http://localhost:8080