🗺️ انتشار نقشه و API
کاشی برداری، OGC API، WMS/WFS، نقشه قابل اشتراک و REST API
-
«انتشار لایه» چیست و چطور جدولم را برای وب‌سایت و برنامه در دسترس قرار دهم؟
در بخش «انتشار» هر جدول مکانی را با یک کلیک به لایه وب تبدیل کنید. لایه منتشرشده آدرس‌های آماده دارد: تایل برداری برای نقشه، OGC API Features و REST برای داده، و نقشه عمومی قابل‌جاسازی. لایه عمومی یا خصوصی (با…
-
لایه عمومی با لایه خصوصی چه فرقی دارد؟
لایه عمومی بدون کلید برای همه قابل‌خواندن است. لایه خصوصی فقط با کلید API خوانده می‌شود. به‌طور پیش‌فرض لایه خصوصی است؛ فقط داده‌ای را عمومی کنید که می‌خواهید همه ببینند.
-
آدرس تایل برداری لایه منتشرشده چیست و چطور در نقشه‌ام استفاده کنم؟
هر لایه دو آدرس دارد: TileJSON در /tiles/نام-لایه.json و تایل‌ها در /tiles/نام-لایه/{z}/{x}/{y}.pbf. این آدرس‌ها را در MapLibre، OpenLayers یا QGIS به‌عنوان منبع برداری بدهید.
-
تایل برداری بهتر است یا GeoJSON؟
برای لایه‌های بزرگ یا نقشه عمومی، تایل برداری بهتر است چون فقط بخش قابل‌دیدن را می‌فرستد. GeoJSON برای تعداد کم عارضه (چند صد تا) و پردازش در برنامه ساده‌تر است.
-
OGC API Features چیست و چطور در QGIS یا برنامه‌ام استفاده کنم؟
استاندارد جدید OGC برای خواندن عارضه‌ها با JSON ساده. آدرس پایه /ogc/نام-لایه/ است و فهرست مجموعه‌ها در /collections و عارضه‌ها در /collections/آی‌دی/items. QGIS آن را به‌عنوان لایه «OGC API - Features» باز می…
-
کلید API چیست و چطور بسازم و بفرستم؟
کلید API با gpk_ شروع می‌شود و دسترسی به لایه‌های خصوصی را می‌دهد. در صفحه انتشار بسازید (فقط یک بار کامل دیده می‌شود) و با Authorization: Bearer، Basic، هدر X-API-Key یا پارامتر ?key= بفرستید.
-
کلید API را چطور امن نگه دارم؟ (آیا می‌شود در کد وب‌سایت گذاشت؟)
هر چیزی در جاوااسکریپت مرورگر قابل‌دیدن است؛ پس کلیدی که در صفحه وب می‌گذارید برای همه آشکار است. برای نقشه عمومی از لایه عمومی استفاده کنید و کلید را فقط در سرور نگه دارید. کلید لورفته را فوراً باطل کنید.
-
سقف درخواست روزانه لایه‌های منتشرشده چقدر است؟
هر پلن سقف درخواست روزانه برای کل لایه‌های منتشرشده دارد؛ پلن شما {{plan_daily_requests}} درخواست در روز است. بعد از سقف تا روز بعد خطای محدودیت می‌گیرید. میزان مصرف را در صفحه انتشار می‌بینید.
-
چطور از لایه‌ام نقشه قابل‌اشتراک و iframe بسازم؟
در صفحه انتشار برای هر لایه «نقشه‌ساز» را باز کنید: رنگ و سبک را تنظیم کنید و لینک نقشه عمومی (/m/نام) یا کد iframe را بردارید. لینک جاسازی در /m/نام/embed/ است. برخی پلن‌ها در گوشه نقشه نشان سایت را نمایش می…
-
نقشه چندلایه چیست و چطور چند جدول را روی یک نقشه بیاورم؟
در «نقشه‌های چندلایه» چند جدول مکانی پایگاه داده را روی یک نقشه می‌گذارید، برای هر لایه سبک جدا می‌دهید و لینک یا iframe می‌گیرید. «نمایش با هم» بدون ذخیره تا ۱۰ جدول را کنار هم نشان می‌دهد.
-
چطور رنگ و سبک هر لایه را در نقشه چندلایه تنظیم کنم؟
در صفحه ساخت نقشه برای هر لایه رنگ، اندازه، شفافیت، برچسب و ستون‌های پنجره اطلاعات را جدا بدهید؛ ترتیب لایه‌ها با کشیدن عوض می‌شود و نمای شروع نقشه قابل ذخیره است.
-
لایه‌ام روی نقشه دیده نمی‌شود؛ چطور پیدایش کنم؟
در نقشه چندلایه هر لایه ⌖ دارد که شما را به محدوده آن می‌برد. لایه روشنی که در نمای فعلی نیست نشان «بیرون از دید» با پیکان جهت می‌گیرد و دکمه ⤢ همه لایه‌ها را یک‌جا نشان می‌دهد. چندضلعی و خط ریز در زوم دور به…
-
چطور نقشه چندلایه را با لینک یا iframe به اشتراک بگذارم؟
نقشه را «عمومی» کنید؛ صفحه نقشه در /maps/نام/ و نسخه جاسازی در /maps/نام/embed/ باز می‌شود. بیننده لایه‌ها را روشن و خاموش می‌کند. نقشه خصوصی را فقط خودتان می‌بینید.
-
چطور روی نقشه نمودار بسازم؟
در تب «نمودارها» صفحه نقشه، از داده‌های یک لایه کارت عددی، میله‌ای، دایره‌ای، هیستوگرام یا سری زمانی بسازید. تجمیع در PostGIS انجام می‌شود، روی ردیف یا ستون نمودار بزنید تا عارضه‌هایش روی نقشه برجسته شود، و نم…
-
چطور از نقشه اسلاید بسازم و ارائه بدهم؟
در صفحه نقشه با «افزودن اسلاید» نمای فعلی و لایه‌های روشن را ذخیره کنید (تا ۳۰ اسلاید). «اجرای ارائه» با کلیدهای جهت‌دار نقشه را از اسلایدی به اسلاید بعد می‌برد؛ صفحه ارائه برای نقشه عمومی بدون ورود باز است.
-
چطور از نقشه چندلایه PDF یا تصویر PNG چاپی بگیرم؟
از «اشتراک و خروجی ← چاپ، PDF و PNG» اندازه کاغذ، جهت، عنوان و راهنمای نقشه را تنظیم کنید و PDF یا PNG بگیرید. خروجی شامل راهنمای لایه‌ها، پیکان شمال و ذکر منبع نقشه پایه است.
-
چطور دو لایه را با پرده کشویی مقایسه کنم؟
در «اشتراک و خروجی ← مقایسه دو لایه» دو لایه را انتخاب کنید و پرده را بکشید تا لایه چپ و راست روی هم دیده شود؛ برای مقایسه قبل و بعد، دو دوره، یا دو سبک. صفحه مقایسه برای نقشه عمومی با لینک باز است.
-
چطور نقشه چندلایه را در QGIS باز کنم یا به‌صورت WMS/WFS منتشر کنم؟
«دانلود پروژه QGIS» فایل .qgs با همان لایه‌ها و رنگ‌ها را بدون رمز می‌دهد؛ QGIS بار اول رمز پایگاه داده را می‌پرسد. «انتشار به‌صورت WMS/WFS» همین نقشه را با یک کلیک سرویس OGC می‌کند و از سقف پروژه WMS/WFS پلن …
-
سقف نقشه چندلایه در هر پلن چقدر است؟
تعداد نقشه چندلایه و تعداد لایه در هر نقشه به پلن بستگی دارد. با رسیدن به سقف، پیام «پلن شما حداکثر … دارد» می‌آید؛ یک نقشه یا لایه را حذف کنید یا پلن را ارتقا دهید. «نمایش با هم» سقف نقشه ندارد، ولی حداکثر ۱۰…
-
چطور پروژه QGIS را به‌صورت WMS/WFS منتشر کنم؟
فایل پروژه QGIS (qgz/qgs) را در بخش «سرویس OGC» آپلود کنید یا از پروژه ذخیره‌شده در پایگاه داده وارد کنید. سایت آدرس /ows/نام/ را برای WMS و (اگر فعال باشد) WFS می‌دهد. هشدارهای لایه‌های ناسازگار نمایش داده می…
-
REST API جدول‌ها چیست و چطور فیلتر کنم؟
آدرس /rest/نام-سرویس/نام-جدول/ ردیف‌ها را به‌صورت JSON برمی‌گرداند. با limit (پیش‌فرض ۱۰۰، حداکثر ۱۰۰۰)، offset، order، bbox و فیلتر ستونی مثل col__gt=5 نتیجه را محدود کنید.
-
چطور از REST API ردیف اضافه یا ویرایش کنم؟
فقط کلیدی که مجوز «نوشتن» دارد می‌تواند ردیف بسازد، ویرایش یا حذف کند. جدول باید در REST فعال و نوشتن برای آن مجاز باشد. کلید نوشتن را فقط در سرور خودتان نگه دارید.
-
«فرم میدانی» چیست و چطور داده را با موبایل جمع‌آوری کنم؟
صفحه فرمی روی /f/نام/ که کاربران بدون ورود می‌توانند نقطه روی نقشه بگذارند و ویژگی‌ها را پر کنند؛ داده مستقیم به جدول شما می‌رود. روی موبایل مثل برنامه نصب می‌شود.
-
نمونه کد MapLibre برای نمایش لایه منتشرشده
منبع vector با آدرس TileJSON لایه بسازید و یک لایه fill، line یا circle با source-layer هم‌نام لایه اضافه کنید. برای لایه خصوصی کلید را به آدرس بیفزایید.
-
نمونه کد Leaflet و OpenLayers برای خواندن لایه منتشرشده
Leaflet با GeoJSON از OGC API (برای تعداد کم عارضه) کار می‌کند؛ OpenLayers تایل برداری را مستقیم می‌خواند. برای حجم زیاد از تایل برداری استفاده کنید.