polylines
v3.0.0
Pelias 是一款完全由开放数据驱动的地理编码器，每个人都可以免费使用。
本地安装·云Web服务·文档·社区聊天
折线导入器有助于将道路网络数据从折线编码线字符串列表导入到 Pelias。
需要 Node.js。请参阅 Pelias 软件要求以了解支持的版本。
由于此模块只是地理编码器的一部分，因此我们建议从 Dockerfile 开始进行快速设置，或者从完整的安装文档开始使用此模块。
$ git clone https://github.com/pelias/polylines.git && cd polylines
$ npm install预处理的全球道路网络文件可从地理编码地球下载。
注意：文件扩展名
.0sv和.polylines可以互换使用，它们都指相同的文件格式；然而，有一些代码会查找.0sv扩展名，因此这是更好的选择。
有关如何生成提取的更多信息，请参阅 wiki 文章：从 Valhalla 生成折线。
我们还有一些较小的摘录用于测试目的，一小部分是根据我们主要贡献者的地理位置从 pbf 中手动剪切的。有关如何生成自己的提取的详细信息，请参阅下面的“从 PBF 提取生成自定义折线提取”部分：
注意：这些提取物是使用与上面切割的行星不同的方法生成的。
下载并提取数据后，您需要按照以下配置步骤操作，以便告诉 Pelias 在哪里可以找到它们。
如果您想使用不同的折线数据源，您可能需要调整./stream/pipeline.js中的默认值，如果遇到困难，请提出问题。
您可以根据自己的数据生成折线文件，数据必须按以下格式编码：
n ) 结尾。 ) 字符分隔。使用 Google 折线算法对几何图形进行编码，精度为6 。
注意：许多库将默认精度为5 ，这会导致错误，请务必选择正确的折线精度。
此存储库中包含一个脚本，它能够将使用 precison 5生成的文件重新编码为 precision 6 ，您可以在bin/reencode.js中找到它。
每一行以编码的折线开始，后跟一个空字节 ( )，然后是一个或多个名称（以空字节分隔），最后以换行符 ( n ) 结束。
例子：
{polyline6} {name} {name}n
oozdnAwvbsBoA?g@{@SoAf@{@nAg@Plaça de la Creu
00000000: 6f6f 7a64 6e41 7776 6273 426f 413f 6740 oozdnAwvbsBoA?g@
00000010: 7b40 536f 4166 407b 406e 4167 4000 506c {@SoAf@{@[email protected]
00000020: 61c3 a761 2064 6520 6c61 2043 7265 750a a..a de la Creu.
为了告诉导入程序您的下载位置和环境设置，您首先需要创建一个~/pelias.json文件。
有关此文件结构的详细信息，请参阅配置文档。折线模块的相关配置信息可能如下所示：
注意：导入器当前仅支持files数组中的单个条目。此外，配置文件仅接受“折线”（不带“s”）。
"imports" : {
"polyline" : {
"datapath" : "/data" ,
"files" : [ "road_network.0sv" ]
}
}折线数据没有完整的行政层次结构（即国家、州、县等名称），但可以使用“Who's on First”中的数据进行计算。有关更多信息，请参阅 pelias/wof-admin-lookup 的自述文件。默认情况下，adminLookup 已启用。要禁用，请在 Pelias 配置中将imports.adminLookup.enabled设置为false 。
注意：管理查找需要将大约 5GB 的数据加载到内存中。
这将启动导入过程，大约需要 30 秒来填充内存中的数据，然后您应该在终端中看到常规的调试输出。
$ PELIAS_CONFIG= < path_to_config_json > npm start您可以使用 CLI 工具运行导入并进行调试：
注意：默认情况下，cli 工具将从stdin读取并写入stdout 。
$ node ./bin/cli.js --help
Usage: cli.js [options]
Options:
--file read from file instead of stdin
--config read filename from pelias config (overrides --file)
--pretty indent output (stdout only)
--db save to elasticsearch instead of printing to stdout
运行导入过程的“空运行”：
node ./bin/cli.js --config --pretty将特定文件导入到elasticsearch：
node ./bin/cli.js --file=/tmp/myfile.polylines --db您可以使用此 OSM PBF 工具生成自定义折线提取。
注意：需要 golang 1.9+，请在继续之前确保正确安装。
$ go version
go version go1.10 linux/amd64
$ go install github.com/missinglink/pbf@latest
$ pbf --help
$ wget https://s3.amazonaws.com/metro-extracts.nextzen.org/chicago_illinois.osm.pbf
$ pbf streets chicago_illinois.osm.pbf | head
yop}nApvc_gDqAywAEast Altgeld Avenue
wto}nAfpl_gDqFuzEEast Altgeld Avenue
_mr}nAbvb~fDkFmQ}BkQ}AkdBEast Altgeld Avenue
mwp}nAt{q~fDKkW]yFi@mDwBcIeS_f@qE}LmDyMwAaH_AoE}C{Uy@mMYaHyCwlDSsFi@iFwEaUEast Altgeld Avenue
smvaoAzxdmfDwbAtyB}cAvzBscAzxBmcAhyB{j@pnAmE|HNorth Navarre Avenue
wq~hoAvt~dgD?hGJfDfCl@zBr@dBrBbDv@jBx@hCpBtBBbCDnB@`@gBpC]jBEzCF~BL~AdBxH?VKpSHidden Lakes Boulevard
o~cooAb~}xfDn_@i^Taggert Court
{garnA|_~zfDo@qdA}@kEWater Tower Lane
ka|}nAh`jlgDdD{C~MmNrByHTall Grass Court
onvdnAbntyfDpMvOhHtCTall Grass Court
$ pbf streets chicago_illinois.osm.pbf > chicago_illinois.polylines
如果您在设置时遇到任何问题或文档缺少某些内容，请在此处提出问题：https://github.com/pelias/polylines/issues
请针对功能分支上的上游 master 分叉并拉取请求。
请漂亮；在test目录中提供单元测试和脚本装置。
提供了一个.jshintrc文件，其中包含 linting 配置，通常您的文本编辑器会理解此配置，并为您提供有关代码样式和可读性的内联提示。
当您执行git commit时，这些设置会严格执行，您可以随时执行git commit以针对您的代码运行 linter。
$ npm testTravis 针对我们支持的 Node.js 版本测试每个更改。
