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

كيف تعمل الخرائط الرقمية؟ المربعات Tiles والطبقات Layers

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

كيف تعمل الخرائط الرقمية؟ المربعات Tiles والطبقات Layers

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

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

  • ما هي الخريطة الرقمية، ولماذا نفصل فيها البيانات عن التنسيق عن الرسم.
  • نوعا البيانات: النقطية Raster والمتجهة Vector، ومتى تستخدم كلاً منهما.
  • الطبقات Layers، والإحداثيات والإسقاط باختصار، ثم المقياس Scale ومستويات التقريب Zoom Levels.
  • المربعات Tiles وعنوانها z/x/y، وكيف يحمل تطبيق الخرائط المربعات خطوة بخطوة.
  • ملف التنسيق Style، والأسماء العربية والكتابة من اليمين إلى اليسار على الخريطة، ومن أين تأتي بيانات الخريطة.
  • دقة الإحداثيات، والخلايا مثل GeoHash وH3.
  • خريطة المسار: ماذا تقرأ بعد هذا المقال، وبأي ترتيب.
  • تجربة عملية: نحسب المربعات، ونفتح مربعاً متجهاً ونقرأ ما فيه في كل مستوى، ونجلب نفس المربع صورةً من OpenStreetMap، ونعد المربعات التي تحملها شاشة الهاتف والحاسوب، ونرسم الخريطة بالعربية والإنجليزية من نفس البيانات.

ما هي الخريطة الرقمية؟ بيانات وتنسيق ورسم

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

  • البيانات Data: ما هو موجود على الأرض ومكانه: هذا خط اسمه طريق الملك فهد ونوعه طريق رئيسي، وهذه نقطة اسمها مستشفى ونوعها مستشفى، وهذا مضلع اسمه حديقة. البيانات لا تعرف شيئاً عن الألوان ولا عن حجم الخط.
  • التنسيق Style: القواعد التي تقرر كيف يبدو كل نوع: الطرق الرئيسية بخط أصفر عرضه 3 بكسل من المستوى 7، والحدائق بلون أخضر فاتح، والأسماء بالعربية إذا وجدت. وهذه القواعد ملف نصي صغير يمكن أن تغيره دون أن تلمس البيانات.
  • الرسم Rendering: البرنامج الذي يأخذ البيانات ويطبق عليها التنسيق ويخرج بكسلات على الشاشة، وقد يكون على السيرفر فيرسل لك صورة جاهزة، أو في المتصفح أو التطبيق فيرسل لك السيرفر البيانات فقط.

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

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

نوعان من البيانات: النقطية Raster والمتجهة Vector

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

  • البيانات النقطية Raster: شبكة من الخلايا المتساوية، كل خلية Pixel تحمل قيمة واحدة، قد تكون لوناً كما في الصورة الجوية، أو ارتفاعاً بالأمتار كما في نموذج الارتفاع الرقمي Digital Elevation Model واختصاراً DEM، أو درجة حرارة أو كثافة نبات. والصورة لا تعرف أن هذا الخط الأبيض طريق، فهي ترى ألواناً فقط، وإذا أردت أن تعرف أين الطرق في صورة جوية فعليك أن تستخرجها منها، وهذا موضوع مقال الذكاء الاصطناعي على الصور الجوية في آخر المسار.
  • البيانات المتجهة Vector: أشكال هندسية Geometry معها خصائص Attributes. والأشكال ثلاثة فقط: النقطة Point مثل مسجد أو صيدلية، والخط LineString مثل طريق أو نهر، والمضلع Polygon مثل مبنى أو حديقة أو حدود حي. وكل شكل يحمل ما تريد من الخصائص: النوع والاسم بعدة لغات وعدد المسارات وحد السرعة.

والصورة التالية تبين الفرق:

لوحتان: على اليمين البيانات النقطية Raster كشبكة خلايا ملونة فيها طريق أبيض قطري ومربع أخضر للحديقة ومربع رمادي لمبنى ومربع أزرق للماء، مع أمثلة صور الأقمار الصناعية ونماذج الارتفاع DEM والمربعات النقطية، وصيغ PNG وJPEG وWebP وGeoTIFF. وعلى اليسار البيانات المتجهة Vector: خط طريق بنقاط عند انعطافاته مع الخاصية kind=major_road، ومضلع حديقة kind=park، ونقطة مستشفى kind=hospital، مع صيغ GeoJSON وShapefile وGeoPackage وMVT
البيانات النقطية تحفظ ما يرى، والمتجهة تحفظ ما هو الشيء وأين هو

ولكل نوع نقاط قوة ونقاط ضعف، والجدول التالي يلخصها من زاوية من يبني خريطة:

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

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

أين النقطة؟ خط العرض وخط الطول باختصار

قبل أن نرسم أي شيء نحتاج طريقة نقول بها أين هو، وأي نقطة على الأرض تحدد برقمين، وهما زاويتان وليسا مسافتين:

  • خط العرض Latitude: الزاوية شمال خط الاستواء أو جنوبه، من 90 جنوباً إلى 90 شمالاً، فخط الاستواء 0، والرياض قرابة 24.64 شمالاً.
  • خط الطول Longitude: الزاوية شرق خط جرينتش Prime Meridian أو غربه، من 180 غرباً إلى 180 شرقاً، والرياض قرابة 46.72 شرقاً.

وتكتب الأرقام في البرمجة بالدرجات العشرية Decimal Degrees، والجنوب والغرب بإشارة سالبة، فنقطة الرياض في OpenStreetMap هي 24.6389160, 46.7160104. وانتبه للترتيب، فهو أكثر خطأ ستقع فيه: الإنسان يقول «خط العرض ثم الطول»، وأغلب المعايير والمكتبات البرمجية، مثل GeoJSON وMapLibre وPostGIS، تكتب الطول أولاً [46.716, 24.639]، لأنه يقابل المحور الأفقي x. فإذا ظهرت نقاطك في المحيط الهندي بدل الرياض، فأول ما تفحصه هو الترتيب.

ولكن الزاوية تحتاج شكلاً تقاس عليه، والأرض ليست كرة تامة وإنما مفلطحة قليلاً عند القطبين، لذلك تحتاج نموذجاً رياضياً للشكل اسمه المرجع الجيوديسي Geodetic Datum، وأشهرها WGS84 الذي يستخدمه GPS، ورقمه في سجل EPSG هو 4326. فعندما ترى EPSG:4326 في أي أداة فالمعنى: خط عرض وخط طول بالدرجات على نموذج WGS84. وهذا يكفيك الآن، أما لماذا تنحرف نقطة من خريطة حكومية قديمة مئات الأمتار عن نفس النقطة على GPS، وما المراجع المستخدمة في المملكة، ولماذا يقلب بعض البرامج ترتيب المحاور، فكل ذلك في مقال المرجع الجيوديسي Datum، وهو المقال الذي تقرأه بعد هذا إذا كان عملك مع بيانات من جهات مختلفة.

كرة أرضية عليها خط الاستواء بخط عرض 0 وخط جرينتش بخط طول 0، وخطوط عرض عند 30 و60 شمالاً، ونقطة الرياض بخط عرض 24.64 شمالاً وخط طول 46.72 شرقاً، مع زاويتين من مركز الأرض توضحان أن الرقمين زاويتان، وتحتها ترتيب الكتابة: الإنسان يقول 24.64, 46.72 وGeoJSON وMapLibre تكتب [46.72, 24.64]
خط العرض وخط الطول زاويتان من مركز الأرض، وأغلب المكتبات تكتب الطول أولاً

الإسقاط Projection: كيف تصبح الكرة مستطيلاً؟

الشاشة مسطحة والأرض كرة، ولا توجد طريقة لفرد قشرة برتقالة على طاولة دون أن تتمزق أو تتمدد، وهذه هي مشكلة الإسقاط Projection: دالة رياضية تحول خط العرض والطول إلى x وy على سطح مستو، وكل إسقاط يضحي بشيء ليحفظ شيئاً آخر: المساحة أو الأشكال أو المسافات أو الاتجاهات، ولا يحفظها كلها.

والإسقاط الذي تستخدمه أغلب خرائط الويب هو Web Mercator، ورقمه EPSG:3857، واسمه الرسمي في السجل WGS 84 / Pseudo-Mercator. وسبب اختياره عملي: يحفظ الأشكال المحلية والزوايا، فالتقاطع القائم في الشارع يبقى قائماً على الشاشة، والشمال دائماً للأعلى، والعالم كله يصبح مربعاً واحداً يسهل تقسيمه إلى مربعات أصغر. والثمن أن المقياس يكبر كلما ابتعدت عن خط الاستواء، فالطول عند خط عرض φ يكبر بالمعامل 1 / cos(φ) والمساحة بمربعه، ولهذا يتوقف الإسقاط عند خط عرض 85.0511 تقريباً، لأن المعامل عند القطب يصبح لا نهائياً، وهذا الحد مذكور في توثيق OpenStreetMap للمربعات.

وهذا يفسر لماذا تبدو جرينلاند على الخريطة بحجم إفريقيا تقريباً: هي قرب خط عرض 72، فكل كيلومتر مربع فيها يرسم أكبر بقرابة 10.5 مرة من كيلومتر مربع عند خط الاستواء، وإفريقيا أغلبها قرب خط الاستواء فترسم بحجم قريب من حقيقتها. والرياض عند خط عرض 24.64 معاملها 1.10 للطول و1.21 للمساحة، وسوف نحسب هذه الأرقام في التجربة.

على اليسار كرة أرضية عليها دوائر متساوية الحجم عند خطوط العرض 0 و24.64 و72، وعلى اليمين خريطة Web Mercator مربعة عليها نفس الدوائر وقد كبرت كلما اتجهت شمالاً: عند خط الاستواء معامل الطول 1 والمساحة 1، وعند الرياض 1.10 و1.21، وعند خط عرض 72 حيث جرينلاند 3.24 و10.47، والخريطة تتوقف عند خط عرض 85.0511 حيث المعامل 11.59 للطول و134 للمساحة
نفس الدائرة على الأرض ترسم أكبر كلما اتجهت نحو القطب، وهذا ثمن خريطة مربعة يسهل تقسيمها

والقاعدة العملية التي تخرج بها: Web Mercator ممتاز للعرض والتنقل، وسيئ لحساب المساحات والمسافات، فلا تحسب مساحة أرض أو طول طريق من x وy على الخريطة، وإنما من خط العرض والطول على النموذج الجيوديسي، كما سوف نرى في التجربة. وإذا احتجت إسقاطاً يحفظ المساحة أو المسافة في منطقة محددة، مثل UTM للأعمال الهندسية، فهذا في قسم المساحة والمسافة: أي إسقاط تستخدم؟ من مقال المرجع الجيوديسي.

المقياس Scale ومستويات التقريب Zoom Levels

في الخريطة الورقية تجد في الزاوية رقماً مثل ⁦1:50,000⁩، أي أن سنتيمتراً واحداً على الورق يساوي 50,000 سنتيمتر على الأرض، أي نصف كيلومتر، وهذا هو المقياس Scale. وكانت الخرائط الورقية تطبع بمقاييس محددة، فخريطة المدينة بمقياس، وخريطة الدولة بمقياس آخر، ولكل مقياس رسام يقرر ماذا يظهر فيها وماذا يحذف.

أما الخريطة الرقمية فليس لها مقياس واحد، لأنك تقرب وتبعد كما تريد، لذلك استبدلت المقاييس بمستويات تقريب Zoom Levels مرقمة من 0، وكل مستوى يضاعف التفاصيل مرتين في كل اتجاه. ففي المستوى 0 يظهر العالم كله في مربع واحد عرضه 256 بكسل، وفي المستوى 1 يصبح العالم 512 بكسل، وفي المستوى 2 يصبح 1024، وهكذا. والطريقة الأوضح لفهم المستوى هي أن تسأل: كم متراً على الأرض يغطي البكسل الواحد على الشاشة؟

