.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "GDAL-VECTOR-INDEX" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdal-vector-index \- ایجاد نمایه برداری از مجموعه‌داده‌های برداری
.sp
افزوده‌شده در نسخه 3.12.

.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
نحوه استفاده: 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>                  الگویی که نام فایل‌ها در پوشه‌های ورودی باید از آن پیروی کنند (نویسه‌های عمومی \(aq*\(aq و \(aq?\(aq) [تکرارپذیر]
  \-\-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                                  آیا فقط نام مجموعه‌داده نوشته شود، به جای اینکه پسوند نمایه لایه به آن اضافه گردد
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
دستور
\fBgdal vector index\fP
یک مجموعه‌داده برداری ایجاد می‌کند که شامل یک رکورد به ازای هر فایل برداری ورودی،
یک ویژگی حاوی نام فایل (همراه با کاما و نمایه لایه در مجموعه‌داده به عنوان پسوند)
و یک هندسه چندضلعی است که محدوده (مستطیلی) آن را مشخص می‌کند.
این خروجی برای استفاده با
\X'tty: link https://mapserver.org'\fI\%MapServer\fP\X'tty: link'
به عنوان نمایه تایل برداری مناسب است.
.SH "گزینه‌های ویژه برنامه (PROGRAM-SPECIFIC OPTIONS)"
.INDENT 0.0
.TP
.B \-\-absolute\-path
مسیر مطلق فایل‌های برداری در فایل نمایه ذخیره می‌شود.
به‌طور پیش‌فرض، نام فایل‌های برداری دقیقاً همان‌گونه که در خط فرمان مشخص شده‌اند،
در فایل قرار می‌گیرند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-accept\-different\-crs
آیا لایه‌ها با سیستم مرجع مختصات (CRS) متفاوت پذیرفته شوند یا خیر.
به‌طور پیش‌فرض، مگر اینکه
\fI\%\-\-output\-crs\fP
مشخص شده باشد، لایه‌هایی که CRS یکسانی با اولین لایه نمایه ندارند، نادیده گرفته می‌شوند.
تنظیم گزینه
\fI\%\-\-accept\-different\-crs\fP
می‌تواند برای دور زدن بررسی سازگاری CRS مفید باشد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-accept\-different\-schemas
آیا لایه‌ها با طرح‌واره‌های (schemas) متفاوت پذیرفته شوند یا خیر.
به‌طور پیش‌فرض، لایه‌هایی که طرح‌واره یکسانی با اولین لایه نمایه ندارند، نادیده گرفته می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-dataset\-name\-only
آیا تنها نام مجموعه‌داده نوشته شود، به‌جای آنکه پسوند نمایه لایه به آن افزوده گردد.
.sp
\fBهشدار:\fP
.INDENT 7.0
.INDENT 3.5
تنظیم این گزینه مکانی را ایجاد می‌کند که با MapServer سازگار نیست.
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-filename\-filter <FILENAME\-FILTER>
الگویی که نام فایل‌های موجود در پوشه‌های ورودی باید از آن پیروی کنند.
کاراکتر
\(aq*\(aq
یک نویسه عمومی (wildcard) است که با هر تعداد نویسه از جمله تهی مطابقت دارد. کاراکتر
\(aq?\(aq
یک نویسه عمومی است که با یک نویسه منفرد مطابقت می‌یابد.
مقایسه‌ها بدون توجه به بزرگی و کوچکی حروف (case\-insensitive) انجام می‌شوند.
می‌توان چندین فیلتر را مشخص کرد.
.sp
برای نمونه: \fB\-\-filename\-filter \(dq*.shp,*.gpkg\(dq\fP
.UNINDENT
.INDENT 0.0
.TP
.B \-\-location\-name <LOCATION\-NAME>
نام فیلد خروجی برای نگه‌داری مسیر فایل/موقعیت مکانی بردارهای نمایه‌شده.
نام فیلد پیش‌فرض
\fBlocation\fP\&
است.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-metadata <KEY>=<VALUE>
نوشتن یک قلم دلخواه از متادیتای لایه، برای قالب‌هایی که از متادیتای لایه پشتیبانی می‌کنند.
این گزینه تکرارپذیر است.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-output\-crs <OUTPUT\-CRS>
محدوده‌های پوشش فایل‌های ورودی به سیستم مرجع مختصات هدف تبدیل خواهند شد.
حالت پیش‌فرض، چندضلعی‌های مستطیلی ساده‌ای در همان سیستم مرجع مختصات بردارهای ورودی ایجاد می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-recursive
آیا پوشه‌های ورودی باید به‌صورت بازگشتی بررسی و پیمایش شوند یا خیر.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-source\-crs\-field\-name <SOURCE\-CRS\-FIELD\-NAME>
نام فیلدی برای ذخیره CRS هر تایل. این نام فیلد می‌تواند به عنوان مقدار کلیدواژه TILESRS در MapServer استفاده شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-source\-crs\-format auto|WKT|EPSG|PROJ
قالبی که CRS هر تایل باید بر اساس آن نوشته شود. انواع مجاز عبارتند از
\fBauto\fP،
\fBWKT\fP،
\fBEPSG\fP
و
\fBPROJ\fP\&.
این گزینه باید همراه با
\fI\%\-\-source\-crs\-field\-name\fP
استفاده شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-source\-layer\-name <SOURCE\-LAYER\-NAME>
افزودن لایه با نام مشخص‌شده از هر فایل مبدأ در نمایه تایل [تکرارپذیر].
اگر هیچ‌کدام از گزینه‌های \fI\%\-\-source\-layer\-name\fP یا \fI\%\-\-source\-layer\-index\fP مشخص نشود، تمام لایه‌ها اضافه خواهند شد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-source\-layer\-index <SOURCE\-LAYER\-INDEX>
افزودن لایه با نمایه مشخص‌شده (مبتنی بر صفر) از هر فایل مبدأ در نمایه تایل [تکرارپذیر].
.UNINDENT
.SH "گزینه‌های استاندارد (STANDARD OPTIONS)"
.INDENT 0.0
.TP
.B \-\-append
آیا الحاق عارضه‌ها (features) به لایه(های) موجود مجاز است یا خیر.
این گزینه همچنین در صورت عدم وجود مجموعه‌داده خروجی، آن را ایجاد می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-co, \-\-creation\-option <NAME>=<VALUE>
بسیاری از قالب‌ها یک یا چند گزینه اختیاری ایجاد مجموعه‌داده دارند که می‌توانند برای
کنترل جزئیات فایل ایجادشده استفاده شوند. برای نمونه،
درایور GeoPackage از گزینه‌های ایجاد برای کنترل نسخه پشتیبانی می‌کند.
.sp
تکرارپذیر است.
.sp
گزینه‌های ایجاد مجموعه‌داده موجود بسته به درایور قالب متفاوت است و برخی قالب‌های
ساده اصلاً هیچ گزینه ایجادی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را
می‌توان با گزینه خط فرمان
\fI\%\-\-formats\fP
مشاهده کرد، اما مستندات مربوط به همان قالب مرجع اصلی اطلاعات درباره گزینه‌های ایجاد درایور است.
برای مشاهده گزینه‌های ایجاد مجاز برای هر قالب، به مستندات اختصاصی قالب \fI\%درایورهای برداری (Vector drivers)\fP مراجعه کنید.
.sp
توجه داشته باشید که گزینه‌های ایجاد مجموعه‌داده با گزینه‌های ایجاد لایه تفاوت دارند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-lco, \-\-layer\-creation\-option <NAME>=<VALUE>
بسیاری از قالب‌ها یک یا چند گزینه اختیاری ایجاد لایه دارند که می‌توانند برای
کنترل جزئیات لایه ایجادشده استفاده شوند. برای نمونه،
درایور GeoPackage از گزینه‌های ایجاد لایه برای کنترل شناسه عارضه یا نام ستون هندسه،
تنظیم شناسه یا توضیحات و غیره پشتیبانی می‌کند.
.sp
تکرارپذیر است.
.sp
گزینه‌های ایجاد لایه موجود بسته به درایور قالب متفاوت است و برخی قالب‌های ساده
اصلاً هیچ گزینه ایجاد لایه‌ای ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را
می‌توان با گزینه خط فرمان
\fI\%\-\-formats\fP
مشاهده کرد، اما مستندات مربوط به همان قالب مرجع اصلی اطلاعات درباره گزینه‌های ایجاد درایور است.
برای مشاهده گزینه‌های ایجاد مجاز برای هر قالب، به مستندات اختصاصی قالب \fI\%درایورهای برداری (Vector drivers)\fP مراجعه کنید.
.sp
توجه داشته باشید که گزینه‌های ایجاد لایه با گزینه‌های ایجاد مجموعه‌داده تفاوت دارند.
.UNINDENT
.INDENT 0.0
.TP
.B \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>
تعیین قالب برداری خروجی. مقادیر مجاز را می‌توان با دستور زیر مشاهده کرد:
\fBgdal \-\-formats | grep vector | grep rw | sort\fP
.UNINDENT
.INDENT 0.0
.TP
.B \-\-nln, \-\-output\-layer <LAYER>
تعیین نام برای لایه برداری خروجی.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-overwrite
اجازه به برنامه برای بازنویسی فایل یا مجموعه‌داده مقصد موجود.
در غیر این صورت، به‌طور پیش‌فرض، اگر فایل یا مجموعه‌داده مقصد از قبل موجود باشد،
\fBgdal\fP
با خطا خارج می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-overwrite\-layer
آیا بازنویسی لایه برداری خروجی موجود مجاز است یا خیر.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-update
آیا مجموعه‌داده خروجی موجود در حالت به‌روزرسانی باز شود یا خیر.
.UNINDENT
.SH "کد وضعیت بازگشتی (RETURN STATUS CODE)"
.sp
برنامه در صورت موفقیت کد وضعیت ۰ و در صورت بروز خطا کد غیر صفر برمی‌گرداند
(خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، به عنوان اجرای موفق در نظر گرفته می‌شوند).
.SH "مثال‌ها (EXAMPLES)"
.SS "مثال ۱"
.sp
تولید یک GeoPackage با یک رکورد برای هر لایه‌ای که این ابزار در پوشه
\fBcountries\fP
می‌یابد. هر رکورد حاوی اطلاعاتی است که به موقعیت مکانی هر فایل برداری ورودی اشاره می‌کند
و همچنین دارای یک شکل هندسی مستطیل مرزی است که حدود آن را نشان می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal vector index countries/*.shp index.gpkg
.EE
.UNINDENT
.UNINDENT
.SS "مثال ۲"
.sp
گزینه
\fI\%\-\-output\-crs\fP
همچنین می‌تواند برای تبدیل تمام محدوده‌های پوشش بردارهای ورودی به همان تصویر خروجی استفاده شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal vector index \-\-output\-crs EPSG:4326 \-\-source\-crs\-field\-name=src_srs countries/*.shp index.gpkg
.EE
.UNINDENT
.UNINDENT
.SH "نویسنده (AUTHOR)"
Even Rouault <even.rouault@spatialys.com>
.SH "حق نشر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.