polylines
v3.0.0
Pelias เป็น geocoder ที่ขับเคลื่อนโดยข้อมูลแบบเปิดโดยสมบูรณ์ ซึ่งทุกคนสามารถใช้ได้อย่างเสรี
การติดตั้งในพื้นที่ · บริการเว็บบนคลาวด์ · เอกสารประกอบ · การแชทในชุมชน
ผู้นำเข้าเส้นโพลีไลน์อำนวยความสะดวกในการนำเข้าข้อมูลเครือข่ายถนนไปยัง Pelias จากรายการสตริงเส้นที่เข้ารหัสเส้นโพลีไลน์
จำเป็นต้องมี Node.js ดูข้อกำหนดซอฟต์แวร์ Pelias สำหรับเวอร์ชันที่รองรับ
เนื่องจากโมดูลนี้เป็นเพียงส่วนหนึ่งของ geocoder ของเรา เราจึงขอแนะนำให้เริ่มต้นด้วย Dockerfiles เพื่อการตั้งค่าอย่างรวดเร็ว หรือใช้เอกสารการติดตั้งทั้งหมดเพื่อใช้โมดูลนี้
$ git clone https://github.com/pelias/polylines.git && cd polylines
$ npm installไฟล์เครือข่ายถนนทั่วทั้งโลกที่ประมวลผลล่วงหน้าพร้อมให้ดาวน์โหลดจาก Geocode Earth
หมายเหตุ: นามสกุลไฟล์
.0svและ.polylinesใช้แทนกันได้ โดยทั้งคู่อ้างอิงถึงรูปแบบไฟล์เดียวกัน อย่างไรก็ตาม มีโค้ดที่ค้นหาส่วนขยาย.0svซึ่งเป็นที่นิยมมากกว่า
สำหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีการสร้างสารสกัด โปรดดูบทความวิกิ: การสร้างโพลีไลน์จาก Valhalla
นอกจากนี้เรายังมีสารสกัดเล็กๆ น้อยๆ เพื่อวัตถุประสงค์ในการทดสอบ โดยมีจำนวนเล็กน้อยที่ถูกตัดออกจาก pbf ด้วยตนเองสำหรับภูมิศาสตร์ของผู้มีส่วนร่วมหลักของเรา ดูส่วน 'การสร้างโพลีไลน์แบบกำหนดเองจากสารสกัด PBF' ด้านล่างสำหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีการสร้างสารสกัดของคุณเอง:
หมายเหตุ: สารสกัดเหล่านี้ถูกสร้างขึ้นโดยใช้วิธีการอื่นจากดาวเคราะห์ที่ถูกตัดด้านบน
เมื่อคุณดาวน์โหลดและแตกข้อมูลแล้ว คุณจะต้องทำตามขั้นตอน การกำหนดค่า ด้านล่างเพื่อแจ้งให้ Pelias ทราบว่าข้อมูลดังกล่าวสามารถพบได้ที่ใด
หากคุณต้องการใช้แหล่งข้อมูล Polyline แหล่งอื่น คุณอาจต้องปรับแต่งค่าเริ่มต้นใน ./stream/pipeline.js ให้เปิดปัญหาหากคุณติดขัด
คุณสามารถสร้างไฟล์โพลีไลน์จากข้อมูลของคุณเองได้ ข้อมูลจะต้องเข้ารหัสในรูปแบบต่อไปนี้:
n ) ) เรขาคณิตถูกเข้ารหัสโดยใช้อัลกอริธึม Google polyline ที่ความแม่นยำ 6
หมายเหตุ: ไลบรารีจำนวนมากจะตั้งค่าเริ่มต้นของความแม่นยำเป็น 5 ซึ่งจะทำให้เกิดข้อผิดพลาด โปรดแน่ใจว่าได้เลือกความแม่นยำของเส้นหลายเส้นที่ถูกต้อง
มีสคริปต์รวมอยู่ใน repo นี้ซึ่งสามารถเข้ารหัสไฟล์ที่สร้างด้วย precison 5 ถึง precision 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 นอกจากนี้ ไฟล์ปรับแต่งจะยอมรับ เฉพาะ "polyline" เท่านั้น (ไม่มี "s")
"imports" : {
"polyline" : {
"datapath" : "/data" ,
"files" : [ "road_network.0sv" ]
}
} ข้อมูล Polyline ไม่มีลำดับชั้นการบริหารแบบเต็ม (เช่น ชื่อประเทศ รัฐ เคาน์ตี ฯลฯ) แต่สามารถคำนวณได้โดยใช้ข้อมูลจาก Who's on First ดู readme สำหรับ pelias/wof-admin-lookup สำหรับข้อมูลเพิ่มเติม ตามค่าเริ่มต้น adminLookup จะเปิดใช้งาน หากต้องการปิดใช้งาน ให้ตั้ง imports.adminLookup.enabled เป็น false ในการกำหนดค่า Pelias
หมายเหตุ: การค้นหาผู้ดูแลระบบจำเป็นต้องโหลดข้อมูลประมาณ 5GB ลงในหน่วยความจำ
การดำเนินการนี้จะเริ่มกระบวนการนำเข้า โดยจะใช้เวลาประมาณ 30 วินาทีในการจัดเตรียมข้อมูลในหน่วยความจำ จากนั้นคุณควรเห็นเอาต์พุตการดีบักปกติในเทอร์มินัล
$ PELIAS_CONFIG= < path_to_config_json > npm startคุณสามารถใช้เครื่องมือ CLI เพื่อดำเนินการนำเข้าและเพื่อการแก้ไขจุดบกพร่อง:
หมายเหตุ: โดยค่าเริ่มต้น เครื่องมือ 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
มีการจัดเตรียมไฟล์ .jshintrc ซึ่งมีการกำหนดค่า Linting โดยปกติแล้วโปรแกรมแก้ไขข้อความของคุณจะเข้าใจการกำหนดค่านี้ และให้คำแนะนำแบบอินไลน์เกี่ยวกับรูปแบบโค้ดและความสามารถในการอ่าน
การตั้งค่าเหล่านี้จะถูกบังคับใช้อย่างเคร่งครัดเมื่อคุณทำการ git commit คุณสามารถดำเนินการ git commit ได้ตลอดเวลาเพื่อรัน linter กับโค้ดของคุณ
$ npm testTravis ทดสอบทุกการเปลี่ยนแปลงกับเวอร์ชัน Node.js ที่เรารองรับ