عرض الأرض عند خط الاستواء قرابة 40,075 كيلومتراً، يقسم على عدد البكسلات في المستوى، وهو 256 مضروباً في 2^z للمربعات التقليدية بعرض 256 بكسل، ثم يضرب في cos(lat) بسبب الإسقاط. ففي الرياض يغطي البكسل قرابة 139 متراً في المستوى 10، و4.3 متر في المستوى 15، وهذا ما يحدد في أي مستوى يبدأ ظهور المباني أو أسماء الشوارع. والجدول التالي يجمع المستويات التي ستقابلها كثيراً، والأرقام من التجربة لخط عرض الرياض وبمربعات 256 بكسل:

المستوىالبكسل على الأرض في الرياضما تراه عادة
0 إلى 3أكثر من 17 كمالقارات والدول وأسماء العواصم
5قرابة 4.4 كمدولة كاملة ومدنها الكبيرة والطرق السريعة
10قرابة 139 ممدينة كاملة وأحياؤها والطرق الرئيسية
12قرابة 35 موسط المدينة وأغلب الطرق ونقاط الاهتمام المهمة
15قرابة 4.3 مالمباني والشوارع الفرعية وأغلب المحلات
18قرابة 0.5 مالمداخل والأرصفة، وهنا تظهر حدود دقة البيانات

ولاحظ أن المقياس على الشاشة يتغير حتى داخل المستوى الواحد، لأنه يعتمد على كثافة بكسلات الشاشة وعلى خط العرض، لذلك تعرض تطبيقات الخرائط مسطرة مقياس Scale Bar تتحدث مع كل تقريب بدل رقم ثابت مثل الورق. فعلى شاشة حاسوب عادية بكثافة 96 بكسل في البوصة، يكون المستوى 12 بمربعات 256 بكسل في الرياض قرابة ⁦1:131,000⁩.

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

المربعات Tiles: كيف يقسم العالم؟

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

  • في المستوى z يقسم العالم إلى 2^z عموداً و2^z صفاً، أي 4^z مربعاً: مربع واحد في المستوى 0، وأربعة في المستوى 1، و1,024 في المستوى 5، وأكثر من مليار في المستوى 15.
  • العمود x يبدأ من 0 عند خط الطول 180 غرباً ويزيد شرقاً، والصف y يبدأ من 0 في الأعلى عند خط عرض 85.0511 شمالاً ويزيد جنوباً، أي عكس اتجاه خط العرض.
  • عنوان المربع هو z/x/y، ومنه يأتي رابط المربع في أي سيرفر خرائط، مثل /tiles/12/2579/1758.png.

والمعادلة من توثيق OpenStreetMap:

n     = 2 ^ zoom
xtile = n × (lon + 180) / 360
ytile = n × (1 − ln(tan(lat) + sec(lat)) / π) / 2

والجزء الصحيح من الناتج هو رقم المربع، والجزء العشري هو مكان النقطة داخله، فإذا كان x = 20.15 فالنقطة في العمود 20 وعلى بعد 15% من حافته اليسرى. وسوف نرى ذلك بالصورة في التجربة. والصورة التالية تبين الترقيم في المستوى 2 ومكان الرياض في المستوى 5:

على اليسار شبكة المستوى 2 من 4 في 4 مربعات بعناوين من 2/0/0 في الزاوية العلوية اليسرى إلى 2/3/3 في السفلية اليمنى، مع سهم x يتجه شرقاً وسهم y يتجه جنوباً، والرياض في المربع 2/2/1. وعلى اليمين المربع 5/20/13 مكبراً، والرياض داخله عند 15% من العرض و74% من الارتفاع، لأن x تساوي 20.15 وy تساوي 13.74، وتحتها المعادلة
الجزء الصحيح من x وy هو عنوان المربع، والجزء العشري هو مكان النقطة داخله

وهناك ثلاث تفاصيل في هذا الترقيم تسبب أغلب مشاكل المبتدئين، فخذها من الآن:

  • قالب الرابط URL Template: كل مزود مربعات يعطيك رابطاً فيه ثلاثة متغيرات، مثل https://tile.openstreetmap.org/{z}/{x}/{y}.png، والمكتبة تستبدلها بأرقام كل مربع. وهذا الأسلوب اسمه XYZ أو Slippy Map، وهو ما تتوقعه MapLibre وLeaflet وOpenLayers افتراضياً.
  • اتجاه y في TMS: هناك معيار أقدم اسمه Tile Map Service واختصاراً TMS، يعد الصفوف من الأسفل بدل الأعلى، فالصف فيه يساوي 2^z − 1 − y. وإذا خلطت بين الأسلوبين فلن تظهر لك رسالة خطأ، وإنما مربع صحيح من مكان آخر تماماً في نصف الكرة الجنوبي، وسوف نجرب ذلك في التجربة ونرى أين تذهب الرياض.
  • حجم المربع 256 أو 512: المربعات النقطية التقليدية بعرض 256 بكسل، أما المربعات المتجهة فترسمها MapLibre بعرض 512 بكسل، لذلك المستوى 12 في MapLibre يعرض نفس المساحة التي يعرضها المستوى 13 في خريطة نقطية تقليدية. وعلى شاشات الهواتف بكثافة بكسلات مضاعفة تبدو المربعات النقطية بعرض 256 ضبابية، لذلك يقدم بعض المزودين نسخة مضاعفة بعرض 512 يرمز لها عادة @2x، أما المتجهة فترسم بدقة الشاشة نفسها دون نسخة إضافية.

طبقات الخريطة Layers: ما الذي يرسم فوق ماذا؟

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

  • الأساس Base: الأرض earth والماء water، ثم استخدامات الأرض landuse مثل الحدائق والمناطق الصناعية.
  • الشبكات Networks: الطرق roads بأنواعها، والسكك الحديدية.
  • المباني Buildings: مضلعات تظهر في المستويات القريبة فقط.
  • الأماكن Places ونقاط الاهتمام Points of Interest واختصاراً POI: أسماء المدن والأحياء، والمستشفيات والمطاعم والمساجد، وكل نقطة لها نوع kind وأسماء بعدة لغات.
  • النصوص Labels: ترسم أخيراً فوق كل شيء، والمكتبة تقرر أي نص يظهر وأيها يخفى حتى لا تتزاحم.

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

طبقات المربع 12/2579/1758 من الرياض مفصولة فوق بعضها كأوراق مائلة، وعدد العناصر في كل طبقة من التجربة: earth بثلاثة عناصر وwater بأربعة وlanduse بثلاثمائة وثمانية عشر وroads بمائة وخمسة وخمسين وbuildings بعنصرين وpois بسبعة وخمسين وplaces بتسعة وأربعين، وفي الأعلى النصوص مثل مستشفى الملك فيصل التخصصي وقصر الناصرية، والمربع كله 99,121 بايت مضغوطاً
طبقات مربع واحد من الرياض بالترتيب الذي ترسم به، والأعداد من التجربة

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

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

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

ثماني خطوات مرقمة في صفين: الشاشة تتحرك بمركزها ومستوى التقريب وحجمها مثل 1440 في 900 عند المستوى 12، ثم حساب المربعات التي تغطي الشاشة Tile Cover، ثم البحث في الذاكرة المؤقتة Cache وشبكة التوزيع CDN، ثم الطلب عبر HTTP برابط z/x/y أو طلب نطاق Range من ملف PMTiles، ثم فك الضغط والتحليل في Web Worker، ثم تطبيق التنسيق Style وطلب الخطوط Glyphs، ثم وضع النصوص ومنع التزاحم Collision، ثم الرسم بكرت الشاشة WebGL. وتحتها أربعة أرقام من التجربة: 9 مربعات، و10 طلبات، و563 كيلوبايت للمربعات، و473 كيلوبايت للخطوط
من تحريك الإصبع إلى الرسم: ثماني خطوات تتكرر مع كل حركة، والخطوط في أول فتح كلفت قرابة نصف ما كلفته المربعات
  1. الشاشة تتحرك: المكتبة تعرف ثلاثة أشياء فقط: مركز الخريطة، ومستوى التقريب، وحجم الشاشة بالبكسل.
  2. أي المربعات تغطي الشاشة؟ هذا حساب اسمه Tile Cover، وهو نفس معادلة المربعات التي رأيناها مطبقة على أركان الشاشة: كل مربع يلمس الشاشة ولو ببكسل واحد يجب أن يحمل. وسوف نحسب العدد بلغة Python ثم نقارنه بما طلبه المتصفح فعلاً.
  3. هل المربع عندي؟ قبل أي طلب تبحث المكتبة في ذاكرتها، ثم في ذاكرة المتصفح المؤقتة Cache، ثم يمر الطلب غالباً على شبكة توزيع المحتوى Content Delivery Network واختصاراً CDN قبل أن يصل إلى السيرفر. ولهذا السبب تفتح الخريطة في المرة الثانية أسرع بكثير، ولهذا السبب ترسل سيرفرات المربعات ترويسات Cache طويلة، كما سوف نرى في ترويسات مربع حقيقي من OpenStreetMap.
  4. الطلب عبر HTTP: طلب مستقل لكل مربع برابط /{z}/{x}/{y}، أو إذا كانت المربعات في ملف PMTiles واحد، فطلب نطاق HTTP Range يجلب البايتات التي فيها المربع فقط من داخل الملف، وهذا ما شرحناه في PMTiles: ملف واحد بدل سيرفر خرائط.
  5. فك الضغط والتحليل Decode: المربع المتجه مضغوط بصيغة gzip ومكتوب بصيغة Protocol Buffers، والمكتبة تفكه في Web Worker، أي خيط معالجة منفصل عن الصفحة، حتى لا تتجمد الشاشة أثناء التحريك.
  6. تطبيق التنسيق: لكل طبقة في ملف التنسيق تختار المكتبة العناصر التي تناسبها وتحسب ألوانها وعرضها، وتطلب ملفات الخطوط Glyphs للحروف التي ستكتبها، والرموز Sprites مثل أيقونة المستشفى.
  7. وضع النصوص Label Placement: أصعب خطوة حسابياً، فالمكتبة تحاول أن تضع كل اسم في مكانه، وإذا تداخل اسمان أخفت الأقل أهمية، وهذا اسمه كشف التصادم Collision Detection. ولهذا السبب تظهر أسماء جديدة وتختفي أخرى أثناء التقريب.
  8. الرسم: كرت الشاشة يرسم الطبقات بالترتيب عبر WebGL، ثم تتكرر الخطوات مع كل حركة، وأثناء انتظار مربع جديد ترسم المكتبة المربع الأب من المستوى السابق مكبراً حتى لا تظهر فراغات، وهذا ما تراه عندما تظهر الخريطة ضبابية لحظة ثم تتضح.

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

التنسيق Style: نفس البيانات بأشكال مختلفة

ملف التنسيق في MapLibre هو ملف JSON يتبع مواصفة MapLibre Style، وفيه ثلاثة أجزاء رئيسية: المصادر Sources وهي من أين تأتي البيانات، والخطوط Glyphs والرموز Sprites وهي من أين تأتي الحروف والأيقونات، ثم الطبقات Layers، وهي قائمة مرتبة كل عنصر فيها يقول: خذ العناصر من الطبقة الفلانية في المربع، واختر منها ما يحقق هذا الشرط، وارسمها بهذا الشكل من هذا المستوى. والمثال التالي طبقة حقيقية من التنسيق الذي استخدمناه في التجربة، وهي إطار الطرق الرئيسية:

{
  "id": "roads_major_casing_late",
  "type": "line",
  "source": "protomaps",
  "source-layer": "roads",
  "minzoom": 12,
  "filter": ["all", ["!has", "is_tunnel"], ["!has", "is_bridge"], ["==", "kind", "major_road"]],
  "paint": {
    "line-color": "#e0e0e0",
    "line-gap-width": ["interpolate", ["exponential", 1.6], ["zoom"], 6, 0, 12, 1.6, 15, 3, 18, 13],
    "line-width": ["interpolate", ["exponential", 1.6], ["zoom"], 9, 0, 9.5, 1]
  }
}

