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