Before we start: most screens have links in the menu to the on-device help system giving you direct access to information relevant for the current context, you can easily navigate back to this text too. If you have a larger device, for example a tablet, you can open the help system in a separate split window. All the help texts and more (FAQs, tutorials) can be found on the Vespucci documentation site too. You can further start the help viewer directly on devices that support short cuts with a long press on the app icon and selecting "Help"

معرفی وسپوچی

Vespucci is a full featured OpenStreetMap editor that supports most operations that desktop editors provide. It has been tested successfully on Google's Android 2.3 to 14.0 (versions prior to 4.1 are no longer supported) and various AOSP based variants. A word of caution: while mobile device capabilities have caught up with their desktop rivals, particularly older devices have very limited memory available and tend to be rather slow. You should take this in to account when using Vespucci and keep, for example, the areas you are editing to a reasonable size.

ویرایش با وسپوچی

بسته به اندازهٔ صفحه‌نمایش و عمر دستگاه، کنش‌های ویرایش مستقیماً از طریق نمادهای موجود در نوار بالا، از طریق منوی کشویی در سمت راست نوار بالا، از نوار پایین (در صورت وجود) یا از طریق کلید منو قابل دسترسی است.

بارگیری دادهٔ OSM

Select either the transfer icon Transfer or the "Transfer" menu item. This will display eleven options:

ساده‌ترین روش بارگیری داده در دستگاه این است که با حرکت و زوم به مکانی که می‌خواهید ویرایش کنید بروید و «بارگیری نمای کنونی» را انتخاب نمایید. می‌توانید با ژست‌های حرکتی، دکمه‌های زوم یا دکمه‌های کنترل صدای دستگاه، زوم کنید. سپس وسپوچی دادهٔ نمای کنونی را دریافت می‌کند. برای بارگیری داده در دستگاهتان به احراز هویت نیازی نیست.

In unlocked state any non-downloaded areas will be dimmed relative to the downloaded ones if you are zoomed in far enough to enable editing. This is to avoid inadvertently adding duplicate objects in areas that are not being displayed. In the locked state dimming is disabled, this behaviour can be changed in the Advanced preferences so that dimming is always active.

If you need to use a non-standard OSM API entry, or use offline data in MapSplit format you can add or change entries via the Configure... entry for the data layer in the layer control.

ویرایش

حالت قفل، حالت باز، تعویض حالت

برای پیشگیری از ویرایش‌های ناخواسته، وسپوچی در حالت «قفل» آغاز می‌شود؛ حالتی که در آن فقط می‌توانید زوم کنید و نقشه را جابه‌جا نمایید. روی نماد قفل بزنید تا قفل باز شود.

A long press on the lock icon or the Modes menu in the map display overflow menu will display a menu offering 4 options:

If you are using Vespucci on an Android device that supports short cuts (long press on the app icon) you can start directly to Address and Indoor mode.

تک‌ضربه، دوضربه و لمس طولانی

به‌طور پیشفرض، دور گره‌ها و راه‌های قابل‌انتخاب محدودهٔ نارنجی‌رنگی مشاهده می‌کنید. با لمس این محدوده می‌توانید چیزها را انتخاب کنید. سه گزینه پیش روی شماست:

اگر سعی می‌کنید ناحیه ای با تراکم بالا را ویرایش کنید، بهتر است بیشتر زوم کنید.

وسپوچی عملکرد «واگرد/ازنو»ی خوبی دارد، بنابراین با خیال راحت روی دستگاه خود آزمایش کنید. اما لطفاً دادهٔ آزمایشی را بارگذاری و ذخیره ننمایید.

انتخاب کردن/نکردن (تک ضربه و "منوی انتخاب")

شیئی را لمس کنید تا انتخاب شود. اگر فضای خالی از صفحه را لمس کنید، از انتخاب در می‌آید. اگر چیزی را انتخاب کرده‌اید و می‌خواهید چیز دیگری را انتخاب کنید، خیلی ساده است، آن چیز جدید را لمس کنید. لازم نیست ابتدا شیء قبلی را از انتخاب در آورید. اگر روی شیئی دوضربه بزنید، حالت انتخاب چندتایی فعال می‌شود.

