OSRM docker环境启动

命令一把梭

wget https://download.geofabrik.de/asia/china-latest.osm.pbf
docker pull osrm/osrm-backend
docker run -t -v "${PWD}:/data" osrm/osrm-backend osrm-extract -p /opt/car.lua /data/china-latest.osm.pbf
docker run -t -v "${PWD}:/data" osrm/osrm-backend osrm-partition /data/china-latest.osrm
docker run -t -v "${PWD}:/data" osrm/osrm-backend osrm-customize /data/china-latest.osrm
docker run -d -p 5000:5000 --rm --name osrm -v "${PWD}:/data" osrm/osrm-backend osrm-routed  --algorithm mld --max-table-size 1000 --max-matching-size 500 /data/china-latest.osrm
# 验证osrm服务是否正常
curl "http://127.0.0.1:5000/route/v1/driving/113.519067,23.125793;113.723684,23.040035?steps=true"
# 前端Web地图可选装，页面类似长这样：https://map.project-osrm.org，https://xxx.xxx是上面安装的osrm服务的https地址
docker run -d -e OSRM_BACKEND='https://xxx.xxx' -p 9966:9966 osrm/osrm-frontend

注意事项

1、准备好梯子，访问https://download.geofabrik.de/asia/china-latest.osm.pbf 有时候需要，该文件一般1.2GB左右大小
2、只下载osm中国地图，pbf格式。
3、对硬件要求高，内存最好有20G以上，内存不够可能在osrm-extract这一步就会报错

[info] RAM: peak bytes used: 12934402048
[error] [exception] std::bad_alloc
[error] Please provide more memory or consider using a larger swapfile

4、用多核多线程cpu。服务启动可以使用 --threads 16 参数设置多线程
5、地图更新频繁，可以通过查看https://map.project-osrm.org/timestamps对应的路由信息更新时间戳来确定是否更新地图

命令解释

以上命令执行过程如下：

1. 提取数据：使用 osrm-extract 命令从原始地图数据文件（如 .osm.pbf）中提取必要的信息，生成中间文件（.osrm）。
2. 分区数据：使用 osrm-partition 命令对生成的 .osrm 文件进行分区，优化路由计算性能。
3. 生成层次结构：使用 osrm-customize 命令生成层次结构数据，进一步优化路由计算。
4. 启动服务：使用 osrm-routed 命令启动路由服务，提供实际的路由查询功能。

前三条命令为工具命令，是利用osrm-backend docker镜像内的内置工具对地图数据进行预处理，只有第四条为osrm服务的启动命令。

详细解释

1、docker run -t -v "${PWD}:/data" osrm/osrm-backend osrm-extract -p /opt/car.lua /data/china-latest.osm.pbf

在使用 OSRM 提供路由服务之前，通常需要先对地图数据进行预处理，生成必要的中间文件。osrm-extract 是这一过程的第一步。这条命令主要用于处理地图数据文件，将其转换为 OSRM 可以使用的格式。生成的 .osrm 文件可以用于后续的路由计算和其他地理信息服务

(1). docker run:
•用于启动一个新的 Docker 容器。
(2) -t:
•分配一个伪TTY（终端）。这通常用于保持容器的标准输入打开，以便你可以与容器进行交互。虽然在这个命令中没有明确的交互需求，但 -t 有时会与其他选项（如 -i）一起使用，以确保容器保持打开状态。
(3) -v “${PWD}:/data”:
•将宿主机当前目录（${PWD}）挂载到容器内的 /data 目录。这样，容器可以访问宿主机上的文件，反之亦然。
(4) osrm/osrm-backend:
•指定要使用的 Docker 镜像。这里是 osrm/osrm-backend，这是 Open Source Routing Machine 的官方镜像，用于处理地图数据和提供路由服务。
(5) osrm-extract:
•在容器启动后要执行的命令。osrm-extract 是 OSRM 工具链中的一个命令，用于从原始地图数据文件（通常是 .osm.pbf 格式）中提取必要的信息，生成中间文件（.osrm 文件）。
(6) -p /opt/car.lua:
•osrm-extract 命令的一个参数，指定了配置文件的路径。/opt/car.lua 是一个预定义的配置文件，用于定义车辆类型（如汽车、自行车等）的行驶规则。osrm支持汽车、自行车、步行三种行驶规则，内置多套lua脚本，当前命令使用的是汽车的行驶规则。以下是自行车和步行的命令，可按需使用

