| GDAL2TILES(1) | GDAL | GDAL2TILES(1) |
نام (NAME)
gdal2tiles - ایجاد دایرکتوری با کاشی‌های TMS، فایل‌های KML و نمایشگرهای وب ساده
خلاصه دستور (SYNOPSIS)
gdal2tiles [--help] [--help-general]
[--legacy]
[-p <profile>] [-r resampling] [-s <srs>] [-z <zoom>]
[-e] [-a nodata] [-v] [-q] [-h] [-k] [-n] [-u <url>]
[-w <webviewer>] [-t <title>] [-c <copyright>]
[--processes=<NB_PROCESSES>] [--mpi] [--xyz]
[--tilesize=<PIXELS>] --tiledriver=<DRIVER> [--tmscompatible]
[--excluded-values=<EXCLUDED_VALUES>]
[--excluded-values-pct-threshold=<EXCLUDED_VALUES_PCT_THRESHOLD>]
[--nodata-values-pct-threshold=<NODATA_VALUES_PCT_THRESHOLD>]
[-g <googlekey] [-b <bingkey>] <input_file> [<output_dir>] [<COMMON_OPTIONS>]
توضیحات (DESCRIPTION)
هشدار:
این ابزار دایرکتوری‌ای شامل کاشی‌های (tiles) کوچک و متادیتا، مطابق با مشخصات Tile Map Service متعلق به OSGeo تولید می‌کند. صفحات وب ساده با نمایشگرهای مبتنی بر Google Maps، OpenLayers و Leaflet نیز تولید می‌شوند - بنابراین هر کسی می‌تواند به‌راحتی نقشه‌های شما را به‌صورت برخط مرور کند و نیازی به نصب یا پیکربندی نرم‌افزارهای خاص (مانند MapServer) ندارید و نقشه با سرعت بسیار بالایی در مرورگر وب نمایش داده می‌شود. شما تنها نیاز دارید دایرکتوری تولیدشده را روی یک سرور وب بارگذاری کنید.
ابزار GDAL2Tiles همچنین در صورتی که نقشه ارائه‌شده از سیستم تصویر EPSG:4326 استفاده کند، متادیتای لازم را برای Google Earth (به‌صورت KML SuperOverlay) ایجاد می‌کند.
فایل‌های World و زمین‌مرجع‌سازی تعبیه‌شده در طول فرایند تولید کاشی استفاده می‌شوند، اما می‌توانید تصویری بدون زمین‌مرجع‌سازی مناسب را نیز منتشر کنید.
نکته:
نکته:
نکته:
نکته کاربردی:
ببینید: gdal raster tile
- --help
- نمایش این پیام راهنما و خروج
- --help-general
- نمایش پیام راهنمای مختصر برای گزینه‌های عمومی خط فرمان GDAL و خروج.
- --legacy
- اضافه‌شده
در نسخه 3.13.
اجبار به استفاده از پایه‌کد قدیمی (legacy). از GDAL 3.13، به‌طور پیش‌فرض gdal2tiles با استفاده از gdal raster tile پیاده‌سازی شده است.
- -p <PROFILE>, --profile=<PROFILE>
- پروفایل
برش کاشی
(mercator، geodetic، raster) -
پیش‌فرض 'mercator'
(سازگار با Google
Maps).
از GDAL 3.2، پروفایل‌های اضافی از طریق فایل‌های tms_XXXX.json موجود در دایرکتوری داده‌های GDAL در دسترس هستند (به شرطی که تمام سطوح بزرگ‌نمایی از مبدأ و ابعاد کاشی یکسان استفاده کنند و تفکیک‌پذیری بین سطوح متوالی با ضریب دو تغییر کند).
- -r <RESAMPLING>, --resampling=<RESAMPLING>
- روش بازنمونه‌برداری (average، near، bilinear، cubic، cubicspline، lanczos، mode، max، min، med، q1، q3) - پیش‌فرض 'average'.
- -s <SRS>, --s_srs=<SRS>
- سیستم مرجع مکانی مورد استفاده برای داده ورودی مبدأ.
- --xyz
- تولید
کاشی‌های XYZ
(استاندارد
OSM Slippy Map) به جای TMS.
در حالت
پیش‌فرض (TMS)،
کاشی‌های y=0
جنوبی‌ترین
کاشی‌ها
هستند، در
حالی که در
حالت XYZ (که
توسط OGC WMTS نیز
استفاده
می‌شود)،
کاشی‌های y=0
شمالی‌ترین
کاشی‌ها به
شمار
می‌روند.
اضافه‌شده در نسخه 3.1.
- -d, --tmscompatible
- هنگام استفاده از پروفایل geodetic، تفکیک‌پذیری پایه را 0.703125 یا ۲ کاشی در سطح بزرگ‌نمایی ۰ مشخص می‌کند.
- -z <ZOOM>, --zoom=<ZOOM>
- سطوح بزرگ‌نمایی برای رندر کردن (فرمت: '2-5'، '10-' یا '10').
- -e, --resume
- حالت ادامه (resume). تنها فایل‌های ناموجود را تولید می‌کند.
- -a <NODATA>, --srcnodata=<NODATA>
- مقداری در مجموعه‌داده ورودی که شفاف در نظر گرفته می‌شود. اگر مجموعه‌داده ورودی از قبل مقدار nodata وابسته داشته باشد، با مقدار مشخص‌شده جایگزین می‌شود.
- -v, --verbose
- تولید
خروجی
پرجزئیات
از فرایند
تولید کاشی.
از GDAL 3.7، این خروجی پرجزئیات از طریق شیء logging.getLogger("gdal2tiles") منتشر می‌شود.
- -x, --exclude
- مستثنی کردن کاشی‌های شفاف از مجموعه‌کاشی حاصل.
- -q, --quiet
- غیرفعال کردن پیام‌ها و وضعیت در stdout.
- --processes=<NB_PROCESSES>
- تعداد فرایندهای موازی مورد استفاده برای تولید کاشی، جهت افزایش سرعت محاسبات.
فرض می‌کند که توسط mpiexec اجرا شده است، موازی‌سازی MPI را فعال کرده و --processes را نادیده می‌گیرد. نیازمند یک محیط کاری MPI و بسته MPI برای پایتون (mpi4py) است. کاربر باید بر اساس میزان حافظه در هر گره و تعداد فرایندهای اجرا شده در هر گره، متغیر GDAL_CACHEMAX را روی اندازه حافظه موقت (cache) مناسبی برای هر فرایند تنظیم کند.
هشدار:
- --tilesize=<PIXELS>
- در نسخه 3.1
اضافه شد.
عرض و ارتفاع کاشی بر حسب پیکسل. مقدار پیش‌فرض 256 است.
- --tiledriver=<DRIVER>
- مشخص
می‌کند که
از کدام
درایور
خروجی برای
کاشی‌ها
استفاده
شود و فرمت
فایل
کاشی‌ها را
تعیین
می‌کند. در
حال حاضر PNG، WEBP
و JPEG (JPEG در GDAL 3.9
اضافه شد)
پشتیبانی
می‌شوند.
مقدار
پیش‌فرض PNG
است.
پیکربندی
اضافی برای
درایورهای
WEBP و JPEG در
ادامه
مستند شده
است.
در نسخه 3.6 اضافه شد.
- --excluded-values=<EXCLUDED_VALUES>
- چندتایی
مقادیر جدا
شده با کاما
(معمولاً
"R,G,B") که در
طول
بازنمونه‌برداری
(resampling) به عنوان
پیکسل‌های
مبدأ
مشارکت‌کننده
نادیده
گرفته
می‌شوند.
تعداد
مقادیر
درون
چندتایی
باید با
تعداد
باندها،
بدون
احتساب
باند آلفا،
یکسان باشد.
چندین
چندتایی از
مقادیر
مستثنی‌شده
را می‌توان
با استفاده
از نحو
"(R1,G1,B2),(R2,G2,B2)" مشخص
کرد. در حال
حاضر فقط
توسط Average در
نظر گرفته
می‌شود. این
مفهوم تا
حدی شبیه به
nodata/alpha است، اما
تفاوت اصلی
در این است
که هنگام
تعیین
اعتبار/تراکم
پیکسل هدف،
پیکسل‌های
منطبق بر
یکی از
چندتایی‌های
مقادیر
مستثنی‌شده
همچنان
معتبر در
نظر گرفته
می‌شوند.
در نسخه 3.9 اضافه شد.
- --excluded-values-pct-threshold=EXCLUDED_VALUES_PCT_THRESHOLD
- حداقل درصد
پیکسل‌های
مبدأ که
باید روی
یکی از --excluded-values
تنظیم شده
باشند تا
باعث شود
مقدار
مستثنی‌شده‌ای
که در میان
پیکسل‌های
مبدأ در
اکثریت
است، به
عنوان
مقدار
پیکسل هدف
استفاده
شود. مقدار
پیش‌فرض 50(%)
است.
در نسخه 3.9 اضافه شد.
- --nodata-values-pct-threshold=<NODATA_VALUES_PCT_THRESHOLD>
- حداقل درصد
پیکسل‌های
مبدأ که
باید روی nodata
(یا alpha=0 یا هر
روش دیگری
برای بیان
پیکسل شفاف)
باشند تا
مقدار
پیکسل هدف
شفاف شود.
مقدار
پیش‌فرض 100 (%)
است، به این
معنی که یک
پیکسل هدف
تنها در
صورتی شفاف
است که تمام
پیکسل‌های
مبدأ
مشارکت‌کننده
شفاف باشند.
فقط برای
بازنمونه‌برداری
average در نظر
گرفته
می‌شود.
در نسخه 3.9 اضافه شد.
- -h, --help
- نمایش پیام راهنما و خروج.
- --version
- نمایش شماره نسخه برنامه و خروج.
گزینه‌های KML (Google Earth)
گزینه‌ها برای فراداده SuperOverlay تولیدشده Google Earth
- -k, --force-kml
- تولید KML برای Google Earth - پیش‌فرض برای نمایه 'geodetic' و 'raster' در EPSG:4326. برای مجموعه‌داده‌ای با تصویرسازی (projection) متفاوت با احتیاط استفاده شود!
- -n, --no-kml
- جلوگیری از تولید خودکار فایل‌های KML برای EPSG:4326.
- -u <URL>, --url=<URL>
- نشانی URL که کاشی‌های تولیدشده قرار است در آن منتشر شوند.
گزینه‌های نمایشگر وب (Web viewer)
گزینه‌ها برای نمایشگرهای HTML تولیدشده به سبک Google Maps
- -w <WEBVIEWER>, --webviewer=<WEBVIEWER>
- نمایشگر وب برای تولید (all, google, openlayers, leaflet, mapml, none) - پیش‌فرض 'all' است.
- -t <TITLE>, --title=<TITLE>
- عنوان نقشه.
- -c <COPYRIGHT>, --copyright=<COPYRIGHT>
- حق نشر (کپی‌رایت) برای نقشه.
- -g <GOOGLEKEY>, --googlekey=<GOOGLEKEY>
- کلید API مربوط به Google Maps از https://developers.google.com/maps/get-started.
- -b <BINGKEY>, --bingkey=<BINGKEY>
- کلید API
مربوط به Bing Maps
از https://www.bingmapsportal.com
پشتیبانی از MapML در GDAL 3.2 اضافه شده است. هنگامی که --webviewer=mapml مشخص شود، --xyz و همچنین در صورت استفاده از --profile=geodetic، گزینه --tmscompatible به‌طور ضمنی اعمال می‌شوند.
پروفایل‌های زیر پشتیبانی می‌شوند:
- mercator: به طرح کاشی‌کاری OSMTILE در MapML نگاشت می‌شود
- geodetic: به طرح کاشی‌کاری WGS84 در MapML نگاشت می‌شود
- APSTILE: برگرفته از فایل داده tms_MapML_APSTILE.json
فایل MapML تولیدشده در پوشه خروجی mapml.mapml است.
گزینه‌های موجود عبارتند از:
- --mapml-template=<filename>
- نام فایل یک فایل قالب mapml که متغیرها در آن جایگزین خواهند شد. در صورت عدم تعیین، از فایل عمومی template_tiles.mapml موجود در منابع داده GDAL استفاده خواهد شد
گزینه --url نیز برای جایگزینی ${URL} در فایل قالب MapML استفاده می‌شود.
گزینه‌های WEBP
پشتیبانی از درایور کاشی WEBP در GDAL 3.6 اضافه شده است. این قابلیت با استفاده از --tiledriver=WEBP فعال می‌شود.
گزینه‌های پیکربندی زیر برای سفارشی‌سازی بیشتر خروجی WebP در دسترس هستند:
- --webp-quality=<QUALITY>
- شناسه QUALITY یک عدد صحیح بین 1-100 است. پیش‌فرض 75 است.
- --webp-lossless
- استفاده از فشرده‌سازی بدون‌اتلاف (lossless) در WEBP، پیش‌فرض اتلافی (lossy) است
نکته:
گزینه‌های JPEG
پشتیبانی از درایور کاشی JPEG در GDAL 3.9 اضافه شده است. این قابلیت با استفاده از --tiledriver=JPEG فعال می‌شود.
توجه داشته باشید که JPEG از شفافیت پشتیبانی نمی‌کند، از این رو کاشی‌های لبه در نواحی پوشش‌داده‌نشده توسط رستر مبدا، پیکسل‌های سیاه را نمایش خواهند داد.
گزینه‌های پیکربندی زیر برای سفارشی‌سازی بیشتر خروجی JPEG در دسترس هستند:
- ---jpeg-quality=JPEG_QUALITY
- شناسه QUALITY یک عدد صحیح بین 1-100 است. پیش‌فرض 75 است.
وضعیت خروج (EXIT STATUS)
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیر صفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، به عنوان اجرای موفقیت‌آمیز در نظر گرفته می‌شوند).
مثال‌ها (EXAMPLES)
مثال 1: مثال پایه
gdal2tiles --zoom=2-5 input.tif output_folder
مثال 2: تولید MapML
gdal2tiles --zoom=16-18 -w mapml -p APSTILE --url "https://example.com" input.tif output_folder
مثال 3: مثال MPI
mpiexec -n $NB_PROCESSES gdal2tiles --mpi --config GDAL_CACHEMAX 500 --zoom=2-5 input.tif output_folder
نویسندگان (AUTHORS)
Klokan Petr Pridal <klokan@klokan.cz>
کپی‌رایت و تکثیر (COPYRIGHT)
1998-2026
| August 18, 2026 |