توجه کنید که اگر تلاش کنید شیئی را انتخاب نمایید و وسپوچی ببیند چیزهای دیگری هم در محل لمس قرار دارند (مانند گره روی راه یا چیزهای دیگری که همپوشانی دارند) در این صورت منوی انتخاب را نشانتان می‌دهد: حال روی شیء موردنظرتان بزنید تا انتخاب شود.

اشیای انتخاب‌شده با خط زردرنگی که دورشان ظاهر می‌شود برجسته می‌شوند. بسته به پس‌زمینهٔ نقشه و میزان زوم، شاید این حاشیهٔ زردرنگ را به‌وضوح نبینید. پس از انتخاب هر چیز، پیامی ظاهر می‌شود و انتخاب را تأیید می‌کند.

پس از انتخاب، لیستی از کنش‌های پشتیبانی‌شده برای شیء انتخابی نشان داده می‌شود (در قالب دکمه یا گزینه‌های منو): برای اطلاعات بیشتر انتخاب گره، انتخاب راه و انتخاب رابطه را ببینید.

اشیای انتخاب‌شده: ویرایش تگ‌ها

با لمس دوبارهٔ شیء انتخاب‌شده، ویرایشگر تگ باز می‌شود و می‌توانید تگ‌های آن را ویرایش کنید.

توجه کنید که برای اشیای هم‌پوشان (مانند گره روی راه) منوی انتخاب دوباره ظاهر می‌شود. اگر دوباره شیء انتخاب‌شده را برگزینید ویرایشگر تگ باز می‌شود. اما اگر شیء دیگری را برگزینید، آن شیء در حالت انتخاب قرار می‌گیرد.

اشیای انتخاب‌شده: جابه‌جایی گره یا راه

هنگامی که یک شی را انتخاب کردید ، می توانید آن را جابجا کنید. توجه داشته باشید که اشیاء تنها در صورت انتخاب می توانند کشیده شوند. به سادگی شیء انتخاب شده را نزدیک (یعنی در محدوده تحمل) بکشید تا آن را منتقل کنید. اگر ناحیه کشیدن بزرگ را در preferences انتخاب کنید ، یک ناحیه بزرگ در اطراف گره انتخاب شده بدست می آورید که موقعیت یابی شی را آسان تر می کند.

افزودن گره/نقطه یا راه جدید

در اولین اجرا، برنامه در «حالت ساده» بالا می‌آید. این حالت را می‌توانید از منوی اصلی با برداشتن تیک مربوطه غیرفعال کنید.

حالت ساده

با زدن روی دکمهٔ شناور سبزرنگ بزرگی که روی صفحه است منویی نمایان می‌شود. پس از انتخاب یکی از موارد، از شما خواسته می‌شود مکان موردنظرتان را برای رسم شیء لمس کنید. اگر نیاز دارید نمای نقشه را تنظیم کنید، از کشیدن و زوم‌کردن بهره ببرید.

See Creating new objects in simple actions mode for more information. Simple mode os the default for new installs.

حالت پیشرفته (فشار طولانی)

فشار طولانی را در جایی که می خواهید گره باشد یا راه شروع را فشار دهید. نماد سیاه "crosshair" را مشاهده خواهید کرد. * اگر می خواهید یک گره جدید ایجاد کنید (به یک شی متصل نیست) ، اجسام موجود را دور بزنید. * اگر می خواهید راهی را گسترش دهید ، "منطقه تحمل" راه (یا یک گره در راه) را لمس کنید. منطقه تحمل توسط مناطق اطراف یک گره یا راه نشان داده می شود.

هنگامی که علامت + نمایان شد، این گزینه‌ها پیش روی شماست:

به سادگی صفحه ای را که می خواهید گره های بیشتری را به آن اضافه کنید لمس کنید. برای اتمام، گره نهایی را دوبار لمس کنید. اگر گره نهایی در یک راه یا گره قرار داشته باشد، قطعه به طور خودکار به راه یا گره متصل می شود.

