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
              آیا تنها نام مجموعه‌داده نوشته شود، به‌جای آنکه پسوند نمایه لایه
              به آن افزوده گردد.

              هشدار:
                 تنظیم این گزینه مکانی را ایجاد می‌کند که با MapServer سازگار
                 نیست.

       --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           GDAL-VECTOR-INDEX(1)