الخرائط ونظم المعلومات الجغرافية الأدلة التقنية

ما هي OpenStreetMap؟ البيانات والرخصة والمساهمة

كيف تبنى أكبر قاعدة بيانات جغرافية مفتوحة من نقاط وطرق ووسوم، وما الذي تلزمك به رخصتها، وكيف تفحص جودتها في مدينتك قبل أن تبني عليها.

ما هي OpenStreetMap؟ البيانات والرخصة والمساهمة

افتح أي تطبيق خرائط على هاتفك وابحث عن صيدلية قريبة منك، وسوف تجد أحياناً صيدلية أغلقت منذ سنة، أو شارعاً جديداً لم يظهر بعد، أو اسماً عربياً مكتوباً بطريقة غريبة. وقد يتساءل البعض: من يصحح هذه الأخطاء؟ وهل هناك جهة واحدة في العالم ترسم كل شارع وكل مبنى؟ الإجابة في حالة شركات الخرائط الكبيرة أنها فرق مسح وصور جوية وعقود مع جهات حكومية، أما في حالة OpenStreetMap فالإجابة مختلفة تماماً: ملايين المتطوعين يعدلون قاعدة بيانات واحدة مفتوحة، وأي شخص يستطيع أن يصحح الصيدلية المغلقة في حيه الآن، وأي شركة تستطيع أن تبني خريطتها على هذه البيانات بشروط رخصة واضحة.

وقد استخدمنا بيانات OpenStreetMap في مقالات سابقة دون أن نتوقف عندها، فبنينا منها خريطة الرياض على سيرفرك، وقرأنا ما داخل مربعاتها في كيف تعمل الخرائط الرقمية، وفحصنا جودة بيانات الأماكن فيها في كيف تبني تطبيق خرائط. وفي هذا المقال نرجع خطوة إلى الخلف ونفهم المصدر نفسه. وسوف نناقش في هذا المقال ما يلي:

  • ما هي OpenStreetMap ومن يديرها، ولماذا هي قاعدة بيانات Database وليست خريطة.
  • نموذج البيانات Data Model: النقطة Node والطريق Way والعلاقة Relation والوسوم Tags، على مثال حقيقي من المدينة المنورة.
  • رخصة ODbL وما تلزمك به عملياً عند استخدام البيانات.
  • كيف تتحرك البيانات من المساهم إلى ملف تحمله أنت: الواجهة البرمجية API ومجموعات التغيير Changesets والمقتطفات Extracts وOverpass API.
  • كيف تساهم بنفسك: محرر iD في المتصفح، وJOSM على الجهاز، وStreetComplete على الهاتف، وما الذي لا يجوز نسخه.
  • الجودة والتخريب Vandalism: كيف يكتشف المجتمع التعديلات الخاطئة، مع حادثة موثقة وتاريخ تعديلات حقيقي لعنصر واحد.
  • تجربة عملية: نحمل مقتطفاً حقيقياً من Geofabrik، ونقص منه المدينة المنورة بأداة osmium، ونعد العناصر حسب الوسوم، ثم نسأل Overpass API نفس السؤال ونقارن.

ما هي OpenStreetMap؟

OpenStreetMap واختصاراً OSM مشروع بدأه Steve Coast في بريطانيا سنة 2004، كما في صفحة تاريخ المشروع، والفكرة بسيطة: الخرائط الرسمية في ذلك الوقت كانت مملوكة ومكلفة، فلماذا لا نرسم خريطة العالم بأنفسنا كما كتب الناس موسوعة Wikipedia؟ واليوم تديره مؤسسة OpenStreetMap وهي منظمة غير ربحية تملك السيرفرات وتحمي الرخصة، ولكنها لا ترسم الخريطة، فالرسم كله من المساهمين.

والنقطة التي يجب أن تفهمها من البداية أن OSM قاعدة بيانات جغرافية Geographic Database، وليست صورة خريطة. ما تراه على موقع openstreetmap.org هو خريطة واحدة مرسومة من هذه البيانات بأسلوب معين، أما البيانات نفسها فهي نقاط وخطوط ومضلعات ومعها وسوم نصية، وتستطيع أن تأخذها وترسم منها خريطتك بألوانك ولغتك، أو تبني منها محرك بحث عن العناوين، أو تحسب منها المسارات، أو تحللها في QGIS، وهذا ما تفعله أغلب المقالات في هذه المرحلة.

ولماذا يهمك هذا كمطور أو مدير أنظمة؟ والسبب أن البديل التجاري يعني أن تدفع على كل طلب، وأن تلتزم بشروط استخدام قد تمنعك من تخزين البيانات أو عرضها على خريطة أخرى، وقد ناقشنا ذلك بالتفصيل في قسم الرخص في مقال تطبيق الخرائط. أما OSM فتعطيك البيانات كاملة، وتطلب منك في المقابل أن تنسبها وأن تشارك ما تعدله فيها بنفس الرخصة.

وقد يتساءل البعض: هل يمكن لبيانات متطوعين أن تكون أدق من بيانات شركة؟ والإجابة أنها تعتمد على المكان، فالمتطوع الذي يسكن الحي يعرف أن الشارع أغلق للصيانة قبل أي شركة، ولكن الحي الذي لا يسكنه متطوع نشيط قد يبقى سنوات دون تحديث. وأوضح مثال على قوة النموذج ما حدث بعد زلزال هايتي في يناير 2010، حيث رسم المساهمون من حول العالم طرق العاصمة ومخيمات النازحين من الصور الجوية خلال أيام، واستخدمت فرق الإغاثة هذه الخريطة لأنها كانت الأحدث، كما في صفحة المشروع في الويكي، ومن هذه التجربة نشأ الفريق الإنساني لـ OpenStreetMap الذي ينظم الرسم بعد الكوارث إلى اليوم.

نموذج البيانات: النقطة والطريق والعلاقة

كل ما في OSM مبني من ثلاثة أنواع فقط من العناصر Elements، كما في توثيق العناصر، ومعها الوسوم التي تعطيها المعنى:

  • النقطة Node: موقع واحد له رقم تعريف ID وخط عرض وخط طول على WGS84. وقد تكون النقطة عنصراً قائماً بذاته، مثل صيدلية أو إشارة مرور، وقد تكون مجرد زاوية في طريق أو مبنى بلا أي وسم.
  • الطريق Way: قائمة مرتبة من أرقام النقاط، من نقطتين إلى 2,000 نقطة كحد أقصى بحسب إعدادات الواجهة البرمجية. والطريق المفتوح خط، مثل شارع أو نهر، والطريق المغلق الذي تكون نقطته الأخيرة هي نفسها الأولى قد يكون خطاً دائرياً أو مساحة Area، مثل مبنى أو حديقة، والوسوم هي التي تحدد أيهما.
  • العلاقة Relation: مجموعة من العناصر لكل منها دور Role، وتستخدم لما لا يمثله طريق واحد: حدود منطقة إدارية مكونة من عشرات الطرق، أو مسار حافلة يمر بشوارع كثيرة، أو مبنى له فناء داخلي، فالحد الخارجي دوره outer والفناء دوره inner.
  • الوسوم Tags: أزواج من مفتاح Key وقيمة Value، مثل amenity=pharmacy أو name:ar=صيدلية النهدي. ولا يوجد مخطط Schema ثابت يفرضه الكود، وإنما اتفاق بين المساهمين موثق في صفحة Map Features، فأي شخص يستطيع أن يكتب أي وسم، والمعتمد هو ما يستخدمه الناس ويوثقونه.

لنأخذ مثالاً حقيقياً: المسجد النبوي في OSM هو الطريق رقم 461699097، وهو طريق مغلق من 118 نقطة أولها وآخرها النقطة 3059361946، والوسوم التي عليه هي التي تقول إنه مبنى ومكان عبادة وتعطيه أسماءه بأكثر من عشرين لغة. ولاحظ أن الشكل نفسه لا يعرف شيئاً عن المسجد، فهو مجرد قائمة نقاط، والمعنى كله في الوسوم. والصورة التالية تبين العلاقة بين الأنواع الثلاثة:

ثلاثة أعمدة: النقطة Node برقم وخط عرض وطول مثل صيدلية عليها amenity=pharmacy، والطريق Way كقائمة مرتبة من أرقام النقاط مع مثال المسجد النبوي way 461699097 بـ 118 نقطة أولها وآخرها 3059361946 فهو مغلق، والعلاقة Relation كمجموعة أعضاء لها أدوار outer وinner مثل حدود منطقة إدارية، وتحتها صندوق الوسوم key=value مثل building=yes وamenity=place_of_worship وname:ar وname:en
كل ما في OpenStreetMap نقاط وطرق وعلاقات، والوسوم هي التي تعطيها المعنى

والصورة التالية هي نفس العنصر كما يعرضه موقع OpenStreetMap عند فتح رابطه، والجدول على اليمين هو الوسوم نفسها:

لقطة شاشة من موقع openstreetmap.org بالعربية تعرض الطريق 461699097 المسجد النبوي، الإصدار 41، مع مضلع المسجد مظللاً بالبرتقالي على الخريطة، وعلى اليمين جدول الوسوم: addr:city المدينة المنورة وaddr:country SA وaddr:street وamenity place_of_worship وbuilding yes وheight 13 وname المسجد النبوي وname:ar
صفحة العنصر على openstreetmap.org: الشكل على الخريطة والوسوم في الجدول ورقم الإصدار

وفي هذه الصفحة لاحظ التالي:

  • رقم الإصدار Version هو 41، أي أن هذا العنصر عدل 41 مرة منذ إنشائه، وكل إصدار محفوظ ويمكن الرجوع إليه، وسوف نقرأ هذا التاريخ في التجربة.
  • الوسم name هو الاسم المحلي كما يكتبه أهل المكان، أي بالعربية هنا، والأسماء بلغات أخرى في name:en وname:fr وغيرها، وهذا ما تقرأه الخرائط عندما تعرض اللغة التي يختارها المستخدم.
  • الوسم addr:street فيه نص ليس اسم شارع، وهذا مثال حي على أن البيانات المفتوحة تحتاج فحصاً قبل أن تبني عليها، فلا يوجد مراجع يمنع قيمة غير صحيحة من الدخول.

متى يكون الطريق المغلق مساحة؟

قد يبدو السؤال بسيطاً، ولكنه من أكثر ما يربك من يكتب برنامجاً يقرأ OSM لأول مرة. الطريق المغلق قد يكون مبنى، وقد يكون دواراً Roundabout يدور حوله المرور، وقد يكون سوراً حول حديقة، والشكل في الحالات الثلاث واحد: قائمة نقاط أولها آخرها. والفيصل هو الوسوم: building=* وlanduse=* وleisure=park تعني مساحة دائماً، أما highway=* وbarrier=wall فتعني خطاً حتى لو كان مغلقاً، إلا إذا أضاف المساهم area=yes صراحة، كما في ساحة للمشاة. والأدوات الجاهزة مثل osmium وGDAL تحمل في داخلها جدولاً بهذه القواعد، فعندما تطلب منها تحويل البيانات إلى مضلعات فهي تقرر نيابة عنك، وإذا كتبت محولاً بنفسك فعليك أن تنقل هذا الجدول وإلا رسمت الدوارات كأنها مبان.

وأما المساحة التي لها فناء داخلي أو التي تتكون من أكثر من قطعة، مثل منطقة إدارية فيها جزر، فلا يكفيها طريق واحد، لذلك ترسم كعلاقة من نوع multipolygon أو boundary، أعضاؤها طرق بدور outer للحد الخارجي وinner للفراغات. وحدود منطقة المدينة المنورة في OSM مثلاً هي العلاقة 3679869، وأعضاؤها 82 طريقاً بدور outer تتصل ببعضها، ومعها تسع علاقات للمحافظات بدور subarea، ولو حذف مساهم طريقاً واحداً منها لانقطع المضلع ولم يعد مغلقاً واختفت المنطقة من أي أداة تبني المضلعات، وهذا يحدث فعلاً، لذلك تجد في أدوات الفحص قسماً كاملاً للعلاقات الناقصة.

كيف تحفظ البيانات في الملفات؟

ستقابل ثلاث صيغ لنفس البيانات. الصيغة الأولى XML، وهي ما تعطيك إياه الواجهة البرمجية افتراضياً، ونص مقروء ولكنه كبير جداً. والثانية PBF، أي Protocol Buffer Binary Format، وهي الصيغة التي تنشر بها المقتطفات وملف الكوكب، وتقسم البيانات إلى كتل Blocks مضغوطة، وتخزن النقاط بطريقة اسمها Dense Nodes تحفظ الفرق بين رقم كل نقطة والتي قبلها وبين إحداثياتها بدل القيم الكاملة، فالنقاط المتجاورة في الملف أرقامها وإحداثياتها متقاربة والفروق صغيرة، وهذا ما يجعل ملف الخليج 245 ميجابايت بدل عدة جيجابايتات. والثالثة OPL، وهي صيغة نصية من سطر واحد لكل عنصر تستخدمها أداة osmium للفحص السريع بأدوات مثل grep وawk، وسوف نستخدمها في التجربة لمعرفة عمر البيانات.

ولاحظ أن الملفات مرتبة: النقاط أولاً ثم الطرق ثم العلاقات، وكل نوع بحسب رقمه، فالبرنامج الذي يقرأ الطريق يكون قد مر بكل نقاطه قبله. وهذا الترتيب هو ما يسمح لأداة مثل osmium أن تعالج ملفاً كبيراً بقراءة متسلسلة سريعة، وهو أيضاً سبب أن قص منطقة يحتاج قراءتين للملف، كما سوف نرى.

الوسوم: الاتفاق أهم من الكود

بما أن الوسوم نصوص حرة، فالخطأ الأكثر شيوعاً هو أن يخترع كل مساهم طريقته. لذلك عليك قبل أن تضيف أي وسم أن تبحث عنه في الويكي وفي أداة taginfo التي تعرض كم مرة استخدم كل مفتاح وكل قيمة في العالم، فإذا وجدت أن amenity=pharmacy مستخدم ملايين المرات فلا تكتب shop=pharmacy لأنك تراه أوضح، والسبب أن كل برنامج يقرأ البيانات، من محرك الخرائط إلى محرك البحث، يبحث عن الوسم المتفق عليه ولن يرى وسمك.

وفي المنطقة العربية هناك قواعد خاصة بالأسماء تستحق الانتباه:

  • name يحمل الاسم بلغة المكان فقط، ولا تضع فيه «Prophet's Mosque المسجد النبوي» بلغتين، والسبب أن التطبيق الذي يعرض العربية سوف يعرض النص كاملاً بالإنجليزية والعربية معاً. وقد كان هذا الخطأ موجوداً فعلاً على المسجد النبوي من 2018 إلى 2022 كما سوف نرى في تاريخه.
  • name:ar وname:en يحملان الاسم بكل لغة، ووجود name:ar مهم حتى لو كان مطابقاً لـ name، لأن تطبيقاً يعرض الأسماء العربية سوف يبحث عنه أولاً.
  • الاسم يكون اسم المكان كما هو، وليس وصفه، فلا تكتب «صيدلية» في name لصيدلية لا اسم لها، والنوع موجود أصلاً في amenity=pharmacy.
  • الفروع التجارية يجب أن تحمل نفس الاسم ووسم brand، وإلا ظهرت نفس السلسلة بثلاثة أسماء مختلفة كما سوف نرى في التجربة.

الرخصة ODbL: ما الذي يلزمك عملياً؟

بيانات OSM مرخصة منذ سبتمبر 2012 برخصة Open Database License واختصاراً ODbL، وقبلها كانت برخصة Creative Commons BY-SA، وكان الانتقال مشروعاً طويلاً احتاج أن يوافق المساهمون على الرخصة الجديدة لما أضافوه، كما في صفحة الرخصة في الويكي.