همچنین می‌توانید از گزینه‌ای در منو استفاده کنید: برای اطلاعات بیشتر ایجاد اشیای جدید را ببینید.

افزودن محدوده

برخلاف سایر سامانه‌های دادهٔ مکانی، اوپن‌استریت‌مپ هم‌اکنون نوع دادهٔ «محدوده» ندارد. ویرایشگر آنلاین iD تلاش می‌کند که مفهوم محدوده را بر اساس عناصر پایه‌ای OSM ایجاد کند که در برخی وضعیت‌ها نیز به‌خوبی کار می‌کند اما نه همیشه. در وسپوچی فعلاً قرار نیست چنین کار مشابهی انجام شود، بنابراین لازم است کمی دربارهٔ چگونگی ارائهٔ محدوده‌ها بدانید:

بهبود هندسهٔ راه

اگر به اندازهٔ کافی روی راهی زوم کنید، وسط پاره‌هایی از راه که به قدر کافی بلند باشند، "×" کوچکی می‌بینید. با کشیدن ضربدر، در آن مکان گرهی روی راه ایجاد می‌شود. نکته: برای پیشگیری از ایجاد گره‌های تصادفی، فضای انتخاب پیرامون این ضربدر نسبتاً کوچک در نظر گرفته شده است.

برش، کپی و درج

You can copy selected nodes and ways, and then paste once or multiple times to a new location. Cutting will retain the osm id and version, thus can only be pasted once. To paste long press the location you want to paste to (you will see a cross hair marking the location). Then select "Paste" from the menu.

نشانی‌زنی به‌طور کارآمد

وسپوچی از عملکردی پشتیبانی می‌کند که با پیش‌بینی شماره خانه (سمت چپ و راست خیابان‌ها به طور جداگانه) و افزودن خودکار برچسب‌های addr:street یا addr:place بر اساس آخرین مقدار استفاده شده و مجاورت، آدرس‌های نقشه‌برداری را کارآمدتر می‌کند. در بهترین حالت، این ویژگی امکان اضافه کردن یک آدرس را بدون هیچ گونه تایپی فراهم می‌کند.

امکان افزودن برچسب‌ها با فشار دادن Address:

برای افزودن مستقیم گره‌های آدرس جداگانه در حالی که در حالت پیش‌فرض «حالت ساده» به حالت ویرایش «آدرس» تغییر می‌کند (دکمه قفل را فشار دهید)، «افزودن گره آدرس» سپس یک گره آدرس را در محل اضافه می‌کند و اگر روی یک طرح کلی ساختمان قرار دارید همانطور که در بالا توضیح داده شد یک برچسب ورودی به آن اضافه کنید.

برای اینکه پیشبینی پلاک خانه کار کند، دست‌کم لازم است دو شمارهٔ خانه در هر کنارهٔ جاده وجود داشته باشد. هر چه تعداد شماره‌ها بیشتر باشد، بهتر است.

استفاده از این را با یکی از حالت‌های Auto-Download در نظر بگیرید.

افزودن محدودیت‌های گردش

وسپوچی برای افزودن محدودیت‌های گردش روش سریعی دارد. اگر لازم باشد خودش راه‌ها را دو نیم می‌کند و دوباره از شما می‌خواهد که عنصرها را انتخاب کنید.

وسپوچی در حالت «قفل»

هنگامی که قفل قرمز نشان داده می‌شود همهٔ کنش‌های غیرویرایشی فعال هستند. همچنین با لمس طولانی روی یک عنصر OSMای، کادری حاوی اطلاعات جزئی از آن عنصر نمایش داده می‌شود.

ذخیره‌سازی تغییراتتان

(به اتصال شبکه نیاز دارد)

روی همان دکمه یا گزینهٔ منو که برای بارگیری زدید، بزنید و اکنون "بارگذاری داده ها در سرور OSM" را انتخاب کنید.

Vespucci supports OAuth 2, OAuth 1.0a authorization and the classical username and password method. Since July 1st 2024 the standard OpenStreetMap API only supports OAuth 2 and other methods are only available on private installations of the API or other projects that have repurposed OSM software.

