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

كيف يتحول العنوان إلى نقطة؟ العنوان الوطني وPlus Codes

كيف يحول محرك البحث عن العناوين جملة مكتوبة إلى نقطة، وما الذي يضيفه العنوان الوطني وPlus Codes، مع اختبار 40 عنواناً حقيقياً على Nominatim وPhoton وقياس كم منها يصل إلى المبنى الصحيح.

كيف يتحول العنوان إلى نقطة؟ العنوان الوطني وPlus Codes

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

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

  • ثلاث طرق لوصف المكان: العنوان المكتوب، والإحداثيات، والرموز الشبكية، وما يجيده كل منها.
  • كيف يعمل البحث عن العناوين Geocoding من الداخل: التحليل، والتوحيد، والمطابقة، والتراجع من المبنى إلى الشارع إلى الحي.
  • العنوان الوطني في المملكة: مكوناته الستة، والعنوان المختصر، والرمز البريدي، وواجهته البرمجية، من صفحات البريد السعودي سبل الرسمية.
  • Plus Codes: كيف تحسب من الإحداثيات بالأرقام، ولماذا تعمل دون إنترنت، ومتى يخدعك الرمز المختصر.
  • what3words: الفكرة، وما تقوله وثائقه، ولماذا يختلف عن غيره في الرخصة.
  • العناوين في OpenStreetMap بوسوم addr:*، وكم منها موجود فعلاً في المملكة.
  • تجربة عملية: نعد العناوين في بيانات OpenStreetMap للمملكة، ونحسب Plus Codes بالمكتبة الرسمية، ثم نرسل 40 عنواناً حقيقياً إلى خادمي Nominatim وPhoton العامين ونقيس كم منها يعود إلى المكان الصحيح.

ثلاث طرق لوصف المكان

عندما تصف مكاناً لشخص آخر فأنت تختار، دون أن تشعر، واحدة من ثلاث طرق، ولكل منها جمهور:

  • العنوان المكتوب Address: سلسلة من الأماكن، كل واحد داخل الذي قبله: الدولة ثم المدينة ثم الحي ثم الشارع ثم رقم المبنى. وهو مصمم للإنسان وللبريد، فتقرؤه وتفهم أين المكان تقريباً قبل أن تفتح الخريطة، ولكنه يعتمد على أسماء قد تتغير أو تكتب بعدة طرق، وعلى أرقام مبان قد لا توجد أصلاً.
  • الإحداثيات Coordinates: خط العرض وخط الطول، مثل 24.711667, 46.674444. وهي مصممة للكمبيوتر: دقيقة ولا تحتاج قاعدة بيانات أسماء، ولكنها لا تقول شيئاً للإنسان، ورقم واحد خطأ ينقل المكان كيلومترات دون أن يلاحظ أحد.
  • الرمز الشبكي Grid Code: تقسيم الأرض إلى خلايا صغيرة، ولكل خلية رمز قصير، مثل Plus Codes أو what3words. وهو محاولة لجمع الميزتين: قصير يمكن نطقه وكتابته، ويحسب من الإحداثيات دون أسماء شوارع.

وتطبيقك يحتاج عادة الاثنين معاً: الإحداثيات لكي يرسم النقطة ويحسب المسافة ويوجه المندوب، والعنوان لكي يفهم الإنسان ويطابق في الأنظمة الأخرى مثل الفواتير والشحن. والعملية التي تحول العنوان المكتوب إلى إحداثيات تسمى البحث عن العناوين Geocoding، والعكس يسمى البحث العكسي Reverse Geocoding، وقد عرفناهما في مقال Nominatim.

ثلاث بطاقات لنفس المكان: عنوان مكتوب بتسلسل الدولة والمدينة والحي والشارع والرقم، وإحداثيات خط العرض والطول، ورمز Plus Code، وتحت كل بطاقة لمن صممت: الإنسان والبريد، والكمبيوتر، والاثنان معاً
نفس المكان بثلاث لغات: العنوان للإنسان، والإحداثيات للكمبيوتر، والرمز الشبكي بينهما

لماذا يصعب العنوان في مدننا؟

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

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

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

كيف يتحول العنوان إلى نقطة؟

قد تبدو العملية من الوهلة الأولى بسيطة: تبحث عن النص في قاعدة بيانات فيها كل العناوين وإحداثياتها، فتعيد السطر المطابق. والطريقة البسيطة هذه تفشل من أول عنوان حقيقي، والسبب أن الناس لا يكتبون العنوان بنفس الطريقة أبداً: «ش التخصصي» و«شارع التخصصي» و«طريق التخصصي»، و«الرياض» و«Riyadh» و«الرياض، المملكة»، ورقم المبنى قبل اسم الشارع أو بعده، والحي مذكور أو محذوف. لذلك يقسم محرك البحث عن العناوين Geocoder العمل إلى خطوات:

  1. التحليل Parsing: يقسم النص إلى أجزاء ويحاول أن يعرف دور كل جزء: هذا رقم مبنى، وهذا اسم شارع، وهذه مدينة. وفي المحركات الكبيرة يستخدم نموذج إحصائي مدرب على ملايين العناوين، مثل مكتبة libpostal المفتوحة.
  2. التوحيد Normalization: يوحد شكل الكلمات قبل المقارنة: الهمزات والتاء المربوطة والاختصارات وحالة الأحرف اللاتينية، وقد رأينا في مقال Nominatim كيف تؤثر الهمزة والتاء المربوطة في البحث العربي.
  3. المطابقة Matching: يبحث عن الأماكن التي تحمل الكلمات في قاعدة بياناته، ويتحقق من أن كل جزء داخل الذي فوقه: الشارع داخل المدينة المذكورة، وليس شارعاً بنفس الاسم في مدينة أخرى.
  4. التراجع Fallback: إذا لم يجد رقم المبنى، يعيد الشارع، وإذا لم يجد الشارع يعيد الحي، ثم المدينة. وبعض المحركات تقدر موقع الرقم على امتداد الشارع إذا عرفت أرقام أول الشارع وآخره، وهذا ما يسمى الاستيفاء Interpolation.
  5. الترتيب Ranking: إذا وجد عدة نتائج، يرتبها بأهمية المكان وقربه من منطقة البحث ومدى تطابق الكلمات، ويعيد الأولى.
