polylines
v3.0.0
Pelias es un geocodificador impulsado completamente por datos abiertos, disponible gratuitamente para todos.
Instalación local · Servicio web en la nube · Documentación · Chat comunitario
El importador de polilíneas facilita la importación de datos de la red de carreteras a Pelias desde una lista de cadenas de líneas codificadas por polilíneas.
Se requiere Node.js. Consulte los requisitos del software Pelias para conocer las versiones compatibles.
Dado que este módulo es solo una parte de nuestro geocodificador, recomendamos comenzar con nuestros Dockerfiles para una configuración rápida o con nuestros documentos de instalación completos para usar este módulo.
$ git clone https://github.com/pelias/polylines.git && cd polylines
$ npm installLos archivos preprocesados de la red de carreteras planetarias están disponibles para descargar desde Geocode Earth.
Nota: las extensiones de archivo
.0svy.polylinesse usan indistintamente, ambas se refieren al mismo formato de archivo; sin embargo, hay un código que busca la extensión.0sv, que por lo tanto es preferible.
Para obtener más información sobre cómo se generó el extracto, consulte el artículo de la wiki: Generando polilíneas desde Valhalla.
También tenemos algunos extractos más pequeños para fines de prueba; una pequeña cantidad se cortó manualmente de pbf para las geografías de nuestros principales contribuyentes. Consulte la sección 'Generar un extracto de polilíneas personalizado a partir de un extracto PBF' a continuación para obtener más información sobre cómo generar sus propios extractos:
nota: estos extractos se generaron utilizando un método diferente al del planeta cortado arriba.
Una vez que haya descargado y extraído los datos, deberá seguir los pasos de configuración a continuación para indicarle a Pelias dónde se pueden encontrar.
Si desea utilizar una fuente diferente de datos de polilínea, es posible que deba modificar los valores predeterminados en ./stream/pipeline.js , abra un problema si se queda atascado.
Puede generar un archivo de polilíneas a partir de sus propios datos; los datos DEBEN estar codificados en el siguiente formato:
n ). ). La geometría se codifica utilizando el algoritmo de polilínea de Google con una precisión de 6 .
NOTA: muchas bibliotecas establecerán de forma predeterminada la precisión en 5 , lo que provocará errores; asegúrese de seleccionar la precisión de polilínea correcta.
Hay un script incluido en este repositorio que es capaz de volver a codificar archivos generados con precisión 5 a precisión 6 , puede encontrarlo en bin/reencode.js .
Cada fila comienza con la polilínea codificada, seguida de un byte nulo ( ), seguido de uno o más nombres (delimitados con un byte nulo) y finalmente termina con una nueva línea ( n ).
Ejemplo:
{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.
Para indicarle al importador la ubicación de sus descargas y la configuración ambiental, primero deberá crear un archivo ~/pelias.json .
Consulte la documentación de configuración para obtener detalles sobre la estructura de este archivo. Su información de configuración relevante para el módulo de polilínea podría verse así:
nota: el importador actualmente solo admite una única entrada en la matriz files . Además, el archivo de configuración sólo acepta "polilínea" (sin la "s").
"imports" : {
"polyline" : {
"datapath" : "/data" ,
"files" : [ "road_network.0sv" ]
}
} Los datos de polilínea no tienen una jerarquía administrativa completa (es decir, nombres de país, estado, condado, etc.), pero se pueden calcular utilizando datos de Who's on First. Consulte el archivo Léame de pelias/wof-admin-lookup para obtener más información. De forma predeterminada, adminLookup está habilitado. Para deshabilitarlo, configure imports.adminLookup.enabled en false en la configuración de Pelias.
Nota: La búsqueda de administrador requiere cargar alrededor de 5 GB de datos en la memoria.
Esto iniciará el proceso de importación, tomará alrededor de 30 segundos preparar los datos en la memoria y luego debería ver el resultado de depuración regular en la terminal.
$ PELIAS_CONFIG= < path_to_config_json > npm startPuede utilizar la herramienta CLI para ejecutar importaciones y con fines de depuración:
nota: de forma predeterminada, la herramienta cli leerá desde stdin y escribirá en 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
Ejecute un 'ensayo' del proceso de importación:
node ./bin/cli.js --config --prettyImporte un archivo específico a elasticsearch:
node ./bin/cli.js --file=/tmp/myfile.polylines --dbPuede generar un extracto de polilíneas personalizado utilizando esta herramienta OSM PBF.
Nota: se requiere golang 1.9+; asegúrese de que esté instalado correctamente antes de continuar.
$ 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 tiene algún problema con la configuración o le falta algo a la documentación, abra un problema aquí: https://github.com/pelias/polylines/issues
Bifurque y extraiga la solicitud contra el maestro ascendente en una rama de función.
Bastante por favor; proporcione pruebas unitarias y accesorios de script en el directorio test .
Se proporciona un archivo .jshintrc que contiene una configuración de linting; normalmente su editor de texto entenderá esta configuración y le dará sugerencias en línea sobre el estilo y la legibilidad del código.
Estas configuraciones se aplican estrictamente cuando realiza un git commit , puede ejecutar git commit en cualquier momento para ejecutar linter en su código.
$ npm testTravis prueba cada cambio con nuestras versiones compatibles de Node.js.