وقد شرحنا شروط الرخصة الثلاثة في مقال الخريطة على سيرفرك، والحد الفاصل بين الطبقة المستقلة والقاعدة المشتقة في مقال تطبيق الخرائط، فلن نكررها هنا، وإنما نلخص ما يلزمك فعله في الحالات التي تمر بها عادة:

ما تفعله بالبياناتما يلزمك
تعرض خريطة مرسومة من OSM في موقعك أو تطبيقكنسبة ظاهرة «© OpenStreetMap contributors» مع رابط لصفحة حقوق النسخ، بحسب إرشادات النسبة
تنشر صورة خريطة في تقرير أو عرضنفس النسبة على الصورة أو تحتها، لأنها عمل منتج Produced Work من البيانات
تحمل مقتطفاً وتحلله داخلياً دون نشرلا يوجد إلزام بالنشر، فالرخصة تتعلق بالاستخدام العلني Public Use
تصحح الطرق في نسختك وتستخدمها علناًنسختك المعدلة قاعدة مشتقة Derivative Database ويجب أن تتيحها بنفس الرخصة
تضع نقاط فروعك فوق خريطة OSMقاعدة مجمعة Collective Database، فبياناتك تبقى لك، وتبقى النسبة

وتذكر أن الرخصة تتعلق بالبيانات، أما البرامج التي تعالجها فلها رخصها الخاصة، فمكتبة osmium التي سوف نستخدمها برخصة GPL، وهذا لا يغير شيئاً في رخصة البيانات التي تخرج منها.

كيف تصل البيانات من المساهم إليك؟

عندما يحفظ مساهم تعديله، فهو يرسله إلى الواجهة البرمجية API v0.6 داخل مجموعة تغيير Changeset، وهي حزمة تعديلات لها تعليق Comment يشرح ما تم ومصدر المعلومات، وقد تحمل حتى 10,000 تعديل. وكل عنصر يتغير يحصل على رقم إصدار جديد، ولا يحذف الإصدار القديم، لذلك تستطيع أن تعرف من عدل ماذا ومتى، وأن ترجع أي تعديل.

ولكن الواجهة البرمجية مخصصة للتحرير، وليست لتحميل البيانات بكميات كبيرة، وسياسة استخدامها تمنع ذلك صراحة. لذلك تخرج البيانات إلى العالم من طرق أخرى:

  • ملف الكوكب Planet: نسخة كاملة من القاعدة تنشر أسبوعياً على planet.openstreetmap.org، وحجمها بصيغة PBF يتجاوز 80 جيجابايت، فلن تحتاجها إلا إذا كنت تخدم العالم كله.
  • ملفات الفروقات Diffs: ملفات صغيرة كل دقيقة أو ساعة أو يوم فيها التعديلات فقط، وتستخدمها السيرفرات لتبقى محدثة دون إعادة تحميل كل شيء.
  • المقتطفات Extracts: شركات وأفراد يقصون الكوكب إلى دول ومناطق وينشرونها يومياً، وأشهرها Geofabrik، والمملكة عندها ضمن ملف دول الخليج GCC States، وهو ما سوف نستخدمه في التجربة.
  • Overpass API: قاعدة بيانات للقراءة فقط تسألها بلغة استعلام خاصة: «أعطني كل الصيدليات في هذا المستطيل»، وتعطيك النتيجة خلال ثوان، وهي مناسبة للأسئلة الصغيرة والمتكررة، كما في توثيقها.
مسار البيانات من اليمين إلى اليسار: المساهمون بمحررات iD وJOSM وStreetComplete يرسلون مجموعات التغيير إلى OSM API، ومنها إلى قاعدة البيانات الرئيسية، ثم تخرج منها ثلاثة طرق: ملف الكوكب الأسبوعي planet.osm.pbf أكثر من 80 جيجابايت، وملفات الفروقات كل دقيقة، ومنها مقتطفات Geofabrik اليومية مثل gcc-states.osm.pbf بحجم 245 ميجابايت، وخوادم Overpass API للاستعلام، وفي النهاية تطبيقاتك: الخرائط والبحث والمسارات وQGIS
المساهمون يكتبون عبر API، وأنت تقرأ من المقتطفات أو Overpass، وليس من API التحرير

والقاعدة العملية: إذا كان سؤالك صغيراً ومحدداً، مثل عدد الصيدليات في حي، فاستخدم Overpass. وإذا كنت تبني خدمة تعمل كل يوم، مثل سيرفر خرائط أو محرك بحث، فحمل مقتطفاً وعالجه عندك، والسبب أن خوادم Overpass العامة مشتركة بين آلاف المستخدمين، وسياسة استخدامها تطلب ألا تتجاوز قرابة 10,000 طلب و1 جيجابايت في اليوم، وقد تجدها مزدحمة في الوقت الذي تحتاجها فيه، كما حدث معنا في التجربة.

⚠️
مقتطفات Geofabrik العامة لا تحمل اسم المساهم ولا رقم مجموعة التغيير لكل عنصر، وإنما الإصدار والتاريخ فقط، والسبب أن هذه بيانات شخصية بحسب اللائحة الأوروبية لحماية البيانات، لذلك تضعها Geofabrik في سيرفر داخلي يتطلب الدخول بحساب OSM. فإذا كنت تحتاج معرفة من عدل عنصراً معيناً فاسأل الواجهة البرمجية عن تاريخه، كما سوف نفعل في التجربة.

كيف تساهم في OpenStreetMap؟

تبدأ بحساب مجاني على openstreetmap.org، ثم تختار المحرر المناسب لما تريد فعله. وهناك ثلاثة محررات سوف تغطي أغلب احتياجك:

  • iD: المحرر الذي يفتح عندما تضغط «تعديل» في الموقع نفسه، ويعمل في المتصفح دون تثبيت، ويقترح عليك الوسوم الصحيحة من قوالب جاهزة Presets، فتختار «صيدلية» فيضع amenity=pharmacy بنفسه. وهو الأنسب للتعديلات الصغيرة والمبتدئين.
  • JOSM: برنامج Java يعمل على جهازك، يحمل منطقة كاملة ويسمح بالتعديل دون اتصال، ومعه أدوات فحص Validator تكتشف الطرق المتقاطعة دون نقطة مشتركة والمباني المتداخلة قبل الرفع، وهو ما يستخدمه من يعدل بكميات كبيرة.
  • StreetComplete: تطبيق Android يعرض عليك أسئلة صغيرة اسمها مهام Quests عن الأماكن حولك: «ما ساعات عمل هذه الصيدلية؟»، «هل هذا الرصيف مرصوف؟»، وتجيب وأنت تمشي، فيكتب الوسوم نيابة عنك، وهو أسهل طريقة لتحسين البيانات التي يحتاجها الناس فعلاً.
ثلاث بطاقات للمحررات: iD في المتصفح مع رسم متصفح، للتعديلات الصغيرة والمبتدئين وقوالب جاهزة، وJOSM على الجهاز مع رسم حاسوب، للتعديلات الكبيرة والعمل دون اتصال وأداة الفحص، وStreetComplete على الهاتف مع رسم هاتف، للأسئلة الميدانية مثل ساعات العمل، وتحتها سهم: كلها ترسل مجموعة تغيير بتعليق ومصدر إلى OSM API
اختر المحرر بحسب حجم التعديل ومكانك: المتصفح أو الجهاز أو الشارع

وإذا لم تكن مستعداً للتعديل بنفسك، فهناك طريق أسهل: ملاحظات الخريطة Map Notes. تضغط على المكان في موقع OSM وتكتب «هذه الصيدلية أغلقت» أو «اسم الشارع تغير»، دون حساب أحياناً، فتظهر الملاحظة للمساهمين في تلك المنطقة ويصححها أحدهم. وهذه الطريقة مناسبة أيضاً إذا بنيت تطبيقاً على OSM وأردت أن يبلغ مستخدموك عن الأخطاء، فبدل أن تجمع البلاغات عندك وتصلحها في نسختك فقط، ترسلها ملاحظات إلى المصدر فيستفيد الجميع، وتبقى نسختك مطابقة للأصل.

