polylines
v3.0.0
Pelias는 모든 사람이 무료로 사용할 수 있는 개방형 데이터로 구동되는 지오코더입니다.
로컬 설치 · 클라우드 웹 서비스 · 문서 · 커뮤니티 채팅
폴리라인 가져오기 도구를 사용하면 폴리라인으로 인코딩된 행 문자열 목록에서 도로 네트워크 데이터를 Pelias로 쉽게 가져올 수 있습니다.
Node.js가 필요합니다. 지원되는 버전은 Pelias 소프트웨어 요구 사항을 참조하세요.
이 모듈은 지오코더의 일부일 뿐이므로 빠른 설정을 위해 Dockerfiles로 시작하거나 이 모듈을 사용하려면 전체 설치 문서로 시작하는 것이 좋습니다.
$ git clone https://github.com/pelias/polylines.git && cd polylines
$ npm install사전 처리된 전 세계의 도로 네트워크 파일을 Geocode Earth에서 다운로드할 수 있습니다.
참고: 파일 확장자
.0sv와.polylines같은 의미로 사용되며 둘 다 동일한 파일 형식을 나타냅니다. 그러나.0sv확장자를 찾는 코드가 있으므로 이것이 바람직합니다.
추출이 생성된 방법에 대한 자세한 내용은 Valhalla에서 폴리라인 생성 위키 문서를 참조하세요.
우리는 또한 테스트 목적으로 더 작은 추출을 가지고 있으며, 주요 기여자의 지역에 대해 pbf에서 소수를 수동으로 잘라냈습니다. 자체 추출을 생성하는 방법에 대한 자세한 내용은 아래의 'PBF 추출에서 사용자 정의 폴리라인 추출 생성' 섹션을 참조하세요.
참고: 이 추출물은 위에서 잘라낸 행성과 다른 방법을 사용하여 생성되었습니다.
데이터를 다운로드하고 추출한 후에는 Pelias에게 해당 데이터를 찾을 수 있는 위치를 알려주기 위해 아래 구성 단계를 따라야 합니다.
폴리라인 데이터의 다른 소스를 사용하려면 ./stream/pipeline.js 에서 기본값을 조정해야 할 수 있습니다. 문제가 발생하면 문제를 열어주세요.
자신의 데이터에서 폴리라인 파일을 생성할 수 있으며, 데이터는 다음 형식으로 인코딩되어야 합니다.
n ) 문자로 끝납니다. ) 문자로 구분됩니다. 도형은 Google 폴리라인 알고리즘을 사용하여 6 의 정밀도로 인코딩됩니다.
참고: 많은 라이브러리의 기본 정밀도는 5 입니다. 이로 인해 오류가 발생하므로 올바른 폴리라인 정밀도를 선택하십시오.
이 저장소에는 정밀도 5 에서 정밀도 6 으로 생성된 파일을 다시 인코딩할 수 있는 스크립트가 포함되어 있으며, bin/reencode.js 에서 찾을 수 있습니다.
각 행은 인코딩된 폴리라인으로 시작하고 그 뒤에 널 바이트( )가 오고 그 뒤에 하나 이상의 이름(널 바이트로 구분됨)이 오고 마지막으로 줄 바꿈( 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 배열에서 단일 항목만 지원합니다. 또한 구성 파일은 "폴리라인"("s" 제외) 만 허용합니다.
"imports" : {
"polyline" : {
"datapath" : "/data" ,
"files" : [ "road_network.0sv" ]
}
} 폴리라인 데이터에는 전체 행정 계층 구조(예: 국가, 주, 군 등 이름)가 없지만 Who's on First의 데이터를 사용하여 계산할 수 있습니다. 자세한 내용은 pelias/wof-admin-lookup에 대한 추가 정보를 참조하세요. 기본적으로 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 디렉터리에 단위 테스트와 스크립트 고정 장치를 제공합니다.
Linting 구성이 포함된 .jshintrc 파일이 제공됩니다. 일반적으로 텍스트 편집기는 이 구성을 이해하고 코드 스타일과 가독성에 대한 인라인 힌트를 제공합니다.
이러한 설정은 git commit 수행할 때 엄격하게 적용되며, 언제든지 git commit 실행하여 코드에 대해 linter를 실행할 수 있습니다.
$ npm testTravis는 지원되는 Node.js 버전에 대해 모든 변경 사항을 테스트합니다.