Authorizing Vespucci to access your account on your behalf requires you to one time login with your display name and password. If your Vespucci install isn't authorized when you attempt to upload modified data you will be asked to login to the OSM website (over an encrypted connection). After you have logged on you will be asked to authorize Vespucci to edit using your account. If you want to or need to authorize the OAuth access to your account before editing there is a corresponding item in the "Tools" menu.

اگر می‌خواهید کار خود را ذخیره کنید اما به اینترنت دسترسی ندارید، می‌توانید تغییرات را در قالب پروندهٔ ‎.osm سازگار با JOSM ذخیره کنید و آن را در آینده با استفاده از وسپوچی یا JOSM بارگذاری نمایید.

حل تداخل‌ها هنگام بارگذاری

وسپوچی حل‌کنندهٔ تداخل ساده‌ای دارد. البته اگر فکر می‌کنید مسئله‌ای جدّی در ویرایش‌هایتان وجود دارد، تغییرات خود را در قالب پروندهٔ ‎.osc برون‌برد کنید (گزینهٔ «انتقال» در منوی «داده‌رسانی») و کار اصلاح و بارگذاری را با JOSM انجام دهید. راهنمای مفصل‌تر را در حل تداخل ببینید.

Nearby point-of-interest display

A nearby point-of-interest display can be shown by pulling the handle in the middle and top of the bottom menu bar up.

More information on this and other available functionality on the main display can be found here Main map display.

استفاده از GPS و مسیرهای GPX

وسپوچی با تنظیمات استاندارد سعی می‌کند GPS (و سایر سیستم‌های ناوبری مبتنی بر ماهواره) را فعال کند و در صورت عدم امکان، موقعیت را از طریق به اصطلاح "موقعیت شبکه" تعیین می‌کند. این رفتار فرض می‌کند که شما در استفاده معمولی، خود دستگاه اندروید خود را طوری پیکربندی کرده‌اید که فقط از مکان‌های تولید شده GPX استفاده کند (برای جلوگیری از ردیابی)، یعنی گزینه «بهبود دقت موقعیت مکانی» را خاموش کرده‌اید. اگر می‌خواهید این گزینه را فعال کنید اما می‌خواهید از بازگشت وسپوچی به "موقعیت شبکه" جلوگیری کنید، باید گزینه مربوطه را در ترجیحات پیشرفته خاموش کنید.

Touching the GPS button (normally on the left hand side of the map display) will center the screen on the current position and as you move the map display will be panned to maintain this. Moving the screen manually or editing will cause the "follow GPS" mode to be disabled and the blue GPS arrow will change from an outline to a filled arrow. To quickly return to the "follow" mode, simply touch GPS button or re-check the equivalent menu option. If the device doesn't have a current location the location marker/arrow will be displayed in black, if a current location is available the marker will be blue.

برای ضبط یک رد GPX و نمایش آن در دستگاه خود، مورد "Start GPX track" را در منوی GPS انتخاب کنید. این یک لایه به صفحه نمایش با رد ضبط شده فعلی اضافه می‌کند، می توانید رد را از ورودی در کنترل لایه آپلود و صادر کنید. لایه‌های بیشتری را می‌توان از فایل‌های GPX محلی و ردهای دانلود شده از OSM API اضافه کرد.

توجه: به‌طور پیش‌فرض وسپوچی داده‌های ارتفاع را با مسیر GPX شما ثبت نمی‌کند، این به دلیل برخی مشکلات خاص اندروید است. برای فعال کردن ضبط ارتفاع، یا یک مدل گرانشی نصب کنید، یا برای حالت ساده تر، به ترجیحات پیشرفته بروید و ورودی NMEA را پیکربندی کنید.

How to export a GPX track?

Open the layer menu, then click the 3-dots menu next to "GPX recording", then select Export GPX track.... Choose in which folder to export the track, then give it a name suffixed with .gpx (example: MyTrack.gpx).

Notes, Bugs and Todos

