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

- خدمة الخريطة WMS Web Map Service: معيار من OGC يطلب فيه الكلاينت صورة لمستطيل محدد بحجم محدد وطبقات محددة، فيرسمها السيرفر من البيانات ويعيدها PNG أو JPEG. والميزة أن الكلاينت لا يحتاج أي شيء غير عرض صورة، فيعمل في أي برنامج GIS قديم أو حديث، والعيب أن كل حركة للخريطة طلب رسم جديد، وأن اللغة والألوان ثابتة في الصورة.
- خدمة المعالم WFS Web Feature Service: معيار يعيد المعالم نفسها بأشكالها وخصائصها، بصيغ مثل GML وGeoJSON، مع ترشيح بالمكان وبالخصائص. وهذا ما تحتاجه عندما يريد الطرف الآخر البيانات لا صورتها، مثل محلل يحمل الأحياء إلى QGIS، ولكنه غير مناسب لعرض طبقة كبيرة في المتصفح.
- المربعات Tiles: الخريطة مقسمة إلى مربعات بعنوان
z/x/yكما شرحنا في كيف تعمل الخرائط الرقمية، والمربع يحسب مرة ويخزن ويقدم آلاف المرات. ومعيار OGC لها هو WMTS، والصيغة الأبسط التي يستخدمها الويب هي XYZ أو TMS. والمربع قد يكون صورة نقطية Raster Tile، أو مربعاً متجهاً بصيغة Mapbox Vector Tile واختصاراً MVT، فيه الخطوط والنقاط وأسماؤها، ويرسمه المتصفح بملف تنسيق.
وقد شرحنا في خرائطك على سيرفرك كيف تقدم خريطة أساسية Basemap كاملة من ملف PMTiles ثابت دون أي سيرفر خرائط، وهذا هو الحل الأنسب للخلفية التي لا تتغير إلا بتحديث شهري. أما هنا فنتحدث عن بياناتك أنت، التي تتغير في قاعدة البيانات كل يوم، وتريد أن يراها الناس بعد التغيير دون أن تعيد بناء ملف، وهذا هو دور سيرفر الخرائط.
GeoServer: ما الذي يفعله من الداخل؟
GeoServer سيرفر خرائط مفتوح المصدر برخصة GPL-2.0، مكتوب بلغة Java فوق مكتبة GeoTools، ويعمل منذ 2001، وهو التطبيق المرجعي لأغلب معايير OGC. والسلسلة 3.0 التي اختبرنا عليها هي أول إصدار رئيسي جديد منذ سنوات، وقد صدرت في يونيو 2026 بعد انتقال المشروع إلى Spring Framework 7 وJakarta EE مع واجهة إدارة جديدة، وتحتاج Java 17 أو 21. وداخله أربعة أجزاء يجب أن تعرفها قبل أن تشغله:
- الفهرس Catalog: مساحات العمل Workspaces، ومخازن البيانات Stores مثل اتصال PostGIS أو مجلد ملفات، والطبقات Layers التي تشير كل منها إلى جدول أو ملف، والمجموعات Layer Groups. وكل ذلك يحفظ كملفات XML في مجلد البيانات
data_dir، وهذا المجلد هو كل ما تحتاج نسخه احتياطياً. - التنسيق Styles: ملفات SLD، أي Styled Layer Descriptor، وهي معيار XML يقول كيف ترسم كل طبقة، مع قواعد بحسب الخصائص ومقياس الرسم.
- الخدمات Services: WMS وWFS وWCS للبيانات الشبكية وWMTS، كلها تقرأ من الفهرس نفسه، فأي طبقة تنشرها تظهر في كل الخدمات تلقائياً.
- الكاش GeoWebCache: مكتبة مدمجة تقسم الخريطة إلى مربعات وتحفظها على القرص، وتقدمها بمعايير WMTS وTMS، وسوف نقيسها بالتفصيل.
التشغيل من ملف الإصدار الرسمي
المشروع ينشر Docker Image رسمية في سجله الخاص docker.osgeo.org/geoserver، ونعرض هنا طريقة أخرى تعطيك تحكماً كاملاً بالإصدار والإضافات: ملف الإصدار الرسمي geoserver-3.0.2-bin.zip من صفحة الإصدارات، على Java 21 من Eclipse Temurin، مع إضافة المربعات المتجهة Vector Tiles من الإصدار نفسه. وهو الملف lab/Dockerfile.geoserver:
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 بعد دقيقة تقريباً:
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{"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، وهذا ما تحتاجه لتكرار الإعداد على أكثر من بيئة دون نقرات. نبدأ بمساحة عمل، ثم مخزن بيانات من نوع PostGIS بملف lab/store.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 بنفسه:
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
doneworkspace 201
store 201
districts 201
roads 201
pois 201والرمز 201 يعني Created. والآن نطلب أول خريطة بخدمة WMS: مربع من 30 كيلومتراً في شمال المدينة بالإسقاط 3857، بحجم 800 في 800 بكسل، للأحياء والطرق بالتنسيق الافتراضي، ونكرر الطلب ثلاث مرات:
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"; done200 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 ويرسم من جديد، والوقت نزل فقط لأن الاتصالات والصفحات أصبحت جاهزة. والنتيجة هي الصورة التالية:

ماذا يحدث داخل 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 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 بيضاء حوله. ونرفع الملفين ونجعلهما التنسيق الافتراضي للطبقتين:
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"create districts 201
assign districts 200
create roads 201
assign roads 200
200 204878 bytes 1.761886sالصورة نفسها أصبحت 205 كيلوبايت بدل 620، أي ثلث الحجم، لأن السيرفر لم يعد يرسم 60 ألف شارع سكني في هذا المقياس، والصورة التالية هي النتيجة:

الخط العربي: خطأ لا يظهر في الصورة
الأسماء العربية في الصورة أعلاه صحيحة ومتصلة الحروف، وهذا قد يجعلك تظن أن الخط الذي طلبناه في ملف SLD يعمل. ولكن الحقيقة أننا طلبنا الخط Noto Sans Arabic، وهو غير موجود في الـ Container، فرجع GeoServer بصمت إلى الخط الافتراضي للنظام DejaVu Sans، والذي يحتوي بالصدفة على الحروف العربية. وعلى نظام لا يحتوي خطه الافتراضي على العربية سوف تظهر مربعات فارغة بدل الأسماء، دون أي رسالة في السجلات. والحل أن تضع ملف الخط TTF داخل مجلد styles في مجلد البيانات، فيحمله GeoServer ويكتب ذلك في السجل:
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 -1INFO [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:
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.json200 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:

ونطلب المربع نفسه مرتين بمعيار WMTS بالملف lab/tile.sh، الذي يطبع حالة الكاش من الترويسة geowebcache-cache-result:
# 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 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 14061HTTP/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، والصورة التالية من الطريقة الأولى:

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

وفي القياس احتاجت الصفحة الأولى 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:
{"seedRequest": {"name": "city:base", "gridSetId": "EPSG:900913", "zoomStart": 10, "zoomStop": 14,
"format": "image/png", "type": "seed", "threadCount": 4}}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، والمخرج في منتصف العمل كان كما يلي:
{"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 التي وضعناها في Dockerfile تضيف صيغة application/vnd.mapbox-vector-tile إلى GeoWebCache، ونفعلها لكل طبقة بتعديل إعدادها عبر REST: نقرأ ملف XML للطبقة، ونضيف الصيغة إلى قائمة mimeFormats، ونعيده بالطلب PUT:
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 14061roads 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 من مشروع MapLibre، وهو سيرفر مكتوب بلغة Rust برخصة MIT أو Apache-2.0، يقرأ جداول PostGIS ودوالها ويقدمها كمربعات MVT، ويقدم ملفات PMTiles وMBTiles، والخطوط Fonts التي يحتاجها المتصفح لكتابة الأسماء. وكان يستخدم في المختبر نفسه 31 ميغابايت من الذاكرة. وهناك أداة مشابهة من Crunchy Data اسمها pg_tileserv، تقوم بالعمل نفسه على PostGIS بإعداد أقل، واخترنا Martin هنا لأنه يقدم الخطوط أيضاً.
والسر الذي يجعل هذه الأدوات صغيرة هو أن PostGIS نفسها تصنع المربع: الدالة ST_AsMVTGeom تحول الأشكال إلى إحداثيات المربع من 0 إلى 4096 وتقصها عند حدوده، والدالة ST_AsMVT تجمع الصفوف في مربع واحد بصيغة Protobuf، فلا يبقى على السيرفر إلا أن يكتب الاستعلام ويرسل البايتات.
ما الذي يوجد داخل المربع المتجه؟
حتى تفهم لماذا يتغير حجم المربع بهذا الشكل، انظر إلى ما تحدده مواصفة MVT: المربع ملف Protobuf فيه طبقة أو أكثر، ولكل طبقة اسم، مثل roads، وقائمة معالم Features، ولكل معلم نوع هندسي وخصائص. والإحداثيات لا تحفظ بخطوط الطول والعرض، وإنما بأرقام صحيحة داخل شبكة المربع، من 0 إلى 4096 في الإعداد المعتاد، وكل نقطة تحفظ كفرق عن النقطة السابقة بترميز صغير، فالخط القصير داخل مربع واحد يحتاج بايتات قليلة. والخصائص لا تكرر النص في كل معلم، وإنما يحفظ كل مفتاح وكل قيمة مرة واحدة في قاموس الطبقة، ويشير إليها كل معلم برقم، فاسم مثل residential يتكرر في آلاف الشوارع لكنه يحفظ مرة واحدة. وهذا يعني أن حجم المربع يعتمد أساساً على عدد النقاط فيه، فالمربع في المستوى 10 الذي يحتوي كل نقاط كل شوارع المدينة كبير مهما كانت الصيغة مضغوطة، والحل الوحيد هو تقليل ما يدخله، إما بحذف طبقات كما فعلنا، أو بتبسيط الأشكال، أو بالاثنين معاً.
وهذا أيضاً سبب أن المتصفح يحتاج ملف تنسيق وخطوطاً: المربع لا يقول بأي لون يرسم الطريق ولا بأي خط يكتب الاسم، وإنما يعطي البيانات فقط، والمتصفح يقرر كل شيء، فتستطيع أن تعرض المربعات نفسها بالعربية أو الإنجليزية، أو بنمط ليلي، دون أي تغيير على السيرفر.
الإعداد بملف YAML
الملف lab/martin.yaml ينشر جدولين وعرضاً View للصيدليات، ومجلد الخطوط:
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:
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{"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 ميغابايت
الآن نقيس حجم مربع الطرق في أربعة مستويات تقريب حول النقطة نفسها، مع الضغط ودونه:
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; doneroads 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:
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، ونقارن المصدرين:
functions:
roads_z:
schema: public
function: roads_z
minzoom: 0
maxzoom: 16roads 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 أصبح 42.5 كيلوبايت بدل 989، أي أصغر 23 مرة، وفي المستوى 15 الحجم نفسه لأن الدالة تعطي كل الطرق من المستوى 14. والقاعدة أن تقيس حجم المربع في أقل مستوى تقريب تعرضه قبل أي شيء آخر، وأن تبقي المربع تحت 500 كيلوبايت، وهو الحد الافتراضي الذي تفرضه أداة tippecanoe المعروفة لبناء المربعات، وما فوقه يجعل الخريطة بطيئة على الهاتف.
nginx أمام الاثنين: كاش وضغط ومسار واحد
المتصفح يجب ألا يتحدث مع GeoServer وMartin مباشرة، والسبب ثلاثة أمور: أن تقدم كل شيء من نطاق واحد فلا تحتاج إعدادات CORS، وأن تضع كاشاً أمام Martin لأن كاشه في الذاكرة يضيع مع كل إعادة تشغيل، وأن تضغط ما لا يضغطه GeoServer. والصورة التالية تبين المسار كاملاً:

وهو الملف lab/nginx.conf:
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 فله كاشه الخاص، ووضع كاش ثان أمامه يجعل تفريغ الكاش بعد تحديث البيانات في مكانين.
ونتحقق من الكاش والرابط بطلبين:
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{"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 بالإصدار 6.13.0 من ملفات على السيرفر نفسه، كما في مقال الخرائط على سيرفرك، وتعرض ثلاثة مصادر من Martin مع الخط العربي منه أيضاً. وهذا جزء التنسيق منها:
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. والصورة التالية هي الصفحة في المتصفح:

وعند فتح الصفحة طلب المتصفح من 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 دون تسجيل دخول، كما في إعلان المشروع، وأضافتها وكالة 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 ظاهرة على الخريطة؟
تنظيف المختبر
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، والأسماء العربية ظهرت مرة واحدة لكل حي لأن المتصفح يضعها على مستوى الشاشة كلها.
- قرر مدة الكاش لكل طبقة بحسب سرعة تغيرها، فالأحياء تبقى أشهراً والفروع دقائق، وضع رقم الإصدار في رابط المربعات للبيانات التي تنشر دفعة واحدة.
دليلالبيانات الجغرافية GIS في PostgreSQL مع PostGISكيف تخزن الأحياء والطرق والفروع في PostgreSQL وتسألها بالمتر الصحيح وبفهرس يعمل فعلاً، بمختبر على بيانات OpenStreetMap لمدينة كاملة.
دليلالتحليل المكاني Spatial Analysis: أقرب فرع والتغطيةكيف تحسب بالأرقام أقرب فرع لكل عميل وكم شخصاً يغطي كل فرع على الطريق لا بالخط المستقيم، بأدوات PostGIS وpgRouting وبيانات سكان مفتوحة.
دليلخرائطك على سيرفرك مع OpenStreetMap وMapLibreكيف تعرض خريطة تفاعلية لمدينتك من سيرفرك ببيانات OpenStreetMap، بالعربية والإنجليزية ودون مفتاح API أو مزود خارجي.
دليلQGIS للمبتدئين: الطبقات Layers والتحليل المكانيكيف تحول جدول مواقع إلى طبقة على الخريطة في QGIS، وتربطها بالمناطق وتحسب النطاقات بالأمتار الصحيحة، ثم تعيد التحليل كله بأمر واحد.
دليلالمرجع الجيوديسي Datum: لماذا تنحرف نقطتك مئات الأمتار؟لماذا تقع نفس الإحداثيات في مكانين بينهما مئة متر، وكيف تحول بين Ain el Abd وKSA-GRF17 وWGS 84 ومناطق UTM دون أن تنقل بياناتك إلى المكان الخطأ.
دليلكيف تعمل الخرائط الرقمية؟ الإحداثيات والمربعات Tilesكيف تتحول خطوط العرض والطول إلى مربعات يرسمها المتصفح، ولماذا تبدو جرينلاند بحجم قارة، وكيف تحسب المسافة بين مدينتين بشكل صحيح.
دليلكيف تعمل شبكة توصيل المحتوى CDN وما الذي تحفظهلماذا يبطؤ موقعك على الزائر البعيد، وكيف تقرب شبكة CDN ملفاتك منه، وكيف تمنعها من حفظ الصفحات الخاصة.
دليلكيف يرى تطبيقك عنوان الزائر الحقيقي خلف ال Reverse Proxyإذا كان تطبيقك يرى عنوان ال Proxy بدلاً من الزائر أو يولد روابط http، فهذا هو السبب والإعداد الصحيح لإطار عملك.سجل التحديثات
- 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.