| GDAL-VECTOR-INDEX(1) | GDAL | GDAL-VECTOR-INDEX(1) |
نام (NAME)
gdal-vector-index - ایجاد نمایه برداری از مجموعهدادههای برداری
افزودهشده در نسخه 3.12.
خلاصه دستور (SYNOPSIS)
نحوه استفاده: gdal vector index [OPTIONS] <INPUT>... <OUTPUT>
ایجاد نمایه برداری از مجموعهدادههای برداری.
آرگومانهای موضعی (Positional arguments):
-i, --input <INPUT> مجموعهدادههای برداری ورودی [تکرارپذیر] [الزامی]
-o, --output <OUTPUT> مجموعهداده برداری خروجی [الزامی]
گزینههای عمومی (Common Options):
-h, --help نمایش پیام راهنما و خروج
--json-usage نمایش نحوه استفاده بهصورت سند JSON و خروج
--config <KEY>=<VALUE> گزینه پیکربندی [تکرارپذیر]
-q, --quiet حالت بیصدا (بدون نوار پیشرفت یا پیام هشدار) [در خطوط لوله در دسترس نیست]
گزینهها (Options):
-f, --of, --format, --output-format <OUTPUT-FORMAT> قالب خروجی
--co, --creation-option <KEY>=<VALUE> گزینه ایجاد [تکرارپذیر]
--lco, --layer-creation-option <KEY>=<VALUE> گزینه ایجاد لایه [تکرارپذیر]
--overwrite آیا بازنویسی مجموعهداده خروجی موجود مجاز است
ناسازگار با --update
--update آیا مجموعهداده موجود در حالت بهروزرسانی باز شود
ناسازگار با --overwrite
--overwrite-layer آیا بازنویسی لایه خروجی موجود مجاز است
--append آیا الحاق به لایه موجود مجاز است
--nln, --output-layer <OUTPUT-LAYER> نام لایه خروجی
--recursive آیا پوشههای ورودی بهصورت بازگشتی پیمایش شوند
--filename-filter <FILENAME-FILTER> الگویی که نام فایلها در پوشههای ورودی باید از آن پیروی کنند (نویسههای عمومی '*' و '?') [تکرارپذیر]
--location-name <LOCATION-NAME> نام فیلد حاوی مسیر بردار (پیشفرض: location)
--absolute-path آیا مسیر مجموعهدادههای ورودی بهصورت یک مسیر مطلق ذخیره شود
--output-crs <OUTPUT-CRS> سیستم مرجع مختصات (CRS) خروجی
--metadata <KEY>=<VALUE> افزودن متادیتای مجموعهداده [تکرارپذیر]
--source-crs-field-name <SOURCE-CRS-FIELD-NAME> نام فیلد برای ذخیره CRS هر مجموعهداده
--source-crs-format <SOURCE-CRS-FORMAT> قالبی که CRS هر مجموعهداده باید در آن نوشته شود. SOURCE-CRS-FORMAT=auto|WKT|EPSG|PROJ (پیشفرض: auto)
--source-layer-name <SOURCE-LAYER-NAME> افزودن لایه با نام مشخصشده از هر فایل مبدأ در نمایه تایل [تکرارپذیر]
--source-layer-index <SOURCE-LAYER-INDEX> افزودن لایه با نمایه مشخصشده (مبتنی بر صفر) از هر فایل مبدأ در نمایه تایل [تکرارپذیر]
--accept-different-crs آیا لایهها با CRSهای متفاوت پذیرفته شوند
--accept-different-schemas آیا لایهها با طرحوارههای (schemas) متفاوت پذیرفته شوند
--dataset-name-only آیا فقط نام مجموعهداده نوشته شود، به جای اینکه پسوند نمایه لایه به آن اضافه گردد
توضیحات (DESCRIPTION)
دستور gdal vector index یک مجموعهداده برداری ایجاد میکند که شامل یک رکورد به ازای هر فایل برداری ورودی، یک ویژگی حاوی نام فایل (همراه با کاما و نمایه لایه در مجموعهداده به عنوان پسوند) و یک هندسه چندضلعی است که محدوده (مستطیلی) آن را مشخص میکند. این خروجی برای استفاده با MapServer به عنوان نمایه تایل برداری مناسب است.
گزینههای ویژه برنامه (PROGRAM-SPECIFIC OPTIONS)
- --absolute-path
- مسیر مطلق فایلهای برداری در فایل نمایه ذخیره میشود. بهطور پیشفرض، نام فایلهای برداری دقیقاً همانگونه که در خط فرمان مشخص شدهاند، در فایل قرار میگیرند.
- --accept-different-crs
- آیا لایهها با سیستم مرجع مختصات (CRS) متفاوت پذیرفته شوند یا خیر. بهطور پیشفرض، مگر اینکه --output-crs مشخص شده باشد، لایههایی که CRS یکسانی با اولین لایه نمایه ندارند، نادیده گرفته میشوند. تنظیم گزینه --accept-different-crs میتواند برای دور زدن بررسی سازگاری CRS مفید باشد.
- --accept-different-schemas
- آیا لایهها با طرحوارههای (schemas) متفاوت پذیرفته شوند یا خیر. بهطور پیشفرض، لایههایی که طرحواره یکسانی با اولین لایه نمایه ندارند، نادیده گرفته میشوند.
- --dataset-name-only
- آیا تنها
نام
مجموعهداده
نوشته شود،
بهجای
آنکه پسوند
نمایه لایه
به آن
افزوده
گردد.
هشدار:
- --filename-filter <FILENAME-FILTER>
- الگویی که
نام
فایلهای
موجود در
پوشههای
ورودی باید
از آن پیروی
کنند.
کاراکتر '*'
یک نویسه
عمومی (wildcard)
است که با
هر تعداد
نویسه از
جمله تهی
مطابقت
دارد.
کاراکتر '?'
یک نویسه
عمومی است
که با یک
نویسه
منفرد
مطابقت
مییابد.
مقایسهها
بدون توجه
به بزرگی و
کوچکی حروف
(case-insensitive) انجام
میشوند.
میتوان
چندین
فیلتر را
مشخص کرد.
برای نمونه: --filename-filter "*.shp,*.gpkg"
- --location-name <LOCATION-NAME>
- نام فیلد خروجی برای نگهداری مسیر فایل/موقعیت مکانی بردارهای نمایهشده. نام فیلد پیشفرض location است.
- --metadata <KEY>=<VALUE>
- نوشتن یک قلم دلخواه از متادیتای لایه، برای قالبهایی که از متادیتای لایه پشتیبانی میکنند. این گزینه تکرارپذیر است.
- --output-crs <OUTPUT-CRS>
- محدودههای پوشش فایلهای ورودی به سیستم مرجع مختصات هدف تبدیل خواهند شد. حالت پیشفرض، چندضلعیهای مستطیلی سادهای در همان سیستم مرجع مختصات بردارهای ورودی ایجاد میکند.
- --recursive
- آیا پوشههای ورودی باید بهصورت بازگشتی بررسی و پیمایش شوند یا خیر.
- --source-crs-field-name <SOURCE-CRS-FIELD-NAME>
- نام فیلدی برای ذخیره CRS هر تایل. این نام فیلد میتواند به عنوان مقدار کلیدواژه TILESRS در MapServer استفاده شود.
- --source-crs-format auto|WKT|EPSG|PROJ
- قالبی که CRS هر تایل باید بر اساس آن نوشته شود. انواع مجاز عبارتند از auto، WKT، EPSG و PROJ. این گزینه باید همراه با --source-crs-field-name استفاده شود.
- --source-layer-name <SOURCE-LAYER-NAME>
- افزودن لایه با نام مشخصشده از هر فایل مبدأ در نمایه تایل [تکرارپذیر]. اگر هیچکدام از گزینههای --source-layer-name یا --source-layer-index مشخص نشود، تمام لایهها اضافه خواهند شد.
- --source-layer-index <SOURCE-LAYER-INDEX>
- افزودن لایه با نمایه مشخصشده (مبتنی بر صفر) از هر فایل مبدأ در نمایه تایل [تکرارپذیر].
گزینههای استاندارد (STANDARD OPTIONS)
- --append
- آیا الحاق عارضهها (features) به لایه(های) موجود مجاز است یا خیر. این گزینه همچنین در صورت عدم وجود مجموعهداده خروجی، آن را ایجاد میکند.
- --co, --creation-option <NAME>=<VALUE>
- بسیاری از
قالبها یک
یا چند
گزینه
اختیاری
ایجاد
مجموعهداده
دارند که
میتوانند
برای کنترل
جزئیات
فایل
ایجادشده
استفاده
شوند. برای
نمونه،
درایور GeoPackage
از
گزینههای
ایجاد برای
کنترل نسخه
پشتیبانی
میکند.
تکرارپذیر است.
گزینههای ایجاد مجموعهداده موجود بسته به درایور قالب متفاوت است و برخی قالبهای ساده اصلاً هیچ گزینه ایجادی ندارند. فهرستی از گزینههای پشتیبانیشده برای یک قالب را میتوان با گزینه خط فرمان --formats مشاهده کرد، اما مستندات مربوط به همان قالب مرجع اصلی اطلاعات درباره گزینههای ایجاد درایور است. برای مشاهده گزینههای ایجاد مجاز برای هر قالب، به مستندات اختصاصی قالب درایورهای برداری (Vector drivers) مراجعه کنید.
توجه داشته باشید که گزینههای ایجاد مجموعهداده با گزینههای ایجاد لایه تفاوت دارند.
- --lco, --layer-creation-option <NAME>=<VALUE>
- بسیاری از
قالبها یک
یا چند
گزینه
اختیاری
ایجاد لایه
دارند که
میتوانند
برای کنترل
جزئیات
لایه
ایجادشده
استفاده
شوند. برای
نمونه،
درایور GeoPackage
از
گزینههای
ایجاد لایه
برای کنترل
شناسه
عارضه یا
نام ستون
هندسه،
تنظیم
شناسه یا
توضیحات و
غیره
پشتیبانی
میکند.
تکرارپذیر است.
گزینههای ایجاد لایه موجود بسته به درایور قالب متفاوت است و برخی قالبهای ساده اصلاً هیچ گزینه ایجاد لایهای ندارند. فهرستی از گزینههای پشتیبانیشده برای یک قالب را میتوان با گزینه خط فرمان --formats مشاهده کرد، اما مستندات مربوط به همان قالب مرجع اصلی اطلاعات درباره گزینههای ایجاد درایور است. برای مشاهده گزینههای ایجاد مجاز برای هر قالب، به مستندات اختصاصی قالب درایورهای برداری (Vector drivers) مراجعه کنید.
توجه داشته باشید که گزینههای ایجاد لایه با گزینههای ایجاد مجموعهداده تفاوت دارند.
- -f, --of, --format, --output-format <OUTPUT-FORMAT>
- تعیین قالب برداری خروجی. مقادیر مجاز را میتوان با دستور زیر مشاهده کرد: gdal --formats | grep vector | grep rw | sort
- --nln, --output-layer <LAYER>
- تعیین نام برای لایه برداری خروجی.
- --overwrite
- اجازه به برنامه برای بازنویسی فایل یا مجموعهداده مقصد موجود. در غیر این صورت، بهطور پیشفرض، اگر فایل یا مجموعهداده مقصد از قبل موجود باشد، gdal با خطا خارج میشود.
- --overwrite-layer
- آیا بازنویسی لایه برداری خروجی موجود مجاز است یا خیر.
- --update
- آیا مجموعهداده خروجی موجود در حالت بهروزرسانی باز شود یا خیر.
کد وضعیت بازگشتی (RETURN STATUS CODE)
برنامه در صورت موفقیت کد وضعیت ۰ و در صورت بروز خطا کد غیر صفر برمیگرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر میشوند، به عنوان اجرای موفق در نظر گرفته میشوند).
مثالها (EXAMPLES)
مثال ۱
تولید یک GeoPackage با یک رکورد برای هر لایهای که این ابزار در پوشه countries مییابد. هر رکورد حاوی اطلاعاتی است که به موقعیت مکانی هر فایل برداری ورودی اشاره میکند و همچنین دارای یک شکل هندسی مستطیل مرزی است که حدود آن را نشان میدهد:
gdal vector index countries/*.shp index.gpkg
مثال ۲
گزینه --output-crs همچنین میتواند برای تبدیل تمام محدودههای پوشش بردارهای ورودی به همان تصویر خروجی استفاده شود:
gdal vector index --output-crs EPSG:4326 --source-crs-field-name=src_srs countries/*.shp index.gpkg
نویسنده (AUTHOR)
Even Rouault <even.rouault@spatialys.com>
حق نشر (COPYRIGHT)
1998-2026
| August 18, 2026 |