وسپوچی از بارگیری، نظردهی و بستن یادداشت‌های OSM (همان باگ‌های OSM در گذشته) و قابلیت متناظر با «باگ» که ابزار تضمین کیفیت OSMOSE آن را تولید می‌کند، پشتیبانی می‌کند. هر کدام از این دو مورد را می‌توانید به‌طور دستی بارگیری کنید یا از قابلیت بارگیری خودکار بهره ببرید و آن‌ها را در محدوده‌ای که هر لحظه کار می‌کنید مشاهده نمایید. پس از ویرایش یا بستن آن‌ها، می‌توانید بلافاصله یادداشت یا باگ را بارگذاری نمایید یا همگی را با هم بارگذاری کنید.

Further we support "Todos" that can either be created from OSM elements, from a GeoJSON layer, or externally to Vespucci. These provide a convenient way to keep track of work that you want to complete.

On the map the Notes and bugs are represented by a small bug icon Bug, green ones are closed/resolved, blue ones have been created or edited by you, and yellow indicates that it is still active and hasn't been changed. Todos use a yellow checkbox icon.

The OSMOSE bug and Todos display will provide a link to the affected element in blue (in the case of Todos only if an OSM element is associated with it), touching the link will select the object, center the screen on it and down load the area beforehand if necessary.

پالایش

علاوه بر فعال سازی جهانی نمایش یادداشت ها و اشکالات ، می توانید یک فیلتر نمایش دانه درشت را برای کاهش درهم ریختگی تنظیم کنید. پیکربندی فیلتر را می توان از ورودی لایه وظیفه در کنترل لایه دریافت کرد:

حالت داخلی

نقشه‌کشی داخلی کار چالش‌برانگیزی است. زیرا چیزهای زیادی هست که معمولاً روی هم می‌افتند. وسپوچی حالت ویژه‌ای برای این منظور دارد که به‌وسیلهٔ آن می‌توانید چیزهایی را که در یک طبقه نیستند فیلتر کنید و همچنین به‌طور خودکار شمارهٔ طبقهٔ کنونی را به همهٔ اشیای نوساخته در آن طبقه می‌افزاید.

این حالت با لمس طولانی روی نماد قفل و انتخاب گزینهٔ مربوطه از منو قابل‌فعال‌سازی است. حالت قفل، حالت باز، تعویض حالت را ببینید.

حالت C

در حالت C فقط چیزهایی نشان داده می‌شود که پرچم هشدار داشته باشند که درنتیجه کمک می‌کند تا چیزهای مشکل‌دار یا چیزهایی را که بر اساس بررسی‌های قابل‌پیکربندی به دست می‌آیند، آسان‌تر بیابیم. در حالت C اگر عنصری انتخاب و ویرایشگر خصوصیت باز شود، بهترین تنظیم از پیش تنظیم شده به طور خودکار اعمال می شود.

این حالت با لمس طولانی روی نماد قفل و انتخاب گزینهٔ مربوطه از منو قابل‌فعال‌سازی است. حالت قفل، حالت باز، تعویض حالت را ببینید.

پیکربندی بررسی‌ها

All validations can be disabled/enabled in the "Validator settings/Enabled validations" in the preferences.

The configuration for "Re-survey" entries allows you to set a time after which a tag combination should be re-surveyed. "Check" entries are tags that should be present on objects as determined by matching presets. Entries can be edited by clicking them, the green menu button allows adding of entries.

مدخل‌های بازنقشه‌برداری

مدخل‌های نقشه‌برداری مجدد این خصوصیت‌ها را دارند:

*** کلید ** - کلید برچسب مورد علاقه. *** ارزش ** - مقداری که برچسب مورد علاقه باید داشته باشد ، در صورت خالی ، مقدار برچسب نادیده گرفته می شود. *** عمر** - چند روز پس از آخرین تغییر عنصر ، عنصر باید مجدداً بررسی شود ، در صورت وجود تگ check_date که مورد استفاده قرار می گیرد ، در غیر این صورت تاریخی که نسخه فعلی ایجاد شد. تنظیم مقدار بر روی صفر منجر به تطبیق چک به سادگی با کلید و مقدار می شود. *** عبارت منظم ** - اگر علامت زده شود ** مقدار ** یک عبارت معمولی JAVA در نظر گرفته می‌شود.

