polylines
v3.0.0
Pelias ist ein Geocoder, der vollständig auf offenen Daten basiert und für jedermann frei verfügbar ist.
Lokale Installation · Cloud-Webservice · Dokumentation · Community-Chat
Der Polylinien-Importer erleichtert den Import von Straßennetzdaten aus einer Liste polyliniencodierter Linienzüge in Pelias.
Node.js ist erforderlich. Informationen zu den unterstützten Versionen finden Sie in den Pelias-Softwareanforderungen.
Da dieses Modul nur ein Teil unseres Geocoders ist, empfehlen wir, mit unseren Docker-Dateien für eine schnelle Einrichtung oder unseren vollständigen Installationsdokumenten zu beginnen, um dieses Modul zu verwenden.
$ git clone https://github.com/pelias/polylines.git && cd polylines
$ npm installVorverarbeitete Dateien des weltweiten Straßennetzes können von Geocode Earth heruntergeladen werden.
Hinweis: Die Dateierweiterungen
.0svund.polylineswerden synonym verwendet, sie beziehen sich beide auf dasselbe Dateiformat; Es gibt jedoch Code, der nach der Erweiterung.0svsucht, die daher vorzuziehen ist.
Weitere Informationen zur Generierung des Extrakts finden Sie im Wiki-Artikel: Polylinien aus Valhalla generieren.
Zu Testzwecken verfügen wir auch über einige kleinere Auszüge. Eine kleine Anzahl wurde manuell aus pbf für die geografischen Regionen unserer Hauptmitwirkenden herausgeschnitten. Weitere Informationen dazu, wie Sie Ihre eigenen Extrakte generieren können, finden Sie im Abschnitt „Generieren eines benutzerdefinierten Polylinien-Extrakts aus einem PBF-Extrakt“ weiter unten:
Hinweis: Diese Auszüge wurden mit einer anderen Methode als der oben gezeigte Planetenausschnitt erstellt.
Nachdem Sie die Daten heruntergeladen und extrahiert haben, müssen Sie die folgenden Konfigurationsschritte ausführen, um Pelias mitzuteilen, wo sie zu finden sind.
Wenn Sie eine andere Quelle für Polyliniendaten verwenden möchten, müssen Sie möglicherweise die Standardeinstellungen in ./stream/pipeline.js anpassen. Öffnen Sie ein Problem, wenn Sie nicht weiterkommen.
Sie können eine Polyliniendatei aus Ihren eigenen Daten generieren. Die Daten MÜSSEN im folgenden Format codiert sein:
n ) abgeschlossen. ) getrennt. Die Geometrie wird mithilfe des Google-Polylinienalgorithmus mit einer Genauigkeit von 6 codiert.
HINWEIS: In vielen Bibliotheken wird die Genauigkeit standardmäßig auf 5 festgelegt. Dies führt zu Fehlern. Stellen Sie sicher, dass Sie die richtige Polyliniengenauigkeit auswählen.
In diesem Repo ist ein Skript enthalten, das Dateien, die mit der Genauigkeit 5 generiert wurden, in die Genauigkeit 6 umkodieren kann. Sie finden es in bin/reencode.js .
Jede Zeile beginnt mit der codierten Polylinie, gefolgt von einem Nullbyte ( ), gefolgt von einem oder mehreren Namen (getrennt durch ein Nullbyte) und endet schließlich mit einer neuen Zeile ( n ).
Beispiel:
{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.
Um dem Importeur den Speicherort Ihrer Downloads und Umgebungseinstellungen mitzuteilen, müssen Sie zunächst eine Datei ~/pelias.json erstellen.
Einzelheiten zur Struktur dieser Datei finden Sie in der Konfigurationsdokumentation. Ihre relevanten Konfigurationsinformationen für das Polylinienmodul könnten etwa so aussehen:
Hinweis: Der Importer unterstützt derzeit nur einen einzelnen Eintrag im files . Außerdem akzeptiert die Konfigurationsdatei nur „polyline“ (ohne das „s“).
"imports" : {
"polyline" : {
"datapath" : "/data" ,
"files" : [ "road_network.0sv" ]
}
} Polyliniendaten verfügen nicht über eine vollständige Verwaltungshierarchie (z. B. Länder-, Bundesland-, Kreisnamen usw.), sie können jedoch anhand von Daten aus „Wer ist zuerst“ berechnet werden. Weitere Informationen finden Sie in der Readme-Datei für pelias/wof-admin-lookup. Standardmäßig ist adminLookup aktiviert. Zum Deaktivieren setzen Sie imports.adminLookup.enabled in der Pelias-Konfiguration auf false .
Hinweis: Für die Admin-Suche müssen etwa 5 GB Daten in den Speicher geladen werden.
Dadurch wird der Importvorgang gestartet. Es dauert etwa 30 Sekunden, bis die In-Memory-Daten vorbereitet sind. Anschließend sollten im Terminal regelmäßige Debugging-Ausgaben angezeigt werden.
$ PELIAS_CONFIG= < path_to_config_json > npm startSie können das CLI-Tool zum Ausführen von Importen und zu Debugging-Zwecken verwenden:
Hinweis: Standardmäßig liest das CLI-Tool von stdin und schreibt nach 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
Führen Sie einen „Probelauf“ des Importvorgangs durch:
node ./bin/cli.js --config --prettyImportieren Sie eine bestimmte Datei in Elasticsearch:
node ./bin/cli.js --file=/tmp/myfile.polylines --dbMit diesem OSM PBF-Tool können Sie einen benutzerdefinierten Polylinienextrakt generieren.
Hinweis: Golang 1.9+ ist erforderlich. Bitte stellen Sie sicher, dass es korrekt installiert ist, bevor Sie fortfahren.
$ 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
Wenn Sie Probleme bei der Einrichtung haben oder in der Dokumentation etwas fehlt, eröffnen Sie bitte hier ein Problem: https://github.com/pelias/polylines/issues
Bitte forken und ziehen Sie die Anfrage an den Upstream-Master in einem Feature-Branch.
Bitte schön; Stellen Sie Unit-Tests und Skript-Fixtures im test bereit.
Es wird eine .jshintrc Datei bereitgestellt, die eine Linting-Konfiguration enthält. Normalerweise versteht Ihr Texteditor diese Konfiguration und gibt Ihnen Inline-Hinweise zum Codestil und zur Lesbarkeit.
Diese Einstellungen werden strikt durchgesetzt, wenn Sie einen git commit durchführen. Sie können git commit jederzeit ausführen, um den Linter für Ihren Code auszuführen.
$ npm testTravis testet jede Änderung anhand unserer unterstützten Node.js-Versionen.