docker run -t -v "${PWD}:/data" osrm/osrm-backend osrm-extract -p /opt/bike.lua /data/china-latest.osm.pbf
docker run -t -v "${PWD}:/data" osrm/osrm-backend osrm-extract -p /opt/foot.lua /data/china-latest.osm.pbf

(7) /data/china-latest.osm.pbf:
•输入文件的路径。这里指定的是宿主机当前目录下的 china-latest.osm.pbf 文件，该文件通过 -v 选项挂载到了容器内的 /data 目录。

2、docker run -t -v "${PWD}:/data" osrm/osrm-backend osrm-partition /data/china-latest.osrm

osrm-partition 命令用于对已经提取的地图数据进行分区，以提高路由计算的性能。分区可以将地图数据划分为多个子区域，从而减少查询时的计算量。
•数据准备：在使用 OSRM 提供路由服务之前，通常需要对地图数据进行多步预处理。osrm-partition 是这一过程的第二步，在 osrm-extract 之后执行。

3、docker run -t -v "${PWD}:/data" osrm/osrm-backend osrm-customize /data/china-latest.osrm

•地图数据优化：osrm-customize 命令用于对已经提取和分区的地图数据进行定制处理，生成层次结构数据。层次结构数据可以显著提高路由计算的性能，特别是在处理大规模地图数据时。
•数据准备：在使用 OSRM 提供路由服务之前，通常需要对地图数据进行多步预处理。osrm-customize 是这一过程的第三步，在 osrm-extract 和 osrm-partition 之后执行。

4、docker run -d -p 5000:5000 --rm --name osrm -v "${PWD}:/data" osrm/osrm-backend osrm-routed --algorithm mld --max-table-size 1000 --max-matching-size 500 /data/china-latest.osrm

(1) docker run:
•用于启动一个新的 Docker 容器。
(2) -d:
•以 detached 模式（后台模式）运行容器。这意味着容器将在后台运行，不会占用当前终端。
(3) -p 5000:5000:
•将宿主机的 5000 端口映射到容器的 5000 端口。这允许你在宿主机上通过 http://localhost:5000 访问容器内的服务。
(4) --rm:
•在容器退出后自动删除该容器。这有助于保持宿主机的整洁，避免留下大量不再需要的容器。
(5) --name osrm:
•为容器指定一个名称 osrm。这使得你可以在后续的 Docker 命令中更容易地引用这个容器。
(6) -v “${PWD}:/data” :
•将宿主机当前目录（${PWD}）挂载到容器内的 /data 目录。这样，容器可以访问宿主机上的文件，反之亦然。
(7) osrm/osrm-backend:
•指定要使用的 Docker 镜像。这里是 osrm/osrm-backend，这是 Open Source Routing Machine 的官方镜像，用于处理地图数据和提供路由服务。
(8) osrm-routed:
•在容器启动后要执行的命令。osrm-routed 是 OSRM 工具链中的一个命令，用于启动路由服务。
(9) --algorithm mld:
•指定路由算法为 mld（Multi-Level Dijkstra）。这是一种高效的路由算法，特别适用于大规模地图数据。
(10) --max-table-size 1000:
•设置Table Service API 中传入位置参数的个数最大为 1000个，不设置默认为100。如计算多个位置两两之间的距离或耗时矩阵API https://xxx/table/v1/driving/116.373627,37.446524;116.787863,37.628356;116.641314,36.913737?annotations=duration&skip_waypoints=true
这个url地址中传入了3个位置，经纬度内部逗号隔开，经纬度之间用分号分隔。api返回结果是一个3X3的两地之间汽车行驶的耗时矩阵，单位为s。 参考
(11) --max-matching-size 500:
•和第10项类似，针对的是Match service API 的位置参数传入个数上限，此处扩展到500
(12) /data/china-latest.osrm:
•指定要使用的地图数据文件的路径。这里指定的是宿主机当前目录下的 china-latest.osrm 文件，该文件通过 -v 选项挂载到了容器内的 /data 目录。

参考文档：

https://download.geofabrik.de/asia/china.html
https://project-osrm.org/docs/v5.24.0/api/#
https://github.com/fossgis-routing-server/osrm-backend
https://github.com/fossgis-routing-server/osrm-frontend
https://github.com/fossgis-routing-server/cbf-routing-profiles
https://map.project-osrm.org/about.html