في الإعداد أعلاه لاحظ التالي:

  • source-layer هو اسم الطبقة داخل المربع المتجه، أي roads التي سوف نعد عناصرها في التجربة، وtype هو نوع الرسم: خط line، أو مساحة fill، أو نص وأيقونة symbol، أو غيرها.
  • filter يختار الطرق الرئيسية فقط، ويستبعد الأنفاق والجسور لأن لها طبقات أخرى ترسم بشكل مختلف، وminzoom يجعل هذه الطبقة تبدأ من المستوى 12.
  • عرض الخط ليس رقماً ثابتاً وإنما دالة في مستوى التقريب interpolate، فالطريق يزداد عرضاً كلما قربت، وهذا ما يجعل الخريطة المتجهة تبدو طبيعية في كل المستويات.

والتنسيق الذي استخدمناه يبنيه سطر واحد من مكتبة @protomaps/basemaps، وعندما سألنا المتصفح عن عدد طبقاته كان الجواب 71 طبقة: طبقة خلفية واحدة، و15 طبقة مساحات، و41 طبقة خطوط، و14 طبقة نصوص وأيقونات، تبدأ بالأرض والغطاء الأرضي وتنتهي بأسماء المناطق والمدن والدول، لأن الأسماء ترسم أخيراً. وهذه الطبقات الواحدة والسبعون كلها تقرأ من نفس المربعات، فإذا غيرت النسخة من light إلى dark أو غيرت اللغة، فلا يتغير أي بايت في البيانات.

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

الأسماء العربية والكتابة من اليمين RTL على الخريطة

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

  1. الاسم في البيانات: في OpenStreetMap يحمل كل مكان الوسم name بلغة أهل المكان، ثم وسوماً لكل لغة مثل name:ar وname:en، كما في صفحة الأسماء متعددة اللغات. وفي التجربة سوف نرى أن المربع الذي فيه وسط الرياض في المستوى 12 فيه 118 عنصراً لها اسم عربي.
  2. اختيار الاسم في التنسيق: طبقة أسماء المدن في التنسيق الذي استخدمناه تختار name:ar إن وجد، وإلا فالاسم الأصلي name، بالتعبير coalesce. وإذا اخترت الإنجليزية فالتنسيق نفسه يكتب الاسم الإنجليزي وتحته الاسم المحلي، كما سوف ترى في صورة التجربة، فتظهر «Riyadh» وتحتها «الرياض».
  3. رسم الحروف: الحرف العربي له أشكال حسب موقعه في الكلمة، والكلمة تكتب من اليمين، والسطر قد يجمع عربياً وأرقاماً وإنجليزياً. والمكتبة ترسم الحروف من ملفات خطوط مقسمة إلى نطاقات كل منها 256 رمزاً من Unicode، كما في توثيق Glyphs، والحروف العربية في النطاق 1536-1791، وهو كتلة Arabic في جدول Unicode، وأشكالها المتصلة في النطاق 65024-65279.

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

وقد كان رسم العربية متصلة من اليمين مشكلة قديمة في مكتبات الخرائط، وكانت تحتاج إضافة اسمها RTL Text Plugin، وقد اختبرنا ذلك بالصور في مقال خرائطك على سيرفرك، والخلاصة أن MapLibre من الإصدار 6.9.0 ترسمها صحيحة دون إضافة. وهناك تغيير آخر أقدم يهمك: منذ الإصدار 5.11.0، إذا لم تجد المكتبة ملف الخط على السيرفر فإنها ترسم الحروف بخط الجهاز بدل أن تتعطل، وسوف نجرب هذا في التجربة ونرى نتيجة قد لا تتوقعها: الخريطة تبدو سليمة رغم أن الخطوط كلها مفقودة.

من أين تأتي بيانات الخريطة؟

كل خريطة تراها تجمع مصادر كثيرة، ولا توجد جهة واحدة تملك خريطة العالم: شركات مثل Google وHERE وTomTom تبني بياناتها من سيارات مسح تجوب الشوارع بكاميرات وماسحات ليزر، كما في سيارات مسح الخرائط، ومن صور الأقمار الصناعية والصور الجوية، ومن بلاغات المستخدمين. ومشروع OpenStreetMap يبنيها من ملايين المتطوعين برخصة مفتوحة، وهو مصدر البيانات في تجربة هذا المقال، وتفاصيله ورخصته في ما هي OpenStreetMap؟. والجهات الحكومية تنشر الحدود الإدارية والعناوين والمخططات، وفي المملكة جمعنا المصادر المفتوحة ورخصها في البيانات الجغرافية المفتوحة في السعودية. أما سرعة الطريق والزحام فتأتي من مواقع الهواتف المتحركة لحظة بلحظة، كما في كيف تعرف الخرائط الزحام؟. وحتى الخريطة الأساسية التي استخدمناها تجمع مصدرين كما يقول وصف الملف نفسه في التجربة: OpenStreetMap، وNatural Earth، وهي بيانات مفتوحة للدول والحدود والسواحل مصممة للمقاييس الصغيرة، أي للمستويات البعيدة التي لا تحتاج تفاصيل الشوارع.

دقة الإحداثيات: كم رقماً بعد الفاصلة تحتاج؟

درجة خط العرض قرابة 111 كيلومتراً في أي مكان، أما درجة خط الطول فتصغر كلما ابتعدت عن خط الاستواء بنفس معامل cos(lat)، ففي الرياض قرابة 101 كيلومتر. ومن هنا تعرف ماذا يعني كل رقم بعد الفاصلة:

الأرقام بعد الفاصلةشمال جنوبشرق غرب في الرياضيكفي لتحديد
111 كم10 كممدينة
21.1 كم1 كمحي
3111 م101 مشارع أو مجمع
411 م10 ممبنى
51.1 م1 مباب أو سيارة
611 سم10 سمأدق من GPS الهاتف غالباً
71.1 سم1 سملا معنى له في أغلب التطبيقات

والقاعدة العملية: ستة أرقام بعد الفاصلة تكفي أي تطبيق تقريباً، وخمسة تكفي توصيل الطلبات، وكل رقم بعدها يخزن ضجيجاً لا دقة، لأن GPS الهاتف نفسه يخطئ عادة بعدة أمتار. والعكس مهم في الخصوصية: إذا عرضت مواقع العملاء أو المندوبين في تقرير، فقرب الأرقام إلى رقمين أو ثلاثة حتى لا تكشف المنزل بعينه. ولا تخزن الإحداثيات كنوع float بدقة مفردة، لأن دقته قرابة 7 أرقام معنوية فقط، فخط طول مثل 46.7160104 يخزن بخطوات قرابة 0.0000038 درجة، أي قرابة 40 سنتيمتراً، فما بعد الرقم الخامس بعد الفاصلة لا يحفظ بدقة، وقد شرحنا السبب في الأنظمة العددية للمبرمجين، واستخدم double أو نوعاً جغرافياً مثل geography في PostGIS.

مسطرة أفقية بمقياس متدرج، عند كل رقم بعد الفاصلة ما يغطيه في الرياض مع رسم صغير: 24.6 عشرة كيلومترات بحجم مدينة، و24.63 كيلومتر بحجم حي، و24.638 مائة متر بحجم شارع، و24.6389 عشرة أمتار بحجم مبنى، و24.63891 متر بحجم سيارة، و24.638916 عشرة سنتيمترات
كل رقم بعد الفاصلة يقسم المسافة على عشرة، والرقم السادس يكفي أغلب التطبيقات

GeoHash وH3: الإحداثيات كخلايا

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

  • GeoHash: يحول النقطة إلى نص قصير، كل حرف إضافي فيه يقسم الخلية إلى خلايا أصغر، فالنقاط التي تشترك في بداية النص قريبة من بعضها، وهذا يجعل البحث عن القريب بحثاً عن بادئة نص في فهرس عادي، كما في الدالة ST_GeoHash في PostGIS. وخلاياه مستطيلات تختلف أبعادها بحسب خط العرض.
  • H3: نظام من Uber برخصة Apache 2 يقسم الأرض إلى خلايا سداسية Hexagons، في 16 مستوى من 0 إلى 15، وفي كل مستوى 12 خلية خماسية فقط لا يمكن تجنبها. وميزة السداسي أن كل خلية لها ستة جيران على نفس المسافة تقريباً، فيصلح لتحليل الطلب وتسعير الرحلات والخرائط الحرارية.
جزءان لنفس نقطة الرياض: على اليسار خلايا GeoHash مستطيلة متداخلة بأسماء th3h ثم th3hpj ثم th3hpj3s، بأبعاد قرابة 35.6 في 19.6 كيلومتر و1112 في 611 متراً و35 في 19 متراً، وعلى اليمين خلايا H3 سداسية بالمستويات 5 و7 و9 بمساحات 245.9 و5.02 و0.10 كيلومتر مربع، وخلية في الوسط حولها ستة جيران
نفس النقطة كنص GeoHash تتشارك بدايته المواقع القريبة، وكخلايا H3 سداسية لها ستة جيران

وسوف تقابل هذه الخلايا عملياً في التحليل المكاني، مثل تجميع الطلبات حسب المنطقة أو حساب التغطية، وهذا في مقال التحليل المكاني Spatial Analysis.

خريطة المسار: ماذا تقرأ بعد هذا المقال؟

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

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

المرحلة الأولى: أساسيات الخرائط والموقع

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

المرحلة الثانية: من يصنع الخريطة ومن أين تأتي بياناتها

هنا تعرف من يرسم الشارع الذي تراه: مقارنة بين Google وHERE وTomTom وOpenStreetMap ومشروع Overture، ثم ما هي OpenStreetMap؟ ونموذج بياناتها ورخصتها، وسيارات المسح وما تحمله من عتاد، وصور الأقمار الصناعية مثل Sentinel-2 وLandsat، وكيف تعرف الخرائط الزحام، والبيانات الجغرافية المفتوحة في السعودية. وهذه المرحلة تفيدك حتى لو لم تكتب كوداً، لأنها تحدد ما يمكنك استخدامه قانونياً في تطبيقك.

المرحلة الثالثة: خدمات الخرائط على سيرفرك

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

المرحلة الرابعة: تحليل المكان بأدوات GIS

هنا تنتقل من عرض الخريطة إلى سؤالها: QGIS للمبتدئين على جهازك، ثم البيانات الجغرافية في PostgreSQL مع PostGIS، ثم التحليل المكاني: أقرب فرع والتغطية بالأرقام، ثم نشر الخرائط مع GeoServer والمربعات المتجهة، وتحليل البيانات الجغرافية بلغة Python مع GeoPandas.

المرحلتان الخامسة والسادسة: داخل المباني وفوقها

GPS لا يصل إلى داخل المجمعات التجارية والمطارات والمستشفيات، لذلك هناك مرحلة للخرائط الداخلية Indoor Maps بطوابقها، ولتحديد الموقع داخل المباني بتقنيات Wi-Fi RTT وBLE وUWB. ثم المرحلة الأخيرة لما بعد الطبقات المتجهة: نماذج الارتفاع والانحدار والرؤية، واستخراج المباني والطرق من الصور الجوية بالذكاء الاصطناعي.

والمقالات التي لم تنشر بعد تجدها في البطاقات التالية، وسوف تفتح عند نشرها إن شاء الله:

دليلكيف يعرف هاتفك مكانك؟ GPS وGalileo وBeiDouكيف يحول جهاز في جيبك أزمنة إشارات الأقمار الصناعية إلى موقع، ولماذا يخطئ بأمتار في الشارع، وكيف يصل المساح إلى المليمترات بطريقة RTK، بأرقام محسوبة من بيانات محطات حقيقية.دليلصيغ البيانات الجغرافية: GeoJSON وShapefile وGeoPackageنحول نفس المباني والأماكن من OpenStreetMap إلى سبع صيغ ونقيس الحجم والسرعة وما يضيع في الطريق، ومنه النص العربي في Shapefile، ثم نختار الصيغة المناسبة لكل عمل.دليلكيف يتحول العنوان إلى نقطة؟ العنوان الوطني وPlus Codesكيف يحول محرك البحث عن العناوين جملة مكتوبة إلى نقطة، وما الذي يضيفه العنوان الوطني وPlus Codes، مع اختبار 40 عنواناً حقيقياً على Nominatim وPhoton وقياس كم منها يصل إلى المبنى الصحيح.دليلمن يرسم خريطة الشارع؟ Google وOSM وOvertureمن أين تأتي بيانات الخريطة التي تراها على هاتفك، ومن يملكها ويصلح أخطاءها، وما الذي تلزمك به رخصتها قبل أن تضعها في تطبيقك.دليلصور الأقمار الصناعية: Sentinel-2 وLandsat مجاناًكيف يرى القمر الصناعي الأرض، وما الذي تعنيه الحزم والدقة والغيوم، وكيف تقرأ مستطيلك من صور Sentinel-2 المجانية وتحسب منها NDVI بنفسك.دليلأول خريطة تفاعلية في موقعك مع MapLibre GL JSخريطة تفاعلية في صفحتك خطوة بخطوة بمكتبة MapLibre: طبقات وعلامات ونوافذ وأسماء عربية وتجميع لآلاف الأماكن، مع الأعطال التي ستقابلها وحلها.دليلتحليل البيانات الجغرافية في Python مع GeoPandasكيف تجيب بكود Python يعاد تشغيله عن أسئلة مثل كم مستشفى في كل منطقة وما القرى البعيدة عن أقرب مستشفى، ببيانات OpenStreetMap حقيقية للمملكة وأرقام مقارنة مع PostGIS.دليلالخرائط الداخلية Indoor Maps: الطوابق وIMDF وOSMكيف تصف المبنى من الداخل بطوابقه وغرفه وأبوابه بثلاثة نماذج مفتوحة، مع مختبر يحول مبنى جامعياً حقيقياً من OpenStreetMap إلى خريطة بطوابق وأرشيف IMDF يمر من قواعد التحقق.دليلتحديد الموقع داخل المباني: Wi-Fi RTT وBLE وUWBلماذا يضيع GPS داخل المبنى، وما الدقة الحقيقية لبصمة Wi-Fi ومنارات BLE وقياس الزمن بـ RTT وUWB، بأرقام من بيانات UJIIndoorLoc ومحاكاة بنموذج ITU-R P.1238.دليلنماذج الارتفاع DEM: الانحدار والرؤية ومستجمع المياهكيف تحسب من نموذج ارتفاع مجاني الانحدار ومجال الرؤية ومجاري الأودية على جبال حقيقية، والأخطاء التي تجعل الأرقام مقنعة وهي خاطئة.دليلاستخراج المباني من الصور الجوية بالتعلم الآلي MLشغلنا نموذجاً منشوراً لرسم المباني على المعالج في مدينتين، وقارنا ما رسمه بطبقات OpenStreetMap وMicrosoft وGoogle بالدقة والاستدعاء، لتعرف متى تنزل طبقة جاهزة ومتى تدرب نموذجك.

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

سوف نستخدم Python داخل Container مع GeographicLib للحساب الدقيق على نموذج WGS84، وgo-pmtiles لقص مربعات الرياض من بناء Protomaps اليومي، وصفحة MapLibre من مختبر خرائطك على سيرفرك مع تعديل صغير يرسم حدود المربعات. والنقطة في كل التجربة هي عقدة الرياض في OpenStreetMap، رقم 315358390.

والتجربة جزءان: الجزء الأول نفذناه عند كتابة المقال في أكتوبر 2026 على بناء Protomaps بتاريخ 20261008، وفيه حساب المربعات وطبقات مربع واحد وحدود المربعات في المتصفح والمسافات. والجزء الثاني أضفناه عند تحديث المقال في نوفمبر 2026 على بناء 20261116 حتى المستوى 15، وفيه ما يحمله المربع في كل مستوى، ونفس المربع صورةً من OpenStreetMap، وعدد المربعات لكل شاشة، والأسماء بلغتين. ولاحظ أن ملفات البناء اليومية لا تبقى على السيرفر طويلاً، فرابط 20261008 لم يعد يعمل اليوم ويعطي 404، لذلك استبدل التاريخ في أي أمر بأحدث بناء من صفحة البناءات.

حساب عنوان المربع للرياض

ملف tiles.py:

# Tile math for one point: the Riyadh node in OpenStreetMap (node 315358390)
import math
lat, lon = 24.6389160, 46.7160104

def tile(lat, lon, z):
    n = 2 ** z
    x = (lon + 180) / 360 * n
    lat_r = math.radians(lat)
    y = (1 - math.asinh(math.tan(lat_r)) / math.pi) / 2 * n
    return x, y

print("zoom  tiles_in_world   x            y            tile")
for z in (0, 1, 5, 10, 12, 15):
    x, y = tile(lat, lon, z)
    print(f"{z:>4}  {4**z:>14,}  {x:>11.4f}  {y:>11.4f}  {z}/{int(x)}/{int(y)}")
docker run --rm --name lab-mapsb-py -v "$PWD:/lab" -w /lab python:3.13.16-slim python tiles.py

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

zoom  tiles_in_world   x            y            tile
   0               1       0.6298       0.4293  0/0/0
   1               4       1.2595       0.8587  1/1/0
   5           1,024      20.1525      13.7391  5/20/13
  10       1,048,576     644.8811     439.6504  10/644/439
  12      16,777,216    2579.5244    1758.6014  12/2579/1758
  15   1,073,741,824   20636.1951   14068.8113  15/20636/14068

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

  • math.asinh(math.tan(lat)) هي نفس ln(tan(lat) + sec(lat)) في المعادلة، بصيغة أقصر.
  • في المستوى 1 العالم أربعة مربعات، والرياض في المربع 1/1/0: العمود 1 لأنها شرق جرينتش، والصف 0 لأنها شمال خط الاستواء.
  • كل مستوى يضاعف x وy تقريباً: 20.15 في المستوى 5 تصبح 644.88 في المستوى 10، أي ضرب في 2 خمس مرات، وهذا ما يجعل المربع في مستوى ما يحتوي أربعة مربعات من المستوى الذي بعده.
  • عدد المربعات في المستوى 15 أكثر من مليار، لذلك لا أحد يرسم المربعات النقطية للعالم كله مسبقاً، وإنما يقص المنطقة التي يحتاجها أو يستخدم المربعات المتجهة.

مربع حقيقي: ماذا يوجد داخل 12/2579/1758؟

نقص مستطيل الرياض من بناء Protomaps بتاريخ 20261008 حتى المستوى 14، كما فعلنا في مختبر خرائطك على سيرفرك، ثم نستخرج المربع الذي حسبناه للمستوى 12:

mkdir -p web/tiles
docker run --rm --name lab-mapsb-pmtiles -v "$PWD/web/tiles:/out" protomaps/go-pmtiles:v1.31.2 \
  extract https://build.protomaps.com/20261008.pmtiles /out/riyadh.pmtiles --bbox=46.45,24.45,47.05,25.00 --maxzoom=14
docker run --rm --name lab-mapsb-pmtiles -v "$PWD/web/tiles:/out" protomaps/go-pmtiles:v1.31.2 \
  tile /out/riyadh.pmtiles 12 2579 1758 > tile-12-2579-1758.mvt

والمخرج من أمر القص سوف يكون كما يلي (اختصرنا شريط التقدم):

extract.go:450: fetching 1108 tiles, 57 chunks, 27 requests
extract.go:606: Completed in 32.584997383s with 4 download threads (34.00337841296619 tiles/s).
extract.go:611: Extract required 37 total requests.
extract.go:612: Extract transferred 9.4 MB (overfetch 0.05) for an archive size of 9.1 MB

ثم نفتح المربع بمكتبة mapbox-vector-tile ونعد ما في كل طبقة. ملف layers.py:

# Open one vector tile (z12/2579/1758) and list what is inside it
import gzip, mapbox_vector_tile
raw = gzip.decompress(open("tile-12-2579-1758.mvt", "rb").read())
tile = mapbox_vector_tile.decode(raw)
print(f"compressed 99121 bytes, uncompressed {len(raw)} bytes")
for name, layer in tile.items():
    kinds = sorted({f["geometry"]["type"] for f in layer["features"]})
    print(f"{name:<10} {len(layer['features']):>5} features  extent {layer['extent']}  {', '.join(kinds)}")
pois = [f["properties"] for f in tile["pois"]["features"] if "name:ar" in f["properties"]]
print("\nfirst POIs with an Arabic name:")
for p in pois[:4]:
    print({k: p[k] for k in ("kind", "name", "name:ar", "name:en") if k in p})
docker run --rm --name lab-mapsb-py -v "$PWD:/lab" -w /lab python:3.13.16-slim sh -c 'pip install -q --root-user-action=ignore mapbox-vector-tile==2.2.0 2>/dev/null; python layers.py'

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

compressed 99121 bytes, uncompressed 131382 bytes
buildings      2 features  extent 4096  MultiPolygon
earth          3 features  extent 4096  MultiLineString, Polygon
landuse      318 features  extent 4096  MultiPolygon, Polygon
places        49 features  extent 4096  Point
pois          57 features  extent 4096  Point
roads        155 features  extent 4096  LineString, MultiLineString
water          4 features  extent 4096  MultiLineString, MultiPolygon, Polygon

first POIs with an Arabic name:
{'kind': 'hospital', 'name': 'مستشفى الملك فيصل التخصصي', 'name:ar': 'مستشفى الملك فيصل التخصصي', 'name:en': 'King Faisal Specialist Hospital'}
{'kind': 'castle', 'name': 'قصر الناصرية', 'name:ar': 'قصر الناصرية', 'name:en': 'Qasr an Nasriyah'}
{'kind': 'administrative', 'name': 'الفاخرية', 'name:ar': 'الفاخرية', 'name:en': 'Al Fakhiriyah District'}
{'kind': 'administrative', 'name': 'البديعة', 'name:ar': 'البديعة', 'name:en': 'Al Badiah District'}

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

  • المربع كله 99 كيلوبايت مضغوطاً و128 كيلوبايت دون ضغط، وفيه كل ما تحتاجه لرسم وسط الرياض في المستوى 12 بأي لغة وأي ألوان.
  • الطبقات السبع هي نفسها طبقات الخريطة التي شرحناها، وكل عنصر فيها هندسة Geometry ونوع، فالطرق خطوط والأماكن نقاط والمباني مضلعات.
  • extent 4096 تعني أن الإحداثيات داخل المربع أعداد صحيحة من 0 إلى 4096، وليست خطوط عرض وطول، فالمكتبة تحولها إلى بكسلات بحسب حجم المربع على الشاشة، وهذا من أسباب صغر حجمه، كما في مواصفة Mapbox Vector Tile.
  • المباني عنصران فقط في المستوى 12، لأن البناء لا يضع المباني إلا في المستويات القريبة، وكل نقطة اهتمام فيها name وname:ar وname:en، فالتنسيق يختار منها.

نرى حدود المربعات على الخريطة

نضيف إلى مجلد web ملفات MapLibre وpmtiles والخطوط كما في ملفات الموقع في المقال السابق، وبنفس إعداد nginx، ثم صفحة جديدة web/tiles.html تفعل الخيار showTileBoundaries الذي يرسم حدود كل مربع وعنوانه وحجمه، وتسجل عنوان كل مربع تحمله الخريطة:

<!doctype html>
<html lang="ar" dir="rtl">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>مربعات الرياض</title>
<link rel="stylesheet" href="/lib/maplibre-gl.css">
<style>html, body, #map { margin: 0; height: 100%; }</style>
<script type="importmap">{ "imports": { "fflate": "/lib/fflate.mjs" } }</script>
</head>
<body>
<div id="map"></div>
<script type="module">
import * as maplibregl from '/lib/maplibre-gl.mjs';
import { Protocol } from '/lib/pmtiles.mjs';
import { layers, namedFlavor } from '/lib/basemaps.mjs';

