.TH "OSM2PGSQL" "1" "2.3.1" "" ""
.SH "نام (NAME)"
osm2pgsql\-expire \- مصورسازی خروجی انقضا (expire)
.SH "خلاصه دستور (SYNOPSIS)"
\f[B]osm2pgsql\-expire\f[R] [\f[I]OPTIONS\f[R]] \f[I]OSM\-FILE\f[R] (1)
\f[B]osm2pgsql\-expire\f[R] \f[I]TILES\-FILE\f[R] (2)
.SH "توضیحات (DESCRIPTION)"
\f[B]این دستور در حال حاضر آزمایشی است.\f[R]
.PP
دستور expire می‌تواند برای دو منظور استفاده شود:
.IP "1." 3
\f[B]بررسی اینکه داده‌های OSM درون چه کاشی‌هایی قرار دارند.\f[R] اگر یک
\f[I]OSM\-FILE\f[R] مشخص شود، osm2pgsql\-expire کاشی‌های پوشش‌دهندهٔ
اشیاء موجود در آن فایل را محاسبه خواهد کرد.
توجه داشته باشید که این فایل نباید یک فایل تغییرات (change file) باشد، بلکه باید یک فایل دادهٔ معمولی OSM باشد!
خروجی به‌طور پیش‌فرض یک فایل کاشی است، اما خروجی GeoJSON نیز امکان‌پذیر است.
کاشی‌های پوشاننده تنها برای اشیاء برچسب‌دار محاسبه می‌شوند.
.IP "2." 3
\f[B]مصورسازی فهرست کاشی‌ها.\f[R] اگر یک \f[I]TILE\-FILE\f[R] (احتمالاً
تولیدشده توسط osm2pgsql) مشخص شود، یک فایل GeoJSON تولید می‌شود
که تمام کاشی‌های ذکرشده را نمایش می‌دهد.
در این حالت تمام گزینه‌های خط فرمان نادیده گرفته می‌شوند.
.PP
برای جزئیات بیشتر در مورد چگونگی تفسیر گزینه‌های \f[CR]\-m, \[rs]\-\-mode\f[R] و
\f[CR]\[rs]\-\-full\-area\-limit\f[R]، بخش \f[I]Expire\f[R] از راهنمای
osm2pgsql را در آدرس (https://osm2pgsql.org/doc/manual.html#expire) بخوانید.
.SH "تولید هندسه (GEOMETRY GENERATION)"
برای محاسبهٔ کاشی‌های پوشش‌دهندهٔ داده‌های OSM مشخص‌شده در حالت (1)، ابتدا
باید برای هر شیء یک هندسه تولید شود.
این فرآیند به شرح زیر عمل می‌کند:
.IP \[bu] 2
برای گره‌ها (nodes)، یک هندسهٔ نقطه (point) تولید خواهد شد.
.IP \[bu] 2
برای مسیرهای بسته (closed ways)، یک هندسهٔ چندضلعی (polygon) و برای مسیرهای باز،
یک هندسهٔ رشته‌خط (linestring) تولید خواهد شد.
اگر چندضلعی تولیدشده معتبر نباشد، برنامه به حالت linestring بازمی‌گردد.
اگر نه یک polygon معتبر و نه یک linestring معتبر قابل تولید نباشد،
شیء نادیده گرفته می‌شود.
.IP \[bu] 2
برای روابط (relations)، هندسه بر اساس برچسب \f[CR]type\f[R] تولید می‌شود.
برای انواع \f[CR]multipolygon\f[R] و \f[CR]boundary\f[R]، یک هندسهٔ multipolygon
ایجاد می‌شود، برای انواع \f[CR]route\f[R] و \f[CR]multilinestring\f[R] یک هندسهٔ
multilinestring ایجاد می‌شود، و برای تمامی انواع دیگر یک مجموعه هندسی (geometry collection)
ایجاد می‌گردد.
.PP
توجه داشته باشید که برای (multi)polygonها، بسته به گزینه‌های خط فرمان
\-\-mode و \-\-full\-area\-limit، محاسبهٔ کاشی‌ها بر اساس مساحت یا
مرز (multi)polygonها خواهد بود.
.SH "گزینه‌ها (OPTIONS)"
این برنامه از شیوه‌نگارش معمول خط فرمان GNU پیروی می‌کند که در آن گزینه‌های طولانی
با دو خط تیره (\f[CR]\-\-\f[R]) آغاز می‌شوند.
آرگومان‌های اجباری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری هستند.
.SH "گزینه‌های اصلی (MAIN OPTIONS)"
.TP
\-b, \-\-buffer=VALUE
تنظیم اندازهٔ حائل (buffer) در اطراف هندسه نسبت به اندازهٔ کاشی.
مثال: برای حائلی که ۱۰٪ اندازهٔ کاشی است، مقدار را روی 0.1 تنظیم کنید.
.TP
\-f, \-\-format=FORMAT
فرمت خروجی.
گزینه‌ها شامل `tiles' (پیش‌فرض) یا `geojson' هستند.
خروجی GeoJSON از سیستم تصویر Web Mercator (EPSG:3857) استفاده می‌کند که توسط
بسیاری از برنامه‌ها پشتیبانی می‌شود، هرچند که از نظر فنی دقیق، در مشخصات GeoJSON
مجاز نیست.
.TP
\-\-full\-area\-limit=VALUE
تنظیم حد مساحت کامل (full area limit).
.TP
\-m, \-\-mode=MODE
تنظیم حالت انقضا (expire mode).
یکی از مقادیر \f[CR]boundary_only\f[R]، \f[CR]full_area\f[R] (پیش‌فرض)، و
\f[CR]hybrid\f[R].
.TP
\-z, \-\-zoom=ZOOM
سطح بزرگ‌نمایی (zoom level) که کاشی‌ها بر اساس آن محاسبه می‌شوند.
.SH "گزینه‌های راهنما/نسخه (HELP/VERSION OPTIONS)"
.TP
\-h, \-\-help
چاپ راهنما.
.TP
\-V, \-\-version
چاپ نسخهٔ osm2pgsql.
.SH "گزینه‌های گزارش‌گیری (LOGGING OPTIONS)"
.TP
\-\-log\-level=LEVEL
تنظیم سطح گزارش‌گیری (`debug'، `info' (پیش‌فرض)، `warn'، یا `error').
.SH "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
\c
.UR https://osm2pgsql.org
وب‌سایت osm2pgsql
.UE \c
.IP \[bu] 2
\c
.UR https://osm2pgsql.org/doc/manual.html
راهنمای osm2pgsql
.UE \c
.IP \[bu] 2
\f[B]osm2pgsql\f[R](1)
.IP \[bu] 2
\f[B]postgres\f[R](1)
.IP \[bu] 2
\f[B]osmcoastline\f[R](1)