.\" Man page generated from reStructuredText
.\" by the Docutils 0.22.4 manpage writer.
.
.
.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 "PROJSYNC" "1" "10 avril 2026" "9.8" "PROJ"
.SH "نام (NAME)"
projsync \- ابزار بارگیری فایل‌های منبع
.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.nf
\fBprojsync\fP
.in +2
[\-\-endpoint URL]
[\-\-local\-geojson\-file FILENAME]
([\-\-user\-writable\-directory] | [\-\-system\-directory] | [\-\-target\-dir DIRNAME])
[\-\-bbox west_long,south_lat,east_long,north_lat]
[\-\-spatial\-test contains|intersects]
[\-\-source\-id ID] [\-\-area\-of\-use NAME]
[\-\-file NAME]
[\-\-all] [\-\-exclude\-world\-coverage]
[\-\-quiet | \-\-verbose] [\-\-dry\-run] [\-\-list\-files]
[\-\-no\-version\-filtering]
.in -2
.fi
.sp
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBprojsync\fP برنامه‌ای است که فایل‌های منبع دوردست را در یک دایرکتوری محلی بارگیری می‌کند. این ابزار جایگزینی برای بارگیری فایل آرشیو proj\-data\-X.Y.Z یا استفاده از قابلیت‌های شبکه‌ای برحسب تقاضا (on\-demand) در PROJ است.
.sp
پارامترهای کنترلی زیر می‌توانند با هر ترتیبی مشخص شوند:
.INDENT 0.0
.TP
.B \-\-endpoint URL
آدرس URL را برای بارگیری فایل اصلی \fBfiles.geojson\fP و سپس فایل‌های منبع مشخص می‌کند. مقدار پیش‌فرض آن برابر با مقدار تعیین‌شده در proj.ini است.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-local\-geojson\-file FILENAME
نام فایل را برای فایل‌های اصلی GeoJSON که به منابع ارجاع می‌دهند، مشخص می‌کند. مقدار پیش‌فرض \fB${endpoint}/files.geojson\fP است.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-user\-writable\-directory
مشخص می‌کند که فایل‌های منبع باید در دایرکتوری قابل نوشتن توسط کاربر بارگیری شوند. این حالت پیش‌فرض است.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-system\-directory
مشخص می‌کند که فایل‌های منبع باید در دایرکتوری ${installation_prefix}/share/proj بارگیری شوند. کاربری که \fBprojsync\fP را اجرا می‌کند باید مطمئن شود که در آن دایرکتوری دسترسی نوشتن دارد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-target\-dir DIRNAME
دایرکتوری مقصدی که فایل‌های منبع باید در آن بارگیری شوند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-bbox west_long,south_lat,east_long,north_lat
محدودهٔ جغرافیایی مورد نظر (area of interest) را برای محدود کردن منابع دانلودی مشخص می‌کند.
محدودهٔ مورد نظر به‌صورت یک کادر احاطه‌کننده (bounding box) با مختصات جغرافیایی تعیین می‌شود که بر حسب درجه در یک CRS جغرافیایی نامشخص بیان شده است.
مقادیر \fIwest_long\fP و \fIeast_long\fP باید در بازهٔ [\-180,180] و مقادیر \fIsouth_lat\fP و \fInorth_lat\fP در بازهٔ [\-90,90] باشند. مقدار \fIwest_long\fP عموماً کوچکتر از \fIeast_long\fP است، به‌جز در حالتی که محدودهٔ مورد نظر از خط نصف‌النهار ۱۸۰ درجه (antimeridian) عبور کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-spatial\-test contains|intersects
نحوهٔ مقایسهٔ گسترهٔ فایل‌های منبع با محدودهٔ کاربردی که صراحتاً با \fB\-\-bbox\fP تعیین شده را مشخص می‌کند.
به‌طور پیش‌فرض، هر فایل منبعی که گسترهٔ آن با مقدار تعیین‌شده توسط \fB\-\-bbox\fP تقاطع داشته باشد (intersects)، انتخاب خواهد شد.
اگر از راهبرد \fBcontains\fP استفاده شود، تنها فایل‌های منبعی انتخاب می‌شوند که گسترهٔ آن‌ها کاملاً درون مقدار تعیین‌شده توسط \fB\-\-bbox\fP قرار داشته باشد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-source\-id ID
فایل‌های منبع قابل بارگیری را به مواردی محدود می‌کند که ویژگی source_id آن‌ها شامل مقدار ID باشد. مشخص کردن \fB?\fP به‌عنوان ID، تمام مقادیر ممکن را فهرست می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-area\-of\-use NAME
فایل‌های منبع قابل بارگیری را به مواردی محدود می‌کند که ویژگی area_of_use آن‌ها شامل مقدار NAME باشد. مشخص کردن \fB?\fP به‌عنوان NAME، تمام مقادیر ممکن را فهرست می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-file NAME
فایل‌های منبع قابل بارگیری را به مواردی محدود می‌کند که ویژگی name آن‌ها شامل مقدار NAME باشد. مشخص کردن \fB?\fP به‌عنوان NAME، تمام مقادیر ممکن را فهرست می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-all
درخواست برای بارگیری تمامی فایل‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-exclude\-world\-coverage
صرف‌نظر کردن از فایل‌هایی که دارای پوشش جهانی هستند.
.UNINDENT
.INDENT 0.0
.TP
.B \-q / \-\-quiet
حالت بی‌صدا
.UNINDENT
.INDENT 0.0
.TP
.B \-\-verbose
در نگارش 8.1 اضافه شد.

