polylines
v3.0.0
Pelias はオープン データを完全に活用したジオコーダーであり、誰でも無料で利用できます。
ローカル インストール · クラウド Web サービス · ドキュメント · コミュニティ チャット
ポリライン インポーターを使用すると、ポリラインでエンコードされた線文字列のリストから道路ネットワーク データを Pelias にインポートすることが容易になります。
Node.js が必要です。サポートされているバージョンについては、Pelias ソフトウェア要件を参照してください。
このモジュールはジオコーダーの一部にすぎないため、簡単なセットアップのために Dockerfile から始めるか、このモジュールを使用するには完全なインストール ドキュメントから始めることをお勧めします。
$ git clone https://github.com/pelias/polylines.git && cd polylines
$ npm install前処理された地球規模の道路網ファイルは、Geocode Earth からダウンロードできます。
注: ファイル拡張子
.0svと.polylinesは同じ意味で使用され、どちらも同じファイル形式を指します。ただし、.0sv拡張子を検索するコードがあるため、これが推奨されます。
抽出の生成方法の詳細については、Wiki 記事「Valhalla からのポリラインの生成」を参照してください。
また、テスト目的で小さな抽出物もいくつかありますが、主要な貢献者の地域に合わせて pbf から手動で少数が切り取られました。独自の抽出を生成する方法の詳細については、以下の「PBF 抽出からのカスタム ポリライン抽出の生成」セクションを参照してください。
注:これらの抽出物は、上記の惑星カットとは異なる方法を使用して生成されました。
データをダウンロードして抽出したら、データがどこにあるかを Pelias に伝えるために、以下の設定手順に従う必要があります。
ポリライン データの別のソースを使用したい場合は、 ./stream/pipeline.jsのデフォルトを調整する必要がある場合があります。行き詰まった場合は、Issue をオープンしてください。
独自のデータからポリライン ファイルを生成できます。データは次の形式でエンコードする必要があります。
n ) 文字で終了します。 ) 文字で区切られます。ジオメトリは、Google ポリライン アルゴリズムを使用して6の精度でエンコードされます。
注: 多くのライブラリはデフォルトで精度を5に設定します。これによりエラーが発生します。必ず正しいポリライン精度を選択してください。
このリポジトリには、精度5で生成されたファイルを精度6に再エンコードできるスクリプトが含まれています。これはbin/reencode.jsにあります。
各行はエンコードされたポリラインで始まり、null バイト ( ) が続き、その後 1 つ以上の名前 (null バイトで区切られている) が続き、最後に改行 ( 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配列内の 1 つのエントリのみをサポートしています。また、設定ファイルは「ポリライン」(「s」を除く)のみを受け入れます。
"imports" : {
"polyline" : {
"datapath" : "/data" ,
"files" : [ "road_network.0sv" ]
}
}ポリライン データには完全な管理階層 (国、州、郡などの名前) はありませんが、Who's on First のデータを使用して計算できます。詳細については、pelias/wof-admin-lookup の Readme を参照してください。デフォルトでは、adminLookup は有効になっています。無効にするには、Pelias 構成でimports.adminLookup.enabled falseに設定します。
注:管理者の検索には、約 5GB のデータをメモリにロードする必要があります。
これによりインポート プロセスが開始され、メモリ内データの準備に約 30 秒かかります。その後、ターミナルに通常のデバッグ出力が表示されるはずです。
$ PELIAS_CONFIG= < path_to_config_json > npm startCLI ツールを使用して、インポートを実行したり、デバッグを行うことができます。
注:デフォルトでは、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
フィーチャーブランチの上流マスターに対してフォークしてプルリクエストを行ってください。
かなりお願いします。単体テストとスクリプト フィクスチャをtestディレクトリに提供します。
lint 設定を含む.jshintrcファイルが提供されます。通常、テキスト エディタはこの設定を理解し、コード スタイルと読みやすさに関するインライン ヒントを提供します。
これらの設定は、 git commit実行するときに厳密に適用され、いつでもgit commit実行して、コードに対してリンターを実行できます。
$ npm testTravis は、サポートされている Node.js バージョンに対してすべての変更をテストします。
