PROJSYNC(1) PROJ PROJSYNC(1)

projsync - ابزار بارگیری فایل‌های منبع

projsync
[--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]

دستور projsync برنامه‌ای است که فایل‌های منبع دوردست را در یک دایرکتوری محلی بارگیری می‌کند. این ابزار جایگزینی برای بارگیری فایل آرشیو proj-data-X.Y.Z یا استفاده از قابلیت‌های شبکه‌ای برحسب تقاضا (on-demand) در PROJ است.

پارامترهای کنترلی زیر می‌توانند با هر ترتیبی مشخص شوند:

آدرس URL را برای بارگیری فایل اصلی files.geojson و سپس فایل‌های منبع مشخص می‌کند. مقدار پیش‌فرض آن برابر با مقدار تعیین‌شده در proj.ini است.
نام فایل را برای فایل‌های اصلی GeoJSON که به منابع ارجاع می‌دهند، مشخص می‌کند. مقدار پیش‌فرض ${endpoint}/files.geojson است.
مشخص می‌کند که فایل‌های منبع باید در دایرکتوری قابل نوشتن توسط کاربر بارگیری شوند. این حالت پیش‌فرض است.
مشخص می‌کند که فایل‌های منبع باید در دایرکتوری ${installation_prefix}/share/proj بارگیری شوند. کاربری که projsync را اجرا می‌کند باید مطمئن شود که در آن دایرکتوری دسترسی نوشتن دارد.
دایرکتوری مقصدی که فایل‌های منبع باید در آن بارگیری شوند.
محدودهٔ جغرافیایی مورد نظر (area of interest) را برای محدود کردن منابع دانلودی مشخص می‌کند. محدودهٔ مورد نظر به‌صورت یک کادر احاطه‌کننده (bounding box) با مختصات جغرافیایی تعیین می‌شود که بر حسب درجه در یک CRS جغرافیایی نامشخص بیان شده است. مقادیر west_long و east_long باید در بازهٔ [-180,180] و مقادیر south_lat و north_lat در بازهٔ [-90,90] باشند. مقدار west_long عموماً کوچکتر از east_long است، به‌جز در حالتی که محدودهٔ مورد نظر از خط نصف‌النهار ۱۸۰ درجه (antimeridian) عبور کند.
نحوهٔ مقایسهٔ گسترهٔ فایل‌های منبع با محدودهٔ کاربردی که صراحتاً با --bbox تعیین شده را مشخص می‌کند. به‌طور پیش‌فرض، هر فایل منبعی که گسترهٔ آن با مقدار تعیین‌شده توسط --bbox تقاطع داشته باشد (intersects)، انتخاب خواهد شد. اگر از راهبرد contains استفاده شود، تنها فایل‌های منبعی انتخاب می‌شوند که گسترهٔ آن‌ها کاملاً درون مقدار تعیین‌شده توسط --bbox قرار داشته باشد.
فایل‌های منبع قابل بارگیری را به مواردی محدود می‌کند که ویژگی source_id آن‌ها شامل مقدار ID باشد. مشخص کردن ? به‌عنوان ID، تمام مقادیر ممکن را فهرست می‌کند.
فایل‌های منبع قابل بارگیری را به مواردی محدود می‌کند که ویژگی area_of_use آن‌ها شامل مقدار NAME باشد. مشخص کردن ? به‌عنوان NAME، تمام مقادیر ممکن را فهرست می‌کند.
فایل‌های منبع قابل بارگیری را به مواردی محدود می‌کند که ویژگی name آن‌ها شامل مقدار NAME باشد. مشخص کردن ? به‌عنوان NAME، تمام مقادیر ممکن را فهرست می‌کند.
درخواست برای بارگیری تمامی فایل‌ها.
صرف‌نظر کردن از فایل‌هایی که دارای پوشش جهانی هستند.
حالت بی‌صدا
در نگارش 8.1 اضافه شد.

حالت پرگو (اطلاعات بیشتر نسبت به حالت پیش‌فرض)

شبیه‌سازی عملکرد ابزار بدون بارگیری فایل‌های منبع.
فهرست کردن نام فایل‌ها به‌همراه ویژگی‌های source_id و area_of_use.
در نگارش 8.1 اضافه شد.

به‌طور پیش‌فرض، projsync فقط فایل‌هایی را بارگیری می‌کند که با فراداده‌های PROJ_DATA.VERSION موجود در proj.db سازگار باشند و ویژگی‌های version_added و version_removed مدخل‌ها در files.geojson را در نظر می‌گیرد. با مشخص کردن این گزینه، تمامی فایل‌های مورد ارجاع در files.geojson کاندید خواهند بود (در ترکیب با سایر فیلترها).

حداقل یکی از گزینه‌های --list-files، --file، --source-id، --area-of-use، --bbox یا --all باید مشخص شود.

گزینه‌های --file، --source-id، --area-of-use و --bbox با منطق AND ترکیب می‌شوند.

1.
بارگیری تمام فایل‌های منبع
projsync --all
2.
بارگیری فایل‌های منبع پوشش‌دهندهٔ نقطهٔ مشخص‌شده و منتسب به یک سازمان
projsync --source-id fr_ign --bbox 2,49,2,49

cs2cs(1), cct(1), geod(1), gie(1), proj(1), projinfo(1)

فهرستی از باگ‌های شناخته‌شده را می‌توان در https://github.com/OSGeo/PROJ/issues مشاهده کرد که گزارش‌های جدید باگ را نیز می‌توان در آنجا ثبت نمود. باگ‌های مربوط به فایل‌های منبع باید به https://github.com/OSGeo/PROJ-data/issues ارسال شوند.

https://proj.org

Even Rouault

1983-2026, PROJ contributors

10 avril 2026 9.8