مسار من خمس خطوات: نص العنوان يدخل إلى التحليل فيقسم إلى رقم وشارع ومدينة، ثم التوحيد، ثم المطابقة مع قاعدة البيانات، ثم سلم التراجع من المبنى بدقة أمتار إلى الشارع بمئات الأمتار إلى الحي إلى المدينة بالكيلومترات، ثم نقطة على الخريطة ومعها نوع النتيجة
الـ Geocoder يحلل النص ويوحده ويطابقه، وإذا لم يجد المبنى يتراجع إلى الشارع ثم الحي

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

«وجدت النتيجة» لا تعني «النتيجة صحيحة»

هنا أهم درس عملي في هذا الموضوع: أغلب المحركات لا ترفض العنوان الذي لا تعرفه، وإنما تتراجع بهدوء إلى أقرب شيء تعرفه، فتعيد لك نقطة في منتصف الشارع أو منتصف الحي، وتطبيقك يرسم النقطة كأنها المبنى. والمحرك يقول لك ذلك في الحقل الذي يصف نوع النتيجة، ففي Nominatim مثلاً يحمل كل جواب الحقل addresstype بقيمة مثل house أو road أو suburb أو city، كما في توثيق مخرجات Nominatim. والقاعدة: لا تخزن نقطة من الـ Geocoder دون أن تخزن معها نوعها، ولا ترسل مندوباً إلى نقطة نوعها «حي» على أنها باب البيت. وسوف نرى في التجربة كم مرة يحدث هذا التراجع بالأرقام.

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

📌
في 2016 رفعت عائلة تسكن مزرعة نائية في ولاية كانساس الأمريكية دعوى على شركة MaxMind التي تبيع قاعدة بيانات لمواقع عناوين IP، كما نقلت The Guardian. والسبب أن الشركة كانت تعطي كل عنوان IP لا تعرف عنه إلا أنه في الولايات المتحدة نقطة افتراضية في منتصف البلاد، وهذه النقطة وقعت على المزرعة، فارتبط بها أكثر من 600 مليون عنوان IP، وزارتها الشرطة والغاضبون مرات لا تحصى بحثاً عن محتالين ولصوص. وهذا هو نفس خطأ التراجع الذي نتحدث عنه: نقطة تمثل «الدولة» أو «المدينة» عوملت كأنها باب بيت، والدرس أن تحفظ مع كل نقطة مستواها، وألا تعرضها لأحد بدقة لا تملكها.

البحث العكسي Reverse Geocoding

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

الإكمال أثناء الكتابة Autocomplete

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

العنوان الوطني National Address في المملكة

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

المكونالشكلما تقوله صفحة سبل
رقم المبنى Building Number4 أرقامأربعة أرقام فريدة تمثل مبنى سكنياً أو تجارياً
الشارع Streetاسمالشارع الذي يقع عليه المدخل الرئيسي للمبنى
الرقم الفرعي Secondary Number4 أرقاميمثل إحداثيات موقع المبنى بدقة، ومفيد عندما لا يوجد اسم للشارع أو الحي
الحي Districtاسمالحي الذي يقع فيه المبنى
الرمز البريدي Postal Code5 أرقاملكل رقم فيه دلالة مكانية، وشبكة الرموز تغطي المملكة بالكامل
المدينة Cityاسمالمدينة التي يقع فيها العنوان

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

العنوان المختصر Short Address

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

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

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

كيف يصل تطبيقك إلى العنوان الوطني؟

بيانات العنوان الوطني ليست ملفاً مفتوحاً تحمله، وإنما خدمة. وتصف صفحة API العنوان الوطني ثلاث خدمات:

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

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

Plus Codes: عنوان من الإحداثيات

Plus Codes هو الاسم التجاري لنظام مفتوح اسمه Open Location Code، نشرته Google برخصة Apache 2.0، وتعرضه خرائط Google لكل نقطة تضغط عليها. والفكرة أن الرمز لا يحتاج قاعدة بيانات أسماء أبداً، فهو يحسب من خط العرض وخط الطول بمعادلة، ويرجع إليهما بمعادلة، فيعمل في قرية لا شوارع فيها، وفي الصحراء، ودون إنترنت.

وطريقة الحساب كما في مواصفة الرمز بسيطة ومفيدة لفهم كل الرموز الشبكية:

  1. تزيح خط العرض بـ 90 وخط الطول بـ 180 حتى تصبح الأرقام موجبة.
  2. تكتب كلاً منهما بنظام العد بالأساس 20، بأبجدية من 20 رمزاً هي 23456789CFGHJMPQRVWX، اختيرت بحيث لا تتشابه الرموز عند الكتابة باليد، ولا تتكون منها كلمات بالصدفة.
  3. تأخذ رمزاً من العرض ثم رمزاً من الطول بالتناوب، فكل زوج يقسم الخلية السابقة إلى 20 × 20 خلية أصغر: الزوج الأول خلايا 20 درجة، والثاني درجة واحدة، والثالث 1/20 درجة، والرابع 1/400 درجة.
  4. تضع علامة + بعد الرمز الثامن، ومنها جاء الاسم.
  5. بعد عشرة رموز تصبح الخلية قرابة 14 × 14 متراً، وكل رمز إضافي يقسمها إلى 20 خلية فقط، 5 في العرض و4 في الطول.

والرمز الكامل طوله عشرة رموز مثل 7HP8JPQ8+HC، ولكن لا أحد يريد أن يحفظ عشرة رموز، لذلك يسمح النظام بالرمز المختصر Short Code: تحذف الرموز الأربعة الأولى وتكتب بعدها اسم مدينة قريبة، مثل JPQ8+HC الرياض، والبرنامج الذي يقرؤه يعرف موقع الرياض فيعيد الرموز المحذوفة من عنده. وهنا فخ مهم، فالمواصفة تشترط أن تكون المدينة المرجعية قريبة من المكان، في حدود 0.4 درجة تقريباً عند حذف أربعة رموز، فإذا قرأ البرنامج الرمز المختصر بالقرب من مدينة أخرى فإنه يعيد مكاناً آخر تماماً دون أي رسالة خطأ، وسوف نرى ذلك بالأرقام في التجربة.

