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. للتعطيل، قم بتعيين imports.adminLookup.enabled إلى false في تكوين Pelias.
ملاحظة: يتطلب بحث المسؤول تحميل حوالي 5 غيغابايت من البيانات في الذاكرة.
سيؤدي هذا إلى بدء عملية الاستيراد، وسيستغرق الأمر حوالي 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 والذي يحتوي على تكوين الفحص، وعادة ما يفهم محرر النصوص هذا التكوين ويعطيك تلميحات مضمنة حول نمط التعليمات البرمجية وسهولة القراءة.
يتم فرض هذه الإعدادات بشكل صارم عند تنفيذ git commit ، ويمكنك تنفيذ git commit في أي وقت لتشغيل linter مقابل التعليمات البرمجية الخاصة بك.
$ npm testيقوم Travis باختبار كل تغيير مقابل إصدارات Node.js المدعومة لدينا.
