npm 包 lrm-osrm4 使用教程-JavaScript中文网-JavaScript教程资源分享门户

前言

路线规划是地图应用领域中的一个重要环节，它可以方便地为用户提供从起点到终点的最优路径。而 OpenStreetMap、OpenRouteService 和 Mapbox 等服务则为路线规划提供了支持。为了方便地集成这些服务到自己的应用中，Leaflet Routing Machine 诞生了。它是一个基于 Leaflet 的路线规划库，支持多种第三方路线服务，其中包括了 lrm-osrm4。

lrm-osrm4 简介

lrm-osrm4 是 Leaflet Routing Machine（LRM）中的一个插件，它使用 OSRM v4 API 进行路线规划。OSRM（Open Source Routing Machine）是一个基于 C++ 的高效路线规划引擎，可以快速地处理大量的地理数据，提供 HTTP API 以供访问。

lrm-osrm4 可以被集成到 LRM 中，为用户提供从 A 到 B 的最短路径。它支持多种配置选项，可以控制路线的类型、输出格式以及详细程度。

安装

如果您的项目中已经包含了 LRM，那么只需执行以下命令安装 lrm-osrm4：

$ npm install lrm-osrm4

如果您的项目尚未使用 LRM，则可以执行以下命令安装：

$ npm install leaflet-routing-machine lrm-osrm4

使用

接下来我们将从以下几个方面介绍 lrm-osrm4 的使用方法。

1. 初始化

在初始化 LRM 对象时，需要先初始化 L.Routing.OSRMv1 插件。代码如下：

var map = L.map('map');
L.tileLayer('http://{s}.tile.osm.org/{z}/{x}/{y}.png').addTo(map);

var control = L.Routing.control({
  router: L.Routing.osrmv1({
    serviceUrl: 'http://router.project-osrm.org/v1'
  })
}).addTo(map);

上述代码初始化了一个地图对象，并添加了一个瓦片图层。接着，调用 L.Routing.control 方法初始化 LRM 对象。在此过程中，需要传入 router 参数，指定使用 L.Routing.OSRMv1 插件。在 router 参数中，需要指定 OSRM 服务器的地址，由于 OSRM 服务器需要提供 HTTPS 服务，因此我们使用了一个公共的服务器地址 'http://router.project-osrm.org/v1' 作为示例。

如果您想在本地搭建一台 OSRM 服务器，则可以参考其官方文档进行操作：OSRM Server Quickstart。

2. 设置路线类型

lrm-osrm4 支持多种路线类型，包括驾车、步行、自行车、多点之间的路程计算等。可以通过传入 profile 参数来指定路线类型，代码如下：

var control = L.Routing.control({
  router: L.Routing.osrmv1({
    serviceUrl: 'http://router.project-osrm.org/v1'
  }),
  profile: 'driving'
}).addTo(map);

上述代码将路线类型设置为驾车，如果要设置为步行、自行车，可将 profile 参数改为 'walking'、'cycling' 进行传入。

同时，lrm-osrm4 还支持多个中间点的路线计算，比如从 A 出发，经过 B、C 两点，最后到达 D 点。如需使用该功能，可以传入 waypoints 参数：

-- -------------------- ---- -------
--- ------- - -------------------
  ------- ------------------
    ----------- -----------------------------------
  ---
  ---------- -
    ------------------- -----------
    ------------------- -----------
    ------------------- -----------
    ------------------- ----------
  -
--------------

上述代码将路线从 A 出发，经过 B、C、D 四个点，并输出最终的路线。

3. 设置输出格式与详细程度

lrm-osrm4 支持多种输出格式，包括 GeoJSON、GML、GPX、Polyline 等，可以通过传入 format 参数来指定输出格式，代码如下：

var control = L.Routing.control({
  router: L.Routing.osrmv1({
    serviceUrl: 'http://router.project-osrm.org/v1'
  }),
  profile: 'driving',
  format: 'geojson'
}).addTo(map);

上述代码将输出格式设置为 GeoJSON，如果要设置为其他格式，可以将 format 参数改为 'xml'、'json' 或 'polyline'。

在路线规划过程中，还可以控制路线的详细程度，包括完整路线、摘要路线、步骤路线等。可以通过传入 geometry_precision 参数来指定路线的详细程度。代码如下：

var control = L.Routing.control({
  router: L.Routing.osrmv1({
    serviceUrl: 'http://router.project-osrm.org/v1'
  }),
  profile: 'driving',
  format: 'geojson',
  geometryPrecision: 1
}).addTo(map);

上述代码将路线详细程度设置为 1（单位：米），如果要设置为其他数值，则可以将 geometry_precision 参数的值改为相应数值即可。

4. 添加事件

LRM 中的路线规划可以添加多个事件，比如路线规划完成时，可以输出最优路径距离、耗时等信息。代码如下：

control.on('routesfound', function(e) {
  var routes = e.routes;
  var summary = routes[0].summary;
  
  console.log('Distance: ' + summary.totalDistance + ' meters');
  console.log('Time: ' + Math.round(summary.totalTime / 60) + ' minutes');
});

上述代码设置了一个 routesfound 事件，当路线规划完成时，输出最优路径的总距离以及总耗时。

示例代码

下面为一个完整的示例代码，其中使用了 lrm-osrm4 进行路线规划，并将结果输出到控制台中：

-- -------------------- ---- -------
--------- -----
------
------
  ---------------- ------------
  ----- ---------------- --------------- --------------------------------------------------------- --
  ----- ---------------- --------------- -------------------------------------------------------------------------------------- --
  ------- ---------------------- -----------------------------------------------------------------
  ------- ---------------------- ----------------------------------------------------------------------------------------------
  ------- ---------------------- -------------------------------------------
-------
------
  ---- -------- -------------- --------------
  ------- -----------------------
    --- --- - -------------
    ------------------------------------------------------------------

    --- ------- - -------------------
      ------- ------------------
        ----------- -----------------------------------
      ---
      -------- ----------
      ------- ----------
      ------------------ -
    --------------

    ------------------------- ----------- -
      --- ------ - ---------
      --- ------- - ------------------
      
      ---------------------- - - --------------------- - - ---------
      ------------------ - - ---------------------------- - --- - - ----------
    ---
  ---------
-------
-------

总结

本文介绍了 lrm-osrm4 的使用方法，包括路线类型、输出格式、详细程度控制以及添加事件等方面。lrm-osrm4 是一个强大的路线规划引擎，它支持多种路线类型、输出格式，并且具有高效性和灵活性。在您的项目中，如果需要进行路线规划，则推荐使用 lrm-osrm4。

来源：JavaScript中文网，转载请注明来源 https://www.javascriptcn.com/post/6005557b81e8991b448d2a73