> ## Content Index
> Fetch the complete content index at: https://arabroot.io/llms.txt
> Use this file to discover other available public pages before exploring further.

# نشر الخرائط مع GeoServer والمربعات المتجهة Vector Tiles
- URL: https://arabroot.io/articles/نشر-الخرائط-مع-geoserver-والمربعات-المتجهة/
- Published: 2026-11-16T18:08:18.000Z
- Updated: 2026-11-16T19:33:06.000Z
- Description: كيف تنشر طبقات PostGIS كخرائط بمعايير WMS وWFS مع GeoServer، وكمربعات متجهة صغيرة مع Martin، وكم يزن كل مربع وكيف تخزنه مؤقتاً.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, الخرائط ونظم المعلومات الجغرافية, تطبيقات لفريقك, السيادة الرقمية والامتثال, الاستضافة الذاتية

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

والحل الذي تستخدمه الخرائط منذ عقدين هو ألا ترسل البيانات كلها، وإنما ترسل ما يظهر على الشاشة فقط وبالتفصيل المناسب لمستوى التقريب، إما كصورة يرسمها السيرفر، أو كمربعات Tiles صغيرة جاهزة، أو كمربعات متجهة Vector Tiles يرسمها المتصفح. وفي هذا المقال نشغل الأداتين الأشهر لذلك على قاعدة PostGIS نفسها التي بنيناها في مقال PostGIS من هذه المرحلة: [GeoServer](https://geoserver.org/?ref=arabroot.io) سيرفر الخرائط الكامل بمعايير OGC، و[Martin](https://maplibre.org/martin/?ref=arabroot.io) سيرفر المربعات المتجهة الصغير، وسوف نناقش في هذا المقال ما يلي:

- الطرق الثلاث لنشر الخرائط: WMS وWFS والمربعات بنوعيها، ومتى تناسب كل واحدة.
- تشغيل GeoServer 3.0 ونشر طبقات PostGIS عبر REST API، وتنسيقها بملفات SLD مع أسماء عربية، والخطأ الصامت في الخط العربي.
- التخزين المؤقت GeoWebCache: الطلب الأول والثاني بالأرقام، والتجهيز المسبق Seeding، ولماذا تتكرر أسماء الأحياء على الخريطة.
- المربعات المتجهة MVT من GeoServer ومن Martin، وقياس حجم المربع في كل مستوى تقريب، والمربع الذي وصل إلى 2 ميغابايت وكيف أصلحناه.
- صفحة MapLibre تعرض كل ذلك من خلف nginx مع تخزين مؤقت وضغط.

## ثلاث طرق لنشر خريطة

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

![مخطط من ثلاثة أعمدة: الأول WMS، المتصفح يطلب صورة بمستطيل وحجم، والسيرفر يرسمها من PostGIS في كل طلب، صورة 800 في 800 حجمها 205 كيلوبايت في 0.6 إلى 1.8 ثانية. والثاني WFS، المتصفح يطلب المعالم نفسها GeoJSON، 109 صيدليات في 30 كيلوبايت، ولكن كل الطرق 40 ميغابايت في 7 ثوان. والثالث المربعات Tiles بعنوان z/x/y، نقطية PNG من GeoWebCache بحجم 19 إلى 43 كيلوبايت أو متجهة MVT من Martin بحجم 6 إلى 52 كيلوبايت مضغوطة، والطلب الثاني من الكاش في 10 مللي ثوان](https://arabroot.io/content/images/2026/11/geoserver-tiles-01-three-ways.webp)

الصورة يرسمها السيرفر، والبيانات يرسمها المتصفح، والمربعات تقسم العمل إلى قطع صغيرة قابلة للتخزين

- **خدمة الخريطة WMS Web Map Service:** معيار من [OGC](https://www.ogc.org/standards/wms/?ref=arabroot.io) يطلب فيه الكلاينت صورة لمستطيل محدد بحجم محدد وطبقات محددة، فيرسمها السيرفر من البيانات ويعيدها PNG أو JPEG. والميزة أن الكلاينت لا يحتاج أي شيء غير عرض صورة، فيعمل في أي برنامج GIS قديم أو حديث، والعيب أن كل حركة للخريطة طلب رسم جديد، وأن اللغة والألوان ثابتة في الصورة.
- **خدمة المعالم WFS Web Feature Service:** معيار يعيد المعالم نفسها بأشكالها وخصائصها، بصيغ مثل GML وGeoJSON، مع ترشيح بالمكان وبالخصائص. وهذا ما تحتاجه عندما يريد الطرف الآخر البيانات لا صورتها، مثل محلل يحمل الأحياء إلى QGIS، ولكنه غير مناسب لعرض طبقة كبيرة في المتصفح.
- **المربعات Tiles:** الخريطة مقسمة إلى مربعات بعنوان `z/x/y` كما شرحنا في [كيف تعمل الخرائط الرقمية](https://arabroot.io/articles/%D9%83%D9%8A%D9%81-%D8%AA%D8%B9%D9%85%D9%84-%D8%A7%D9%84%D8%AE%D8%B1%D8%A7%D8%A6%D8%B7-%D8%A7%D9%84%D8%B1%D9%82%D9%85%D9%8A%D8%A9/)، والمربع يحسب مرة ويخزن ويقدم آلاف المرات. ومعيار OGC لها هو WMTS، والصيغة الأبسط التي يستخدمها الويب هي XYZ أو TMS. والمربع قد يكون صورة نقطية Raster Tile، أو مربعاً متجهاً بصيغة [Mapbox Vector Tile](https://github.com/mapbox/vector-tile-spec?ref=arabroot.io) واختصاراً MVT، فيه الخطوط والنقاط وأسماؤها، ويرسمه المتصفح بملف تنسيق.

وقد شرحنا في [خرائطك على سيرفرك](https://arabroot.io/articles/%D8%AE%D8%B1%D8%A7%D8%A6%D8%B7%D9%83-%D8%B9%D9%84%D9%89-%D8%B3%D9%8A%D8%B1%D9%81%D8%B1%D9%83-%D9%85%D8%B9-openstreetmap-%D9%88-maplibre/) كيف تقدم خريطة أساسية Basemap كاملة من ملف PMTiles ثابت دون أي سيرفر خرائط، وهذا هو الحل الأنسب للخلفية التي لا تتغير إلا بتحديث شهري. أما هنا فنتحدث عن بياناتك أنت، التي تتغير في قاعدة البيانات كل يوم، وتريد أن يراها الناس بعد التغيير دون أن تعيد بناء ملف، وهذا هو دور سيرفر الخرائط.

## GeoServer: ما الذي يفعله من الداخل؟

GeoServer سيرفر خرائط مفتوح المصدر برخصة GPL-2.0، مكتوب بلغة Java فوق مكتبة GeoTools، ويعمل منذ 2001، وهو التطبيق المرجعي لأغلب معايير OGC. والسلسلة 3.0 التي اختبرنا عليها هي أول إصدار رئيسي جديد منذ سنوات، وقد [صدرت في يونيو 2026](https://geoserver.org/announcements/vulnerability/2026/06/11/geoserver-3-0-0-released.html?ref=arabroot.io) بعد انتقال المشروع إلى Spring Framework 7 وJakarta EE مع واجهة إدارة جديدة، وتحتاج Java 17 أو 21\. وداخله أربعة أجزاء يجب أن تعرفها قبل أن تشغله:

1. **الفهرس Catalog:** مساحات العمل Workspaces، ومخازن البيانات Stores مثل اتصال PostGIS أو مجلد ملفات، والطبقات Layers التي تشير كل منها إلى جدول أو ملف، والمجموعات Layer Groups. وكل ذلك يحفظ كملفات XML في مجلد البيانات `data_dir`، وهذا المجلد هو كل ما تحتاج نسخه احتياطياً.
2. **التنسيق Styles:** ملفات SLD، أي Styled Layer Descriptor، وهي معيار XML يقول كيف ترسم كل طبقة، مع قواعد بحسب الخصائص ومقياس الرسم.
3. **الخدمات Services:** WMS وWFS وWCS للبيانات الشبكية وWMTS، كلها تقرأ من الفهرس نفسه، فأي طبقة تنشرها تظهر في كل الخدمات تلقائياً.
4. **الكاش GeoWebCache:** مكتبة مدمجة تقسم الخريطة إلى مربعات وتحفظها على القرص، وتقدمها بمعايير WMTS وTMS، وسوف نقيسها بالتفصيل.

### التشغيل من ملف الإصدار الرسمي

المشروع ينشر Docker Image رسمية في سجله الخاص `docker.osgeo.org/geoserver`، ونعرض هنا طريقة أخرى تعطيك تحكماً كاملاً بالإصدار والإضافات: ملف الإصدار الرسمي `geoserver-3.0.2-bin.zip` من [صفحة الإصدارات](https://geoserver.org/release/stable/?ref=arabroot.io)، على Java 21 من Eclipse Temurin، مع إضافة المربعات المتجهة Vector Tiles من الإصدار نفسه. وهو الملف `lab/Dockerfile.geoserver`:

```dockerfile
FROM eclipse-temurin:21-jre-noble
ARG GS=3.0.2
RUN apt-get update && apt-get install -y --no-install-recommends unzip curl && rm -rf /var/lib/apt/lists/* \
 && curl -fsSL -o /tmp/gs.zip "https://sourceforge.net/projects/geoserver/files/GeoServer/${GS}/geoserver-${GS}-bin.zip/download" \
 && curl -fsSL -o /tmp/vt.zip "https://sourceforge.net/projects/geoserver/files/GeoServer/${GS}/extensions/geoserver-${GS}-vectortiles-plugin.zip/download" \
 && mkdir -p /opt/geoserver && unzip -q /tmp/gs.zip -d /opt/geoserver \
 && unzip -q -o /tmp/vt.zip -d /opt/geoserver/webapps/geoserver/WEB-INF/lib \
 && rm /tmp/*.zip
ENV GEOSERVER_HOME=/opt/geoserver GEOSERVER_DATA_DIR=/opt/geoserver/data_dir
EXPOSE 8080
WORKDIR /opt/geoserver
CMD ["sh", "bin/startup.sh"]
```

نشغله على الشبكة نفسها التي فيها قاعدة PostGIS، ونفتح منفذه على 127.0.0.1 فقط، ثم نسأل عن الإصدار عبر REST API بعد دقيقة تقريباً:

```bash
docker build -q -t lab-gs-geoserver -f Dockerfile.geoserver .
docker run -d --name lab-gs-geoserver --network lab-gs-net -p 127.0.0.1:9521:8080 lab-gs-geoserver
curl -s -u admin:geoserver http://127.0.0.1:9521/geoserver/rest/about/version.json
```

```text
{"about":{"resource":[{"@name":"GeoServer","Build-Timestamp":"16-Oct-2026 15:07","Version":"3.0.2",...},
 {"@name":"GeoTools","Build-Timestamp":"16-Oct-2026 01:58","Version":35.2,...},
 {"@name":"GeoWebCache","Version":"2.0.2",...}]}
```

لاحظ أن الأمر نجح بكلمة المرور الافتراضية `admin:geoserver`، وهذه أول مشكلة أمنية يجب أن تصلحها قبل أي شيء، فكل من يصل إلى المنفذ يستطيع عبر REST حذف الطبقات وتعديل الاتصال بقاعدة البيانات وقراءة كلمة مرورها. وتذكر أيضاً أن ملف الإصدار يأتي ببيانات تجريبية في مساحات عمل مثل `topp` و`tiger` و`nurc`، وهي ظاهرة في كل الخدمات حتى تحذفها، وقد كان ملف GetCapabilities لخدمة WMS عندنا 228 كيلوبايت أغلبها لهذه الطبقات.

### نشر جداول PostGIS عبر REST API

كل ما تفعله في واجهة GeoServer يمكن فعله بطلبات [REST API](https://docs.geoserver.org/latest/en/user/rest/index.html?ref=arabroot.io)، وهذا ما تحتاجه لتكرار الإعداد على أكثر من بيئة دون نقرات. نبدأ بمساحة عمل، ثم مخزن بيانات من نوع PostGIS بملف `lab/store.json`:

```json
{"dataStore": {"name": "riyadh", "connectionParameters": {"entry": [
  {"@key": "dbtype", "$": "postgis"}, {"@key": "host", "$": "lab-gs-pg"}, {"@key": "port", "$": "5432"},
  {"@key": "database", "$": "gis"}, {"@key": "schema", "$": "public"},
  {"@key": "user", "$": "postgres"}, {"@key": "passwd", "$": "lab"}, {"@key": "Expose primary keys", "$": "true"}]}}}
```

ثم ننشر ثلاثة جداول كطبقات، ويكفي اسم الجدول، فيقرأ GeoServer نظام الإحداثيات والمستطيل المحيط من PostGIS بنفسه:

```bash
G=http://127.0.0.1:9521/geoserver/rest; A="-u admin:geoserver"
curl -s $A -w "workspace %{http_code}\n" -H 'Content-Type: application/json' -d '{"workspace":{"name":"city"}}' $G/workspaces
curl -s $A -w "store %{http_code}\n" -H 'Content-Type: application/json' -d @store.json $G/workspaces/city/datastores
for t in districts roads pois; do
  curl -s $A -w "$t %{http_code}\n" -H 'Content-Type: application/json' -d "{\"featureType\":{\"name\":\"$t\"}}" \
    $G/workspaces/city/datastores/riyadh/featuretypes
done
```

```text
workspace 201
store 201
districts 201
roads 201
pois 201
```

والرمز 201 يعني Created. والآن نطلب أول خريطة بخدمة WMS: مربع من 30 كيلومتراً في شمال المدينة بالإسقاط 3857، بحجم 800 في 800 بكسل، للأحياء والطرق بالتنسيق الافتراضي، ونكرر الطلب ثلاث مرات:

```bash
W="http://127.0.0.1:9521/geoserver/city/wms?service=WMS&version=1.3.0&request=GetMap&layers=city:districts,city:roads&styles=&crs=EPSG:3857&bbox=5185000,2845000,5215000,2875000&width=800&height=800&format=image/png"
for i in 1 2 3; do curl -s -o wms1.png -w "%{http_code} %{content_type} %{size_download} bytes %{time_total}s\n" "$W"; done
```

```text
200 image/png 620192 bytes 3.676383s
200 image/png 620192 bytes 1.024196s
200 image/png 620192 bytes 0.407086s
```

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

![صورة حقيقية من خدمة WMS في GeoServer لشمال الرياض بالتنسيق الافتراضي: الأحياء مضلعات رمادية بحدود سوداء، وكل الطرق بخطوط زرقاء بالسماكة نفسها، والشوارع السكنية الكثيفة تغطي أغلب الصورة بالأزرق دون أي تمييز بين طريق سريع وشارع، ولا توجد أسماء](https://arabroot.io/content/images/2026/11/geoserver-tiles-02-wms-default.webp)

الطبقات بالتنسيق الافتراضي: كل طريق بالأزرق نفسه، والصورة 620 كيلوبايت

### ماذا يحدث داخل GeoServer عند طلب WMS؟

من المفيد أن تعرف الخطوات التي يمر بها الطلب الواحد، لأن كل خطوة منها مكان محتمل للبطء. أولاً يقرأ GeoServer المعاملات ويبحث في الفهرس عن الطبقات والتنسيق الافتراضي لكل منها. ثانياً يحسب مقياس الرسم من المستطيل وعرض الصورة، فيعرف أي قواعد SLD تنطبق، فالقاعدة التي لا تنطبق على هذا المقياس لا تقرأ بياناتها إطلاقاً. ثالثاً يبني استعلاماً واحداً لكل طبقة إلى PostGIS، فيه شرط المستطيل بالمعامل `&&` فيستخدم فهرس GiST، ويحاول أن ينقل شروط القواعد نفسها إلى SQL، مثل `highway = 'motorway'`، حتى لا يقرأ صفوفاً لن يرسمها. رابعاً يرسم الأشكال بمكتبة الرسم في Java طبقة بعد طبقة وقاعدة بعد قاعدة، ثم يضع الأسماء في النهاية بعد أن يحسب أماكنها ويتجنب تصادمها. وأخيراً يضغط الصورة بصيغة PNG ويرسلها. ولذلك فإن أول ما تفحصه عند بطء WMS هو الفهرس على عمود الهندسة وعلى الأعمدة التي تستخدمها قواعد SLD، ثم عدد الأشكال في المقياس المطلوب، فالصورة الأولى بالتنسيق الافتراضي رسمت كل الشوارع السكنية في مقياس لا تظهر فيه، وهذا ما جعلها ثلاثة أضعاف حجم الثانية.

وهذا الرابط نفسه هو ما تعطيه لفريق التخطيط: في QGIS يضيف المستخدم اتصال WMS أو WFS بالعنوان `http://server/geoserver/city/wms`، فيقرأ البرنامج ملف GetCapabilities، ويعرض قائمة الطبقات المنشورة وأنظمة الإحداثيات المدعومة، ويضيفها إلى مشروعه مثل أي ملف على جهازه، دون أن يعرف شيئاً عن PostGIS أو كلمة مرور قاعدة البيانات.

### التنسيق بملفات SLD وقواعد مقياس الرسم

التنسيق الافتراضي يرسم كل شيء بالطريقة نفسها، وهذا يجعل الخريطة غير مقروءة ويكبر حجم الصورة. وفي ملف SLD نكتب قواعد Rules، لكل قاعدة شرط على الخصائص Filter، وحد لمقياس الرسم Scale Denominator تظهر فيه، ورمز Symbolizer يرسمها. والملف التالي `lab/roads.sld` يرسم الطرق بثلاث قواعد، والشوارع السكنية فقط عند التقريب:

```xml
<?xml version="1.0" encoding="UTF-8"?>
<StyledLayerDescriptor version="1.0.0" xmlns="http://www.opengis.net/sld" xmlns:ogc="http://www.opengis.net/ogc"
  xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <NamedLayer><Name>roads</Name><UserStyle><Title>roads-by-class</Title><FeatureTypeStyle>
    <Rule>
      <Name>minor</Name>
      <ogc:Filter><ogc:PropertyIsEqualTo><ogc:PropertyName>highway</ogc:PropertyName><ogc:Literal>residential</ogc:Literal></ogc:PropertyIsEqualTo></ogc:Filter>
      <MaxScaleDenominator>40000</MaxScaleDenominator>
      <LineSymbolizer><Stroke><CssParameter name="stroke">#D5D8DE</CssParameter><CssParameter name="stroke-width">1</CssParameter></Stroke></LineSymbolizer>
    </Rule>
    <Rule>
      <Name>major</Name>
      <ogc:Filter><ogc:Or>
        <ogc:PropertyIsEqualTo><ogc:PropertyName>highway</ogc:PropertyName><ogc:Literal>primary</ogc:Literal></ogc:PropertyIsEqualTo>
        <ogc:PropertyIsEqualTo><ogc:PropertyName>highway</ogc:PropertyName><ogc:Literal>secondary</ogc:Literal></ogc:PropertyIsEqualTo>
      </ogc:Or></ogc:Filter>
      <LineSymbolizer><Stroke><CssParameter name="stroke">#F2B544</CssParameter><CssParameter name="stroke-width">2</CssParameter></Stroke></LineSymbolizer>
    </Rule>
    <Rule>
      <Name>highway</Name>
      <ogc:Filter><ogc:Or>
        <ogc:PropertyIsEqualTo><ogc:PropertyName>highway</ogc:PropertyName><ogc:Literal>motorway</ogc:Literal></ogc:PropertyIsEqualTo>
        <ogc:PropertyIsEqualTo><ogc:PropertyName>highway</ogc:PropertyName><ogc:Literal>trunk</ogc:Literal></ogc:PropertyIsEqualTo>
      </ogc:Or></ogc:Filter>
      <LineSymbolizer><Stroke><CssParameter name="stroke">#E95420</CssParameter><CssParameter name="stroke-width">3.5</CssParameter></Stroke></LineSymbolizer>
    </Rule>
  </FeatureTypeStyle></UserStyle></NamedLayer>
</StyledLayerDescriptor>
```

في الملف أعلاه لاحظ أن الطرق التي لا تطابق أي قاعدة، مثل طرق الخدمة Service والمشاة، لا ترسم إطلاقاً، وأن القاعدة الأولى فيها `MaxScaleDenominator` بقيمة 40000، أي أن الشوارع السكنية تظهر فقط عندما يكون مقياس الرسم 1:40000 أو أقرب. وملف الأحياء `lab/districts.sld` يرسم المضلعات بلون فاتح، ويضيف رمز نص TextSymbolizer يكتب اسم الحي من العمود `name` بخط عربي مع هالة Halo بيضاء حوله. ونرفع الملفين ونجعلهما التنسيق الافتراضي للطبقتين:

```bash
for s in districts roads; do
  curl -s $A -o /dev/null -w "create $s %{http_code}\n" -X POST -H 'Content-Type: application/vnd.ogc.sld+xml' \
    --data-binary @$s.sld "$G/workspaces/city/styles?name=$s-style"
  curl -s $A -o /dev/null -w "assign $s %{http_code}\n" -X PUT -H 'Content-Type: application/json' \
    -d "{\"layer\":{\"defaultStyle\":{\"name\":\"city:$s-style\"}}}" $G/layers/city:$s
done
curl -s -o wms2.png -w "%{http_code} %{size_download} bytes %{time_total}s\n" "$W"
```

```text
create districts 201
assign districts 200
create roads 201
assign roads 200
200 204878 bytes 1.761886s
```

الصورة نفسها أصبحت 205 كيلوبايت بدل 620، أي ثلث الحجم، لأن السيرفر لم يعد يرسم 60 ألف شارع سكني في هذا المقياس، والصورة التالية هي النتيجة:

![صورة حقيقية من خدمة WMS للمنطقة نفسها بعد التنسيق: الأحياء بلون بيج فاتح وحدود بنية رفيعة، والطرق السريعة برتقالية سميكة، والطرق الرئيسية صفراء، والشوارع السكنية مخفية في هذا المقياس، وأسماء الأحياء بالعربية في وسطها مثل النرجس والياسمين والملقا والصحافة والعارض والقيروان وحطين وغرناطة](https://arabroot.io/content/images/2026/11/geoserver-tiles-03-wms-styled.webp)

بعد التنسيق بملفات SLD: ثلث الحجم، وأسماء الأحياء بالعربية

### الخط العربي: خطأ لا يظهر في الصورة

الأسماء العربية في الصورة أعلاه صحيحة ومتصلة الحروف، وهذا قد يجعلك تظن أن الخط الذي طلبناه في ملف SLD يعمل. ولكن الحقيقة أننا طلبنا الخط `Noto Sans Arabic`، وهو غير موجود في الـ Container، فرجع GeoServer بصمت إلى الخط الافتراضي للنظام DejaVu Sans، والذي يحتوي بالصدفة على الحروف العربية. وعلى نظام لا يحتوي خطه الافتراضي على العربية سوف تظهر مربعات فارغة بدل الأسماء، دون أي رسالة في السجلات. والحل أن تضع ملف الخط TTF داخل مجلد `styles` في مجلد البيانات، فيحمله GeoServer ويكتب ذلك في السجل:

```bash
docker cp NotoSansArabic-Regular.ttf lab-gs-geoserver:/opt/geoserver/data_dir/styles/
curl -s -u admin:geoserver -X POST http://127.0.0.1:9521/geoserver/rest/reload
docker logs lab-gs-geoserver 2>&1 | grep -i font | tail -1
```

```text
INFO   [geoserver.wms] - Loaded font file /opt/geoserver/data_dir/styles/NotoSansArabic-Regular.ttf, loaded font 'Noto Sans Arabic Regular' in family 'Noto Sans Arabic'
```

ولكن عندما طلبنا الصورة مرة أخرى، وحتى بعد إعادة تشغيل الـ Container، خرجت مطابقة بايتاً ببايت للصورة السابقة، أي أن الخط ما زال DejaVu. والسبب في السجل نفسه: الخط حمل باسم `Noto Sans Arabic Regular`، والاسم الذي يبحث عنه GeoServer في `font-family` هو اسم الخط الكامل كما في السجل، فلما غيرنا السطر في ملف SLD إلى `Noto Sans Arabic Regular` ورفعناه بالطلب PUT تغيرت الصورة وظهر الخط الصحيح. والقاعدة هنا أن تتحقق من الخط بمقارنة الصورة قبل التغيير وبعده، أو بالأمر `cmp` على الملفين، لا بالنظر إلى الأسماء فقط، لأن الرجوع إلى خط آخر لا يعطي أي خطأ.

## WFS: عندما يريد الطرف الآخر البيانات نفسها

الطبقات نفسها متاحة الآن بخدمة WFS دون أي إعداد إضافي، والطلب التالي يعيد ثلاث صيدليات بصيغة GeoJSON مع ترشيح بلغة CQL على عمود `kind`:

```bash
curl -s -o ph.json -w "%{http_code} %{content_type} %{size_download} bytes %{time_total}s\n" \
  "http://127.0.0.1:9521/geoserver/city/ows?service=WFS&version=2.0.0&request=GetFeature&typeNames=city:pois&outputFormat=application/json&CQL_FILTER=kind=%27amenity:pharmacy%27&count=3"
jq -c '.numberMatched, .numberReturned, .features[0]' ph.json
```

```text
200 application/json;charset=utf-8 1073 bytes 2.724578s
109
3
{"type":"Feature","id":"pois.fid-6d293479_1a1e55b8803_1ec9","geometry":{"type":"Point","coordinates":[46.6146292,24.6012791]},"geometry_name":"geom","properties":{"osm_type":"N","osm_id":6263329083,"kind":"amenity:pharmacy","name":"صيدلية أركان الرياض الرابعة","name_en":null}}
```

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

- الخدمة قالت إن هناك 109 معالم تطابق الشرط وأعادت 3، وهذا هو الترقيم Paging في WFS 2.0 بالمعاملين `count` و`startIndex`، فلا يحتاج الكلاينت أن يحمل كل شيء دفعة واحدة.
- المعرف `pois.fid-6d293479_...` مولد ويتغير بين تشغيل وآخر، والسبب أن جدول `pois` الذي أنشأته osm2pgsql ليس له مفتاح أساسي Primary Key. وإذا كان الطرف الآخر يحفظ المعرف ليعود إلى المعلم نفسه لاحقاً، أو إذا أردت التعديل عبر WFS-T، فأضف مفتاحاً أساسياً للجدول، مثل `(osm_type, osm_id)`، قبل النشر.

وعند إرسال الطلب نفسه لكل الطبقات دون `count` كان رد الصيدليات كلها 29,922 بايت في 0.32 ثانية، وكل الأحياء 157,894 بايت في 0.32 ثانية، أما كل الطرق فكانت 39,938,796 بايت، أي 40 ميغابايت، في 7 ثوان. وهذا هو الرقم الذي بدأنا به المقال، وهو السبب الذي يجعل WFS مناسبة لنقل البيانات بين الأنظمة، لا لعرض طبقة كبيرة في المتصفح. ولاحظ أيضاً أن GeoServer يرسل JSON دون ضغط، فلما وضعنا nginx أمامه مع `gzip` كما يأتي، أصبح ملف الصيدليات 3,809 بايت بدل 29,922.

## التخزين المؤقت بالمربعات: GeoWebCache

خدمة WMS ترسم كل طلب من جديد، وهذا مكلف ولا يحتاجه أغلب الزوار، لأن الجميع يرون الخريطة نفسها. وGeoWebCache المدمجة في GeoServer تنشئ لكل طبقة جديدة طبقة مربعات Tile Layer تلقائياً بصيغتي PNG وJPEG، على شبكتي مربعات Gridsets هما `EPSG:900913`، وهو الاسم القديم لـ Web Mercator، و`EPSG:4326`. والصورة التالية من واجهة الإدارة الجديدة في GeoServer 3.0 تبين طبقات المربعات لمساحة العمل `city`:

![لقطة حقيقية من واجهة GeoServer 3.0 في صفحة Tile Layers بعد البحث بكلمة city: أربع طبقات مربعات هي city:roads وcity:pois وcity:districts ومجموعة city:base، كلها مفعلة، ولكل منها قائمة معاينة وزرا Seed/Truncate وEmpty، وفي القائمة الجانبية مساحات العمل ومنها city وne وnurc وsf وtiger وtopp من البيانات التجريبية](https://arabroot.io/content/images/2026/11/geoserver-tiles-04-gwc-ui.webp)

طبقات المربعات في GeoServer 3.0، وكل طبقة جديدة تحصل على مربعات تلقائياً

ونطلب المربع نفسه مرتين بمعيار WMTS بالملف `lab/tile.sh`، الذي يطبع حالة الكاش من الترويسة `geowebcache-cache-result`:

```bash
# usage: tile.sh LAYER FORMAT Z X Y
L=$1; F=$2; Z=$3; X=$4; Y=$5
curl -s -o /dev/null -D - -w "size=%{size_download} time=%{time_total}\n" \
  "http://127.0.0.1:9521/geoserver/gwc/service/wmts?service=WMTS&version=1.0.0&request=GetTile&layer=$L&style=&tilematrixset=EPSG:900913&format=$F&tilematrix=EPSG:900913:$Z&tilecol=$X&tilerow=$Y" \
  | grep -iE "^HTTP|geowebcache-cache-result|content-type|size="
```

```bash
bash tile.sh city:roads image/png 13 5158 3515; bash tile.sh city:roads image/png 13 5158 3515
bash tile.sh city:roads image/png 15 20632 14061; bash tile.sh city:roads image/png 15 20632 14061
```

```text
HTTP/1.1 200 OK
Content-Type: image/png
geowebcache-cache-result: MISS
size=19114 time=0.600748
HTTP/1.1 200 OK
Content-Type: image/png
geowebcache-cache-result: HIT
size=19114 time=0.016272
HTTP/1.1 200 OK
Content-Type: image/png
geowebcache-cache-result: MISS
size=43420 time=0.195950
HTTP/1.1 200 OK
Content-Type: image/png
geowebcache-cache-result: HIT
size=43420 time=0.014141
```

الطلب الأول MISS أخذ 0.6 ثانية والثاني HIT أخذ 16 مللي ثانية، أي أسرع بنحو 37 مرة. ولاحظ أن الطلب الأول في المستوى 13 أبطأ من المستوى 15 رغم أن المربع أصغر، والسبب ما يسمى التبليط الكبير Metatiling: GeoWebCache لا يرسم المربع وحده، وإنما يرسم كتلة من 4 في 4 مربعات في طلب واحد إلى قاعدة البيانات ثم يقصها ويخزنها كلها، فالطلب الأول يدفع ثمن 16 مربعاً، والمربعات المجاورة تصبح HIT دون أن تطلب.

### لماذا تتكرر أسماء الأحياء؟

للتبليط الكبير سبب ثان أهم من السرعة، ويظهر عندما تعرض WMS كمربعات في المتصفح. فقد عرضنا في صفحة MapLibre طبقتي الأحياء والطرق مرة بطلب WMS مباشر لكل مربع من 256 بكسل، ومرة من GeoWebCache بمعيار TMS على مجموعة طبقات `city:base`، والصورة التالية من الطريقة الأولى:

![لقطة حقيقية من صفحة MapLibre تعرض WMS مباشرة في مربعات من 256 بكسل: أسماء الأحياء مكررة كثيراً، فاسم مثل العقيق والملقا والصحافة يظهر مرتين وثلاثاً في الحي الواحد، وبعض الأسماء مقطوعة عند حدود المربعات، والصفحة احتاجت 54 مربعاً بحجم 1.85 ميغابايت وبعض المربعات أخذ حتى 9.7 ثوان](https://arabroot.io/content/images/2026/11/geoserver-tiles-05-wms-tiles-labels.webp)

WMS مباشرة في مربعات صغيرة: كل مربع يضع أسماءه وحده، فتتكرر الأسماء وتقطع

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

![لقطة حقيقية من صفحة MapLibre للمنطقة نفسها من GeoWebCache بمعيار TMS: الطرق والأحياء نفسها، ولكن اسم كل حي يظهر غالباً مرة واحدة مثل العقيق والغدير والمروج والنفل والربيع والملقا، مع بقاء تكرار قليل في الأحياء الكبيرة](https://arabroot.io/content/images/2026/11/geoserver-tiles-06-gwc-tiles.webp)

من GeoWebCache بالتبليط الكبير 4 في 4: تكرار أقل بكثير للأسماء

وفي القياس احتاجت الصفحة الأولى 54 طلب WMS بحجم 1.85 ميغابايت، وأخذ كل طلب بين 2.4 و9.7 ثانية، لأن المتصفح يرسل الطلبات معاً والسيرفر يرسمها كلها في الوقت نفسه. ولذلك القاعدة: لا تعرض WMS مباشرة في مربعات على صفحة عامة، وإنما اجعل الطلبات تمر بـ GeoWebCache، إما بمعيار WMTS أو TMS كما فعلنا، أو بتفعيل خيار التكامل المباشر Direct WMS Integration الذي يجعل طلبات WMS ذات المعامل `tiled=true` تذهب إلى الكاش.

### التجهيز المسبق Seeding: قبل أن يطلب أحد

حتى لا يدفع أول زائر ثمن الرسم، يمكن أن تطلب من GeoWebCache تجهيز المربعات مسبقاً لمستويات تقريب محددة، وهو الملف `lab/seed.json` للمستويات من 10 إلى 14:

```json
{"seedRequest": {"name": "city:base", "gridSetId": "EPSG:900913", "zoomStart": 10, "zoomStop": 14,
  "format": "image/png", "type": "seed", "threadCount": 4}}
```

```bash
curl -s -u admin:geoserver -H 'Content-Type: application/json' -d @seed.json \
  http://127.0.0.1:9521/geoserver/gwc/rest/seed/city:base.json
curl -s -u admin:geoserver http://127.0.0.1:9521/geoserver/gwc/rest/seed/city:base.json
```

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

```text
{"long-array-array":[[528,4496,43,9,1],[464,4496,54,10,1],[592,4496,34,11,1],[416,4496,65,12,1]]}
```

كل مصفوفة فيها: المربعات التي انتهت، ثم العدد الكلي 4496، ثم الثواني المتبقية بالتقدير، ثم رقم المهمة، ثم الحالة. واكتمل التجهيز في 114 ثانية، وأصبح في مجلد الكاش 3,884 ملفاً بحجم 32 ميغابايت. والفرق بين 4496 و3884 أن المربعات تحسب لمستطيل الطبقة كاملاً، وبعضها خارج البيانات أو فارغ. ولاحظ أن كل مستوى تقريب فيه أربعة أضعاف ما قبله، فلو أضفت المستويين 15 و16 لتضاعف العدد قرابة عشرين مرة، لذلك جهز المستويات المنخفضة فقط، واترك العالية تملأ نفسها عند الطلب.

## المربعات المتجهة من GeoServer

إضافة [Vector Tiles](https://docs.geoserver.org/latest/en/user/extensions/vectortiles/index.html?ref=arabroot.io) التي وضعناها في Dockerfile تضيف صيغة `application/vnd.mapbox-vector-tile` إلى GeoWebCache، ونفعلها لكل طبقة بتعديل إعدادها عبر REST: نقرأ ملف XML للطبقة، ونضيف الصيغة إلى قائمة `mimeFormats`، ونعيده بالطلب PUT:

```bash
for l in roads districts pois; do
  curl -s -u admin:geoserver http://127.0.0.1:9521/geoserver/gwc/rest/layers/city:$l.xml \
    | sed 's#<string>image/jpeg</string>#<string>image/jpeg</string>\n    <string>application/vnd.mapbox-vector-tile</string>#' > gwc-$l.xml
  curl -s -u admin:geoserver -o /dev/null -w "$l %{http_code}\n" -X PUT -H 'Content-Type: text/xml' \
    --data-binary @gwc-$l.xml http://127.0.0.1:9521/geoserver/gwc/rest/layers/city:$l.xml
done
bash tile.sh city:roads application/vnd.mapbox-vector-tile 13 5158 3515
bash tile.sh city:roads application/vnd.mapbox-vector-tile 15 20632 14061
```

```text
roads 200
districts 200
pois 200
Content-Type: application/vnd.mapbox-vector-tile
geowebcache-cache-result: MISS
size=9639 time=0.561050
Content-Type: application/vnd.mapbox-vector-tile
geowebcache-cache-result: MISS
size=8374 time=0.185117
```

والطلبات الثانية لكل منهما كانت HIT في 10 و9 مللي ثوان. وهنا ملاحظة مهمة عن طريقة GeoServer في المربعات المتجهة: المربع في المستوى 13 حجمه 9.6 كيلوبايت فقط، والسبب أن GeoServer يطبق قواعد ملف SLD على المربع المتجه أيضاً، فالشوارع السكنية التي لا تظهر في هذا المقياس لا تدخل المربع، والطرق التي لا تطابق أي قاعدة لا تدخل إطلاقاً. وهذه ميزة إذا كنت تريد أن يتحكم ملف SLD واحد في الصور والمربعات معاً، وعيب إذا كنت تريد أن يقرر المتصفح ما يظهر. ولاحظ أيضاً أن GeoServer أرسل المربع دون ضغط، فلما مر الطلب نفسه عبر nginx مع `gzip` أصبح 6,211 بايت بدل 9,639.

## Martin: سيرفر مربعات متجهة فقط

GeoServer أداة كاملة لكل معايير OGC، وهذا له ثمن: بعد المختبر كان يستخدم 1.6 جيجابايت من الذاكرة، ويحتاج قرابة دقيقة ليبدأ. أما إذا كان كل ما تحتاجه مربعات متجهة من PostGIS لصفحة ويب، فهناك أدوات أصغر بكثير، منها [Martin](https://maplibre.org/martin/?ref=arabroot.io) من مشروع MapLibre، وهو سيرفر مكتوب بلغة Rust برخصة MIT أو Apache-2.0، يقرأ جداول PostGIS ودوالها ويقدمها كمربعات MVT، ويقدم ملفات PMTiles وMBTiles، والخطوط Fonts التي يحتاجها المتصفح لكتابة الأسماء. وكان يستخدم في المختبر نفسه 31 ميغابايت من الذاكرة. وهناك أداة مشابهة من Crunchy Data اسمها [pg\_tileserv](https://github.com/CrunchyData/pg%5Ftileserv?ref=arabroot.io)، تقوم بالعمل نفسه على PostGIS بإعداد أقل، واخترنا Martin هنا لأنه يقدم الخطوط أيضاً.

والسر الذي يجعل هذه الأدوات صغيرة هو أن PostGIS نفسها تصنع المربع: الدالة `ST_AsMVTGeom` تحول الأشكال إلى إحداثيات المربع من 0 إلى 4096 وتقصها عند حدوده، والدالة `ST_AsMVT` تجمع الصفوف في مربع واحد بصيغة Protobuf، فلا يبقى على السيرفر إلا أن يكتب الاستعلام ويرسل البايتات.

### ما الذي يوجد داخل المربع المتجه؟

حتى تفهم لماذا يتغير حجم المربع بهذا الشكل، انظر إلى ما تحدده [مواصفة MVT](https://github.com/mapbox/vector-tile-spec?ref=arabroot.io): المربع ملف Protobuf فيه طبقة أو أكثر، ولكل طبقة اسم، مثل `roads`، وقائمة معالم Features، ولكل معلم نوع هندسي وخصائص. والإحداثيات لا تحفظ بخطوط الطول والعرض، وإنما بأرقام صحيحة داخل شبكة المربع، من 0 إلى 4096 في الإعداد المعتاد، وكل نقطة تحفظ كفرق عن النقطة السابقة بترميز صغير، فالخط القصير داخل مربع واحد يحتاج بايتات قليلة. والخصائص لا تكرر النص في كل معلم، وإنما يحفظ كل مفتاح وكل قيمة مرة واحدة في قاموس الطبقة، ويشير إليها كل معلم برقم، فاسم مثل `residential` يتكرر في آلاف الشوارع لكنه يحفظ مرة واحدة. وهذا يعني أن حجم المربع يعتمد أساساً على عدد النقاط فيه، فالمربع في المستوى 10 الذي يحتوي كل نقاط كل شوارع المدينة كبير مهما كانت الصيغة مضغوطة، والحل الوحيد هو تقليل ما يدخله، إما بحذف طبقات كما فعلنا، أو بتبسيط الأشكال، أو بالاثنين معاً.

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

### الإعداد بملف YAML

الملف `lab/martin.yaml` ينشر جدولين وعرضاً View للصيدليات، ومجلد الخطوط:

```yaml
listen_addresses: '0.0.0.0:3000'
postgres:
  connection_string: 'postgresql://postgres:lab@lab-gs-pg/gis'
  auto_publish: false
  tables:
    districts:
      schema: public
      table: districts
      srid: 4326
      geometry_column: geom
      geometry_type: MULTIPOLYGON
      properties: { name: text, name_en: text }
    roads:
      schema: public
      table: roads
      srid: 4326
      geometry_column: geom
      geometry_type: LINESTRING
      properties: { highway: text, name: text }
    pharmacies:
      schema: public
      table: pharmacies
      srid: 4326
      geometry_column: geom
      geometry_type: POINT
      properties: { name: text }
fonts:
  - /fonts
```

الخيار `auto_publish: false` مهم، فبدونه ينشر Martin كل جدول فيه عمود هندسي في القاعدة، بما فيها جداول قد لا تريد أن يراها أحد. وننشئ العرض ثم نشغل Martin:

```bash
docker exec lab-gs-pg psql -U postgres -d gis -c "CREATE VIEW pharmacies AS SELECT osm_id, name, geom FROM pois WHERE kind = 'amenity:pharmacy';"
docker run -d --name lab-gs-martin --network lab-gs-net -p 127.0.0.1:9522:3000 \
  -v "$PWD/martin.yaml:/config.yaml:ro" -v "$PWD/fonts:/fonts:ro" ghcr.io/maplibre/martin:1.16.1 --config /config.yaml
curl -s http://127.0.0.1:9522/catalog
```

```text
{"tiles":{"districts":{"content_type":"application/x-protobuf","description":"public.districts.geom"},
 "pharmacies":{"content_type":"application/x-protobuf","description":"public.pharmacies.geom"},
 "roads":{"content_type":"application/x-protobuf","description":"public.roads.geom"}},
 "sprites":{},"fonts":{"Noto Sans Arabic Regular":{"family":"Noto Sans Arabic","style":"Regular","glyphs":1399,"start":0,"end":69375,"format":"ttf"}},
 "styles":{},"settings":{"rendering":false}}
```

في المخرج لاحظ أن Martin وجد الخط العربي وقرأ منه 1399 حرفاً، وسوف يحوله إلى ملفات الحروف Glyphs التي تطلبها MapLibre بالمدى، مثل `1536-1791` وهو مدى الحروف العربية في Unicode. وفي سجل البداية ظهر تحذير واحد: `ST_EstimatedExtent on "public"."pharmacies".geom failed, trying slower method`، والسبب أن العرض View ليس له إحصاءات، فيحسب Martin المستطيل المحيط بقراءة البيانات، وهذا سريع مع 109 صيدليات وبطيء مع عرض على جدول كبير، فحدد `bounds` في الإعداد في تلك الحالة.

### المربع الذي وصل إلى 2 ميغابايت

الآن نقيس حجم مربع الطرق في أربعة مستويات تقريب حول النقطة نفسها، مع الضغط ودونه:

```bash
for t in 10/644/439 12/2579/1757 13/5158/3515 15/20632/14061; do for enc in identity gzip; do
  curl -s -o /dev/null -H "Accept-Encoding: $enc" -w "roads $t $enc: %{http_code} size=%{size_download} time=%{time_total}\n" \
    http://127.0.0.1:9522/roads/$t
done; done
```

```text
roads 10/644/439 identity: 200 size=2163035 time=24.055294
roads 10/644/439 gzip: 200 size=992506 time=0.271141
roads 12/2579/1757 identity: 200 size=299872 time=0.185501
roads 12/2579/1757 gzip: 200 size=154683 time=0.032450
roads 13/5158/3515 identity: 200 size=93460 time=0.051961
roads 13/5158/3515 gzip: 200 size=52067 time=0.009111
roads 15/20632/14061 identity: 200 size=9753 time=0.010457
roads 15/20632/14061 gzip: 200 size=6233 time=0.003586
```

وهذه مشكلة حقيقية: مربع واحد في المستوى 10 حجمه 2.16 ميغابايت، ومليون بايت حتى بعد الضغط، وأول طلب له أخذ 24 ثانية لأن القاعدة كانت باردة وقرأت كل طرق المدينة. والسبب أن المستوى 10 يغطي المدينة كلها في مربع واحد، والجدول يعطي Martin كل الطرق الـ 111 ألف دون تمييز، بينما الشاشة في هذا المستوى لا تستطيع أصلاً أن تعرض شارعاً سكنياً عرضه بكسل واحد. ولاحظ أن الطلب الثاني للمربع نفسه أخذ 0.27 ثانية لأن Martin يحفظ المربعات في ذاكرته. وهذا هو الفرق الذي رأيناه في GeoServer: هناك يطبق ملف SLD الترشيح بحسب المقياس، أما مصدر الجدول في Martin فلا يعرف أي قواعد.

والحل أن نعطي Martin دالة بدل الجدول، تقرر ماذا يدخل المربع بحسب مستوى التقريب. وMartin يقبل أي دالة في PostgreSQL تأخذ `z, x, y` وتعيد `bytea`، وهو الملف `lab/roads_z.sql`:

```sql
CREATE OR REPLACE FUNCTION roads_z(z integer, x integer, y integer)
RETURNS bytea AS $$
  SELECT ST_AsMVT(t, 'roads', 4096, 'geom')
  FROM (
    SELECT highway, name,
           ST_AsMVTGeom(ST_Transform(geom, 3857), ST_TileEnvelope(z, x, y), 4096, 64, true) AS geom
    FROM roads
    WHERE geom && ST_Transform(ST_TileEnvelope(z, x, y, margin => 64.0 / 4096), 4326)
      AND (   highway IN ('motorway', 'trunk', 'primary', 'motorway_link', 'trunk_link')
           OR (z >= 12 AND highway IN ('secondary', 'tertiary'))
           OR  z >= 14)
  ) AS t
$$ LANGUAGE sql STABLE STRICT PARALLEL SAFE;
```

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

- `ST_TileEnvelope(z, x, y)` تعطي مستطيل المربع بالإسقاط 3857، ونحوله إلى 4326 في شرط WHERE، أي نحول قيمة السؤال لا عمود الجدول، حتى يستخدم فهرس GiST على `geom` كما شرحنا في مقال PostGIS.
- الهامش `64.0 / 4096` والرقم 64 في `ST_AsMVTGeom` يضيفان حافة صغيرة حول المربع، حتى لا تظهر الخطوط السميكة مقطوعة عند حدود المربعات.
- الطرق الرئيسية في كل المستويات، والثانوية من المستوى 12، والباقي من 14، وهذا القرار نفسه الذي اتخذناه في ملف SLD لكن بلغة SQL.

نضيف الدالة إلى ملف الإعداد تحت `functions`، ونعيد تشغيل Martin، ونقارن المصدرين:

```yaml
  functions:
    roads_z:
      schema: public
      function: roads_z
      minzoom: 0
      maxzoom: 16
```

```text
roads 10/644/439: size=989078 time=0.772196
roads 12/2579/1757: size=153200 time=0.108360
roads 13/5158/3515: size=52067 time=0.094520
roads 15/20632/14061: size=6233 time=0.005655
roads_z 10/644/439: size=42527 time=0.077329
roads_z 12/2579/1757: size=23203 time=0.022039
roads_z 13/5158/3515: size=8516 time=0.007281
roads_z 15/20632/14061: size=6233 time=0.005722
```

والصورة التالية تبين الفرق في كل مستوى:

![رسم بياني بالأعمدة لحجم مربع الطرق المضغوط بالكيلوبايت في أربعة مستويات تقريب: في المستوى 10 الجدول كاملاً 989 كيلوبايت مقابل 42.5 للدالة roads_z، وفي المستوى 12 153 مقابل 23، وفي المستوى 13 52 مقابل 8.5، وفي المستوى 15 الحجم نفسه 6.2 كيلوبايت لأن الدالة تعطي كل الطرق من المستوى 14](https://arabroot.io/content/images/2026/11/geoserver-tiles-07-tile-sizes.webp)

الترشيح بحسب مستوى التقريب صغر مربع المستوى 10 من 989 إلى 42.5 كيلوبايت

المربع في المستوى 10 أصبح 42.5 كيلوبايت بدل 989، أي أصغر 23 مرة، وفي المستوى 15 الحجم نفسه لأن الدالة تعطي كل الطرق من المستوى 14\. والقاعدة أن تقيس حجم المربع في أقل مستوى تقريب تعرضه قبل أي شيء آخر، وأن تبقي المربع تحت 500 كيلوبايت، وهو الحد الافتراضي الذي تفرضه أداة [tippecanoe](https://github.com/felt/tippecanoe?ref=arabroot.io) المعروفة لبناء المربعات، وما فوقه يجعل الخريطة بطيئة على الهاتف.

## nginx أمام الاثنين: كاش وضغط ومسار واحد

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

![مخطط: المتصفح بمكتبة MapLibre يطلب من nginx على مسار واحد، والمسار /tiles/ يذهب إلى Martin مع كاش nginx على القرص فالطلب الأول MISS والثاني HIT، والمسار /geoserver/ يذهب إلى GeoServer مع ضغط gzip للمربعات المتجهة وJSON، وGeoServer فيه GeoWebCache على القرص بحجم 32 ميغابايت بعد التجهيز، والاثنان يقرآن من PostGIS، والذاكرة: GeoServer 1.6 جيجابايت وMartin 31 ميغابايت وPostGIS 250 ميغابايت وnginx 14 ميغابايت](https://arabroot.io/content/images/2026/11/geoserver-tiles-08-architecture.webp)

nginx يقدم كل شيء من نطاق واحد، ويخزن مربعات Martin ويضغط ردود GeoServer

وهو الملف `lab/nginx.conf`:

```nginx
proxy_cache_path /var/cache/nginx/tiles levels=1:2 keys_zone=tiles:10m max_size=1g inactive=7d use_temp_path=off;

server {
    listen 80;
    root /usr/share/nginx/html;

    # nginx does not know .mjs; browsers refuse a module served as octet-stream
    location ~ \.mjs$ { default_type text/javascript; }

    # vector tiles, TileJSON and fonts from Martin
    location /tiles/ {
        proxy_pass http://lab-gs-martin:3000/;
        proxy_set_header Host $http_host;
        proxy_set_header X-Rewrite-URL $request_uri;
        proxy_cache tiles;
        proxy_cache_valid 200 1h;
        add_header X-Cache-Status $upstream_cache_status;
    }

    # WMS, WFS and GeoWebCache from GeoServer
    location /geoserver/ {
        proxy_pass http://lab-gs-geoserver:8080/geoserver/;
        proxy_set_header Host $http_host;
        # GeoServer sends vector tiles uncompressed
        gzip on;
        gzip_proxied any;
        gzip_types application/vnd.mapbox-vector-tile application/json;
    }
}
```

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

- الترويسة `X-Rewrite-URL` تخبر Martin بالمسار الذي يراه المتصفح، فيكتب في ملف TileJSON روابط المربعات عبر nginx لا عبر منفذه الداخلي، وبدونها سوف ترى في ملف TileJSON عنوان `lab-gs-martin:3000` الذي لا يصل إليه المتصفح.
- السطر الخاص بالامتداد `.mjs` أضفناه بعد مشكلة حقيقية: الصفحة الأولى ظهرت بيضاء تماماً دون أي خطأ ظاهر، والسبب أن ملف `mime.types` في nginx 1.29 لا يعرف الامتداد `.mjs` فيرسله بالنوع `application/octet-stream`، والمتصفح يرفض تحميل JavaScript Module بهذا النوع، ويكتب في وحدة التحكم `Failed to fetch dynamically imported module`.
- الكاش على المسار `/tiles/` فقط، أما GeoServer فله كاشه الخاص، ووضع كاش ثان أمامه يجعل تفريغ الكاش بعد تحديث البيانات في مكانين.

ونتحقق من الكاش والرابط بطلبين:

```bash
curl -s http://127.0.0.1:9523/tiles/roads_z
for i in 1 2; do curl -s -o /dev/null -D - -H "Accept-Encoding: gzip" http://127.0.0.1:9523/tiles/roads_z/13/5158/3515 | grep -iE "x-cache|content-length"; done
```

```text
{"tilejson":"3.0.0","tiles":["http://127.0.0.1:9523/tiles/roads_z/{z}/{x}/{y}"],"description":"public.roads_z","maxzoom":16,"minzoom":0,"name":"roads_z"}
Content-Length: 8516
X-Cache-Status: MISS
X-Cache-Status: HIT
```

## عندما تتغير البيانات: الكاش ضد الحداثة

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

- **مدة صلاحية قصيرة:** للطبقات التي تتغير كثيراً وحجمها صغير، مثل الصيدليات، اجعل مدة الكاش دقائق في nginx، أو لا تخزنها أصلاً، فمربع الصيدليات كان 1.4 كيلوبايت ويخرج من PostGIS في مللي ثوان.
- **تفريغ عند التغيير:** للطبقات الكبيرة التي تتغير بشكل معروف، مثل استيراد ليلي للطرق، أضف في آخر مهمة الاستيراد طلباً إلى GeoWebCache من نوع `truncate` لطبقة المربعات، ويمكن أن تحدده بمستطيل المنطقة التي تغيرت فقط، ثم أعد تجهيز المستويات المنخفضة.
- **إصدار في الرابط:** للبيانات التي تنشر كدفعة كاملة، ضع رقم الإصدار أو التاريخ في مسار المربعات، مثل `/tiles/v20261116/`، وغير الرابط في ملف التنسيق عند كل نشر، فيبقى الكاش القديم صالحاً لمن فتح الصفحة قبل التحديث، والجديد يبدأ نظيفاً، ولا تحتاج إلى تفريغ أي شيء.

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

وهناك أمر أخير يظهر في أي قياس للمربعات من المتصفح: في المختبر كانت أزمنة بعض طلبات WMS تسع ثوان، ولكن جزءاً كبيراً منها انتظار لا رسم، لأن المتصفح على HTTP/1.1 لا يفتح أكثر من ستة اتصالات لكل نطاق، فالطلب السابع ينتظر حتى ينتهي أحد الستة. وعلى السيرفر الحقيقي فعل HTTP/2 في nginx مع TLS، فتمر كل المربعات في اتصال واحد بطلبات متوازية، ويختفي هذا الانتظار، وهذه من الأسباب التي تجعل وضع nginx أمام سيرفر الخرائط أفضل من فتح منفذه مباشرة.

## الخريطة في المتصفح بمكتبة MapLibre

الصفحة `lab/web/index.html` تستخدم [MapLibre GL JS](https://github.com/maplibre/maplibre-gl-js?ref=arabroot.io) بالإصدار 6.13.0 من ملفات على السيرفر نفسه، كما في مقال الخرائط على سيرفرك، وتعرض ثلاثة مصادر من Martin مع الخط العربي منه أيضاً. وهذا جزء التنسيق منها:

```javascript
const T = `${location.origin}/tiles`;
const attribution = '<a href="https://www.openstreetmap.org/copyright">© OpenStreetMap</a>';
const vector = {
  version: 8,
  glyphs: `${T}/font/{fontstack}/{range}`,
  sources: {
    districts:  { type: 'vector', url: `${T}/districts`, attribution },
    roads:      { type: 'vector', url: `${T}/roads_z` },
    pharmacies: { type: 'vector', url: `${T}/pharmacies` }
  },
  layers: [
    { id: 'bg', type: 'background', paint: { 'background-color': '#FAFAF7' } },
    { id: 'districts', type: 'fill', source: 'districts', 'source-layer': 'districts',
      paint: { 'fill-color': '#F4EFE6', 'fill-outline-color': '#9C8F7A' } },
    { id: 'roads-minor', type: 'line', source: 'roads', 'source-layer': 'roads',
      filter: ['!', ['in', ['get', 'highway'], ['literal', ['motorway', 'trunk', 'primary', 'secondary']]]],
      paint: { 'line-color': '#D5D8DE', 'line-width': 1 } },
    { id: 'roads-major', type: 'line', source: 'roads', 'source-layer': 'roads',
      filter: ['in', ['get', 'highway'], ['literal', ['primary', 'secondary']]],
      paint: { 'line-color': '#F2B544', 'line-width': 2 } },
    { id: 'roads-highway', type: 'line', source: 'roads', 'source-layer': 'roads',
      filter: ['in', ['get', 'highway'], ['literal', ['motorway', 'trunk']]],
      paint: { 'line-color': '#E95420', 'line-width': 3.5 } },
    { id: 'pharmacies', type: 'circle', source: 'pharmacies', 'source-layer': 'pharmacies',
      paint: { 'circle-radius': 6, 'circle-color': '#1F8A55', 'circle-stroke-color': '#fff', 'circle-stroke-width': 2 } },
    { id: 'district-names', type: 'symbol', source: 'districts', 'source-layer': 'districts',
      layout: { 'text-field': ['get', 'name'], 'text-font': ['Noto Sans Arabic Regular'], 'text-size': 13 },
      paint: { 'text-color': '#5A4A32', 'text-halo-color': '#fff', 'text-halo-width': 2 } }
  ]
};
window.map = new maplibregl.Map({ container: 'map', center: [46.6620, 24.7660], zoom: 12.5, style: vector });
```

لاحظ أن الاسم في `text-font` هو الاسم الكامل كما ظهر في فهرس Martin `Noto Sans Arabic Regular`، وهو الدرس نفسه الذي تعلمناه في GeoServer. والصورة التالية هي الصفحة في المتصفح:

![لقطة حقيقية من صفحة MapLibre تعرض المربعات المتجهة من Martin: الأحياء بلون بيج وأسماؤها بالعربية بخط Noto Sans Arabic مرة واحدة لكل حي مثل الملقا والصحافة والربيع والنفل والعقيق والغدير والمروج والتعاون والمصيف، والطرق السريعة برتقالية والرئيسية صفراء والشوارع الصغيرة رمادية، والصيدليات دوائر خضراء، ونسبة OpenStreetMap في الزاوية](https://arabroot.io/content/images/2026/11/geoserver-tiles-09-maplibre-martin.webp)

المربعات المتجهة من Martin: الأسماء مرة واحدة لكل حي، والمتصفح يرسم كل شيء

وعند فتح الصفحة طلب المتصفح من nginx ستة مربعات من كل مصدر، بحجم 112 كيلوبايت لمربعات الطرق، و8 كيلوبايت للأحياء، و1.4 كيلوبايت للصيدليات، و56 كيلوبايت لثلاثة ملفات من الحروف، أي قرابة 178 كيلوبايت للشاشة كاملة، مقابل 1.85 ميغابايت لصفحة WMS في المنطقة نفسها. ولاحظ أن الأسماء في هذه الصفحة تظهر مرة واحدة لكل حي، لأن MapLibre تضع الأسماء على مستوى الشاشة كلها لا على مستوى المربع، وتتجنب التصادم بينها.

### متى تبقى الصور النقطية الخيار الأفضل؟

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

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

## GeoServer أم Martin؟

الأداتان لا تتنافسان بقدر ما تخدمان جمهورين مختلفين، والجدول التالي يلخص ما رأيناه في المختبر:

| المعيار            | GeoServer 3.0.2                                                   | Martin 1.16.1                                                        |
| ------------------ | ----------------------------------------------------------------- | -------------------------------------------------------------------- |
| المعايير           | WMS وWFS وWCS وWMTS وTMS، والمربعات المتجهة بإضافة                | مربعات MVT وTileJSON والخطوط والرموز وملفات PMTiles                  |
| الكلاينت           | أي برنامج GIS مثل QGIS وArcGIS، وأي مكتبة ويب                     | مكتبات الويب والهاتف مثل MapLibre                                    |
| التنسيق            | على السيرفر بملفات SLD، ويطبق على الصور والمربعات                 | في المتصفح بملف Style، وأي ترشيح على السيرفر تكتبه بنفسك في دالة SQL |
| الذاكرة في المختبر | 1.6 جيجابايت                                                      | 31 ميغابايت                                                          |
| الكاش              | GeoWebCache على القرص مع التجهيز المسبق                           | في الذاكرة، ويحتاج كاشاً أمامه مثل nginx                             |
| الإدارة            | واجهة ويب وREST API، وإعداد في data\_dir                          | ملف YAML واحد                                                        |
| نقاط القوة         | كل المعايير، وجهات خارجية تتصل بها مباشرة، والبيانات الشبكية      | صغير وسريع، ومناسب لتطبيقات الويب والهاتف، ويقدم الخطوط العربية      |
| نقاط الضعف         | ثقيل، وكلمة مرور وبيانات تجريبية افتراضية، وضغط غير مفعل للمربعات | لا معايير OGC، وأي منطق عرض على السيرفر تكتبه بنفسك                  |

والقاعدة العملية: إذا كان جمهورك أنظمة GIS أخرى وجهات تطلب WMS وWFS، أو عندك بيانات شبكية، فاختر GeoServer. وإذا كان جمهورك صفحة ويب أو تطبيق هاتف تبنيه أنت، فاختر Martin أو pg\_tileserv. وكثير من المشاريع تشغل الاثنين على قاعدة PostGIS واحدة كما فعلنا، كل منهما لجمهوره.

## قبل أن تفتحه للإنترنت

- غير كلمة مرور `admin` في GeoServer فوراً، واحذف مساحات العمل التجريبية، ولا تعرض المسار `/geoserver/rest` ولا `/geoserver/web` عبر nginx للإنترنت، وإنما من شبكة الإدارة فقط.
- اجعل اتصال GeoServer وMartin بقاعدة البيانات بمستخدم للقراءة فقط على الجداول المنشورة، لا بالمستخدم `postgres` كما في المختبر.
- في Martin اترك `auto_publish: false` وانشر ما تحتاجه بالاسم، لأن النشر التلقائي يعرض كل جدول فيه عمود هندسي.
- خدمة WFS تعيد كل الأعمدة المنشورة، فإذا كان في الجدول أعمدة داخلية، فانشر عرضاً View بالأعمدة المطلوبة فقط.
- ضع حداً للطلبات Rate Limit على خدمات WMS وWFS في nginx، لأن طلب WMS كبير أو WFS دون `count` يأخذ ثوان من المعالج والذاكرة.
- تابع الإصدارات الأمنية لـ GeoServer، فقد نشر المشروع في 2024 ثغرة خطيرة CVE-2024-36401 تسمح بتنفيذ كود عن بعد عبر خدمات OGC دون تسجيل دخول، كما في [إعلان المشروع](https://github.com/geoserver/geoserver/security/advisories/GHSA-6jj6-gm7p-fcvv?ref=arabroot.io)، وأضافتها وكالة CISA إلى قائمة الثغرات المستغلة فعلاً، فالسيرفرات التي لم تحدث كانت هدفاً مباشراً.

## أخطاء شائعة وحلولها

- **الأسماء العربية مربعات فارغة أو بخط غير المطلوب:** ضع ملف TTF في `data_dir/styles`، واكتب في SLD الاسم الكامل كما يظهر في السجل، مثل `Noto Sans Arabic Regular`.
- **أسماء مكررة ومقطوعة على الخريطة:** WMS في مربعات صغيرة دون Metatiling، فاستخدم GeoWebCache بمعيار WMTS أو TMS، أو المربعات المتجهة.
- **مربع متجه بحجم ميغابايت:** جدول دون ترشيح بحسب مستوى التقريب، فاستخدم دالة تقرر الطبقات بحسب `z`، وقس أقل مستوى تقريب أولاً.
- **صفحة بيضاء دون خطأ ظاهر:** افتح وحدة التحكم في المتصفح، فإذا رأيت `Failed to fetch dynamically imported module` فالسيرفر يرسل `.mjs` بنوع خاطئ.
- **روابط المربعات في TileJSON تشير إلى عنوان داخلي:** أرسل الترويسة `X-Rewrite-URL` من nginx إلى Martin، أو حدد العنوان العام في الإعداد.
- **معرفات WFS تتغير:** الجدول بلا مفتاح أساسي، فأضف مفتاحاً قبل النشر وفعل خيار Expose primary keys في المخزن.
- **البيانات تغيرت والخريطة لم تتغير:** الكاش، ففرغ طبقة المربعات في GeoWebCache بالطلب `truncate`، وكاش nginx بحذف ملفاته أو بمدة قصيرة في `proxy_cache_valid` للطبقات التي تتغير كثيراً.

## قائمة تحقق قبل النشر

- هل غيرت كلمة مرور GeoServer وحذفت البيانات التجريبية وأغلقت REST والواجهة عن الإنترنت؟
- هل الاتصال بقاعدة البيانات بمستخدم للقراءة فقط على الجداول المنشورة؟
- هل قست حجم المربع في أقل مستوى تقريب، وهو تحت 500 كيلوبايت؟
- هل الضغط مفعل للمربعات المتجهة وJSON، والكاش أمام Martin؟
- هل الخط العربي محمل فعلاً، وتحققت بمقارنة الصورة لا بالنظر فقط؟
- هل جهزت المستويات المنخفضة مسبقاً، وعندك طريقة لتفريغ الكاش بعد تحديث البيانات؟
- هل نسبة OpenStreetMap ظاهرة على الخريطة؟

## تنظيف المختبر

```bash
docker rm -f lab-gs-geoserver lab-gs-martin lab-gs-web lab-gs-pg
docker network rm lab-gs-net
docker image rm lab-gs-geoserver ghcr.io/maplibre/martin:1.16.1 nginx:1.29-alpine eclipse-temurin:21-jre-noble
```

## تدريب عملي

- اكتب دالة مثل `roads_z` للأحياء تبسط الحدود في المستويات المنخفضة بالدالة `ST_SimplifyPreserveTopology`، وقس حجم المربع في المستوى 10 قبل وبعد.
- انشر طبقة الصيدليات في GeoServer بتنسيق SLD يرسم دائرة خضراء، ثم افتح رابط WMS نفسه في QGIS من قائمة طبقات WMS، وقارن ما تراه بما يعرضه MapLibre.

## الخلاصة

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

- لا ترسل الطبقة كاملة إلى المتصفح، فطرق المدينة كانت 40 ميغابايت بخدمة WFS، وأرسل ما يظهر فقط كصورة أو كمربعات.
- GeoServer ينشر جداول PostGIS بمعايير WMS وWFS وWMTS من REST API، والتنسيق بملفات SLD صغر الصورة من 620 إلى 205 كيلوبايت، والخط العربي يحتاج اسمه الكامل وإلا رجع بصمت إلى خط آخر.
- GeoWebCache جعل المربع الثاني أسرع 37 مرة، والتبليط الكبير يقلل تكرار الأسماء، والتجهيز المسبق للمستويات 10 إلى 14 أخذ دقيقتين و32 ميغابايت.
- Martin يقدم مربعات متجهة من PostGIS بـ 31 ميغابايت من الذاكرة، ولكن الجدول دون ترشيح أعطى مربعاً من 2 ميغابايت، والدالة بحسب مستوى التقريب صغرته 23 مرة.
- nginx أمام الاثنين يقدم كل شيء من نطاق واحد، ويخزن مربعات Martin، ويضغط ما لا يضغطه GeoServer.
- الشاشة نفسها احتاجت 178 كيلوبايت بالمربعات المتجهة مقابل 1.85 ميغابايت بصور WMS، والأسماء العربية ظهرت مرة واحدة لكل حي لأن المتصفح يضعها على مستوى الشاشة كلها.
- قرر مدة الكاش لكل طبقة بحسب سرعة تغيرها، فالأحياء تبقى أشهراً والفروع دقائق، وضع رقم الإصدار في رابط المربعات للبيانات التي تنشر دفعة واحدة.

[![](https://arabroot.io/content/images/2026/11/gis-postgis-cover-cover.webp)دليلالبيانات الجغرافية GIS في PostgreSQL مع PostGISكيف تخزن الأحياء والطرق والفروع في PostgreSQL وتسألها بالمتر الصحيح وبفهرس يعمل فعلاً، بمختبر على بيانات OpenStreetMap لمدينة كاملة.](https://arabroot.io/articles/%D8%A7%D9%84%D8%A8%D9%8A%D8%A7%D9%86%D8%A7%D8%AA-%D8%A7%D9%84%D8%AC%D8%BA%D8%B1%D8%A7%D9%81%D9%8A%D8%A9-gis-%D9%81%D9%8A-postgresql-%D9%85%D8%B9-postgis/)[![](https://arabroot.io/content/images/2026/11/spatial-analysis-cover-cover.webp)دليلالتحليل المكاني Spatial Analysis: أقرب فرع والتغطيةكيف تحسب بالأرقام أقرب فرع لكل عميل وكم شخصاً يغطي كل فرع على الطريق لا بالخط المستقيم، بأدوات PostGIS وpgRouting وبيانات سكان مفتوحة.](https://arabroot.io/articles/%D8%A7%D9%84%D8%AA%D8%AD%D9%84%D9%8A%D9%84-%D8%A7%D9%84%D9%85%D9%83%D8%A7%D9%86%D9%8A-spatial-analysis-%D8%A7%D9%82%D8%B1%D8%A8-%D9%81%D8%B1%D8%B9-%D9%88%D8%A7%D9%84%D8%AA%D8%BA%D8%B7%D9%8A%D8%A9/)[![](https://arabroot.io/content/images/2026/10/self-hosted-maps-cover-cover.webp)دليلخرائطك على سيرفرك مع OpenStreetMap وMapLibreكيف تعرض خريطة تفاعلية لمدينتك من سيرفرك ببيانات OpenStreetMap، بالعربية والإنجليزية ودون مفتاح API أو مزود خارجي.](https://arabroot.io/articles/%D8%AE%D8%B1%D8%A7%D8%A6%D8%B7%D9%83-%D8%B9%D9%84%D9%89-%D8%B3%D9%8A%D8%B1%D9%81%D8%B1%D9%83-%D9%85%D8%B9-openstreetmap-%D9%88-maplibre/)[![](https://arabroot.io/content/images/2026/11/qgis-basics-cover-cover.webp)دليلQGIS للمبتدئين: الطبقات Layers والتحليل المكانيكيف تحول جدول مواقع إلى طبقة على الخريطة في QGIS، وتربطها بالمناطق وتحسب النطاقات بالأمتار الصحيحة، ثم تعيد التحليل كله بأمر واحد.](https://arabroot.io/articles/qgis-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86-%D8%A7%D9%84%D8%B7%D8%A8%D9%82%D8%A7%D8%AA-layers-%D9%88%D8%A7%D9%84%D8%AA%D8%AD%D9%84%D9%8A%D9%84-%D8%A7%D9%84%D9%85%D9%83%D8%A7%D9%86%D9%8A/)[![](https://arabroot.io/content/images/2026/11/coordinate-systems-cover-cover.webp)دليلالمرجع الجيوديسي Datum: لماذا تنحرف نقطتك مئات الأمتار؟لماذا تقع نفس الإحداثيات في مكانين بينهما مئة متر، وكيف تحول بين Ain el Abd وKSA-GRF17 وWGS 84 ومناطق UTM دون أن تنقل بياناتك إلى المكان الخطأ.](https://arabroot.io/articles/%D8%A7%D9%84%D9%85%D8%B1%D8%AC%D8%B9-%D8%A7%D9%84%D8%AC%D9%8A%D9%88%D8%AF%D9%8A%D8%B3%D9%8A-datum-%D9%84%D9%85%D8%A7%D8%B0%D8%A7-%D8%AA%D9%86%D8%AD%D8%B1%D9%81-%D9%86%D9%82%D8%B7%D8%AA%D9%83-%D9%85%D8%A6%D8%A7%D8%AA-%D8%A7%D9%84%D8%A7%D9%85%D8%AA%D8%A7%D8%B1/)[![](https://arabroot.io/content/images/2026/10/maps-basics-cover-cover.webp)دليلكيف تعمل الخرائط الرقمية؟ الإحداثيات والمربعات Tilesكيف تتحول خطوط العرض والطول إلى مربعات يرسمها المتصفح، ولماذا تبدو جرينلاند بحجم قارة، وكيف تحسب المسافة بين مدينتين بشكل صحيح.](https://arabroot.io/articles/%D9%83%D9%8A%D9%81-%D8%AA%D8%B9%D9%85%D9%84-%D8%A7%D9%84%D8%AE%D8%B1%D8%A7%D8%A6%D8%B7-%D8%A7%D9%84%D8%B1%D9%82%D9%85%D9%8A%D8%A9/)[![](https://arabroot.io/content/images/2026/10/cdn-basics-cover-cover.webp)دليلكيف تعمل شبكة توصيل المحتوى CDN وما الذي تحفظهلماذا يبطؤ موقعك على الزائر البعيد، وكيف تقرب شبكة CDN ملفاتك منه، وكيف تمنعها من حفظ الصفحات الخاصة.](https://arabroot.io/articles/%D8%B4%D8%A8%D9%83%D8%A9-%D8%AA%D9%88%D8%B5%D9%8A%D9%84-%D8%A7%D9%84%D9%85%D8%AD%D8%AA%D9%88%D9%89-cdn-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86/)[![](https://arabroot.io/content/images/2026/10/behind-proxy-cover-cover.webp)دليلكيف يرى تطبيقك عنوان الزائر الحقيقي خلف ال Reverse Proxyإذا كان تطبيقك يرى عنوان ال Proxy بدلاً من الزائر أو يولد روابط http، فهذا هو السبب والإعداد الصحيح لإطار عملك.](https://arabroot.io/articles/%D8%AA%D8%B7%D8%A8%D9%8A%D9%82%D9%83-%D8%AE%D9%84%D9%81-reverse-proxy/)

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

- 16 نوفمبر 2026: كتابة المقال وتنفيذ المختبر على GeoServer 3.0.2 (GeoTools 35.2 وGeoWebCache 2.0.2) مع إضافة Vector Tiles على Eclipse Temurin 21، وMartin 1.16.1، وPostgreSQL 18.7 مع PostGIS 3.7.0، وnginx 1.29.8، وMapLibre GL JS 6.13.0، وبيانات OpenStreetMap من Geofabrik بتاريخ 15 نوفمبر 2026.