maplibregl.addProtocol('pmtiles', new Protocol().tile);
const q = new URLSearchParams(location.search);
const riyadh = [46.7160104, 24.6389160];          // the Riyadh node in OpenStreetMap
window.map = new maplibregl.Map({
  container: 'map',
  center: riyadh,
  zoom: Number(q.get('z') || 12),
  style: {
    version: 8,
    glyphs: '/assets/fonts/{fontstack}/{range}.pbf',
    sprite: `${location.origin}/assets/sprites/v4/light`,
    sources: { protomaps: { type: 'vector', url: 'pmtiles:///tiles/riyadh.pmtiles',
      attribution: '<a href="https://www.openstreetmap.org/copyright">© OpenStreetMap</a>' } },
    layers: layers('protomaps', namedFlavor('light'), { lang: 'ar' })
  }
});
map.showTileBoundaries = true;                    // draw each tile's edge and its z/x/y
new maplibregl.Marker({ color: '#E95420' }).setLngLat(riyadh).addTo(map);
// log every tile the map loads, as z/x/y
window.tiles = new Set();
map.on('sourcedata', (e) => {
  if (e.coord) { const c = e.coord.canonical; window.tiles.add(`${c.z}/${c.x}/${c.y}`); }
});
</script>
</body>
</html>

وملف compose.yaml بمنفذ مختلف عن المقال السابق:

name: lab-mapsb
services:
  web:
    image: nginx:1.29.8-alpine
    container_name: lab-mapsb-web
    volumes:
      - ./web:/usr/share/nginx/html:ro
      - ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
    ports:
      - "127.0.0.1:18761:80"

ثم نشغله ونفتح http://127.0.0.1:18761/tiles.html?z=5، ثم z=10 وz=12 وz=14، ونقرأ قائمة المربعات من Console بالأمر JSON.stringify([...window.tiles].sort()):

{"zoom":5,"tiles":["5/20/13"]}
{"zoom":10,"tiles":["10/644/438","10/644/439","10/644/440","10/645/438","10/645/439","10/645/440"]}
{"zoom":12,"tiles":["12/2578/1757","12/2578/1758","12/2578/1759","12/2579/1757","12/2579/1758","12/2579/1759","12/2580/1757","12/2580/1758","12/2580/1759"]}
{"zoom":14,"tiles":["14/10316/7033","14/10316/7034","14/10316/7035","14/10317/7033","14/10317/7034","14/10317/7035","14/10318/7033","14/10318/7034","14/10318/7035","14/10319/7033","14/10319/7034","14/10319/7035"]}

المربع الذي حسبناه في Python لكل مستوى موجود في القائمة: 5/20/13 و10/644/439 و12/2579/1758، والمتصفح طلب حوله المربعات التي تغطي الشاشة فقط. والصورة التالية للمستوى 5، والملف الذي قصصناه فيه مربع واحد فقط في هذا المستوى، فظهر وحده وحوله رمادي:

خريطة بالمستوى 5 فيها مربع واحد ملون بحدود حمراء وعنوانه 5/20/13 وحجمه 68 كيلوبايت، يظهر فيه الخليج العربي والكويت والبحرين وقطر والإمارات وشيراز، وعلامة الرياض في الربع السفلي الأيسر من المربع، وحوله مساحة رمادية لا بيانات فيها
المربع 5/20/13 وحده، والرياض عند 15% من عرضه و74% من ارتفاعه كما قال الجزء العشري في الحساب

ولاحظ مكان العلامة: حسبنا x = 20.1525 وy = 13.7391، أي 15% من عرض المربع من اليسار و74% من ارتفاعه من الأعلى، وهذا بالضبط مكانها في الصورة. والصورة التالية للمستوى 12، والمربع 12/2579/1758 في الوسط بحجم 128 كيلوبايت، وهو نفس الرقم الذي حصلنا عليه بعد فك الضغط في Python:

خريطة وسط الرياض بالمستوى 12 بأسماء عربية مثل العليا والملز والناصرية والشميسي وطريق الملك فهد، وعليها خطوط حمراء تفصل المربعات وعناوينها 12/2579/1758 بحجم 128 كيلوبايت و12/2580/1758 بحجم 51 كيلوبايت و12/2579/1759 بحجم 82 كيلوبايت و12/2580/1759 بحجم 47 كيلوبايت، وعلامة الرياض داخل المربع 12/2579/1758
المستوى 12: المربع الأوسط أكبر حجماً لأن وسط المدينة أكثر تفاصيل
خريطة بالمستوى 14 حول قصر المصمك وحديقة الوطن وشارع الإمام فيصل بن تركي، وحدود المربعات بعناوين مثل 14/10317/7034 بحجم 54 كيلوبايت و14/10318/7034 بحجم 56 كيلوبايت و14/10318/7035 بحجم 40 كيلوبايت، وعلامة الرياض في الوسط، وتظهر المباني والبريد السعودي
المستوى 14: كل مربع من المستوى 12 أصبح ستة عشر مربعاً، وظهرت المباني

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

ماذا يحمل المربع في كل مستوى؟

رأينا مربعاً واحداً في المستوى 12، والآن نريد أن نرى التعميم Generalization الذي تحدثنا عنه بالأرقام: نأخذ المربع الذي فيه نقطة الرياض في كل مستوى من 0 إلى 15، ونعد ما فيه. نبدأ بقص المنطقة نفسها من أحدث بناء حتى المستوى 15 هذه المرة، وبصورة Python صغيرة فيها المكتبتان اللتان نحتاجهما، ومنهما مكتبة pmtiles التي تقرأ المربع من الملف مباشرة دون أن نستخرجه أولاً. ملف Dockerfile:

# Python with the two libraries the lab needs: read PMTiles archives and decode vector tiles
FROM python:3.13.16-slim
RUN pip install --no-cache-dir --root-user-action=ignore mapbox-vector-tile==2.2.0 pmtiles==3.8.1

ثم نبني الصورة ونقص المنطقة ونقرأ وصف الملف:

docker build -t mapsb-py .
docker run --rm -v "$PWD/web/tiles:/out" protomaps/go-pmtiles:v1.31.2 \
  extract https://build.protomaps.com/20261116.pmtiles /out/riyadh.pmtiles --bbox=46.45,24.45,47.05,25.00 --maxzoom=15
docker run --rm -v "$PWD/web/tiles:/out" protomaps/go-pmtiles:v1.31.2 show /out/riyadh.pmtiles

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

extract.go:441: Region tiles 4249, result tile entries 4184
extract.go:450: fetching 4184 tiles, 98 chunks, 36 requests
extract.go:606: Completed in 36.211173774s with 4 download threads (115.54444501037597 tiles/s).
extract.go:612: Extract transferred 18 MB (overfetch 0.05) for an archive size of 17 MB

pmtiles spec version: 3
tile type: mvt
bounds: (long: 46.450000, lat: 24.450000) (long: 47.050000, lat: 25.000000)
min zoom: 0
max zoom: 15
addressed tiles count: 4249
tile entries count: 4184
tile contents count: 4126
internal compression: gzip
tile compression: gzip
description Basemap layers derived from OpenStreetMap and Natural Earth
planetiler:osm:osmosisreplicationtime 2026-11-16T04:00:00Z
version 4.15.2

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

  • المستطيل نفسه الذي كان 9.1 ميجابايت حتى المستوى 14 في أكتوبر أصبح 17 ميجابايت حتى المستوى 15، أي أن مستوى واحد إضافي ضاعف الحجم تقريباً، لأن عدد المربعات يتضاعف أربع مرات في كل مستوى، وهذا ما تحسبه عندما تختار أقصى مستوى للمنطقة التي تقصها.
  • addressed tiles count: 4249 وtile contents count: 4126: هناك 4,249 عنواناً ولكن 4,126 محتوى مختلفاً فقط، لأن المربعات المتطابقة، مثل مربعات صحراء ليس فيها إلا الأرض، تحفظ مرة واحدة ويشير إليها أكثر من عنوان.
  • planetiler:osm:osmosisreplicationtime هو عمر البيانات: هذا البناء فيه تعديلات OpenStreetMap حتى فجر يوم 16 نوفمبر، والملف أنتجته أداة Planetiler.

الآن ملف zooms.py يحسب عنوان المربع في كل مستوى بنفس معادلة tiles.py، ثم يقرأه من الملف ويفك ضغطه ويعد ما فيه:

# What one map tile carries at each zoom: the tile that contains the Riyadh node, z0 to z15
import gzip, math
import mapbox_vector_tile
from pmtiles.reader import Reader, MmapSource

lat, lon = 24.6389160, 46.7160104
def tile(z):
    n = 2 ** z
    x = int((lon + 180) / 360 * n)
    y = int((1 - math.asinh(math.tan(math.radians(lat))) / math.pi) / 2 * n)
    return x, y

with open("web/tiles/riyadh.pmtiles", "rb") as f:
    r = Reader(MmapSource(f))
    print("tile           gzip_B  raw_B  roads  build  polys  pois  places  ar_names")
    for z in range(0, 16):
        x, y = tile(z)
        data = r.get(z, x, y)
        raw = gzip.decompress(data)
        t = mapbox_vector_tile.decode(raw)
        count = lambda name: len(t.get(name, {}).get("features", []))
        parts = sum(len(f["geometry"]["coordinates"]) if f["geometry"]["type"] == "MultiPolygon" else 1 for f in t.get("buildings", {}).get("features", []))
        ar = sum(1 for l in t.values() for f in l["features"] if "name:ar" in f["properties"])
        print(f"{f'{z}/{x}/{y}':<15} {len(data):>7} {len(raw):>7} {count('roads'):>5} {count('buildings'):>6} {parts:>6} "
              f"{count('pois'):>5} {count('places'):>6} {ar:>8}")
docker run --rm -v "$PWD:/lab" -w /lab mapsb-py python zooms.py

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

tile           gzip_B  raw_B  roads  build  polys  pois  places  ar_names
0/0/0             66795   93230     0      0      0     0      0        5
1/1/0             77372  106575     0      0      0     0     29       29
2/2/1            126522  178449     0      0      0     0     71       71
3/5/3             77523  108721     2      0      0     0     60       62
4/10/6            64046   89241     2      0      0     0     50       51
5/20/13           50514   69940     2      0      0     0     44       45
6/40/27           23723   31018     4      0      0     0      9       10
7/80/54           30017   40614    16      0      0     5     25       25
8/161/109         26331   35890    21      0      0     1      8        8
9/322/219         87933  121501    30      0      0     1      7        8
10/644/439        78062  108873    26      0      0     0     16       16
11/1289/879       46966   67007    36      2     85    67      1       71
12/2579/1758      99241  131443   153      2    341    57     49      118
13/5159/3517      40314   51307    93      4    105    29     16       43
14/10318/7034     32488   57601   511      4     73    28      8       26
15/20636/14068    12239   20397   139     43     43    48      2       17

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

  • الحجم لا يكبر مع التقريب، وإنما يدور حول 12 إلى 124 كيلوبايت في كل المستويات، وهذا هو التعميم: في المستوى 0 يحمل المربع العالم كله ولكن بخطوط مبسطة جداً، وفي المستوى 15 يحمل مساحة صغيرة بكل تفاصيلها. وهذا التوازن مقصود عند البناء، لأن المربع الذي يزيد عن بضع مئات من الكيلوبايتات يبطئ الخريطة.
  • أكبر مربع في القائمة هو 2/2/1 بحجم 124 كيلوبايت، وفيه 71 اسماً لدول ومدن، ومعها حدود الدول والغطاء الأرضي لربع الكرة تقريباً. وعندما فحصنا طبقاته وجدنا فيه 42,543 نقطة لطبقة الغطاء الأرضي landcover وحدها، أي الصحارى والغابات والجليد مرسومة كمضلعات.
  • المستوى 9 ارتفع فجأة إلى 86 كيلوبايت، والسبب أن استخدامات الأرض landuse ظهرت فيه بتفصيل، 945 مضلعاً في مربع واحد، ثم تقل في المستويات التالية لأن كل مربع يغطي مساحة أصغر.
  • الطرق تبدأ من المستوى 3 بعنصرين فقط في المربع كله، ونقاط الاهتمام من المستوى 7، والمباني من المستوى 11. والعمود build يعد العناصر، والعمود polys يعد المضلعات داخلها، لأن البناء يدمج مباني متجاورة متشابهة في عنصر واحد من نوع MultiPolygon: في المستوى 12 عنصران فقط ولكن فيهما 341 مبنى.
  • العمود الأخير يعد العناصر التي لها name:ar، وهو في المستوى 12 أكثر من مئة عنصر، وهذا كل ما تحتاجه الخريطة لتعرض الأسماء بالعربية.

والصورة التالية تجمع الحجم في كل مستوى:

أعمدة لحجم المربع الذي فيه نقطة الرياض بالكيلوبايت بعد الضغط من المستوى 0 إلى 15: 65 و76 و124 و76 و63 و49 و23 و29 و26 و86 و76 و46 و97 و39 و32 و12، والأعمدة البرتقالية عند المستويات 2 و9 و12 و15 مع شرح: في المستوى 2 ربع العالم و71 اسماً، وفي 9 ظهرت 945 مضلعاً لاستخدامات الأرض، وفي 12 وسط المدينة و153 طريقاً و118 اسماً عربياً، وفي 15 مساحة صغيرة فيها 43 مبنى
كل مستوى يختار ما يناسبه من التفاصيل، فيبقى المربع صغيراً من المستوى 0 إلى 15

نفس المربع صورةً: مربع نقطي من OpenStreetMap

الآن نطلب نفس العنوان 12/2579/1758 من سيرفر المربعات النقطية لمشروع OpenStreetMap، وهو سيرفر يعمل بالتبرعات وله سياسة استخدام واضحة: ترويسة User-Agent تعرف تطبيقك، وعدم التحميل الجماعي، واحترام ترويسات Cache. وتنص السياسة على أن الطلبات بالترويسة الافتراضية لأدوات مثل curl وpython-requests تحظر، لذلك نضع اسماً لتطبيقنا، ونطلب مربعين فقط:

curl -sS -A "ArabRoot-lab/1.0 (+https://arabroot.io)" -D - -o osm-12-2579-1758.png \
  https://tile.openstreetmap.org/12/2579/1758.png | tr -d '\r' \
  | grep -iE "^HTTP|content-type|content-length|cache-control|expires|etag|x-cache|age:"

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

HTTP/1.1 200 OK
Content-Length: 44878
ETag: "3e40eab3897ae1e7064a36c1839c6770"
Cache-Control: max-age=87165, stale-while-revalidate=604800, stale-if-error=604800
Expires: Thu, 12 Nov 2026 13:22:08 GMT
Content-Type: image/png
Age: 459442
X-Cache: HIT

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

  • المربع صورة PNG بحجم 44,878 بايت، أي أقل من نصف المربع المتجه الذي يغطي نفس المساحة بحجم 99,241 بايت، فالصورة أصغر هنا، ولكنها بلغة واحدة وألوان واحدة وعرض 256 بكسل فقط.
  • X-Cache: HIT وAge: 459442: المربع جاء من ذاكرة شبكة التوزيع، وعمره فيها قرابة خمسة أيام وثلث، ولم يصل طلبنا إلى سيرفر الرسم أصلاً، وهذا هو السبب الذي يجعل سيرفراً واحداً للتبرعات يخدم العالم.
  • Cache-Control يسمح بتقديم النسخة القديمة أسبوعاً كاملاً أثناء تحديثها stale-while-revalidate=604800، لذلك قد ترى في الخريطة النقطية تعديلاً قديماً بعد أن صححته في OpenStreetMap، وهذا طبيعي.
  • ETag بصمة للمربع، فإذا طلبه المتصفح مرة أخرى بنفس البصمة أجابه السيرفر بأنه لم يتغير دون أن يرسل البايتات.

والصورة التالية تضع المربع النقطي بجانب نفس المساحة مرسومة من المربعات المتجهة بالعربية ثم بالإنجليزية، والصور كلها من التجربة:

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

ولاحظ أن الخريطة النقطية من OpenStreetMap تعرض الاسم الأصلي name، وهو بالعربية في المملكة، أما في دولة أخرى فسوف تعرضه بلغة أهلها، ولن تستطيع أن تجعلها عربية إلا بسيرفر رسم خاص بك. أما الخريطة المتجهة فقد غيرنا فيها المعامل lang في الرابط فقط.

نجرب الخطأ: y من الأسفل بدل الأعلى

لنفرض أن مكتبة أو سيرفراً يتبع ترقيم TMS، فيعد الصفوف من الأسفل، وأنت أعطيته عنوان XYZ. الرقم الذي سيطلبه هو 4095 − 1758 = 2337، فلنطلب هذا المربع ونرى ماذا يحدث:

curl -sS -A "ArabRoot-lab/1.0 (+https://arabroot.io)" -o osm-12-2579-2337.png \
  -w "%{http_code} %{size_download} %{content_type}\n" https://tile.openstreetmap.org/12/2579/2337.png

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

200 9181 image/png

الطلب نجح والسيرفر أعاد صورة سليمة بحجم 9,181 بايت، ولا يوجد أي خطأ تكتشفه من الكود، ولكن الصورة من جنوب مدغشقر، أي نفس خط الطول ونفس خط العرض تقريباً جنوب خط الاستواء بدل شماله:

مربعان نقطيان من OpenStreetMap: على اليمين 12/2579/1758 بإطار أخضر وهو وسط الرياض بشوارعه وأسمائه العربية، وعلى اليسار 12/2579/2337 بإطار أحمر وهو منطقة خضراء جنوب مدغشقر مكتوب فيها Amboasary-Atsimo، وبينهما المعادلة y_tms تساوي 2 أس z ناقص 1 ناقص y، و4095 ناقص 1758 يساوي 2337
خطأ y المقلوب لا يعطي رسالة خطأ، وإنما يعطي مكاناً صحيحاً في نصف الكرة الآخر

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

كم مربعاً تحمل الشاشة؟

نحسب أولاً بلغة Python عدد المربعات التي تغطي ثلاث شاشات حول نقطة الرياض: هاتف وحاسوب محمول وشاشة Full HD، في المستويين 12 و14، مرة بمربعات نقطية بعرض 256 بكسل، ومرة بمربعات متجهة بعرض 512 بكسل لنفس المنظر. ملف screen.py:

# How many tiles cover one screen? Count the tiles a viewport touches around the Riyadh node
import math

lat, lon = 24.6389160, 46.7160104
def cover(w, h, tz, size):                    # tiles of zoom tz, `size` px wide, that touch a w x h screen
    n = size * 2 ** tz                         # the whole world in pixels
    cx = (lon + 180) / 360 * n
    cy = (1 - math.asinh(math.tan(math.radians(lat))) / math.pi) / 2 * n
    cols = math.floor((cx + w / 2) / size) - math.floor((cx - w / 2) / size) + 1
    rows = math.floor((cy + h / 2) / size) - math.floor((cy - h / 2) / size) + 1
    return cols * rows

# the same view (same metres per pixel): 512 px vector tiles of zoom z, or 256 px raster tiles of zoom z+1
screens = {"phone 390x844": (390, 844), "laptop 1440x900": (1440, 900), "full HD 1920x1080": (1920, 1080)}
print("screen              view_zoom  raster_256px(z+1)  vector_512px(z)")
for name, (w, h) in screens.items():
    for z in (12, 14):
        print(f"{name:<19} {z:>9}  {cover(w, h, z + 1, 256):>17}  {cover(w, h, z, 512):>15}")
docker run --rm -v "$PWD:/lab" -w /lab mapsb-py python screen.py

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

screen              view_zoom  raster_256px(z+1)  vector_512px(z)
phone 390x844              12                  8                3
phone 390x844              14                  8                6
laptop 1440x900            12                 24                9
laptop 1440x900            14                 28               12
full HD 1920x1080          12                 40               15
full HD 1920x1080          14                 40               12

ثم نتحقق من الحساب في المتصفح، بصفحة web/view.html تشبه صفحة حدود المربعات، ولكنها تأخذ المركز واللغة ومسار الخطوط من الرابط، وتجمع في الدالة stats() عدد المربعات والطلبات والبايتات من performance:

<!doctype html>
<html lang="ar" dir="rtl">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>كم مربعاً تحمل الشاشة؟</title>
<link rel="stylesheet" href="/lib/maplibre-gl.css">
<style>html, body, #map { margin: 0; height: 100%; }</style>
<script type="importmap">{ "imports": { "fflate": "/lib/fflate.mjs" } }</script>
</head>
<body>
<div id="map"></div>
<script type="module">
import * as maplibregl from '/lib/maplibre-gl.mjs';
import { Protocol } from '/lib/pmtiles.mjs';
import { layers, namedFlavor } from '/lib/basemaps.mjs';

maplibregl.addProtocol('pmtiles', new Protocol().tile);
const q = new URLSearchParams(location.search);
window.map = new maplibregl.Map({
  container: 'map',
  center: [Number(q.get('lon') || 46.7160104), Number(q.get('lat') || 24.6389160)],
  zoom: Number(q.get('z') || 12),
  attributionControl: { compact: false },
  style: {
    version: 8,
    glyphs: q.get('glyphs') || '/assets/fonts/{fontstack}/{range}.pbf',
    sprite: `${location.origin}/assets/sprites/v4/light`,
    sources: { protomaps: { type: 'vector', url: 'pmtiles:///tiles/riyadh.pmtiles',
      attribution: '<a href="https://www.openstreetmap.org/copyright">© OpenStreetMap</a>' } },
    layers: layers('protomaps', namedFlavor(q.get('flavor') || 'light'), { lang: q.get('lang') || 'ar' })
  }
});
// every tile the map asked for, as z/x/y, and every error it reported
window.tiles = new Set();
window.errors = [];
map.on('sourcedata', (e) => { if (e.coord) { const c = e.coord.canonical; tiles.add(`${c.z}/${c.x}/${c.y}`); } });
map.on('error', (e) => errors.push(String(e.error && e.error.message)));
// what the screen cost: tiles, HTTP requests and bytes on the wire
window.stats = () => {
  const r = performance.getEntriesByType('resource');
  const pick = (re) => r.filter(e => re.test(e.name));
  const kb = (a) => Math.round(a.reduce((s, e) => s + e.transferSize, 0) / 1024);
  return { size: `${innerWidth}x${innerHeight}`, zoom: map.getZoom(), tiles: tiles.size,
    pmtilesRequests: pick(/\.pmtiles/).length, pmtilesKB: kb(pick(/\.pmtiles/)),
    glyphRequests: pick(/\.pbf/).length, glyphKB: kb(pick(/\.pbf/)), errors: errors.length };
};
</script>
</body>
</html>

نفتح الصفحة بالمستويين 12 و14 بثلاثة أحجام للنافذة، في نافذة جديدة كل مرة حتى لا تأتي الملفات من الذاكرة، ثم نكتب في Console الأمر JSON.stringify(stats())، والمخرج سوف يكون كما يلي:

{"size":"390x844","zoom":12,"tiles":3,"pmtilesRequests":4,"pmtilesKB":245,"glyphRequests":6,"glyphKB":473,"errors":0}
{"size":"390x844","zoom":14,"tiles":6,"pmtilesRequests":7,"pmtilesKB":175,"glyphRequests":7,"glyphKB":475,"errors":0}
{"size":"1440x900","zoom":12,"tiles":9,"pmtilesRequests":10,"pmtilesKB":563,"glyphRequests":6,"glyphKB":473,"errors":0}
{"size":"1440x900","zoom":14,"tiles":12,"pmtilesRequests":13,"pmtilesKB":277,"glyphRequests":7,"glyphKB":475,"errors":0}
{"size":"1920x1080","zoom":12,"tiles":15,"pmtilesRequests":16,"pmtilesKB":722,"glyphRequests":6,"glyphKB":473,"errors":0}
{"size":"1920x1080","zoom":14,"tiles":12,"pmtilesRequests":13,"pmtilesKB":277,"glyphRequests":7,"glyphKB":475,"errors":0}

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

  • عدد المربعات في المتصفح يطابق عمود vector_512px في Python تماماً: 3 و6 للهاتف، و9 و12 للحاسوب، و15 و12 لشاشة Full HD. فالمكتبة لا تفعل شيئاً سحرياً، وإنما تطبق نفس المعادلة على أركان الشاشة.
  • طلبات الملف دائماً أكثر من عدد المربعات بطلب واحد، وهو طلب الترويسة والدليل في أول ملف PMTiles، ثم طلب لكل مربع.
  • نفس المنظر بمربعات نقطية بعرض 256 بكسل يحتاج من 1.3 إلى 3.3 أضعاف عدد المربعات، وفي أغلب الحالات قرابة 2.5: 24 مقابل 9 للحاسوب في المستوى 12، لأن كل مربع متجه بعرض 512 يغطي مساحة أربعة مربعات نقطية.
  • شاشة Full HD في المستوى 14 حملت 12 مربعاً فقط مثل الحاسوب، لأن العدد يعتمد على مكان حواف الشاشة بالنسبة لحدود المربعات، لا على مساحة الشاشة وحدها، فقد تزيد الشاشة 480 بكسل في العرض دون أن تلمس عموداً جديداً.
  • الخطوط كلفت 473 كيلوبايت في كل حالة تقريباً، وهي في الهاتف أكبر من المربعات نفسها، وهذا ما ذكرناه في الأسماء العربية على الخريطة: نطاق الحروف العربية 1536-1791 وحده 108 كيلوبايت.

