polylines
v3.0.0
Pelias est un géocodeur entièrement alimenté par des données ouvertes, accessible gratuitement à tous.
Installation locale · Service Web cloud · Documentation · Chat communautaire
L'importateur de polylignes facilite l'importation de données de réseau routier dans Pelias à partir d'une liste de chaînes de lignes codées en polyligne.
Node.js est requis. Voir la configuration logicielle requise pour Pelias pour connaître les versions prises en charge.
Étant donné que ce module n'est qu'une partie de notre géocodeur, nous vous recommandons de commencer par nos Dockerfiles pour une configuration rapide, ou par nos documents d'installation complets pour utiliser ce module.
$ git clone https://github.com/pelias/polylines.git && cd polylines
$ npm installDes fichiers de réseau routier planétaire prétraités peuvent être téléchargés à partir de Geocode Earth.
Remarque : les extensions de fichier
.0svet.polylinessont utilisées de manière interchangeable, elles font toutes deux référence au même format de fichier ; cependant il existe du code qui recherche l'extension.0svqui est donc préférable.
Pour plus d'informations sur la façon dont l'extrait a été généré, consultez l'article wiki : Générer des polylignes à partir de Valhalla.
Nous disposons également de quelques extraits plus petits à des fins de tests, un petit nombre ayant été découpé manuellement à partir de pbf pour les zones géographiques de nos principaux contributeurs. Consultez la section « Génération d'un extrait de polylignes personnalisé à partir d'un extrait PBF » ci-dessous pour plus d'informations sur la façon dont vous pouvez générer vos propres extraits :
note : ces extraits ont été générés selon une méthode différente de celle de la planète coupée ci-dessus.
Une fois que vous avez téléchargé et extrait les données, vous devrez suivre les étapes de configuration ci-dessous afin d'indiquer à Pelias où elles peuvent être trouvées.
Si vous souhaitez utiliser une autre source de données polylignes, vous devrez peut-être modifier les valeurs par défaut dans ./stream/pipeline.js , ouvrez un problème si vous êtes bloqué.
Vous pouvez générer un fichier polylignes à partir de vos propres données, les données DOIVENT être encodées au format suivant :
n ). ). La géométrie est codée à l'aide de l'algorithme polyligne de Google avec une précision de 6 .
REMARQUE : de nombreuses bibliothèques auront par défaut une précision de 5 , ce qui entraînera des erreurs. Assurez-vous de sélectionner la précision de polyligne correcte.
Il existe un script inclus dans ce dépôt qui est capable de ré-encoder les fichiers générés avec précision 5 en précision 6 , vous pouvez le trouver dans bin/reencode.js .
Chaque ligne commence par la polyligne codée, suivie d'un octet nul ( ) puis suivie d'un ou plusieurs noms (délimités par un octet nul) et enfin terminée par une nouvelle ligne ( n ).
Exemple:
{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.
Afin d'indiquer à l'importateur l'emplacement de vos téléchargements et les paramètres environnementaux, vous devrez d'abord créer un fichier ~/pelias.json .
Voir la documentation de configuration pour plus de détails sur la structure de ce fichier. Vos informations de configuration pertinentes pour le module polyligne pourraient ressembler à ceci :
remarque : l'importateur ne prend actuellement en charge qu'une seule entrée dans le tableau files . De plus, le fichier de configuration n'accepte que les "polylignes" (sans le "s").
"imports" : {
"polyline" : {
"datapath" : "/data" ,
"files" : [ "road_network.0sv" ]
}
} Les données polylignes n'ont pas de hiérarchie administrative complète (c'est-à-dire les noms de pays, d'état, de comté, etc.), mais elles peuvent être calculées à l'aide des données de Who's on First. Consultez le fichier Lisez-moi de pelias/wof-admin-lookup pour plus d'informations. Par défaut, adminLookup est activé. Pour désactiver, définissez imports.adminLookup.enabled sur false dans la configuration Pelias.
Remarque : La recherche par l'administrateur nécessite le chargement d'environ 5 Go de données en mémoire.
Cela démarrera le processus d'importation, il faudra environ 30 secondes pour amorcer les données en mémoire, puis vous devriez voir une sortie de débogage régulière dans le terminal.
$ PELIAS_CONFIG= < path_to_config_json > npm startVous pouvez utiliser l'outil CLI pour exécuter des importations et à des fins de débogage :
remarque : par défaut, l'outil cli lira depuis stdin et écrira sur 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
Exécutez un « essai à sec » du processus d'importation :
node ./bin/cli.js --config --prettyImportez un fichier spécifique dans elasticsearch :
node ./bin/cli.js --file=/tmp/myfile.polylines --dbVous pouvez générer un extrait de polylignes personnalisé à l'aide de cet outil OSM PBF.
Remarque : Golang 1.9+ est requis, veuillez vous assurer qu'il est correctement installé avant de continuer.
$ 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
Si vous rencontrez des problèmes lors de la configuration ou si quelque chose manque dans la documentation, veuillez ouvrir un problème ici : https://github.com/pelias/polylines/issues
Veuillez fork et pull request contre le maître en amont sur une branche de fonctionnalités.
Jolie s'il vous plaît ; fournir des tests unitaires et des montages de script dans le répertoire test .
Un fichier .jshintrc est fourni qui contient une configuration de linting, généralement votre éditeur de texte comprendra cette configuration et vous donnera des conseils en ligne sur le style et la lisibilité du code.
Ces paramètres sont strictement appliqués lorsque vous effectuez un git commit , vous pouvez exécuter git commit à tout moment pour exécuter le linter sur votre code.
$ npm testTravis teste chaque modification par rapport à nos versions Node.js prises en charge.