کلید و مقدار با تگ‌های موجود در عنصر موردبحث مطابقت داده می‌شود.

گروه Annotations در پیش‌تنظیم‌های استاندارد گزینه‌ای دارد که به‌طور خودکار تگ check_date را همراه با تاریخ جاری اضافه می‌کند.

مدخل‌های بررسی

مدخل‌های بررسی این دو خصوصیت را دارند:

این بررسی، ابتدا پیش‌تنظیم جور را تشخیص می‌دهد و سپس بررسی می‌کند که طبق پیش‌تنظیم، آیا کلید برای این عنصر «توصیه‌شده» است. گزینهٔ اختیاریِ لازم بررسی را به تگ‌های «اختیاری» عارضه گسترش می‌دهد. توجه: فعلاً پیش‌تنظیم‌های پیوندشده بررسی نمی‌شوند.

فیلترها

فیلتر مبتنی بر تگ

فیلتر را می‌توانید از منوی اصلی فعال کنید. سپس با زدن روی نماد فیلتر، آن را تغییر دهید. مستندات بیشتر در این باره در فیلتر با تگ آمده است.

فیلتر مبتنی بر پیش‌تنظیم

راه دیگری برای کار بالا، فیلتر عارضه‌ها بر اساس پیش‌تنظیم یا گروهی از پیش‌تنظیم‌ها است. با زدن روی نماد پالایه، مشابه با جاهای دیگر وسپوچی، کادری برای انتخاب پیش‌تنظیم باز می‌شود. برای انتخاب پیش‌تنظیم، یک بار لمس کافی است. برای انتخاب گروه پیش‌تنظیم‌ها لمس طولانی بکنید (لمس کوتاه گروه را باز می‌کند). مستندات بیشتر در فیلتر با پیش‌تنظیم آمده است.

سفارشی‌سازی وسپوچی

برنامه را از جنبه‌های مختلفی می‌توانید سفارشی کنید. اگر به دنبال چیز خاصی هستید و پیدایش نمی‌کنید، وبسایت وسپوچی قابل‌جستجو است و اطلاعاتی علاوه بر اطلاعات موجود روی دستگاه دارد.

تنظیمات لایه

تنظیمات لایه را می توان از طریق کنترل لایه (منوی "همبرگر" در گوشه بالا سمت راست) تغییر داد ، همه تنظیمات دیگر از طریق دکمه تنظیمات منوی اصلی قابل دسترسی است. لایه ها را می توان فعال ، غیرفعال و به طور موقت پنهان کرد.

انواع لایه های موجود:

اطلاعات بیشتر را می توانید در بخش نمایش نقشه مشاهده کنید.

ترجیحات

توضیحات کامل را اینجا ببینید ترجیحات

ترجیحات پیشرفته

توضیحات کامل را اینجا ببینید ترجیحات پیشرفته

Reporting and Resolving Issues

اگر وسپوچی خراب شود یا حالتی ناسازگار را تشخیص دهد، از شما خواسته می شود که برگرفتِ خرابی را ارسال کنید. لطفاً اگر چنین شد، این کار را انجام دهید، اما فقط یک بار در هر موقعیت خاص. اگر می‌خواهید اطلاعات بیشتری بدهید یا برای درخواست ویژگی یا موارد مشابه مسئله‌ای باز کنید، لطفاً این کار را در اینجا انجام دهید: پیگیر مسائل وسپوچی. عملکرد «ارائه بازخورد» از منوی اصلی مسئلهٔ جدیدی باز می‌کند و اطلاعات مربوط به برنامه و دستگاه را بدون تایپ اضافی شامل می‌شود.

If you are experiencing difficulties starting the app after a crash, you can try to start it in Safe mode on devices that support short cuts: long press on the app icon and then select Safe from the menu.

If you want to discuss something related to Vespucci, you can either start a discussion on the OpenStreetMap forum.