وقد لاحظنا أثناء التصوير شيئاً يؤكد قاعدة «كل مربع يلمس الشاشة»: عندما وضعنا مركز نافذة بعرض 512 بكسل في منتصف المربع 12/2579/1758 تماماً، أي أن النافذة تساوي المربع نفسه، طلبت الخريطة 4 مربعات لا مربعاً واحداً، لأن حواف النافذة وقعت على حدود المربعات المجاورة بالضبط فاعتبرتها المكتبة ملامسة.

نجرب الخطوط: ماذا لو لم يجد المتصفح ملفات الخطوط؟

صفحة view.html تقبل في الرابط مساراً آخر للخطوط، فنعطيها مساراً غير موجود، glyphs=/assets/nofonts/{fontstack}/{range}.pbf، ونتوقع أن تختفي الأسماء. والنتيجة أن الصفحة طلبت نفس ملفات الخطوط الستة من المسار الخطأ وحصلت على 404 لكل منها بحجم كيلوبايت واحد، ومع ذلك كانت قيمة errors صفراً، وظهرت الخريطة بكل أسمائها العربية. والسبب هو التغيير الذي ذكرناه في MapLibre 5.11.0: إذا لم تجد المكتبة ملف الخط فإنها ترسم الحروف محلياً بخط النظام. والصورة التالية تبين الفرق، وإذا نظرت جيداً ستجد أن شكل الحروف تغير قليلاً، فالأسماء صارت بخط الجهاز بدل خط Noto الذي اختاره التنسيق:

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

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

وفي نفس الصفحة سألنا المتصفح عن التنسيق نفسه، بالأمر map.getStyle().layers، وهذا جزء من المخرج:

{"layers":71,"byType":{"background":1,"fill":15,"line":41,"symbol":14},"firstIds":["background","earth","landcover","landuse_park"],"lastIds":["places_region","places_locality","places_country"]}

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

المسافة: Haversine مقابل الحساب المسطح

آخر جزء في التجربة يعود إلى الإحداثيات، وهو السؤال الذي يقع فيه كثير من المطورين: كم المسافة بين الرياض وجدة؟ نحسبها بأربع طرق: على نموذج WGS84 بمكتبة GeographicLib وهي المرجع، وبمعادلة Haversine على كرة، وبالطريقة البسيطة أي فيثاغورس على الدرجات كأنها شبكة مسطحة، وبفيثاغورس على x وy في Web Mercator. والمدن الثلاث من نقاطها في OpenStreetMap. ملف geo.py:

# Distances, Mercator distortion and coordinate precision, compared with the WGS84 ellipsoid (geographiclib)
import math
from geographiclib.geodesic import Geodesic

R = 6371008.8  # mean Earth radius in metres
cities = {"Riyadh": (24.6389160, 46.7160104), "Jeddah": (21.5504432, 39.1742363), "Dammam": (26.4367824, 50.1039991)}

def haversine(a, b):
    p1, p2 = math.radians(a[0]), math.radians(b[0])
    dp, dl = p2 - p1, math.radians(b[1] - a[1])
    h = math.sin(dp / 2) ** 2 + math.cos(p1) * math.cos(p2) * math.sin(dl / 2) ** 2
    return 2 * R * math.asin(math.sqrt(h))

def degrees_pythagoras(a, b):          # the simple way: treat degrees as a flat grid
    return math.hypot(b[0] - a[0], b[1] - a[1]) * 111_195

def mercator_xy(lat, lon):             # EPSG:3857 metres
    return math.radians(lon) * 6378137, math.log(math.tan(math.pi / 4 + math.radians(lat) / 2)) * 6378137

def mercator_planar(a, b):             # straight line on the Web Mercator plane
    (x1, y1), (x2, y2) = mercator_xy(*a), mercator_xy(*b)
    return math.hypot(x2 - x1, y2 - y1)

print("route            ellipsoid_km  haversine_km  err    flat_degrees_km  err    mercator_plane_km  err")
for x, y in (("Riyadh", "Jeddah"), ("Riyadh", "Dammam")):
    a, b = cities[x], cities[y]
    g = Geodesic.WGS84.Inverse(*a, *b)["s12"] / 1000
    h, f, m = haversine(a, b) / 1000, degrees_pythagoras(a, b) / 1000, mercator_planar(a, b) / 1000
    pct = lambda v: f"{(v - g) / g * 100:+.2f}%"
    print(f"{x}->{y:<9} {g:>10.1f}  {h:>12.1f}  {pct(h):>6}  {f:>12.1f}  {pct(f):>8}  {m:>14.1f}  {pct(m):>8}")

print("\nWeb Mercator scale at latitude (length factor, area factor)")
for name, lat in (("Equator", 0), ("Riyadh", 24.64), ("Greenland centre", 72), ("Max latitude", 85.0511)):
    k = 1 / math.cos(math.radians(lat))
    print(f"{name:<17} lat {lat:>7.2f}  x{k:6.2f}  area x{k*k:7.2f}")

print("\nMetres per pixel (256 px tiles) at Riyadh's latitude")
for z in (0, 5, 10, 12, 15, 18):
    print(f"z{z:<3} {40075016.686 * math.cos(math.radians(24.64)) / (256 * 2**z):>12,.2f} m")

print("\nCoordinate precision: size of the last decimal place")
for d in range(1, 8):
    step = 10 ** -d
    lat_m = Geodesic.WGS84.Inverse(24.64, 46.71, 24.64 + step, 46.71)["s12"]
    lon_m = Geodesic.WGS84.Inverse(24.64, 46.71, 24.64, 46.71 + step)["s12"]
    print(f"{d} decimals  {step:<10g} north-south {lat_m:>12,.3f} m   east-west at Riyadh {lon_m:>12,.3f} m")
docker run --rm --name lab-mapsb-py -v "$PWD:/lab" -w /lab python:3.13.16-slim sh -c 'pip install -q --root-user-action=ignore geographiclib==2.0 2>/dev/null; python geo.py'

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

route            ellipsoid_km  haversine_km  err    flat_degrees_km  err    mercator_plane_km  err
Riyadh->Jeddah         844.8         844.2  -0.07%         906.2    +7.27%           919.0    +8.79%
Riyadh->Dammam         394.5         394.3  -0.03%         426.5    +8.12%           437.5   +10.92%

Web Mercator scale at latitude (length factor, area factor)
Equator           lat    0.00  x  1.00  area x   1.00
Riyadh            lat   24.64  x  1.10  area x   1.21
Greenland centre  lat   72.00  x  3.24  area x  10.47
Max latitude      lat   85.05  x 11.59  area x 134.37

Metres per pixel (256 px tiles) at Riyadh's latitude
z0     142,289.05 m
z5       4,446.53 m
z10        138.95 m
z12         34.74 m
z15          4.34 m
z18          0.54 m

Coordinate precision: size of the last decimal place
1 decimals  0.1        north-south   11,076.829 m   east-west at Riyadh   10,124.224 m
2 decimals  0.01       north-south    1,107.676 m   east-west at Riyadh    1,012.422 m
3 decimals  0.001      north-south      110.768 m   east-west at Riyadh      101.242 m
4 decimals  0.0001     north-south       11.077 m   east-west at Riyadh       10.124 m
5 decimals  1e-05      north-south        1.108 m   east-west at Riyadh        1.012 m
6 decimals  1e-06      north-south        0.111 m   east-west at Riyadh        0.101 m
7 decimals  1e-07      north-south        0.011 m   east-west at Riyadh        0.010 m
أربعة أعمدة أفقية للمسافة من الرياض إلى جدة: على نموذج WGS84 بمكتبة GeographicLib 844.8 كيلومتر وهي المرجع، وHaversine على كرة 844.2 بفرق 0.07%، وفيثاغورس على الدرجات 906.2 بزيادة 7.27%، وخط مستقيم على Web Mercator 919.0 بزيادة 8.79%، وخط منقط عند المرجع
Haversine يكفي أغلب التطبيقات، والحساب المسطح يخطئ بعشرات الكيلومترات

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

  • Haversine أخطأ بأقل من 0.1%، أي قرابة 600 متر في 845 كيلومتراً، لأنه يفترض كرة تامة بنصف قطر متوسط، وهذا يكفي لترتيب المطاعم الأقرب أو تقدير المسافة لعميل. أما إذا كنت تحسب مسافات للفوترة أو للمساحة الرسمية فاستخدم الحساب على النموذج الجيوديسي، أو ST_Distance على نوع geography في PostGIS.
  • الطريقة البسيطة على الدرجات أخطأت بأكثر من 7%، أي 61 كيلومتراً، والسبب أنها تعامل درجة الطول كأنها 111 كيلومتراً مثل درجة العرض، وفي الرياض هي قرابة 101 كيلومتر فقط.
  • الخط المستقيم على Web Mercator أسوأ، لأن الإسقاط يكبر كل شيء بمعامل 1.10 في هذه المنطقة كما في الجزء الثاني من المخرج، ويزيد الخطأ كلما اتجهت شمالاً، فلا تحسب مسافة من إحداثيات EPSG:3857 أبداً.
  • المسافة هنا خط مستقيم على سطح الأرض، وليست مسافة الطريق بالسيارة، وهذه نحسبها بمحركات المسارات Routing في مقال حساب أقصر طريق مع OSRM وValhalla.

وآخر خطوة: نفس نقطة الرياض كخلايا GeoHash وH3. ملف cells.py:

# The same Riyadh point as a GeoHash text and as H3 hexagon cells
import math, geohash2, h3
lat, lon = 24.6389160, 46.7160104
for n in (4, 6, 8):
    g = geohash2.encode(lat, lon, precision=n)
    _, _, dlat, dlon = geohash2.decode_exactly(g)          # half the cell size, in degrees
    h = 2 * dlat * 111_320
    w = 2 * dlon * 111_320 * math.cos(math.radians(lat))
    print(f"geohash {n} chars: {g:<9} cell about {w:,.0f} x {h:,.0f} m")
for r in (5, 7, 9):
    c = h3.latlng_to_cell(lat, lon, r)
    print(f"h3 res {r}: {c}  area {h3.cell_area(c, unit='km^2'):.4f} km2  neighbours {len(h3.grid_disk(c, 1)) - 1}")
docker run --rm --name lab-mapsb-py -v "$PWD:/lab" -w /lab python:3.13.16-slim sh -c 'pip install -q --root-user-action=ignore h3==4.3.1 geohash2==1.1 2>/dev/null; python cells.py'
geohash 4 chars: th3h      cell about 35,573 x 19,568 m
geohash 6 chars: th3hpj    cell about 1,112 x 611 m
geohash 8 chars: th3hpj3s  cell about 35 x 19 m
h3 res 5: 855355d3fffffff  area 245.8690 km2  neighbours 6
h3 res 7: 875355d06ffffff  area 5.0199 km2  neighbours 6
h3 res 9: 895355d0637ffff  area 0.1024 km2  neighbours 6

لاحظ أن كل GeoHash أطول يبدأ بالأقصر منه، th3h ثم th3hpj ثم th3hpj3s، فالبحث عن كل النقاط في الخلية th3hpj هو بحث عن النصوص التي تبدأ بهذه الأحرف. وفي H3 مساحة الخلية في المستوى 7 قرابة 5 كيلومترات مربعة، ولها ستة جيران، ومعرفها رقم بصيغة ست عشرية Hexadecimal يخزن في عمود عادي.

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