ماذا يحدث بعد أن تحفظ تعديلك؟

لنفرض أنك أضفت ساعات عمل صيدلية في حيك بمحرر iD. الخطوات من لحظة الحفظ إلى أن يرى أحد تعديلك كما يلي:

  1. يرسل المحرر مجموعة تغيير فيها التعديل مع تعليقك ومصدرك، فيحصل العنصر على إصدار جديد في القاعدة الرئيسية خلال ثوان.
  2. خلال دقائق يدخل التعديل في ملف الفروقات الدقيقي، فتراه خوادم Overpass المحدثة، ويراه من يراقب منطقتك في OSMCha.
  3. الخريطة على موقع openstreetmap.org ترسم المربعات من جديد عند الحاجة، فقد يظهر التعديل خلال دقائق أو بعد ساعات بحسب مستوى التقريب.
  4. في اليوم التالي يصل التعديل إلى مقتطف Geofabrik لدول الخليج.
  5. يصل إلى تطبيقك عندما تحدث بياناتك، وإلى التطبيقات الأخرى عندما يحدثون بياناتهم، وقد يكون ذلك بعد أسابيع.

وهذا يفسر شكوى شائعة: «صححت الخطأ في OSM ولكنه ما زال يظهر في التطبيق». التصحيح وصل إلى المصدر، ولكن التطبيق يقرأ نسخة قديمة، وكل ما عليك هو الانتظار أو مراسلة صاحب التطبيق، ولا تقم بتكرار التعديل أو تغيير وسوم صحيحة ظناً أن التعديل لم يحفظ.

ما الذي لا يجوز نسخه؟

القاعدة الأهم في المساهمة هي المصدر. يجوز أن ترسم مما تعرفه بنفسك، ومن مشاهدتك في الميدان، ومن مسار GPS سجلته، ومن صور جوية سمحت أصحابها باستخدامها في OSM، مثل الطبقات الموجودة في قائمة الخلفيات داخل iD. ولا يجوز أن تنسخ من Google Maps أو أي خريطة تجارية، لا الأسماء ولا الأشكال ولا الصور الجوية، والسبب أن هذه البيانات محمية بحقوق أصحابها، وإذا ثبت النسخ فقد يحذف المجتمع كل ما أضفته. والمنع مكتوب في الكود نفسه، فإعدادات الواجهة البرمجية التي ذكرناها تحتوي قائمة حظر لعناوين صور Google وغيرها حتى لا تستخدمها المحررات خلفية للرسم.

وإذا كنت تساهم باسم شركة أو مشروع، كأن يضيف فريقك كل فروع شركتك أو ينظم مجموعة طلاب لرسم حي، فهذا اسمه التحرير المنظم Organised Editing، وله إرشادات تطلب منك أن توثق المشروع في صفحة على الويكي قبل البدء، وأن يستخدم كل محرر حساباً شخصياً يوضح علاقته بالشركة، وأن تتواصل مع المجتمع المحلي. أما رفع آلاف العناصر دفعة واحدة من ملف عندك فاسمه الاستيراد Import، وله إرشادات أشد تتطلب نقاشاً علنياً قبل الرفع، والسبب أن استيراداً سيئاً واحداً قد يفسد مدينة كاملة ويستغرق إصلاحه شهوراً.

💡
اكتب تعليقاً واضحاً لكل مجموعة تغيير، مثل «إضافة ساعات عمل ثلاث صيدليات في حي قباء من زيارة ميدانية»، واذكر المصدر في الوسم source للمجموعة. التعليق «تعديل» لا يساعد من يراجع تعديلاتك، وقد يجعله يشك فيها.

الجودة والتخريب: من يراقب التعديلات؟

قاعدة يعدلها أي شخص سوف تتعرض للخطأ وللتخريب المتعمد Vandalism، والسؤال هو كيف يكتشف ذلك. ولا توجد في OSM مراجعة قبل النشر، فالتعديل يظهر في القاعدة فوراً، والمراقبة تأتي بعده من عدة طبقات:

  • المساهمون المحليون: من يعدل في مدينته يتابع التغييرات فيها، وأدوات مثل OSMCha تعرض مجموعات التغيير وتعلم المشبوه منها، مثل حذف عدد كبير من العناصر أو تغيير اسم مدينة.
  • فريق بيانات المؤسسة Data Working Group: فريق يتعامل مع النزاعات والتخريب المتكرر، ويستطيع أن يحظر الحسابات ويرجع التعديلات.
  • الشركات التي تستخدم البيانات: شركة تعرض خريطة لملايين المستخدمين لا تأخذ كل تعديل كما هو، وإنما تمرره في خط فحص قبل أن يصل إلى خريطتها، وهذه هي الطبقة التي فشلت في الحادثة التالية.
📌
في أغسطس 2018 غير مستخدم في OSM اسم مدينة نيويورك إلى اسم مسيء ضد اليهود، وظهر الاسم في خرائط Snapchat وتطبيقات أخرى تعتمد على Mapbox. ونظام Mapbox علم التعديل على أنه مشبوه، ولكن مراجعاً بشرياً قبله بالخطأ فوصل إلى ملايين المستخدمين، كما نقلت TechCrunch عن الشركة. والدرس أن البيانات المفتوحة لا تعني أن تثق في كل تعديل، فإذا كنت تبني منتجاً على OSM فضع فحصاً على الأسماء الكبيرة والتغييرات المفاجئة قبل أن تحدث بياناتك.

والتخريب المتعمد نادر مقارنة بالأخطاء العادية: مساهم جديد يحذف وسماً لا يفهمه، أو يضع الاسم الإنجليزي في name، أو تطبيق يكتب بيانات بصيغة خاطئة. وتاريخ المسجد النبوي الذي سوف نقرؤه في التجربة فيه مثالان من هذا النوع: وسم أساسي حذف وبقي محذوفاً قرابة سنة ونصف دون أن يلاحظه أحد، ووسم اسم حذف وأعيد ثلاث مرات في يومين.

كيف تحمي تطبيقك من تعديل خاطئ؟

إذا كانت خدمتك تحدث بيانات OSM كل يوم، فأنت تأخذ معها كل خطأ دخل في ذلك اليوم، ولا تحتاج نظاماً معقداً مثل نظام Mapbox لتحمي نفسك، فيكفي فحص بسيط بين التحديث والذي قبله قبل أن تنشر:

  • أعداد الوسوم المهمة: احسب عدد الطرق والمباني والأماكن بأداة osmium tags-count كما سوف نفعل في التجربة، وقارنها بالتحديث السابق، فإذا نقص عدد الطرق في مدينتك 5% في يوم واحد فهناك حذف كبير يستحق النظر قبل النشر.
  • أسماء الأماكن الكبيرة: احتفظ بقائمة قصيرة من المدن والأحياء والمعالم وأسمائها، وأوقف النشر إذا تغير أحدها، والسبب أن هذا بالضبط ما حدث في حادثة نيويورك.
  • العلاقات الناقصة: إذا فشل بناء مضلع منطقة إدارية كان يبنى بالأمس، فلا تنشر حدوداً ناقصة، واستخدم نسخة الأمس لهذه المنطقة حتى تصلح.
  • إرجاع التحديث: احتفظ بالملف السابق، فإذا اكتشفت خطأ بعد النشر ترجع إليه خلال دقائق، ثم أبلغ المجتمع عن الخطأ بملاحظة أو بتعليق على مجموعة التغيير.

متى تكفيك OpenStreetMap ومتى لا تكفي؟