أربع شبكات متداخلة تقرب من الأرض إلى مبنى: خلية بطول رمزين 20 درجة، ثم بأربعة رموز درجة واحدة، ثم بستة رموز قرابة 5.5 كم، ثم بثمانية رموز قرابة 278 متراً، ثم بعشرة رموز قرابة 14 متراً، وفي كل مستوى الرمز يكبر بزوج من الرموز حتى الرمز الكامل مع علامة +
كل زوج من الرموز يقسم الخلية إلى 400 خلية أصغر، وعشرة رموز تكفي لمبنى

متى يناسبك Plus Code؟

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

what3words: ثلاث كلمات لكل مربع

what3words نظام آخر بنفس الفكرة الشبكية مع اختلافين كبيرين. الأول أنه يقسم العالم إلى مربعات 3 × 3 أمتار، ويعطي كل مربع ثلاث كلمات من قاموس بدل الرموز، فالكلمات أسهل في النطق والتذكر من رمز مثل JPQ8+HC، وتدعم وثائقه لغات كثيرة منها العربية برمز ar. والثاني أنه نظام مملوك لشركة، وليس معياراً مفتوحاً: الخوارزمية التي تربط الكلمات بالمربعات غير منشورة، والتحويل يتم عبر الواجهة البرمجية للشركة بمفتاح API.

وتقول وثائق الواجهة البرمجية إن الخدمة تقدم تحويل الإحداثيات إلى ثلاث كلمات convert-to-3wa، والعكس convert-to-coordinates، والاقتراح التلقائي autosuggest الذي يصحح عنواناً مكتوباً بخطأ بسيط، وإن الخطة المجانية لا تشمل إلا الاقتراح التلقائي وقائمة اللغات، أما التحويل إلى إحداثيات فله حصة في خطط الأعمال. وهذا يعني عملياً أن تطبيقك إذا قبل عناوين what3words فهو يعتمد على شركة واحدة في كل تحويل، وعلى شروطها وأسعارها، بينما يحسب Plus Code في كودك بمكتبة مفتوحة دون أي خدمة. لذلك لم نضعه في التجربة العملية، فلا يمكنك أن تختبره دون حساب لدى الشركة.

العناوين في OpenStreetMap: وسوم addr:*

في OpenStreetMap يكتب العنوان كوسوم على المبنى أو النقطة، كلها تبدأ بـ addr:، كما في صفحة الوسم في ويكي OSM: addr:housenumber لرقم المبنى، وaddr:street للشارع، وaddr:city للمدينة، وaddr:postcode للرمز البريدي، وغيرها. وقد شرحنا نموذج البيانات والوسوم في مقال OpenStreetMap، والمهم هنا أن Nominatim وPhoton، وكل محرك مبني على OSM، لا يعرف رقم مبنى إلا إذا كان مكتوباً بهذه الوسوم، ولا يعرف الرقم الفرعي ولا العنوان المختصر لأنهما غير موجودين فيه. وسوف نعد في التجربة كم مبنى في المملكة يحمل عنواناً في OSM، والنتيجة تفسر لماذا يتراجع البحث غالباً إلى الشارع.

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

مقارنة الأنظمة

النظامما يدل عليهيحتاج خدمة؟الرخصةنقاط القوةنقاط الضعف
العنوان الوطنيمبنى بعينهنعم، API سبلشروط استخدام الخدمةرسمي، يغطي المملكة، يقبله البريد والجهات الحكوميةداخل المملكة فقط، ومعنى الرمز المختصر غير منشور
Plus Codesخلية قرابة 14 متراًلا، معادلة في كودكApache 2.0مفتوح، يعمل دون إنترنت وفي أي مكانلا يعرف المباني ولا المداخل، والرمز المختصر يحتاج مدينة قريبة
what3wordsمربع 3 × 3 أمتارنعم، API الشركةمملوكسهل النطق والتذكرشركة واحدة تتحكم في التحويل وشروطه
عنوان OSM addr:*مبنى أو نقطةلا، بيانات مفتوحةODbLمفتوح، تبحث فيه على سيرفركقليل جداً في المملكة كما سنرى
الإحداثياتنقطةلا-دقيقة وعالميةلا تقول شيئاً للإنسان، والخطأ فيها لا يلاحظ

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

نجيب في التجربة عن ثلاثة أسئلة بالأرقام: كم عنواناً موجوداً فعلاً في بيانات OpenStreetMap للمملكة، وكيف يحسب Plus Code ومتى يخدعك، وكم عنواناً حقيقياً يعيده محركا بحث مفتوحان إلى المبنى الصحيح. ونستخدم أدوات osmium وGDAL ومكتبة Open Location Code الرسمية في Python، داخل Container من Debian 13. ملف lab/Dockerfile:

FROM debian:trixie-slim
RUN apt-get update && apt-get install -y --no-install-recommends osmium-tool gdal-bin python3-pyproj python3-venv curl ca-certificates jq \
      && rm -rf /var/lib/apt/lists/*
# Google's reference Plus Codes library (github.com/google/open-location-code), published on PyPI
RUN python3 -m venv --system-site-packages /opt/venv && /opt/venv/bin/pip install --no-cache-dir openlocationcode==1.0.1
ENV PATH=/opt/venv/bin:$PATH
docker build -t address-lab lab/

كم عنواناً في OpenStreetMap للمملكة؟

نبدأ من مقتطف Geofabrik لدول الخليج الذي استخدمناه في مقال OpenStreetMap، ونقصه على حدود المملكة، ثم نعد المباني، والعناصر التي تحمل أي وسم addr:*، وكل وسم منها، ونفحص الرموز البريدية. ملف lab/addr_stats.sh:

#!/bin/sh
# How many objects in the Saudi part of OpenStreetMap carry an address, and which parts of it?
set -e
PBF=gcc-states-261115.osm.pbf
if [ ! -f sa.osm.pbf ]; then          # cut the GCC extract to the Kingdom's outline (same steps as the formats article)
  osmium tags-filter -O -o /tmp/sa-rel.osm.pbf $PBF "r/ISO3166-1=SA"
  osmium export -O --geometry-types=polygon -o /tmp/sa.geojson /tmp/sa-rel.osm.pbf
  ogr2ogr -f GeoJSON /tmp/sa1.geojson /tmp/sa.geojson -where "\"ISO3166-1\" = 'SA'"
  osmium extract -O -p /tmp/sa1.geojson -o sa.osm.pbf $PBF
fi

osmium tags-filter -O -o /tmp/b.osm.pbf sa.osm.pbf "w/building"
echo "building ways: $(osmium fileinfo -e -g data.count.ways /tmp/b.osm.pbf)"
osmium tags-filter -O -o addr.osm.pbf sa.osm.pbf "nwr/addr:*" --omit-referenced
echo "objects with any addr:* tag: $(osmium fileinfo -e addr.osm.pbf | awk '/Number of (nodes|ways|relations)/{s+=$NF} END{print s}')"
osmium tags-count addr.osm.pbf "addr:*" | sort -rn | head -12

# postcodes: how many look like the national five-digit code?
osmium cat -f opl addr.osm.pbf | grep -o 'addr:postcode=[^,]*' | sed 's/addr:postcode=//' > /tmp/pc.txt
echo "postcodes: $(wc -l < /tmp/pc.txt), five digits: $(grep -cE '^[0-9]{5}$' /tmp/pc.txt), other forms: $(grep -cvE '^[0-9]{5}$' /tmp/pc.txt)"
grep -vE '^[0-9]{5}$' /tmp/pc.txt | sort | uniq -c | sort -rn | head -5
docker run --rm -v "$PWD/lab:/lab:ro" -v "$PWD/data:/data" -w /data address-lab sh /lab/addr_stats.sh
building ways: 395564
objects with any addr:* tag: 86415
79559	"addr:street"
74304	"addr:city"
10342	"addr:housenumber"
2663	"addr:postcode"
745	"addr:country"
604	"addr:district"
582	"addr:district:en"
474	"addr:city:en"
472	"addr:place"
390	"addr:province"
382	"addr:province:en"
382	"addr:place:en"
postcodes: 2663, five digits: 2234, other forms: 429
     55 23955-6900
      4 13311-6488
      3 3297
      3 26513-6733
      3 15573%20%-%20%2315

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

  • في بيانات المملكة 395,564 مبنى مرسوماً كطريق مغلق، و10,342 عنصراً فقط عليها رقم مبنى addr:housenumber، والرقم يشمل المحلات والنقاط وليس المباني فقط. أي أن أغلب مباني المملكة في OpenStreetMap لا تحمل رقماً، وهذا ما يجعل البحث بالعنوان الكامل يتراجع إلى الشارع.
  • الشارع addr:street موجود على 79,559 عنصراً والمدينة على 74,304، فالمساهمون يكتبون الشارع والمدينة بسهولة لأنهما ظاهران، ويتركون الرقم لأنه لا يعرف إلا من اللوحة على المبنى.
  • 2,663 رمزاً بريدياً، منها 2,234 من خمسة أرقام كما في العنوان الوطني، و429 بأشكال أخرى. وأكثرها تكراراً 23955-6900 في 55 عنصراً، وهو رمز بريدي مكتوب معه رقم إضافي بعد شرطة، أي أن من أدخلها نقل جزءاً من العنوان الوطني كما هو. والقيمة 15573%20%-%20%2315 هي 15573 - 2315، فصيغة OPL التي تطبع بها osmium تكتب المسافة كرمز %20%.
  • وجود addr:district على 604 عناصر فقط يعني أن الحي، وهو جزء أساسي من العنوان في المملكة، غائب تقريباً، فالمحرك يعرف الحي من حدود الأحياء المرسومة وليس من وسم على المبنى.
أربعة أعمدة أفقية لنتائج 40 عنواناً: Nominatim بالعنوان كاملاً 25 أقل من 25 متراً و2 بين 250 متر وكيلومترين و2 أكثر من كيلومترين و11 لم يجدها، وPhoton بالعنوان كاملاً 38 أقل من 25 متراً وواحد أكثر من كيلومترين وواحد لم يجده، وNominatim دون رقم المبنى واحد قريب و8 و8 و13 بعيدة و10 لم يجدها، وPhoton دون رقم المبنى 4 قريبة و8 و8 و19 بعيدة وواحد لم يجده
نفس 40 عنواناً في محركين: مع رقم المبنى تعود أغلبها إلى المبنى، ودونه تتراجع إلى الشارع وأغلبها يبتعد كيلومترات

Plus Codes بالمكتبة الرسمية

نحسب الرمز لعقدة الرياض في OpenStreetMap، التي استخدمناها في مقالات هذه المرحلة، بكل الأطوال من 2 إلى 13 رمزاً، ونقيس حجم الخلية بالأمتار وبعد مركزها عن النقطة الأصلية، ثم نختصر الرمز بالنسبة للدرعية ونستعيده مرة قرب الدرعية ومرة قرب جدة. ملف lab/pluscodes.py:

# Plus Codes (Open Location Code) with Google's reference library: encode, decode, shorten, recover
from openlocationcode import openlocationcode as olc
from pyproj import Geod

geod = Geod(ellps="WGS84")
lat, lon = 24.6389160, 46.7160104           # the Riyadh node in OpenStreetMap (node 315358390), used across this track

print("length  code              cell (m, N-S x E-W)   centre offset (m)")
for n in (2, 4, 6, 8, 10, 11, 12, 13):
    code = olc.encode(lat, lon, n)
    a = olc.decode(code)
    ns = geod.inv(a.longitudeCenter, a.latitudeLo, a.longitudeCenter, a.latitudeHi)[2]
    ew = geod.inv(a.longitudeLo, a.latitudeCenter, a.longitudeHi, a.latitudeCenter)[2]
    off = geod.inv(lon, lat, a.longitudeCenter, a.latitudeCenter)[2]
    print(f"{n:>4}    {code:<16}  {ns:10.1f} x {ew:<10.1f}  {off:10.1f}")

full = olc.encode(lat, lon)                 # default length 10
short = olc.shorten(full, 24.7483029, 46.5717678)   # reference locality: Diriyah (OSM node 1236703790)
print(f"\nfull {full}  short {short}")
for city, rlat, rlon in [("Diriyah", 24.7483029, 46.5717678), ("Jeddah", 21.5504432, 39.1742363)]:
    back = olc.decode(olc.recoverNearest(short, rlat, rlon))
    d = geod.inv(lon, lat, back.longitudeCenter, back.latitudeCenter)[2]
    print(f"recover '{short}' near {city:<7} -> {olc.recoverNearest(short, rlat, rlon)}  {d / 1000:9.3f} km from the original point")

print("\nvalid?", {c: olc.isValid(c) for c in [full, short, full.replace("+", ""), full.lower(), full.replace("C", "A")]})
docker run --rm -v "$PWD/lab:/lab:ro" -v "$PWD/data:/data" -w /data address-lab python3 -W ignore /lab/pluscodes.py
length  code              cell (m, N-S x E-W)   centre offset (m)
   2    7H000000+          2214258.6 x 2091685.4     615027.0
   4    7HP80000+           110765.5 x 101354.6       26750.2
   6    7HP8JP00+             5538.4 x 5062.7          1790.1
   8    7HP8JPQ8+              276.9 x 253.1             30.4
  10    7HP8JPQ8+HC             13.8 x 12.7               5.8
  11    7HP8JPQ8+HC6             2.8 x 3.2                0.7
  12    7HP8JPQ8+HC6M            0.6 x 0.8                0.2
  13    7HP8JPQ8+HC6M7           0.1 x 0.2                0.1

full 7HP8JPQ8+HC  short JPQ8+HC
recover 'JPQ8+HC' near Diriyah -> 7HP8JPQ8+HC      0.006 km from the original point
recover 'JPQ8+HC' near Jeddah  -> 7GHWJPQ8+HC    883.901 km from the original point

valid? {'7HP8JPQ8+HC': True, 'JPQ8+HC': True, '7HP8JPQ8HC': False, '7hp8jpq8+hc': True, '7HP8JPQ8+HA': False}

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

  • الرمز بعشرة أحرف 7HP8JPQ8+HC يدل على خلية 13.8 × 12.7 متراً، ومركزها على بعد 5.8 متر من النقطة، وهذه دقة كافية لباب بيت أو مدخل استراحة. وكل حرف بعدها يصغر الخلية إلى قرابة 3 أمتار ثم أقل من متر.
  • الخلية ليست مربعة تماماً: 13.8 متراً شمالاً وجنوباً و12.7 شرقاً وغرباً، والسبب أن درجة الطول تقصر كلما ابتعدت عن خط الاستواء، كما شرحنا في مقال الخرائط الرقمية.
  • الرمز المختصر JPQ8+HC عاد قرب الدرعية إلى النقطة الأصلية بفارق 6 أمتار، أي مركز الخلية نفسها. أما قرب جدة فعاد الرمز 7GHWJPQ8+HC، وهو مكان صحيح الشكل على بعد 884 كيلومتراً، دون أي رسالة خطأ. لذلك لا تقبل في تطبيقك رمزاً مختصراً دون المدينة المكتوبة معه، ولا تستعيده بموقع المستخدم الحالي إذا كان قد يكون في مدينة أخرى.
  • المكتبة تقبل الأحرف الصغيرة، وترفض الرمز دون علامة +، وترفض الحرف A لأنه ليس من الأبجدية، فتستطيع أن تتحقق من الرمز قبل أن ترسله إلى أي مكان.

أربعون عنواناً حقيقياً

نحتاج عناوين حقيقية مكتوبة كما يكتبها الناس، ومعها الموقع الصحيح لكل منها حتى نقيس الخطأ. والمصدر الذي يعطينا الاثنين معاً دون أي بيانات شخصية هو OpenStreetMap نفسها: العناصر التي عليها رقم مبنى وشارع ومدينة بالعربية. نصدرها ونأخذ منها عينة عشوائية ثابتة من 40 عنواناً. ملف lab/sample.py:

# Pick 40 real addresses from OpenStreetMap in the Kingdom: house number + Arabic street name + city
#   input: addr.geojsonseq (osmium export of addr.osm.pbf)   output: sample.json
import json, random, re

AR = re.compile("[" + chr(0x0600) + "-" + chr(0x06FF) + "]")    # any letter of the Arabic block
rows, messy = [], 0
for line in open("addr.geojsonseq", encoding="utf-8"):
    f = json.loads(line.strip("\x1e"))
    p, g = f["properties"], f["geometry"]
    if not all(k in p for k in ("addr:housenumber", "addr:street", "addr:city")):
        continue
    if not AR.search(p["addr:street"]) or not AR.search(p["addr:city"]):
        continue
    if not re.search(r"[0-9]", p["addr:housenumber"]):    # "-" or a building name in the number field
        messy += 1
        continue
    ring = g["coordinates"] if g["type"] == "Point" else (g["coordinates"][0] if g["type"] == "Polygon" else g["coordinates"][0][0])
    pts = [ring] if g["type"] == "Point" else ring
    lon = sum(x for x, _ in pts) / len(pts); lat = sum(y for _, y in pts) / len(pts)
    rows.append({"osm": p["@type"][0] + str(p["@id"]), "house": p["addr:housenumber"], "street": p["addr:street"], "city": p["addr:city"],
                 "district": p.get("addr:district") or p.get("addr:suburb"), "postcode": p.get("addr:postcode"),
                 "lat": round(lat, 6), "lon": round(lon, 6)})

print(f"objects with house number + Arabic street + Arabic city: {len(rows) + messy} ({messy} without a digit in the number)")
cities = {}
for r in rows:
    cities[r["city"]] = cities.get(r["city"], 0) + 1
print("top cities:", sorted(cities.items(), key=lambda x: -x[1])[:6])
random.seed(2026)
sample = random.sample(rows, 40)
json.dump(sample, open("sample.json", "w", encoding="utf-8"), ensure_ascii=False, indent=1)
for r in sample[:3]:
    print(r)
docker run --rm -v "$PWD/lab:/lab:ro" -v "$PWD/data:/data" -w /data address-lab sh -c '
  osmium export -O -f geojsonseq -a type,id -o addr.geojsonseq addr.osm.pbf && python3 /lab/sample.py'
objects with house number + Arabic street + Arabic city: 193 (34 without a digit in the number)
top cities: [('الرياض', 30), ('جدة', 24), ('الهفوف', 10), ('شقراء', 8), ('جده', 8), ('المدينة المنورة', 6)]
{'osm': 'n6640450629', 'house': '52378', 'street': 'شارع البخاري', 'city': 'بريدة', 'district': None, 'postcode': None, 'lat': 26.400604, 'lon': 43.916606}
{'osm': 'n9781483816', 'house': '1', 'street': 'حي الياسمين, طريق الملك عبدالعزيز', 'city': 'الرياض', 'district': None, 'postcode': '13322', 'lat': 24.813152, 'lon': 46.647116}
{'osm': 'n13020902791', 'house': '7874', 'street': 'الشراع الجنوبي 20', 'city': 'الاحساء', 'district': None, 'postcode': '36343', 'lat': 25.40599, 'lon': 49.631277}

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

نرسلها إلى Nominatim وPhoton

نرسل كل عنوان بطريقتين: كاملاً «الرقم الشارع، المدينة»، ودون رقم المبنى كما يكتبه أغلب الناس، إلى الخادمين العامين لـ Nominatim وPhoton، وكلاهما مبني على OpenStreetMap. ونلتزم سياسة استخدام خادم Nominatim العام: طلب واحد في الثانية على الأكثر، وUser-Agent يعرف التطبيق، وعدد قليل من الطلبات، ولا بيانات شخصية، فالمجموع هنا 160 طلباً على الخادمين معاً. ثم نقيس بعد كل نتيجة عن المبنى الحقيقي. ملف lab/geocode.py:

# Send the 40 sampled addresses to the public Nominatim and Photon servers, written two ways,
# and measure how many come back and how far the answer is from the real building.
# Usage policy: one request per second at most, an identifying User-Agent, no personal data.
import json, time, urllib.parse, urllib.request
from pyproj import Geod

UA = {"User-Agent": "ArabRoot-article-lab/1.0 (+https://arabroot.io)"}
geod = Geod(ellps="WGS84")
sample = json.load(open("sample.json", encoding="utf-8"))

def get(url):
    time.sleep(1.1)
    with urllib.request.urlopen(urllib.request.Request(url, headers=UA), timeout=30) as r:
        return json.load(r)

def nominatim(q):
    u = "https://nominatim.openstreetmap.org/search?" + urllib.parse.urlencode(
        {"q": q, "format": "jsonv2", "limit": 1, "countrycodes": "sa", "accept-language": "ar"})
    res = get(u)
    return (float(res[0]["lat"]), float(res[0]["lon"]), res[0]["addresstype"]) if res else None

def photon(q):
    u = "https://photon.komoot.io/api/?" + urllib.parse.urlencode({"q": q, "limit": 1})
    res = get(u)["features"]
    if not res:
        return None
    lon, lat = res[0]["geometry"]["coordinates"]
    p = res[0]["properties"]
    return lat, lon, p.get("type") or p.get("osm_value")

def level(d):
    return "<25 m" if d < 25 else "<250 m" if d < 250 else "<2 km" if d < 2000 else ">=2 km"

results = []
for r in sample:
    forms = {"full": f"{r['house']} {r['street']}، {r['city']}",       # house number, street, city
             "no-house": f"{r['street']}، {r['city']}"}                 # what most people write
    for name, q in forms.items():
        for engine, fn in (("nominatim", nominatim), ("photon", photon)):
            hit = fn(q)
            d = geod.inv(r["lon"], r["lat"], hit[1], hit[0])[2] if hit else None
            results.append({"osm": r["osm"], "form": name, "engine": engine, "query": q,
                            "found": bool(hit), "dist": d, "type": hit[2] if hit else None})
json.dump(results, open("results.json", "w", encoding="utf-8"), ensure_ascii=False, indent=1)

for engine in ("nominatim", "photon"):
    for form in ("full", "no-house"):
        rs = [x for x in results if x["engine"] == engine and x["form"] == form]
        found = [x for x in rs if x["found"]]
        buckets = {b: sum(1 for x in found if level(x["dist"]) == b) for b in ("<25 m", "<250 m", "<2 km", ">=2 km")}
        types = {}
        for x in found:
            types[x["type"]] = types.get(x["type"], 0) + 1
        print(f"{engine:<9} {form:<8} found {len(found):>2}/{len(rs)}  {buckets}  types {dict(sorted(types.items(), key=lambda t: -t[1]))}")
docker run --rm -v "$PWD/lab:/lab:ro" -v "$PWD/data:/data" -w /data address-lab python3 -W ignore /lab/geocode.py
nominatim full     found 29/40  {'<25 m': 25, '<250 m': 0, '<2 km': 2, '>=2 km': 2}  types {'amenity': 12, 'shop': 5, 'office': 2, 'leisure': 2, 'tertiary': 2, 'craft': 2, 'place': 2, 'postcode': 1, 'primary': 1}
nominatim no-house found 30/40  {'<25 m': 1, '<250 m': 8, '<2 km': 8, '>=2 km': 13}  types {'trunk': 5, 'tertiary': 5, 'primary': 5, 'residential': 4, 'secondary': 3, 'motorway': 2, 'amenity': 1, 'town': 1, 'leisure': 1, 'track': 1, 'shop': 1, 'suburb': 1}
photon    full     found 39/40  {'<25 m': 38, '<250 m': 0, '<2 km': 0, '>=2 km': 1}  types {'house': 37, 'other': 1, 'city': 1}
photon    no-house found 39/40  {'<25 m': 4, '<250 m': 8, '<2 km': 8, '>=2 km': 19}  types {'street': 25, 'house': 12, 'county': 1, 'other': 1}

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

  • بالعنوان الكامل أعاد Nominatim 25 عنواناً من 40 إلى المبنى نفسه، في أقل من 25 متراً، ولم يجد 11 عنواناً أصلاً. وأعاد Photon 38 من 40 إلى المبنى. والمحركان يقرآن نفس البيانات، والفرق في طريقة التحليل والمطابقة: Photon مبني للبحث أثناء الكتابة ويتسامح مع الكلمات الزائدة والناقصة، بينما يتوقع Nominatim أن تطابق أجزاء العنوان ما في بياناته.
  • أنواع نتائج Nominatim الكاملة أغلبها amenity وshop وoffice، أي أن العناوين في OpenStreetMap للمملكة موجودة في الغالب على المحلات والخدمات وليس على البيوت، فالمستخدم الذي يكتب عنوان بيته لن يجد غالباً رقمه.
  • دون رقم المبنى عاد عنوان واحد فقط من Nominatim إلى المبنى، و13 إلى مكان يبعد أكثر من كيلومترين، وأغلب الأنواع طرق: trunk وprimary وtertiary. والسبب أن المحرك وجد الشارع فأعاد نقطة على الشارع، والشارع في المدن قد يمتد عشرات الكيلومترات، مثل طريق الملك فهد، فالنقطة «صحيحة» من جهة المحرك، وخاطئة بكيلومترات من جهة المندوب.
  • وجد المحرك شيئاً لـ 30 عنواناً من 40 دون رقم، وهذا أخطر من عدم الوجود، فلو اعتبر تطبيقك كل نتيجة صحيحة لأرسل المندوب إلى منتصف شارع طوله عشرون كيلومتراً.

لماذا فشلت بعض العناوين؟

نفتح ملف النتائج ونطبع العناوين التي فشلت أو ابتعدت في بحث Nominatim الكامل، وهذه بعضها كما خرجت:

docker run --rm -v "$PWD/data:/data" -w /data address-lab sh -c \
  'jq -r ".[] | select(.engine==\"nominatim\" and .form==\"full\" and ((.found|not) or .dist > 250)) | \"\(.found) \(.dist // 0 | floor) \(.type) | \(.query)\"" results.json | head -8'
false 0 null | 1 حي الياسمين, طريق الملك عبدالعزيز، الرياض
false 0 null | 7874 الشراع الجنوبي 20، الاحساء
true 2805 postcode | 11981 رماح، الرياض
false 0 null | 7300 شارع 11 حي العدامة، الدمام
false 0 null | طحينة - حي النسيم, King Abdallah Rd, An Naseem, Jeddah 23233 أبي القاسم الناصري، جدة
true 301 tertiary | 7949 ابن سينا، الهفوف
false 0 null | 2397 طريق الملك فيصل، شقراء
true 285606 primary | W6WW+4J طريق الملك فهد، جده

وكل سطر منها درس عن العناوين الحقيقية:

  • بيانات في الحقل الخطأ: «1 حي الياسمين، طريق الملك عبدالعزيز» فيها الحي داخل حقل الشارع، والمحرك يبحث عن شارع اسمه «حي الياسمين، طريق...» فلا يجده.
  • رقم ليس رقم مبنى: «11981 رماح» فيها الرمز البريدي في حقل الرقم، فوجد Nominatim الرمز البريدي ووضع النقطة على بعد 2.8 كيلومتر.
  • Plus Code في حقل الرقم: «W6WW+4J طريق الملك فهد، جده» فيها رمز Plus Code مختصر مكان رقم المبنى، ومدينة مكتوبة «جده». والمحرك لا يفهم الرمز، فبحث عن طريق الملك فهد ووجد طريقاً بهذا الاسم على بعد 286 كيلومتراً من المبنى. وهذا المثال وحده يلخص المقال: ثلاثة أنظمة عناوين في سطر واحد، والمحرك يفهم واحداً منها فقط.
  • نص مخلوط في الحقول: في عنوان جدة اسم المحل «طحينة» وعنوان كامل بالإنجليزية داخل حقل الرقم، ثم الشارع بالعربية، فلا يجد المحرك شيئاً يطابق هذا الخليط. وفي «2397 طريق الملك فيصل، شقراء» فشل البحث رغم أن الصيغة نظيفة، فقد يكون اسم الطريق في بيانات الخريطة مكتوباً بصيغة أخرى، وقد رأينا في مقال Nominatim أن التوحيد بالعربية يحتاج عملاً إضافياً.

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

docker image rm address-lab
rm -f data/sa.osm.pbf data/addr.osm.pbf data/addr.geojsonseq data/sample.json data/results.json

أي محرك تستخدم في تطبيقك؟

بعد التجربة يصبح السؤال العملي: من أين يأتي تطبيقك بالنقطة لكل عنوان؟ وهناك أربعة خيارات رئيسية، ولكل منها نقاط قوة ونقاط ضعف:

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

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

كيف تخزن العنوان في تطبيقك؟

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

  • النص كما كتبه المستخدم: احفظه كما هو دون تعديل، فهو ما يقرؤه المندوب، والمرجع إذا اختلفت الأنظمة.
  • العنوان المختصر للعنوان الوطني: إذا أدخله المستخدم، مع العنوان الكامل والإحداثيات التي أعادتها الخدمة الرسمية، وتاريخ التحقق.
  • النقطة نفسها: خط العرض والطول على EPSG:4326، ويفضل أن يختارها المستخدم بإصبعه على الخريطة عند أول طلب، فهو يعرف مدخل بيته أفضل من أي محرك.
  • مصدر النقطة ودقتها: من أين جاءت: العنوان الوطني، أو اختيار المستخدم، أو GPS الهاتف مع دقته كما شرحنا في مقال تحديد الموقع بالأقمار الصناعية من هذه المرحلة، أو محرك بحث مع نوع النتيجة. فنقطة من نوع road لا ترسل إليها مندوباً على أنها البيت.
  • Plus Code اختياري: تحسبه أنت من النقطة لتطبعه على الفاتورة أو ترسله في رسالة، ولا تحتاج حفظه لأنه معادلة.
⚠️
لا ترسل كل عنوان يكتبه المستخدم إلى خادم Nominatim العام من تطبيق في الإنتاج، فسياسة استخدامه تمنع الاستخدام الكثيف وتحظر البحث التلقائي أثناء الكتابة، وقد يحظر عنوان سيرفرك. إذا احتجت البحث في تطبيقك فشغل محركك على سيرفرك كما في مقال Nominatim، أو استخدم خدمة العنوان الوطني الرسمية بحسب شروطها.

أخطاء شائعة

  • اعتبار أي نتيجة من الـ Geocoder صحيحة: رأينا أن المحرك أعاد شيئاً لـ 30 عنواناً دون رقم، و13 منها على بعد أكثر من كيلومترين، فاقرأ نوع النتيجة واحفظه.
  • تفكيك العنوان المختصر في كودك: معنى حروفه غير منشور في صفحات سبل الرسمية، فعامله كمفتاح وحوله عبر الخدمة الرسمية فقط.
  • رمز Plus Code مختصر دون مدينة: نفس الرمز JPQ8+HC عاد إلى مكانين بينهما 884 كيلومتراً، فاطلب الرمز الكامل أو الرمز مع المدينة.
  • البحث عن العنوان في كل مرة: حول العنوان مرة واحدة واحفظ النتيجة بحسب شروط الخدمة، والسبب التكلفة والحدود وأن النتيجة لا تتغير غالباً.
  • نسخ العناوين من خدمة رسمية إلى OpenStreetMap: رخصة ODbL لا تقبل بيانات لا تملك حق نشرها.
  • الوثوق في حقول OSM كما هي: رأينا رموزاً بريدية ورموز Plus Codes وأسماء أحياء داخل حقلي الرقم والشارع، فنظف البيانات قبل أن تبني عليها.
  • الاعتماد على نظام مغلق دون خطة بديلة: إذا قبل تطبيقك عناوين what3words، فكل تحويل يمر بخدمة شركة واحدة، فاحفظ الإحداثيات الناتجة مع الكلمات بحسب شروطها.

قائمة تحقق لحقل العنوان في تطبيقك

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

تدريب عملي

  • أضف إلى geocode.py طريقة ثالثة لكتابة العنوان: الشارع والمدينة والرمز البريدي، وقارن هل يساعد الرمز البريدي المحرك على الاقتراب من المبنى.
  • احسب Plus Code لبيتك من إحداثيات هاتفك بالملف pluscodes.py، ثم ابحث عنه في خرائط Google، وقارن موقع الخلية بمدخل البيت الحقيقي.

الخلاصة

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

  • للمكان ثلاثة أوصاف: العنوان للإنسان، والإحداثيات للكمبيوتر، والرمز الشبكي بينهما، وتطبيقك يحتاج الأولين معاً على الأقل.
  • الـ Geocoder يحلل ويوحد ويطابق، وإذا لم يجد المبنى يتراجع بهدوء إلى الشارع أو الحي، فنوع النتيجة أهم من وجودها.
  • العنوان الوطني ستة مكونات وعنوان مختصر من أربعة أحرف وأربعة أرقام، وتصل إليه عبر واجهة سبل البرمجية، ولا تفكك الرمز المختصر بنفسك.
  • Plus Code معادلة مفتوحة: عشرة رموز تعني خلية قرابة 14 متراً، والرمز المختصر يحتاج مدينة قريبة وإلا عاد إلى مكان على بعد مئات الكيلومترات.
  • what3words مربعات 3 أمتار بثلاث كلمات، ولكنه نظام مملوك يمر كل تحويل فيه بخدمة الشركة.
  • في OpenStreetMap للمملكة 10,342 عنصراً فقط عليها رقم مبنى، و193 بعنوان عربي كامل، ومن 40 عنواناً منها أعاد Photon 38 إلى المبنى وNominatim 25، ودون الرقم تراجعت أغلبها إلى شوارع تبعد كيلومترات.

والخطوة التالية في المسار أن تشغل محرك البحث عن العناوين على سيرفرك وتجعله يفهم العربية جيداً، وهذا ما في مقال Nominatim، ثم تعرض النتائج على خريطة ويب.

دليلكيف تعمل الخرائط الرقمية؟ المربعات Tiles والطبقات Layersالمدخل إلى مسار الخرائط، يشرح ما الخريطة الرقمية وكيف يحمل تطبيقك المربعات ويرسم الأسماء العربية، مع تجربة على مربعات حقيقية وخريطة لكل ما تقرأه بعده.دليلكيف يعرف هاتفك مكانك؟ GPS وGalileo وBeiDouكيف يحول جهاز في جيبك أزمنة إشارات الأقمار الصناعية إلى موقع، ولماذا يخطئ بأمتار في الشارع، وكيف يصل المساح إلى المليمترات بطريقة RTK، بأرقام محسوبة من بيانات محطات حقيقية.دليلصيغ البيانات الجغرافية: GeoJSON وShapefile وGeoPackageنحول نفس المباني والأماكن من OpenStreetMap إلى سبع صيغ ونقيس الحجم والسرعة وما يضيع في الطريق، ومنه النص العربي في Shapefile، ثم نختار الصيغة المناسبة لكل عمل.دليلما هي OpenStreetMap؟ البيانات والرخصة والمساهمةكيف تبنى أكبر قاعدة بيانات جغرافية مفتوحة من نقاط وطرق ووسوم، وما الذي تلزمك به رخصتها، وكيف تفحص جودتها في مدينتك قبل أن تبني عليها.دليلالبيانات الجغرافية المفتوحة Open Data في السعوديةأين تجد البيانات الجغرافية عن المملكة، وما الذي يمكن تحميله فعلاً من كل مصدر وبأي رخصة، وكيف تفحص الملف الرسمي قبل أن تبني عليه.دليلالبحث عن العناوين Geocoding مع Nominatimكيف تحول اسم المكان إلى إحداثيات والإحداثيات إلى عنوان على سيرفرك مع Nominatim، وما الذي يجيده بالعربية وما الذي يفوته.دليلكيف تبني تطبيق خرائط وملاحة مثل هدهد وGoogle Maps؟ما الذي يقف خلف كل ميزة في تطبيقات الخرائط، وكيف تبني نسخة أولى منها بأدوات مفتوحة المصدر وبيانات مرخصة بشكل صحيح.دليلمن يرسم خريطة الشارع؟ Google وOSM وOvertureمن أين تأتي بيانات الخريطة التي تراها على هاتفك، ومن يملكها ويصلح أخطاءها، وما الذي تلزمك به رخصتها قبل أن تضعها في تطبيقك.

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

  • 17 نوفمبر 2026: كتابة المقال، وتنفيذ التجربة بـ osmium 1.18.0 وGDAL 3.10.3 وpyproj 3.7.1 وopenlocationcode 1.0.1 وPython 3.13 على Debian 13، على مقتطف Geofabrik لدول الخليج بتاريخ 2026-11-15، وإرسال 160 طلباً إلى خادمي Nominatim وPhoton العامين في 17 نوفمبر 2026، ومراجعة صفحات العنوان الوطني في سبل ووثائق what3words في نفس اليوم، مع Docker Desktop على Windows 11.
نشرة عرب رووت | ArabRoot

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

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

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

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