polylines
v3.0.0
Pelias é um geocodificador totalmente alimentado por dados abertos, disponíveis gratuitamente para todos.
Instalação local · Webservice em nuvem · Documentação · Bate-papo comunitário
O importador de polilinhas facilita a importação de dados da rede rodoviária para o Pelias a partir de uma lista de cadeias de linhas codificadas em polilinhas.
Node.js é obrigatório. Consulte os requisitos de software Pelias para versões suportadas.
Como este módulo é apenas uma parte do nosso geocodificador, recomendamos começar com nossos Dockerfiles para configuração rápida ou com nossos documentos de instalação completos para usar este módulo.
$ git clone https://github.com/pelias/polylines.git && cd polylines
$ npm installArquivos pré-processados da rede rodoviária de todo o planeta estão disponíveis para download no Geocode Earth.
Nota: as extensões de arquivo
.0sve.polylinessão usadas de forma intercambiável, ambas se referem ao mesmo formato de arquivo; no entanto, existe um código que procura a extensão.0sv, que é, portanto, preferível.
Para obter mais informações sobre como a extração foi gerada, consulte o artigo wiki: Gerando polilinhas do Valhalla.
Também temos alguns extratos menores para fins de teste; um pequeno número foi cortado manualmente do pbf para as geografias de nossos principais colaboradores. Consulte a seção 'Gerando uma extração de polilinhas personalizada a partir de uma extração PBF' abaixo para obter mais informações sobre como você pode gerar suas próprias extrações:
nota: esses extratos foram gerados usando um método diferente do planeta cortado acima.
Depois de baixar e extrair os dados você precisará seguir os passos de configuração abaixo para informar ao Pelias onde eles podem ser encontrados.
Se você quiser usar uma fonte diferente de dados de polilinha, pode ser necessário ajustar os padrões em ./stream/pipeline.js , abra um problema se tiver dúvidas.
Você pode gerar um arquivo de polilinhas a partir de seus próprios dados, os dados DEVEM ser codificados no seguinte formato:
n ). ). A geometria é codificada usando o algoritmo de polilinha do Google com uma precisão de 6 .
NOTA: muitas bibliotecas terão como padrão a precisão 5 , isso causará erros, certifique-se de selecionar a precisão correta da polilinha.
Há um script incluído neste repositório que é capaz de recodificar arquivos gerados com precisão 5 até precisão 6 , você pode encontrá-lo em bin/reencode.js .
Cada linha começa com a polilinha codificada, seguida por um byte nulo ( ), seguida por um ou mais nomes (delimitados com um byte nulo) e finalmente terminada com uma nova linha ( n ).
Exemplo:
{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 informar ao importador a localização dos seus downloads e configurações ambientais, primeiro você precisará criar um arquivo ~/pelias.json .
Consulte a documentação de configuração para obter detalhes sobre a estrutura deste arquivo. Suas informações de configuração relevantes para o módulo polilinha podem ser mais ou menos assim:
nota: o importador atualmente suporta apenas uma única entrada na matriz files . Além disso, o arquivo de configuração aceita apenas "polilinha" (sem o "s").
"imports" : {
"polyline" : {
"datapath" : "/data" ,
"files" : [ "road_network.0sv" ]
}
} Os dados de polilinha não possuem uma hierarquia administrativa completa (ou seja, nomes de país, estado, município, etc.), mas podem ser calculados usando dados de Who's on First. Consulte o leia-me de pelias/wof-admin-lookup para obter mais informações. Por padrão, adminLookup está ativado. Para desabilitar, defina imports.adminLookup.enabled como false na configuração do Pelias.
Observação: a pesquisa do administrador requer o carregamento de cerca de 5 GB de dados na memória.
Isso iniciará o processo de importação, levará cerca de 30 segundos para preparar os dados na memória e então você deverá ver a saída de depuração regular no terminal.
$ PELIAS_CONFIG= < path_to_config_json > npm startVocê pode usar a ferramenta CLI para executar importações e para fins de depuração:
nota: por padrão, a ferramenta cli irá ler stdin e gravar em 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
Execute uma simulação do processo de importação:
node ./bin/cli.js --config --prettyImporte um arquivo específico para o elasticsearch:
node ./bin/cli.js --file=/tmp/myfile.polylines --dbVocê pode gerar uma extração de polilinhas personalizada usando esta ferramenta OSM PBF.
Nota: golang 1.9+ é necessário, certifique-se de que esteja instalado corretamente 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
Se você tiver algum problema de configuração ou estiver faltando alguma coisa na documentação, abra um problema aqui: https://github.com/pelias/polylines/issues
Faça bifurcação e pull de solicitação contra o mestre upstream em uma ramificação de recurso.
Por favor; forneça testes de unidade e acessórios de script no diretório test .
É fornecido um arquivo .jshintrc que contém uma configuração de linting. Geralmente, seu editor de texto entenderá essa configuração e fornecerá dicas embutidas sobre estilo e legibilidade do código.
Essas configurações são estritamente aplicadas quando você faz um git commit , você pode executar git commit a qualquer momento para executar o linter em seu código.
$ npm testTravis testa todas as alterações em nossas versões suportadas do Node.js.
