使用graphhopper(map-matching)进行地图匹配
因为在做国创项目的时候需要进行地图匹配，在地图匹配的过程中也遇见了很多问题，在此记录，希望我的经历可以帮助大家规避一些问题，节约时间
在github上面有关地图匹配的开源项目有很多，我在此分享一下：
bmwcarit/barefoot: Java map matching library for integrating the map into software and services with state-of-the-art online and offline map matching that can be used stand-alone and in the cloud. (github.com)这个是barefoot，用java写的。因为在GitHub上面介绍的使用方式：它是在Unix系统上面运行的，所以在地图匹配的时候，我就没有使用它（但是因为java是跨平台语言，所以在Windows上面也可以运行，如果大家想使用barefoot也是可以的）
amillb/pgMapMatch: map-matching of GPS traces (github.com)
这个是pgMapMatch，语言是python。其实在进行地图匹配的时候，我首选是这个(因为我对python熟悉些)，但是它的使用步骤比较麻烦。需要“使用 osm2po 将 OpenStreetMap 数据加载到 PostgreSQL 中”，如果使用其他的导入工具，可能会出现问题：在config.py中的街道名称和数据中的街道名称不一致，如果不一致，还需要自己改正。我在网上搜索osm2po的使用方法也没有搜索到，所以我也就放弃使用pgMapMatch了。
https://github.com/graphhopper/map-matching
这个就是我使用的开源包，graphhopper中的子项目map-matching,在使用过程中出现了一些问题，在此分享给大家
一、使用步骤
1、生成github tokens，并在maven的settings中添加github的tokens
这一步在graphhopper的GitHub的readme中没有介绍，但是这一步非常关键！！！
（在这里说一句题外话，因为我没有弄这个，然后在打jar包的时候，使用maven下载很多jar包都下载不了，我就一直找方法，找了很多方法都没有用，最后还是去graphhopper的社区里面找到了方法，哎，真的很痛苦，就是因为这个点，我卡了很久）下面我会具体说明怎么生成github tokens，并且怎么在setting中添加github的tokens
（1）生成github tokens
github 配置使用 personal access token 认证_惜鸟的博客-CSDN博客_personalaccesstoken
（2）在maven中配置settings
找到你maven的安装的位置，因为我是安装在D盘的，所以我的settings的位置是：D:\Maven\apache-maven-3.8.6\conf\settings.xml
并在settings中添加下面的东西
<servers>
<!-- github packages needs a personal access token from *any* account even to read public packages... -->
<server>
<id>github</id>
<username>你的github的用户名</username>
<password>GitHub tokens</password>
</server>
</servers>
</settings>注意：username是填写你的GitHub的用户名不是在申请GitHub tokens的时候填写的名字，GitHub tokens就是申请的时候系统生成的那一大串的字母数字（不要填错了！！！）
下面分享一下我的maven中的settings
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
http://maven.apache.org/xsd/settings-1.0.0.xsd">
<activeProfiles>
<activeProfile>github</activeProfile>
</activeProfiles>
<profiles>
<profile>
<id>github</id>
<repositories>
<repository>
<id>central</id>
<url>https://repo1.maven.org/maven2</url>
<releases><enabled>true</enabled></releases>
<snapshots><enabled>true</enabled></snapshots>
</repository>
<repository>
<id>github</id>
<name>GitHub GraphHopper Apache Maven Packages</name>
<url>https://maven.pkg.github.com/graphhopper/graphhopper</url>
</repository>
</repositories>
</profile>
</profiles>
<servers>
<!-- github packages needs a personal access token from *any* account even to read public packages... -->
<server>
<id>github</id>
<username>your username</username>
<password>your github tokens</password>
</server>
</servers>
</settings> 2、clone map-matching（下载map-matching包）
在cmd中输入（进入cmd是win+r）
git clone https://github.com/graphhopper/map-matching.git3、打包
进入你下载包的位置，比如我下载到了D:\Workspace\GraphHopper\map-matching，那就输入
cd D:\Workspace\GraphHopper\map-matching然后打包（输入下面的指令）
mvn package -DskipTests4、生成 graph-cache
在网址：Index of /extracts/asia/china中下载你需要的.osm.pbf文件，然后输入下面的指令（注意改成你下载的文件的名称）
java -jar matching-web/target/graphhopper-map-matching-web-3.0-SNAPSHOT.jar import map-data/leipzig_germany.osm.pbf（import后面的就是需要改变的）
5、匹配
java -jar matching-web/target/graphhopper-map-matching-web-3.0-SNAPSHOT.jar match matching-web/src/test/resources/test1.gpx匹配完成之后会出现下面的输出
loading graph from cache
matching-web\src\test\resources\test1.gpx
matches: 138, gps entries:264
gpx length: 9551.638 vs 9536.442
export results to:D:\Workspace\GraphHopper\map-matching\matching-web\src\test\resources\test1.gpx.res.gpx
gps import took:0.105556495s, match took: 0.36684602输出的意思是匹配的结果输出在D:\Workspace\GraphHopper\map-matching\matching-web\src\test\resources\test1.gpx.res.gpx，然后你去查看就OK啦
二、在使用过程中可能的报错（下面的错误都是在打包的时候出现的）
1、
[ERROR] Failed to execute goal on project graphhopper-map-matching-core: Could n
ot resolve dependencies for project com.graphhopper:graphhopper-map-matching-cor
e:jar:2.0-SNAPSHOT: Failed to collect dependencies at com.graphhopper:graphhoppe
r-reader-osm:jar:4da82d9226e1ff9c5525fa3936204c7effc2fc8a: Failed to read artifa
ct descriptor for com.graphhopper:graphhopper-reader-osm:jar:4da82d9226e1ff9c552
5fa3936204c7effc2fc8a: Could not transfer artifact com.graphhopper:graphhopper-r
eader-osm:pom:4da82d9226e1ff9c5525fa3936204c7effc2fc8a from/to github (https://m 1
aven.pkg.github.com/graphhopper/graphhopper 1): Authentication failed for https://
maven.pkg.github.com/graphhopper/graphhopper/com/graphhopper/graphhopper-reader- 2
osm/4da82d9226e1ff9c5525fa3936204c7effc2fc8a/graphhopper-reader-osm-4da82d9226e1
ff9c5525fa3936204c7effc2fc8a.pom 401 Unauthorized -> [Help 1]这个报错的出现就表明你的settings没有配置好，具体的解决方案，参见：
Recent Core Build Fails - Open Source Routing Engine / Map Matching - GraphHopper Forum
2、
[WARNING] The POM for com.graphhopper:graphhopper-reader-osm:jar:0.9-SNAPSHOT is missing, no dependency information available出现这个报错的一般都是网络状态不好的，换成5G网络就可以解决，但是也可能是其他的问题，可以参见：
3、
PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target出现这个错误我是没有想到的，我在网上搜索了很久，也使用了很多方法，都不行，搞了一天都没有把这个报错给解决，结果第二天再试的时候，电脑不知道怎么了，就直接不报错了。哎，真的是搞不懂，可能这个看运气？搞不懂
4、在打包的时候尽量不要使用阿里镜像，我使用阿里镜像的时候就一直报一个错误（忘了记录了），我不知道是我电脑的问题还是其他的问题，所以如果你们如果遇见报错中有提到阿里镜像的，可以尝试不使用阿里镜像，再来打包
三、祝福、分享
好了，以上就是我分享的全部内容了，希望大家能够顺利的完成地图匹配，下面分享一下我在搜索过程中遇见的比较好的一些地图匹配的博客
研究生work——地图匹配 · Mr.li's Blog (nymrli.top)