قد يتساءل البعض: هل يجوز لشركة تجارية أن تبني منتجها على بيانات متطوعين؟ والإجابة نعم، والرخصة لا تمنع الاستخدام التجاري إطلاقاً، وكثير من الشركات الكبيرة تفعل ذلك وتساهم في البيانات أيضاً. والسؤال الحقيقي ليس الإذن وإنما الجودة في منطقتك، وهي تختلف كثيراً بحسب نوع البيانات، والجدول التالي يلخص ما سوف تراه في المدن السعودية، وتؤكده أرقام التجربة:

نوع البياناتالحالة في OSMماذا تفعل
شبكة الطرق والاتجاهاتجيدة في المدن، وتكفي حساب المساراتاستخدمها مباشرة مع محركات المسارات
الحدود الإداريةالمناطق والمحافظات موجودة، ودقتها ليست رسميةللعرض والتجميع، وللاستخدام الرسمي ارجع إلى المصادر الحكومية
المبانيجزئية، وكثير من الأحياء بلا مبانافحص منطقتك أولاً، وفكر في مصادر أخرى
الأماكن وساعات العمل والهواتفناقصة وقديمة في الغالباجعلها طبقة تملكها وتحدثها، كما شرحنا في مقال تطبيق الخرائط
العناوين وأرقام المبانيقليلة جداًالعنوان الوطني من سبل هو المصدر الرسمي
الأسماء العربيةموجودة في name غالباً، وname:ar أقلارجع إلى name عند غياب name:ar

والقاعدة العملية: لا تحكم على OSM من مدينة أخرى أو من مقال قديم، وإنما من فحص لمنطقتك أنت بالأدوات التي في التجربة التالية، فالفحص يستغرق دقائق، وقرار بناء منتج على بيانات ناقصة يكلف شهوراً.

التجربة العملية

سوف نستخدم osmium-tool، وهي أداة سطر أوامر سريعة لقراءة ملفات OSM وقصها وفلترتها، داخل Container من Debian 13، مع curl لسؤال الواجهة البرمجية وOverpass. وملف lab/Dockerfile فيه نفس الأدوات التي نستخدمها في مقالات هذه المرحلة:

FROM debian:trixie-slim
RUN apt-get update && apt-get install -y --no-install-recommends osmium-tool proj-bin gdal-bin python3-pyproj python3-gdal curl ca-certificates jq && rm -rf /var/lib/apt/lists/*
docker build -t geo-tools lab/
docker run --rm geo-tools osmium --version | head -2
osmium version 1.18.0
libosmium version 2.22.0

تحميل المقتطف والتحقق منه

صفحة دول الخليج في Geofabrik تقول إن الملف يحتوي البيانات حتى 2026-11-15 وحجمه 245 ميجابايت. والرابط gcc-states-latest.osm.pbf يحول إلى ملف بتاريخ اليوم، فنحمل الملف بتاريخه حتى نعرف بالضبط ما الذي حللناه، ومعه ملف التحقق MD5:

curl -sIL https://download.geofabrik.de/asia/gcc-states-latest.osm.pbf | grep -i -E "^HTTP|location|content-length"
curl -sLO https://download.geofabrik.de/asia/gcc-states-261115.osm.pbf
curl -sLO https://download.geofabrik.de/asia/gcc-states-261115.osm.pbf.md5
md5sum -c gcc-states-261115.osm.pbf.md5
HTTP/1.1 307 Temporary Redirect
Location: https://download.geofabrik.de/asia/gcc-states-261115.osm.pbf
HTTP/1.1 200 OK
Content-Length: 257651855
gcc-states-261115.osm.pbf: OK

ثم نسأل osmium عما في الملف:

docker run --rm -v "$PWD:/lab" -w /lab geo-tools osmium fileinfo -e gcc-states-261115.osm.pbf

والمخرج سوف يكون كما يلي (اختصرنا بعض الأسطر):

Header:
  Bounding boxes:
    (34.434886,15.24752,60.94748,32.196534)
  With history: no
  Options:
    osmosis_replication_base_url=https://download.geofabrik.de/asia/gcc-states-updates
    osmosis_replication_sequence_number=3887
    osmosis_replication_timestamp=2026-11-15T21:22:28Z
Data:
  Timestamps:
    First: 2007-04-17T00:19:38Z
    Last: 2026-11-15T21:00:41Z
  Number of changesets: 0
  Number of nodes: 34097838
  Number of ways: 4165068
  Number of relations: 42352
  Largest node ID: 14381934801
  Sum of buffer sizes: 3100139088 (2.956 GB)
Metadata:
  All objects have following metadata attributes: version+timestamp

في المخرج أعلاه لاحظ التالي:

  • الملف 245 ميجابايت، ولكن البيانات بعد فك الضغط قرابة 3 جيجابايت، فصيغة PBF مضغوطة بشكل كبير، وهذا ما يجعل osmium يحتاج ذاكرة أكبر من حجم الملف عند القص كما سوف نرى.
  • 34 مليون نقطة مقابل 4 ملايين طريق، فأغلب النقاط زوايا في طرق ومبان وليست أماكن مستقلة.
  • osmosis_replication_timestamp هو عمر البيانات، وهذا الرقم هو ما تكتبه في تقريرك أو في سجل خدمتك، لأن نفس السؤال على نفس المنطقة سوف يعطي نتيجة مختلفة بعد شهر.
  • رقم أكبر نقطة يتجاوز 14 مليار، لذلك خزن أرقام عناصر OSM في عمود من نوع bigint وليس integer، والسبب أن الأخير يتوقف عند 2.1 مليار تقريباً.
  • osmosis_replication_base_url ورقم التسلسل 3887 يخبران أي أداة تحديث من أين تأخذ ملفات الفروقات التالية لهذا الملف، فأداة مثل pyosmium-up-to-date من مشروع pyosmium تقرأ هذين الحقلين وتطبق التعديلات على ملفك بدل أن تحمل 245 ميجابايت كل يوم، وهذا ما تحتاجه خدمة تعمل باستمرار.
  • Number of changesets: 0 والسطر الأخير يؤكدان ما ذكرناه: الإصدار والتاريخ فقط، بلا اسم مساهم ولا مجموعة تغيير.

قص المدينة المنورة

لا نحتاج الخليج كله، فنقص مستطيلاً حول المدينة المنورة بالترتيب الذي يطلبه osmium: الغرب ثم الجنوب ثم الشرق ثم الشمال:

docker run --rm -v "$PWD:/lab" -w /lab geo-tools bash -c '
  time osmium extract -v -b 39.50,24.38,39.75,24.56 gcc-states-261115.osm.pbf -o madinah.osm.pbf -O
  for t in nodes ways relations; do echo "$t $(osmium fileinfo -e -g data.count.$t madinah.osm.pbf)"; done'
[ 0:00] Running 'complete_ways' strategy in two passes...
[ 0:00] First pass (of two)...
[ 0:06] Second pass (of two)...
[ 0:11] Peak memory used: 3182 MBytes
[ 0:11] Done.

real	0m10.837s
nodes 130749
ways 27487
relations 169

في المخرج أعلاه لاحظ التالي:

  • الاستراتيجية الافتراضية complete_ways تقرأ الملف مرتين، والسبب أن الطريق الذي يدخل المستطيل جزئياً يجب أن يأتي بكل نقاطه حتى خارج المستطيل، وإلا خرجت لك طرق مقطوعة لا تصلح لحساب المسارات.
  • الذاكرة القصوى 3.1 جيجابايت لملف حجمه 245 ميجابايت، فإذا كان Docker عندك محدداً بذاكرة صغيرة فسوف يتوقف القص، وعلى سيرفر صغير قص من ملف الدولة أفضل من ملف القارة.
  • المدينة كلها في ملف 1.4 ميجابايت، وهذا حجم مناسب لتجربة أي أداة عليه بسرعة.

عد العناصر حسب الوسوم

الآن نسأل: ما أكثر المفاتيح استخداماً في المدينة؟ وما أنواع الطرق والأماكن؟ وكم عنصراً عليه اسم عربي؟

docker run --rm -v "$PWD:/lab" -w /lab geo-tools bash -c '
  echo "== keys";     osmium tags-count -s count-desc madinah.osm.pbf | head -8
  echo "== highway";  osmium tags-count -s count-desc madinah.osm.pbf "highway=*" | head -5
  echo "== amenity";  osmium tags-count -s count-desc madinah.osm.pbf "amenity=*" | head -10
  echo "== names";    osmium tags-count madinah.osm.pbf name name:ar name:en'

والمخرج سوف يكون كما يلي:

== keys
22739	"highway"
5147	"oneway"
3247	"name"
2664	"building"
1567	"name:en"
1541	"power"
1532	"amenity"
1235	"name:ar"
== highway
15232	"highway"	"residential"
2761	"highway"	"service"
1221	"highway"	"secondary"
616	"highway"	"tertiary"
510	"highway"	"footway"
== amenity
545	"amenity"	"place_of_worship"
187	"amenity"	"parking"
145	"amenity"	"restaurant"
94	"amenity"	"fuel"
68	"amenity"	"fast_food"
63	"amenity"	"school"
51	"amenity"	"parking_entrance"
49	"amenity"	"atm"
48	"amenity"	"pharmacy"
44	"amenity"	"toilets"
== names
3247	"name"
1567	"name:en"
1235	"name:ar"

في المخرج أعلاه لاحظ التالي:

  • الطرق هي أغنى ما في البيانات: 22,739 طريقاً، ثلثاها شوارع سكنية residential، وهذا يفسر لماذا تكفي OSM لحساب المسارات في أغلب مدن المملكة.
  • المباني 2,664 فقط في مستطيل يغطي أغلب المدينة، أي أن أغلب المباني غير مرسومة، فإذا كان مشروعك يعتمد على المباني فلا تعتمد على OSM وحدها هنا.
  • المساجد 545 عنصراً، وهي أكثر الأماكن رسماً، ثم المواقف والمطاعم، والصيدليات 48 صيدلية فقط في مدينة يسكنها أكثر من مليون، فبيانات الأماكن ناقصة كما وجدنا في الرياض في مقال تطبيق الخرائط.
  • عدد العناصر التي عليها name:en أكبر من التي عليها name:ar، أي أن تطبيقاً يعرض الأسماء العربية ويبحث عن name:ar وحده سوف يفقد كثيراً منها، والحل أن يرجع إلى name عندما لا يجد name:ar.
أعمدة أفقية لما في مقتطف المدينة المنورة بتاريخ 2026-11-15: highway 22,739 طريقاً منها residential 15,232، وbuilding 2,664، وname 3,247 وname:en 1,567 وname:ar 1,235، والأماكن: place_of_worship 545 وrestaurant 145 وpharmacy 48، ومن الصيدليات عنصر واحد فقط عليه opening_hours
الطرق غنية والمباني والأماكن ناقصة، والاسم العربي ليس على كل عنصر له اسم

كم عمر البيانات؟

العدد وحده لا يكفي، فشارع رسم في 2010 ولم يلمسه أحد بعد ذلك قد يكون تغير اسمه أو اتجاهه. وكل عنصر في المقتطف يحمل تاريخ آخر تعديل عليه، فنحول الطرق والمباني والأماكن إلى صيغة OPL ونعدها حسب سنة آخر تعديل:

docker run --rm -v "$PWD:/lab" -w /lab geo-tools bash -c '
  osmium tags-filter -O -o /tmp/t.osm.pbf madinah.osm.pbf w/highway w/building w/amenity w/shop
  osmium cat -f opl -t way /tmp/t.osm.pbf | cut -d" " -f5 | cut -c2-5 | sort | uniq -c | awk "{t+=\$1; print} END {print t, \"total\"}"'
    657 2010
     58 2011
     53 2012
     92 2013
    129 2014
    448 2015
   1556 2016
   2709 2017
    481 2018
    911 2019
   1222 2020
   4998 2021
   5098 2022
   2234 2023
   1079 2024
   1786 2025
   1832 2026
25343 total

في المخرج أعلاه لاحظ التالي:

  • الحقل الخامس في سطر OPL هو التاريخ ويبدأ بالحرف t، فأخذنا منه السنة فقط.
  • 8,316 طريقاً ومبنى، أي قرابة 33% مما في المدينة، آخر تعديل عليها في 2020 أو قبلها، و657 منها لم تلمس منذ 2010.
  • سنتا 2021 و2022 فيهما قرابة 40% من التعديلات، وهذا يشير غالباً إلى مشاريع رسم منظمة في تلك الفترة، وليس إلى نشاط مستمر، فإذا رأيت مثل هذا في منطقتك فاسأل: هل هناك من يحدثها اليوم؟
  • آخر تعديل لا يعني آخر مراجعة، فعنصر لم يتغير لأنه صحيح يبدو قديماً بنفس الطريقة، لذلك يوجد الوسم check_date الذي يكتبه من تحقق ميدانياً، وهو نادر في المملكة كما رأينا في الرياض.

قراءة عنصر وتاريخه من الواجهة البرمجية

نرجع إلى المسجد النبوي، ونقرأ آخر إصدار منه من الواجهة البرمجية بصيغة JSON، ونضع في الطلب اسماً يعرف البرنامج كما تطلب سياسة الاستخدام:

UA="arabroot-lab/1.0 ([email protected])"
curl -s -A "$UA" https://api.openstreetmap.org/api/0.6/way/461699097.json \
  | jq '.elements[0] | {version, timestamp, nodes: (.nodes | length), first: .nodes[0], last: .nodes[-1], tags: (.tags | {name, "name:ar", "name:en", amenity, building, height, "addr:street"})}'
{
  "version": 41,
  "timestamp": "2025-10-31T11:56:14Z",
  "nodes": 118,
  "first": 3059361946,
  "last": 3059361946,
  "tags": {
    "name": "المسجد النبوي",
    "name:ar": "المسجد النبوي",
    "name:en": "Prophet's Mosque",
    "amenity": "place_of_worship",
    "building": "yes",
    "height": "13",
    "addr:street": "قبرالجسد الطاهر محمدبن عبدالله المصطفى ص اله"
  }
}

أول نقطة وآخر نقطة متطابقتان، فالطريق مغلق، ومع building=yes فهو مساحة. والآن نطلب التاريخ كاملاً ونطبع ما تغير في كل إصدار. ملف lab/history.py:

# Print what changed in each version of one OSM element (from /history.json)
import json, sys
versions = json.load(sys.stdin)["elements"]
print(len(versions), "versions by", len({v["uid"] for v in versions}), "accounts")
prev = {}
for v in versions:
    tags = v.get("tags", {})
    changed = sorted(k for k in set(tags) | set(prev) if tags.get(k) != prev.get(k))
    gone = [k for k in changed if k not in tags]
    print(f'v{v["version"]:<3}{v["timestamp"][:10]}  nodes {len(v.get("nodes", [])):<4}'
          f' changed {",".join(changed)[:60] or "-"}' + (f'  REMOVED {",".join(gone)}' if gone else ''))
    prev = tags
curl -s -A "$UA" https://api.openstreetmap.org/api/0.6/way/461699097/history.json \
  | docker run --rm -i -v "$PWD/lab:/lab" geo-tools python3 /lab/history.py

والمخرج سوف يكون كما يلي (حذفنا بعض الإصدارات المتشابهة من الوسط):

41 versions by 12 accounts
v1  2016-12-25  nodes 49   changed -
v2  2017-09-22  nodes 50   changed -
v14 2018-09-03  nodes 81   changed -
v17 2018-09-03  nodes 104  changed barrier
v19 2018-09-04  nodes 114  changed -
v20 2018-09-08  nodes 114  changed addr:city,addr:country,addr:street,amenity,barrier,building,  REMOVED barrier
v28 2020-08-06  nodes 118  changed name:hi
v29 2020-11-01  nodes 118  changed amenity,building,religion  REMOVED amenity,religion
v30 2022-03-29  nodes 118  changed amenity,building,name:ru,religion
v33 2022-07-18  nodes 118  changed alt_name:fa,name,name:hi,name:sr,name:ug,name:ur
v34 2023-08-20  nodes 118  changed name:ru  REMOVED name:ru
v35 2023-08-20  nodes 118  changed name:ru
v36 2023-08-21  nodes 118  changed name:ru  REMOVED name:ru
v37 2023-08-21  nodes 118  changed name:ru
v38 2023-08-21  nodes 118  changed name:ru  REMOVED name:ru
v39 2023-08-22  nodes 118  changed name:ru
v41 2025-10-31  nodes 118  changed height

في المخرج أعلاه لاحظ التالي:

  • العنصر بدأ في 2016 شكلاً من 49 نقطة بلا أي وسم، أي حداً مرسوماً لا يعرف أحد ما هو، ثم كبر الشكل على مدى سنتين حتى 114 نقطة، ولم يحصل على اسمه ونوعه إلا في الإصدار 20 في سبتمبر 2018.
  • في الإصدار 29 في نوفمبر 2020 حذف أحدهم amenity=place_of_worship وreligion=muslim وغير building إلى mosque، فاختفى المسجد من كل تطبيق يبحث عن أماكن العبادة بالوسم المتفق عليه، وبقي كذلك حتى مارس 2022، أي قرابة 16 شهراً. وهذا ليس تخريباً متعمداً على الأغلب، وإنما مساهم ظن أن building=mosque يكفي، ولكن النتيجة على المستخدم واحدة.
  • الإصدار 33 في يوليو 2022 غير name من «Prophet's Mosque المسجد النبوي» إلى «المسجد النبوي»، أي أصلح خطأ الاسم بلغتين الذي ذكرناه في قسم الوسوم.
  • من الإصدار 34 إلى 39 حذف name:ru وأعيد ثلاث مرات في يومين، وهذا شكل حرب التعديلات Edit War بين حسابين، وهو ما ترصده أدوات مثل OSMCha.
  • 12 حساباً عدلت العنصر على مدى تسع سنوات، وهذا هو المجتمع الذي يحافظ على البيانات، وهو نفسه مصدر الأخطاء.
خط زمني من 2016 إلى 2025 لتاريخ الطريق 461699097: الإصدار 1 في 2016 شكل بلا وسوم من 49 نقطة، والإصدار 20 في سبتمبر 2018 أضيف الاسم والنوع، وشريط أحمر من الإصدار 29 في نوفمبر 2020 إلى الإصدار 30 في مارس 2022 مكتوب عليه حذف amenity وreligion لمدة 16 شهراً، والإصدار 33 في يوليو 2022 تصحيح name إلى العربية فقط، ونقاط متقاربة للإصدارات 34 إلى 39 في أغسطس 2023 حذف وإعادة name:ru ثلاث مرات في يومين، والإصدار 41 في أكتوبر 2025 إضافة height
41 إصداراً لعنصر واحد: خطأ بقي 16 شهراً، وحرب تعديلات في يومين، وتصحيح للاسم

نفس السؤال مع Overpass API

الآن نسأل Overpass عن الصيدليات في نفس المستطيل، ونطلب العدد الكلي، وعدد التي عليها ساعات عمل، وأول ثلاث نتائج. وترتيب المستطيل في Overpass مختلف عن osmium: الجنوب ثم الغرب ثم الشمال ثم الشرق. ملف lab/pharmacies.overpassql:

[out:json][timeout:90];
// Pharmacies in the same Madinah box we cut with osmium (south, west, north, east)
nwr["amenity"="pharmacy"](24.38,39.50,24.56,39.75)->.all;
nwr.all["opening_hours"]->.hours;
.all out count;
.hours out count;
.all out center 3;
curl -s -A "$UA" --data-binary @lab/pharmacies.overpassql https://overpass-api.de/api/interpreter

في المحاولة الأولى كان الرد كما يلي:

# 502 Gateway Timeout

This Overpass API server is currently at capacity. All query workers are busy
and the request queue is full.

## What to do

Retry your request using exponential backoff: wait a short interval, then retry.

وهذا ما ذكرناه عن الخوادم العامة: الخادم مشغول بطلبات غيرك، والرسالة نفسها تطلب أن تعيد المحاولة بانتظار يتضاعف Exponential Backoff، فلا تضع طلب Overpass في مسار يحتاجه المستخدم فوراً، وإنما في مهمة خلفية تعيد المحاولة. وبعد دقائق نجح الطلب نفسه، والمخرج سوف يكون كما يلي (اختصرنا الأسطر الفارغة):

{
  "generator": "Overpass API 0.7.62.11 87bfad18",
  "osm3s": {
    "timestamp_osm_base": "2026-11-16T16:47:38Z",
    "copyright": "The data included in this document is from www.openstreetmap.org. The data is made available under ODbL."
  },
  "elements": [
{ "type": "count", "tags": { "nodes": "47", "ways": "1", "relations": "0", "total": "48" } },
{ "type": "count", "tags": { "nodes": "1", "ways": "0", "relations": "0", "total": "1" } },
{ "type": "node", "id": 4400886196, "lat": 24.4718161, "lon": 39.5814652,
  "tags": { "amenity": "pharmacy", "name": "النهدي", "name:ar": "النهدي" } },
{ "type": "node", "id": 4656668490, "lat": 24.4878277, "lon": 39.5994876,
  "tags": { "amenity": "pharmacy" } },
{ "type": "node", "id": 4805820827, "lat": 24.4463298, "lon": 39.6436606,
  "tags": { "amenity": "pharmacy", "name": "صيدلية النهدي", "name:ar": "صيدلية النهدي",
            "name:en": "Nahdi Pharmacy", "website": "https://www.nahdi.sa/" } }
  ]
}

في المخرج أعلاه لاحظ التالي:

  • 48 صيدلية، منها 47 نقطة وطريق واحد مرسوم كمبنى، وهو نفس العدد الذي أعطانا إياه osmium من المقتطف، فالبيانات لم تتغير في هذه المنطقة بين مساء 15 نوفمبر وعصر 16 نوفمبر.
  • timestamp_osm_base يقول إن بيانات الخادم متأخرة دقائق فقط عن القاعدة الرئيسية، وهذه ميزة Overpass على المقتطف اليومي.
  • صيدلية واحدة فقط من 48 عليها opening_hours، فإذا كان تطبيقك يعرض «مفتوح الآن» فلن يجد ما يعرضه، وهذا بالضبط نوع السؤال الذي يجمعه StreetComplete من الناس.
  • نفس السلسلة مكتوبة «النهدي» في نقطة و«صيدلية النهدي» في أخرى، والثانية عليها name:en والأولى لا، والصيدلية الثانية في القائمة بلا اسم أصلاً، وهذا ما يحدث عندما لا يستخدم المساهمون الوسم brand والقوالب الجاهزة.

ماذا لو سألت خادماً آخر؟

عندما يكون الخادم الرئيسي مشغولاً، يلجأ كثيرون إلى خادم Overpass عام آخر. أرسلنا سؤال الصيدليات نفسه إلى خادم overpass.kumi.systems، فاستغرق الرد 75 ثانية، وفي رأسه:

"osm3s": {
    "timestamp_osm_base": "2026-07-15T15:22:01Z",

أي أن بيانات هذا الخادم متوقفة عند منتصف يوليو، قبل أربعة أشهر من يوم التجربة، والرد لا يحذرك من ذلك بأي شكل غير هذا السطر. وفي محاولة لاحقة في نفس اليوم رد الخادم نفسه بالخطأ 502 Bad Gateway بعد أربع دقائق من الانتظار، فالخوادم البديلة ليست حلاً للاعتماد عليه أيضاً. لذلك عليك بقراءة timestamp_osm_base في كل رد وتسجيله، وإذا كان أقدم من حد تقبله، مثل يوم واحد، فاعتبر النتيجة غير صالحة. وهذا ينطبق على أي مصدر بيانات: النتيجة دون تاريخها لا معنى لها.

تنظيف التجربة

كل Container كان بالخيار --rm، فيبقى ال Image والملفات:

docker image rm geo-tools
rm -f gcc-states-261115.osm.pbf gcc-states-261115.osm.pbf.md5 madinah.osm.pbf

واحتفظ بملف المدينة إذا كنت سوف تكمل في مقالات المرحلة، فسوف نفتحه في QGIS ونبني منه طبقات للتحليل.

أخطاء شائعة

  • تحميل البيانات من الواجهة البرمجية للتحرير: الواجهة للمحررات فقط، وسياسة استخدامها تمنع التحميل الكبير، فاستخدم المقتطفات أو Overpass.
  • استخدام البيانات دون تاريخها: اكتب تاريخ المقتطف أو timestamp_osm_base مع كل نتيجة، والسبب أن البيانات تتغير كل دقيقة، وأن بعض الخوادم متأخرة شهوراً كما رأينا.
  • الاعتماد على name:ar وحده: كثير من الأماكن عليها name بالعربية دون name:ar، فارجع إلى name عندما لا تجد الوسم اللغوي.
  • اختراع وسوم: ابحث في الويكي وtaginfo أولاً، فالوسم الذي لا يستخدمه غيرك لا يقرؤه أي برنامج.
  • النسخ من خرائط تجارية: لا تنسخ اسماً أو شكلاً من Google Maps، ولو لتصحيح خطأ، فقد يحذف كل ما أضفته.
  • الثقة في كل تعديل: إذا كنت تبني منتجاً على OSM فضع فحصاً للتغييرات الكبيرة في الأسماء والحدود قبل تحديث بياناتك، كما تعلمت Mapbox في 2018.
  • الخلط في ترتيب المستطيل: osmium يطلب الغرب ثم الجنوب ثم الشرق ثم الشمال، وOverpass يطلب الجنوب ثم الغرب ثم الشمال ثم الشرق، فإذا أعطاك أحدهما نتيجة فارغة أو منطقة في مكان آخر من العالم فابدأ بفحص الترتيب، وقد شرحنا أصل هذه المشكلة في ترتيب خط العرض والطول.
  • تخزين أرقام العناصر في integer: أرقام النقاط تجاوزت 14 مليار، فاستخدم bigint.
  • إخفاء النسبة: النسبة «© OpenStreetMap contributors» شرط في الرخصة على كل خريطة وكل صورة منشورة.

قائمة تحقق قبل أن تبني على OpenStreetMap

السؤالإذا كانت الإجابة نعم
هل تحتاج البيانات مرة واحدة لتحليل أو تقرير؟Overpass لسؤال صغير، أو مقتطف Geofabrik لمنطقة كاملة
هل تبني خدمة تعمل كل يوم؟مقتطف يومي مع ملفات الفروقات، ومعالجة على سيرفرك
هل تعرض البيانات علناً؟نسبة ظاهرة ورابط لصفحة حقوق النسخ
هل تعدل البيانات وتستخدم نسختك علناً؟قرار مسبق بنشر التعديلات بنفس الرخصة، أو أفضل من ذلك: صححها في OSM نفسها
هل يعتمد مشروعك على المباني أو ساعات العمل أو الهواتف؟افحص التغطية في منطقتك بأداة مثل osmium قبل أن تعد العميل بشيء
هل سوف يضيف فريقك بيانات كثيرة؟صفحة مشروع في الويكي وفق إرشادات التحرير المنظم، وحسابات شخصية واضحة

تدريب عملي

  • قص مستطيلاً حول حيك من نفس الملف، واعرض أكثر قيم shop=* فيه، ثم قارنها بما تعرفه عن الحي.
  • افتح حساباً في OSM، وأضف ساعات عمل صيدلية تعرفها بمحرر iD أو بتطبيق StreetComplete، ثم اقرأ تاريخ العنصر من الواجهة البرمجية بالملف history.py وشاهد إصدارك الجديد.

الخلاصة

وصلنا لنهاية الموضوع، وأهم ما فيه:

  • OpenStreetMap قاعدة بيانات جغرافية مفتوحة يحررها المتطوعون، وليست خريطة جاهزة، وتستطيع أن تبني منها الخرائط والبحث والمسارات والتحليل.
  • كل البيانات نقاط وطرق وعلاقات، والمعنى كله في الوسوم، والوسوم اتفاق بين المساهمين موثق في الويكي.
  • رخصة ODbL تطلب النسبة الظاهرة، ومشاركة ما تعدله في البيانات نفسها إذا استخدمته علناً.
  • التحرير عبر الواجهة البرمجية، والقراءة من المقتطفات اليومية أو Overpass، ومقتطفات Geofabrik العامة بلا أسماء مساهمين.
  • في المدينة المنورة: 22,739 طريقاً مقابل 2,664 مبنى و48 صيدلية، واحدة منها فقط بساعات عمل.
  • تاريخ عنصر واحد كشف خطأ بقي 16 شهراً وحرب تعديلات، فافحص البيانات قبل أن تبني عليها، وسجل تاريخها مع كل نتيجة.

والخطوة التالية أن تعرض هذه البيانات على خريطة من سيرفرك، وأن تحول العناوين إلى إحداثيات، وأن تفتحها في QGIS وتحللها، وهذا ما في المقالات التالية.

دليلخرائطك على سيرفرك مع OpenStreetMap وMapLibreكيف تعرض خريطة تفاعلية لمدينتك من سيرفرك ببيانات OpenStreetMap، بالعربية والإنجليزية ودون مفتاح API أو مزود خارجي.دليلكيف تعمل الخرائط الرقمية؟ المربعات Tiles والطبقات Layersالمدخل إلى مسار الخرائط، يشرح ما الخريطة الرقمية وكيف يحمل تطبيقك المربعات ويرسم الأسماء العربية، مع تجربة على مربعات حقيقية وخريطة لكل ما تقرأه بعده.دليلالبحث عن العناوين Geocoding مع Nominatimكيف تحول اسم المكان إلى إحداثيات والإحداثيات إلى عنوان على سيرفرك مع Nominatim، وما الذي يجيده بالعربية وما الذي يفوته.دليلحساب أقصر طريق وزمن الوصول مع OSRM وValhallaكيف يحسب محرك المسارات أقصر طريق وزمن الوصول على شوارع مدينتك، وكيف تشغله على سيرفرك وتقيس سرعته بنفسك.دليلQGIS للمبتدئين: الطبقات Layers والتحليل المكانيكيف تحول جدول مواقع إلى طبقة على الخريطة في QGIS، وتربطها بالمناطق وتحسب النطاقات بالأمتار الصحيحة، ثم تعيد التحليل كله بأمر واحد.دليلالبيانات الجغرافية المفتوحة Open Data في السعوديةأين تجد البيانات الجغرافية عن المملكة، وما الذي يمكن تحميله فعلاً من كل مصدر وبأي رخصة، وكيف تفحص الملف الرسمي قبل أن تبني عليه.دليلكيف تبني تطبيق خرائط وملاحة مثل هدهد وGoogle Maps؟ما الذي يقف خلف كل ميزة في تطبيقات الخرائط، وكيف تبني نسخة أولى منها بأدوات مفتوحة المصدر وبيانات مرخصة بشكل صحيح.

سجل التحديثات

  • 16 نوفمبر 2026: كتابة المقال، وتنفيذ التجربة بأداة osmium 1.18.0 على Debian 13 على مقتطف Geofabrik لدول الخليج بتاريخ 2026-11-15، وقراءة العنصر 461699097 من OSM API v0.6، والاستعلام من Overpass API 0.7.62.11، مع Docker Engine 29.8.0 على Windows 11.
نشرة عرب رووت | ArabRoot

معرفة تستحق مكاناً في بريدك.

مقالات مختارة وأدوات مفيدة وأفكار لمشروعك القادم، في رسالة واحدة كل أسبوع.

يمكنك إلغاء الاشتراك متى شئت. الخصوصية

تم استلام طلبك. افتح بريدك واضغط رابط التأكيد لإتمام الاشتراك.