عندما تفتح تطبيق خرائط على هاتفك وتكتب اسم مدينة، تظهر لك في أقل من ثانية، ثم تقرب بإصبعين فتظهر الأحياء ثم الشوارع ثم أسماء المحلات، وتسحب الشاشة يميناً فتمتلئ الأطراف قبل أن تلاحظ أنها كانت فارغة، وكأن الخريطة صورة واحدة ضخمة للعالم كله محفوظة في جهازك. وهي ليست كذلك، فصورة واحدة للعالم بدقة تظهر فيها الشوارع ستكون بحجم آلاف الجيجابايتات، ولن يحملها هاتف ولا متصفح. وقد يتساءل البعض: إذا لم تكن صورة، فما هي إذن؟ ومن أين تأتي الأسماء العربية التي تراها؟ ولماذا تبدو الخريطة نفسها بالعربية عند شخص وبالإنجليزية عند آخر؟ وإذا كانت الأرض كرة، فكيف تعرض على شاشة مسطحة؟
هذا المقال هو أول مقال في مسار الخرائط ونظم المعلومات الجغرافية، وهو المدخل الذي يشرح الأفكار التي تتكرر في كل ما بعده، ثم يأخذك في جولة على المسار كله حتى تعرف ماذا تقرأ بعده ولماذا. وسوف نناقش في هذا المقال ما يلي:
- ما هي الخريطة الرقمية، ولماذا نفصل فيها البيانات عن التنسيق عن الرسم.
- نوعا البيانات: النقطية 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 | المتجهة 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]](https://arabroot.io/content/images/2026/11/maps-basics-01-latlon.webp)
الإسقاط 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 للمساحة، وسوف نحسب هذه الأرقام في التجربة.

والقاعدة العملية التي تخرج بها: 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:

وهناك ثلاث تفاصيل في هذا الترقيم تسبب أغلب مشاكل المبتدئين، فخذها من الآن:
- قالب الرابط 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 ترسمه صحيحاً دون إضافة، وأن الاسم الناقص بالعربية يصلح في البيانات لا في الكود، وسوف نعود لهذا بتفصيل أكثر في الأسماء العربية على الخريطة.

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

- الشاشة تتحرك: المكتبة تعرف ثلاثة أشياء فقط: مركز الخريطة، ومستوى التقريب، وحجم الشاشة بالبكسل.
- أي المربعات تغطي الشاشة؟ هذا حساب اسمه Tile Cover، وهو نفس معادلة المربعات التي رأيناها مطبقة على أركان الشاشة: كل مربع يلمس الشاشة ولو ببكسل واحد يجب أن يحمل. وسوف نحسب العدد بلغة Python ثم نقارنه بما طلبه المتصفح فعلاً.
- هل المربع عندي؟ قبل أي طلب تبحث المكتبة في ذاكرتها، ثم في ذاكرة المتصفح المؤقتة Cache، ثم يمر الطلب غالباً على شبكة توزيع المحتوى Content Delivery Network واختصاراً CDN قبل أن يصل إلى السيرفر. ولهذا السبب تفتح الخريطة في المرة الثانية أسرع بكثير، ولهذا السبب ترسل سيرفرات المربعات ترويسات Cache طويلة، كما سوف نرى في ترويسات مربع حقيقي من OpenStreetMap.
- الطلب عبر HTTP: طلب مستقل لكل مربع برابط
/{z}/{x}/{y}، أو إذا كانت المربعات في ملف PMTiles واحد، فطلب نطاق HTTP Range يجلب البايتات التي فيها المربع فقط من داخل الملف، وهذا ما شرحناه في PMTiles: ملف واحد بدل سيرفر خرائط. - فك الضغط والتحليل Decode: المربع المتجه مضغوط بصيغة gzip ومكتوب بصيغة Protocol Buffers، والمكتبة تفكه في Web Worker، أي خيط معالجة منفصل عن الصفحة، حتى لا تتجمد الشاشة أثناء التحريك.
- تطبيق التنسيق: لكل طبقة في ملف التنسيق تختار المكتبة العناصر التي تناسبها وتحسب ألوانها وعرضها، وتطلب ملفات الخطوط Glyphs للحروف التي ستكتبها، والرموز Sprites مثل أيقونة المستشفى.
- وضع النصوص Label Placement: أصعب خطوة حسابياً، فالمكتبة تحاول أن تضع كل اسم في مكانه، وإذا تداخل اسمان أخفت الأقل أهمية، وهذا اسمه كشف التصادم Collision Detection. ولهذا السبب تظهر أسماء جديدة وتختفي أخرى أثناء التقريب.
- الرسم: كرت الشاشة يرسم الطبقات بالترتيب عبر 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 على الخريطة
الاسم الذي تراه على الخريطة يمر بثلاث مراحل، وكل مرحلة يمكن أن تفشل وحدها، لذلك من المفيد أن تعرفها حتى تعرف أين تبحث عندما يظهر اسم بالإنجليزية أو بحروف منفصلة:
- الاسم في البيانات: في OpenStreetMap يحمل كل مكان الوسم
nameبلغة أهل المكان، ثم وسوماً لكل لغة مثلname:arوname:en، كما في صفحة الأسماء متعددة اللغات. وفي التجربة سوف نرى أن المربع الذي فيه وسط الرياض في المستوى 12 فيه 118 عنصراً لها اسم عربي. - اختيار الاسم في التنسيق: طبقة أسماء المدن في التنسيق الذي استخدمناه تختار
name:arإن وجد، وإلا فالاسم الأصليname، بالتعبيرcoalesce. وإذا اخترت الإنجليزية فالتنسيق نفسه يكتب الاسم الإنجليزي وتحته الاسم المحلي، كما سوف ترى في صورة التجربة، فتظهر «Riyadh» وتحتها «الرياض». - رسم الحروف: الحرف العربي له أشكال حسب موقعه في الكلمة، والكلمة تكتب من اليمين، والسطر قد يجمع عربياً وأرقاماً وإنجليزياً. والمكتبة ترسم الحروف من ملفات خطوط مقسمة إلى نطاقات كل منها 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 كيلومتر. ومن هنا تعرف ماذا يعني كل رقم بعد الفاصلة:
| الأرقام بعد الفاصلة | شمال جنوب | شرق غرب في الرياض | يكفي لتحديد |
|---|---|---|---|
| 1 | 11 كم | 10 كم | مدينة |
| 2 | 1.1 كم | 1 كم | حي |
| 3 | 111 م | 101 م | شارع أو مجمع |
| 4 | 11 م | 10 م | مبنى |
| 5 | 1.1 م | 1 م | باب أو سيارة |
| 6 | 11 سم | 10 سم | أدق من GPS الهاتف غالباً |
| 7 | 1.1 سم | 1 سم | لا معنى له في أغلب التطبيقات |
والقاعدة العملية: ستة أرقام بعد الفاصلة تكفي أي تطبيق تقريباً، وخمسة تكفي توصيل الطلبات، وكل رقم بعدها يخزن ضجيجاً لا دقة، لأن GPS الهاتف نفسه يخطئ عادة بعدة أمتار. والعكس مهم في الخصوصية: إذا عرضت مواقع العملاء أو المندوبين في تقرير، فقرب الأرقام إلى رقمين أو ثلاثة حتى لا تكشف المنزل بعينه. ولا تخزن الإحداثيات كنوع float بدقة مفردة، لأن دقته قرابة 7 أرقام معنوية فقط، فخط طول مثل 46.7160104 يخزن بخطوات قرابة 0.0000038 درجة، أي قرابة 40 سنتيمتراً، فما بعد الرقم الخامس بعد الفاصلة لا يحفظ بدقة، وقد شرحنا السبب في الأنظمة العددية للمبرمجين، واستخدم double أو نوعاً جغرافياً مثل geography في PostGIS.

GeoHash وH3: الإحداثيات كخلايا
أحياناً لا تحتاج النقطة نفسها، وإنما الخلية التي هي فيها: كم طلباً في كل منطقة؟ أي السائقين قريب من هذا العميل؟ وهنا تأتي أنظمة تقسم الأرض إلى خلايا لها أسماء، وهي فكرة قريبة من المربعات التي رأيناها، ولكن هدفها التجميع والبحث لا الرسم:
- GeoHash: يحول النقطة إلى نص قصير، كل حرف إضافي فيه يقسم الخلية إلى خلايا أصغر، فالنقاط التي تشترك في بداية النص قريبة من بعضها، وهذا يجعل البحث عن القريب بحثاً عن بادئة نص في فهرس عادي، كما في الدالة ST_GeoHash في PostGIS. وخلاياه مستطيلات تختلف أبعادها بحسب خط العرض.
- H3: نظام من Uber برخصة Apache 2 يقسم الأرض إلى خلايا سداسية Hexagons، في 16 مستوى من 0 إلى 15، وفي كل مستوى 12 خلية خماسية فقط لا يمكن تجنبها. وميزة السداسي أن كل خلية لها ستة جيران على نفس المسافة تقريباً، فيصلح لتحليل الطلب وتسعير الرحلات والخرائط الحرارية.

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

المرحلة الأولى: أساسيات الخرائط والموقع
أنت الآن في أولها. بعد هذا المقال تأتي الأسئلة التي تقابلها في أي مشروع قبل أن تختار أداة: كيف يعرف هاتفك مكانك من أقمار 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، والملف الذي قصصناه فيه مربع واحد فقط في هذا المستوى، فظهر وحده وحوله رمادي:

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


ولاحظ في الصور أن المربعات على الشاشة أكبر من 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 أكثر من مئة عنصر، وهذا كل ما تحتاجه الخريطة لتعرض الأسماء بالعربية.
والصورة التالية تجمع الحجم في كل مستوى:

نفس المربع صورةً: مربع نقطي من 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 تعرض الاسم الأصلي 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 بايت، ولا يوجد أي خطأ تكتشفه من الكود، ولكن الصورة من جنوب مدغشقر، أي نفس خط الطول ونفس خط العرض تقريباً جنوب خط الاستواء بدل شماله:

والدرس من هذه التجربة أن أخطاء الخرائط في الغالب صامتة، فالرابط يعمل والصورة تظهر، والخطأ لا يكتشفه إلا من ينظر. لذلك إذا ظهرت لك خريطة غابات بدل مدينة، أو بحر بدل يابسة، فتحقق من ترقيم 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 الذي اختاره التنسيق:

وهذه نتيجة جيدة للمستخدم وسيئة لمن يراقب، لأن خطأ إعداد مثل مسار خاطئ بعد نقل الملفات لن يظهر لك في الصفحة ولا في الأخطاء، وسوف يرى كل مستخدم الخريطة بخط جهازه، وقد لا يكون في بعض الأجهزة خط عربي جيد. لذلك افحص طلبات الخطوط في تبويب 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
في المخرج أعلاه لاحظ التالي:
- 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 عند فقد ملفات الخطوط.