.sp
حالت پرگو (اطلاعات بیشتر نسبت به حالت پیش‌فرض)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-dry\-run
شبیه‌سازی عملکرد ابزار بدون بارگیری فایل‌های منبع.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-list\-files
فهرست کردن نام فایل‌ها به‌همراه ویژگی‌های source_id و area_of_use.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-version\-filtering
در نگارش 8.1 اضافه شد.

.sp
به‌طور پیش‌فرض، \fBprojsync\fP فقط فایل‌هایی را بارگیری می‌کند که با فراداده‌های PROJ_DATA.VERSION موجود در \fBproj.db\fP سازگار باشند و ویژگی‌های \fBversion_added\fP و \fBversion_removed\fP مدخل‌ها در \fBfiles.geojson\fP را در نظر می‌گیرد.
با مشخص کردن این گزینه، تمامی فایل‌های مورد ارجاع در \fBfiles.geojson\fP کاندید خواهند بود (در ترکیب با سایر فیلترها).
.UNINDENT
.sp
حداقل یکی از گزینه‌های \fB\-\-list\-files\fP، \fB\-\-file\fP، \fB\-\-source\-id\fP، \fB\-\-area\-of\-use\fP، \fB\-\-bbox\fP یا \fB\-\-all\fP باید مشخص شود.
.sp
گزینه‌های \fB\-\-file\fP، \fB\-\-source\-id\fP، \fB\-\-area\-of\-use\fP و \fB\-\-bbox\fP با منطق AND ترکیب می‌شوند.
.SH "مثال‌ها (EXAMPLES)"
.INDENT 0.0
.IP 1. 3
بارگیری تمام فایل‌های منبع
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
projsync \-\-all
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP 2. 3
بارگیری فایل‌های منبع پوشش‌دهندهٔ نقطهٔ مشخص‌شده و منتسب به یک سازمان
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
projsync \-\-source\-id fr_ign \-\-bbox 2,49,2,49
.EE
.UNINDENT
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBcs2cs(1)\fP, \fBcct(1)\fP, \fBgeod(1)\fP, \fBgie(1)\fP, \fBproj(1)\fP, \fBprojinfo(1)\fP
.SH "گزارش باگ‌ها (BUGS)"
.sp
فهرستی از باگ‌های شناخته‌شده را می‌توان در \%<https://github.com/OSGeo/PROJ/issues> مشاهده کرد
که گزارش‌های جدید باگ را نیز می‌توان در آنجا ثبت نمود.
باگ‌های مربوط به فایل‌های منبع باید به
\%<https://github.com/OSGeo/PROJ-data/issues>
ارسال شوند.
.SH "صفحه اصلی (HOME PAGE)"
.sp
\%<https://proj.org>
.SH "نویسندگان (AUTHORS)"
Even Rouault
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
1983-2026, PROJ contributors
.\" End of generated man page.