GDAL-VECTOR-INDEX(1) GDAL GDAL-VECTOR-INDEX(1)

gdal-vector-index - ایجاد نمایه برداری از مجموعه‌داده‌های برداری

افزوده‌شده در نسخه 3.12.

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

دستور gdal vector index یک مجموعه‌داده برداری ایجاد می‌کند که شامل یک رکورد به ازای هر فایل برداری ورودی، یک ویژگی حاوی نام فایل (همراه با کاما و نمایه لایه در مجموعه‌داده به عنوان پسوند) و یک هندسه چندضلعی است که محدوده (مستطیلی) آن را مشخص می‌کند. این خروجی برای استفاده با MapServer به عنوان نمایه تایل برداری مناسب است.

مسیر مطلق فایل‌های برداری در فایل نمایه ذخیره می‌شود. به‌طور پیش‌فرض، نام فایل‌های برداری دقیقاً همان‌گونه که در خط فرمان مشخص شده‌اند، در فایل قرار می‌گیرند.
آیا لایه‌ها با سیستم مرجع مختصات (CRS) متفاوت پذیرفته شوند یا خیر. به‌طور پیش‌فرض، مگر اینکه --output-crs مشخص شده باشد، لایه‌هایی که CRS یکسانی با اولین لایه نمایه ندارند، نادیده گرفته می‌شوند. تنظیم گزینه --accept-different-crs می‌تواند برای دور زدن بررسی سازگاری CRS مفید باشد.
آیا لایه‌ها با طرح‌واره‌های (schemas) متفاوت پذیرفته شوند یا خیر. به‌طور پیش‌فرض، لایه‌هایی که طرح‌واره یکسانی با اولین لایه نمایه ندارند، نادیده گرفته می‌شوند.
آیا تنها نام مجموعه‌داده نوشته شود، به‌جای آنکه پسوند نمایه لایه به آن افزوده گردد.

هشدار:

تنظیم این گزینه مکانی را ایجاد می‌کند که با MapServer سازگار نیست.
الگویی که نام فایل‌های موجود در پوشه‌های ورودی باید از آن پیروی کنند. کاراکتر '*' یک نویسه عمومی (wildcard) است که با هر تعداد نویسه از جمله تهی مطابقت دارد. کاراکتر '?' یک نویسه عمومی است که با یک نویسه منفرد مطابقت می‌یابد. مقایسه‌ها بدون توجه به بزرگی و کوچکی حروف (case-insensitive) انجام می‌شوند. می‌توان چندین فیلتر را مشخص کرد.

برای نمونه: --filename-filter "*.shp,*.gpkg"

نام فیلد خروجی برای نگه‌داری مسیر فایل/موقعیت مکانی بردارهای نمایه‌شده. نام فیلد پیش‌فرض location است.
نوشتن یک قلم دلخواه از متادیتای لایه، برای قالب‌هایی که از متادیتای لایه پشتیبانی می‌کنند. این گزینه تکرارپذیر است.
محدوده‌های پوشش فایل‌های ورودی به سیستم مرجع مختصات هدف تبدیل خواهند شد. حالت پیش‌فرض، چندضلعی‌های مستطیلی ساده‌ای در همان سیستم مرجع مختصات بردارهای ورودی ایجاد می‌کند.
آیا پوشه‌های ورودی باید به‌صورت بازگشتی بررسی و پیمایش شوند یا خیر.
نام فیلدی برای ذخیره CRS هر تایل. این نام فیلد می‌تواند به عنوان مقدار کلیدواژه TILESRS در MapServer استفاده شود.
قالبی که CRS هر تایل باید بر اساس آن نوشته شود. انواع مجاز عبارتند از auto، WKT، EPSG و PROJ. این گزینه باید همراه با --source-crs-field-name استفاده شود.
افزودن لایه با نام مشخص‌شده از هر فایل مبدأ در نمایه تایل [تکرارپذیر]. اگر هیچ‌کدام از گزینه‌های --source-layer-name یا --source-layer-index مشخص نشود، تمام لایه‌ها اضافه خواهند شد.
افزودن لایه با نمایه مشخص‌شده (مبتنی بر صفر) از هر فایل مبدأ در نمایه تایل [تکرارپذیر].

آیا الحاق عارضه‌ها (features) به لایه(های) موجود مجاز است یا خیر. این گزینه همچنین در صورت عدم وجود مجموعه‌داده خروجی، آن را ایجاد می‌کند.
بسیاری از قالب‌ها یک یا چند گزینه اختیاری ایجاد مجموعه‌داده دارند که می‌توانند برای کنترل جزئیات فایل ایجادشده استفاده شوند. برای نمونه، درایور GeoPackage از گزینه‌های ایجاد برای کنترل نسخه پشتیبانی می‌کند.

تکرارپذیر است.

گزینه‌های ایجاد مجموعه‌داده موجود بسته به درایور قالب متفاوت است و برخی قالب‌های ساده اصلاً هیچ گزینه ایجادی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان --formats مشاهده کرد، اما مستندات مربوط به همان قالب مرجع اصلی اطلاعات درباره گزینه‌های ایجاد درایور است. برای مشاهده گزینه‌های ایجاد مجاز برای هر قالب، به مستندات اختصاصی قالب درایورهای برداری (Vector drivers) مراجعه کنید.

توجه داشته باشید که گزینه‌های ایجاد مجموعه‌داده با گزینه‌های ایجاد لایه تفاوت دارند.

بسیاری از قالب‌ها یک یا چند گزینه اختیاری ایجاد لایه دارند که می‌توانند برای کنترل جزئیات لایه ایجادشده استفاده شوند. برای نمونه، درایور GeoPackage از گزینه‌های ایجاد لایه برای کنترل شناسه عارضه یا نام ستون هندسه، تنظیم شناسه یا توضیحات و غیره پشتیبانی می‌کند.

تکرارپذیر است.

گزینه‌های ایجاد لایه موجود بسته به درایور قالب متفاوت است و برخی قالب‌های ساده اصلاً هیچ گزینه ایجاد لایه‌ای ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان --formats مشاهده کرد، اما مستندات مربوط به همان قالب مرجع اصلی اطلاعات درباره گزینه‌های ایجاد درایور است. برای مشاهده گزینه‌های ایجاد مجاز برای هر قالب، به مستندات اختصاصی قالب درایورهای برداری (Vector drivers) مراجعه کنید.

توجه داشته باشید که گزینه‌های ایجاد لایه با گزینه‌های ایجاد مجموعه‌داده تفاوت دارند.

تعیین قالب برداری خروجی. مقادیر مجاز را می‌توان با دستور زیر مشاهده کرد: gdal --formats | grep vector | grep rw | sort
تعیین نام برای لایه برداری خروجی.
اجازه به برنامه برای بازنویسی فایل یا مجموعه‌داده مقصد موجود. در غیر این صورت، به‌طور پیش‌فرض، اگر فایل یا مجموعه‌داده مقصد از قبل موجود باشد، gdal با خطا خارج می‌شود.
--overwrite-layer
آیا بازنویسی لایه برداری خروجی موجود مجاز است یا خیر.
آیا مجموعه‌داده خروجی موجود در حالت به‌روزرسانی باز شود یا خیر.

برنامه در صورت موفقیت کد وضعیت ۰ و در صورت بروز خطا کد غیر صفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، به عنوان اجرای موفق در نظر گرفته می‌شوند).

تولید یک 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

Even Rouault <even.rouault@spatialys.com>

1998-2026

August 18, 2026