كل Container من Python وgo-pmtiles كان بالخيار --rm، فيبقى سيرفر الصفحة، فنحذفه مع شبكته من داخل مجلد المختبر:

docker compose down

ثم ال Images والملفات إذا لم تعد تحتاجها:

docker image rm protomaps/go-pmtiles:v1.31.2 python:3.13.16-slim
rm -rf web tile-12-2579-1758.mvt

وللجزء الذي أضفناه في نوفمبر، نحذف صورة Python التي بنيناها وصورة nginx والمربعين النقطيين:

docker image rm mapsb-py nginx:1.29.8-alpine
rm -rf web osm-12-2579-1758.png osm-12-2579-2337.png

أخطاء شائعة

  • عكس ترتيب الإحداثيات: GeoJSON وMapLibre وPostGIS تكتب الطول أولاً، وأغلب الناس والتطبيقات تكتب العرض أولاً، فإذا ظهرت النقطة في مكان غريب فابدأ من هنا.
  • الخلط بين XYZ وTMS: رأينا في التجربة أن الرياض تصبح جنوب مدغشقر دون أي رسالة خطأ، فإذا ظهرت لك منطقة لا علاقة لها بما تتوقعه فتحقق من اتجاه y.
  • حساب المسافة أو المساحة على Web Mercator أو على الدرجات مباشرة: رأينا خطأ 7% إلى 11% بين مدن المملكة، ويزيد كلما اتجهت شمالاً، فاستخدم Haversine أو الحساب الجيوديسي.
  • استخدام سيرفر مربعات OpenStreetMap العام في تطبيق إنتاجي: السيرفر للتبرعات وسياسته تمنع التحميل الجماعي وتحظر الترويسات الافتراضية، ويمكن أن يحظر تطبيقك دون إنذار، فاستضف المربعات بنفسك أو استخدم مزوداً تجارياً.
  • إخفاء النسبة Attribution: رخصة OpenStreetMap تطلب ظهور النسبة على الخريطة، والتنسيق في التجربة يضعها في الزاوية تلقائياً، فلا تخفها خلف قائمة أو زر.
  • المربعات النقطية لتطبيق متعدد اللغات: كل لغة تحتاج نسخة كاملة من الصور، وكل تنسيق ألوان كذلك، أما المربعات المتجهة فتعرض اللغات كلها من نفس البيانات.
  • مسار الخطوط الخاطئ: رأينا أن MapLibre تخفي الخطأ وترسم بخط الجهاز، فراقب طلبات الخطوط بعد أي نقل للملفات.
  • قص منطقة بمستوى أعلى من الحاجة: كل مستوى إضافي يضاعف حجم الملف تقريباً كما رأينا من 9.1 إلى 17 ميجابايت، فاختر أقصى مستوى بحسب ما يحتاجه المستخدم فعلاً، فالمكتبة تكبر المستوى الأخير Overzoom بحدة عند الحاجة.
  • تخزين الإحداثيات بدقة مفردة float: تضيع الأمتار الأخيرة، فاستخدم double أو نوعاً جغرافياً.
  • تخزين أو عرض أرقام أكثر مما تحتاج: عشرة أرقام بعد الفاصلة لا تعني دقة، وعرض ستة أرقام لموقع منزل عميل في تقرير يكشفه بالمتر.
  • الخلط بين EPSG:4326 وEPSG:3857: الأول درجات والثاني أمتار على المسقط، فإذا ظهرت إحداثيات مثل 5200000, 2840000 فهي على الأغلب EPSG:3857، ولا تضعها في حقل خط العرض والطول.
  • توقع اسم عربي لكل مكان: الخريطة تعرض name:ar إذا وجد، وإلا الاسم الأصلي، فالحل في بيانات OpenStreetMap وليس في الكود.

قائمة تحقق قبل أول خريطة في مشروعك

السؤالالإجابة الشائعةأين تقرأ أكثر
هل تحتاج عرضاً فقط أم تحليلاً؟العرض مكتبة رسم ومربعات، والتحليل أدوات GIS وقاعدة بيانات مكانيةالمرحلتان الثالثة والرابعة
نقطية أم متجهة؟متجهة للخريطة الأساسية والأسماء، ونقطية للصور الجوية والارتفاعاتقسم النقطية والمتجهة أعلاه
من أين البيانات وبأي رخصة؟OpenStreetMap برخصة ODbL مع النسبة، أو مزود تجاري بعقدمقال OpenStreetMap ومقال البيانات المفتوحة في السعودية
من أين المربعات؟ملف PMTiles على سيرفرك أو تخزين S3، أو مزود بحساب واستهلاكمقال خرائطك على سيرفرك
ما أقصى مستوى تحتاجه؟14 أو 15 يكفي أغلب التطبيقات، والمكتبة تكبر بعدهتجربة ما يحمله المربع في كل مستوى
هل الأسماء العربية سليمة؟MapLibre 6.9.0 فما بعده، وخطوط تحتوي النطاق العربي، وname:ar في البياناتقسم الأسماء العربية
بأي ترتيب وأي مرجع تحفظ الإحداثيات؟WGS84 بالطول أولاً في GeoJSON، وdouble أو geography في قاعدة البياناتمقال المرجع الجيوديسي
هل تحتاج العمل دون إنترنت؟قص منطقة PMTiles وتخزينها في التطبيققسم كيف يحمل التطبيق المربعات

تدريب عملي

  • احسب عنوان المربع لمدينتك في المستويات 5 و10 و15 بالملف tiles.py، ثم تأكد من النتيجة بالصفحة tiles.html بعد أن تقص مستطيل مدينتك.
  • غير النقطة في zooms.py إلى قرية صغيرة أو منطقة صحراوية، وقارن أحجام المربعات بما رأيناه في وسط الرياض، ثم فسر الفرق بالتعميم.
  • أضف إلى geo.py مسافة بين مدينتين في شمال أوروبا، مثل أوسلو وستوكهولم، وقارن خطأ الحساب على Web Mercator بما رأيناه في المملكة.

الخلاصة

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

  • الخريطة الرقمية ثلاثة أشياء منفصلة: بيانات وتنسيق ورسم، ولهذا تعرض نفس البيانات بأي لغة وأي ألوان.
  • البيانات النقطية شبكة بكسلات تصلح للصور والارتفاعات، والمتجهة أشكال وخصائص تصلح للطرق والمباني والأسماء، والخرائط الحديثة تجمع النوعين.
  • خط العرض وخط الطول زاويتان على نموذج WGS84، أي EPSG:4326، وأغلب المكتبات تكتب الطول أولاً، والتفصيل في مقال المرجع الجيوديسي.
  • Web Mercator، أي EPSG:3857، يجعل العالم مربعاً سهل التقسيم ويحفظ الأشكال المحلية، ويكبر المساحات بمعامل 1/cos²(lat)، أي 1.21 في الرياض و10.47 عند جرينلاند.
  • في المستوى z يقسم العالم إلى 2^z × 2^z مربعاً، والرياض في المربع 12/2579/1758، والترقيم TMS المقلوب يرسلها إلى جنوب مدغشقر دون رسالة خطأ.
  • التعميم يبقي كل مربع صغيراً: من 12 إلى 124 كيلوبايت في كل المستويات من 0 إلى 15 في تجربتنا، والمباني لا تظهر قبل المستوى 11.
  • الشاشة تحمل ما يلمسها من مربعات فقط: 3 للهاتف و9 للحاسوب في المستوى 12، والحساب في Python طابق المتصفح تماماً، والخطوط العربية في أول فتح كلفت قرابة نصف ما كلفته المربعات.
  • الاسم العربي يمر بالبيانات name:ar ثم التنسيق ثم ملفات الخطوط، وكل مرحلة يمكن أن تفشل وحدها.
  • Haversine أخطأ بأقل من 0.1% بين الرياض وجدة، والحساب المسطح بأكثر من 7%، وعلى Web Mercator بقرابة 9%.

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

دليلالمرجع الجيوديسي Datum: لماذا تنحرف نقطتك مئات الأمتار؟لماذا تقع نفس الإحداثيات في مكانين بينهما مئة متر، وكيف تحول بين Ain el Abd وKSA-GRF17 وWGS 84 ومناطق UTM دون أن تنقل بياناتك إلى المكان الخطأ.دليلما هي OpenStreetMap؟ البيانات والرخصة والمساهمةكيف تبنى أكبر قاعدة بيانات جغرافية مفتوحة من نقاط وطرق ووسوم، وما الذي تلزمك به رخصتها، وكيف تفحص جودتها في مدينتك قبل أن تبني عليها.دليلخرائطك على سيرفرك مع OpenStreetMap وMapLibreكيف تعرض خريطة تفاعلية لمدينتك من سيرفرك ببيانات OpenStreetMap، بالعربية والإنجليزية ودون مفتاح API أو مزود خارجي.دليلالبحث عن العناوين Geocoding مع Nominatimكيف تحول اسم المكان إلى إحداثيات والإحداثيات إلى عنوان على سيرفرك مع Nominatim، وما الذي يجيده بالعربية وما الذي يفوته.دليلحساب أقصر طريق وزمن الوصول مع OSRM وValhallaكيف يحسب محرك المسارات أقصر طريق وزمن الوصول على شوارع مدينتك، وكيف تشغله على سيرفرك وتقيس سرعته بنفسك.دليلكيف تبني تطبيق خرائط وملاحة مثل هدهد وGoogle Maps؟ما الذي يقف خلف كل ميزة في تطبيقات الخرائط، وكيف تبني نسخة أولى منها بأدوات مفتوحة المصدر وبيانات مرخصة بشكل صحيح.دليلQGIS للمبتدئين: الطبقات Layers والتحليل المكانيكيف تحول جدول مواقع إلى طبقة على الخريطة في QGIS، وتربطها بالمناطق وتحسب النطاقات بالأمتار الصحيحة، ثم تعيد التحليل كله بأمر واحد.دليلالبيانات الجغرافية GIS في PostgreSQL مع PostGISكيف تخزن الأحياء والطرق والفروع في PostgreSQL وتسألها بالمتر الصحيح وبفهرس يعمل فعلاً، بمختبر على بيانات OpenStreetMap لمدينة كاملة.دليلالأنظمة العددية للمبرمجين: من Binary إلى Floating Pointلماذا يظهر القرص 465 بدل 500، ويصبح العداد سالباً فجأة، ولا يساوي 0.1 + 0.2 القيمة 0.3؟ الإجابة في طريقة تخزين الأرقام.دليلPostgreSQL لكل شيء: متى يكفيك ومتى تحتاج غيره؟كم عملاً يستطيع PostgreSQL واحد أن يقوم به في شركتك الناشئة قبل أن تحتاج Redis أو Elasticsearch، وما الإشارة التي تقول لك إن الوقت قد حان.

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

  • أكتوبر 2026: كتابة المقال، وتنفيذ التجربة بلغة Python 3.13 مع geographiclib 2.0 وmapbox-vector-tile 2.2.0 وh3 4.3.1 وgeohash2 1.1، وgo-pmtiles 1.31.2 على بناء Protomaps بتاريخ 20261008، وMapLibre GL JS 6.13.0 وnginx 1.29.8، وDocker Engine 29.8.0 وDocker Compose v5.5.1 على Windows 11 مع Docker Desktop.
  • 16 نوفمبر 2026: إعادة كتابة المقال وتوسيعه ليكون أول مقال في مسار الخرائط: أقسام جديدة عن البيانات النقطية والمتجهة والمقياس والتعميم وكيف يحمل التطبيق المربعات والتنسيق والأسماء العربية ومصادر البيانات وخريطة المسار، واختصار الإحداثيات والإسقاط مع الإحالة لمقال المرجع الجيوديسي، وتجارب جديدة على بناء Protomaps بتاريخ 20261116 حتى المستوى 15 مع مكتبة pmtiles 3.8.1، ومربعين نقطيين من سيرفر OpenStreetMap، وعد المربعات لثلاثة أحجام شاشة، والأسماء بالعربية والإنجليزية، وسلوك MapLibre عند فقد ملفات الخطوط.
نشرة عرب رووت | ArabRoot

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

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

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

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