開始之前:大部分操作畫面在選單當中連結到裝置上的說明系統,能夠給予相關操作的資訊,你也能輕易找到這段文字。如果你有畫面較大的裝置,例如平板的話,你也能有分割畫面模式來開啟說明文件。所有的說明文件以及其他文件 (常見問題、教學) 也能在 Vespucci 文件網站 找得到。你可以直接在支援快捷方式的裝置直接對著 app 圖示長按,然後選擇"說明"

Vespucci 介紹

Vespucci 是全功能的開放街圖編輯器,支援大部分能在桌面版編輯器能做的操作。Vespucci 已經在 Google Android 2.3 到 14.0 ( 4.1 之前的版本已經不支援了) 等多個以 AOSP 為基礎的版本測試成功。忠告:儘管行動裝置的效能已經追上桌機,但在較老的裝置上面,記憶體並不夠,因此運作速度上會很慢。你應該記住上述的事情,並且可能的話,控制自己編輯的區域大小在合理的大小。

使用 Vespucci 編輯

根據畫面尺寸和您裝置的新舊,編輯操作可以經由在頂端列的圖示可直接進入,通過下拉選單中頂端列的右側,從底部列(如果存在的話) ,或者透過選單鍵。

下載 OSM 資料

選擇轉移圖示 Transfer,或是轉移選項的項目,這樣會顯示十一個選項:

最簡單下載資料到裝置的方式是縮放和平移到你想編輯的地方,接著選擇 "下載當前檢視"。你可以用手勢縮放,用縮放按鈕,或是用裝置的音量鍵。Vespucci 應當下載當前檢視的資料,下載資料到裝置時並不需要認證。

採用非鎖定設定時,所有非下載區域相比下載區域會用暗淡色顯示,只有在放大到一定程度才會允許編輯。這是要避免在未顯示區域不適當的新增重覆物件。在鎖定狀態時,暗淡色顯示則會取消,而在進階設定當中能改變行為,能夠一直以暗淡色顯示。

如果你需要非正規 OSM API 輸入,或是以 MapSplit 格式使用離線資料,你可以在 設定... 的圖層控制當中資料圖層那邊改變。

編輯

鎖定,解鎖,模式切換

要避免不小心編輯的狀況,Vespucci 啟動時處於"鎖定"模式。處於鎖定模式時只允許縮放和移動地圖。點 Locked  圖示則會解鎖螢幕。

在鎖定圖示長按,或是在地圖顯示的 模式 選單,跳出選單會顯示以下四個選項:

如果你使用 Vespucci 的 Android 裝置支援快捷選項 (對著 app 圖示長按),你可以直接進入 地址室內 模式。

單點,雙點和長按

根據預設設定,可選擇的節點或是路徑周圍會出現橘色區域,粗略表示你可以從那裡選碰觸選擇物件。你有三個選擇:

如果您試著編輯高密度區域時進行放大,這是一個很好的對策。

Vespucci 擁有一個良好的"取消/重做"系統,所以不要害怕在您的裝置嘗試,但是請不要上傳和儲存純測試資料。

選擇/取消選擇 (單擊和“選擇選單”)

碰觸物件選取和高亮度顯示物件,碰觸螢幕空白處則會取消選取。如果你選取物件後你想再選取其他物件,就輕觸你想選取的物件,不需要先解除選取。在物件雙點會啟用多重選取模式

注意如果你嘗試選取物件,而 Vespucci 覺得這次選取重作可能意味多重選取物件 (像是路徑上的節點,或是重疊的物件),之後會出現選取選單:點你想選取的物件,物件就會被選取。

選取物件會以黃色細邊線顯示,黃色邊線也許會難以查察,視地圖背景和放大因子而定。一旦選取,你會看到通知確認要選取。

一旦選取完成,你會看到 (可能是按鈕或是選單項目) 對選取物件的支援操作清單。要看更多資訊,請見 物件選取, 路徑選取關係選取

選擇物件:編輯標籤

第二次碰觸選取物件會開啟標籤編輯器,而你可以編輯選取物件的標籤。

注意當有重疊的物件 (像是路徑上的節點),選取選單會再次顯示。選取相同物件則會出現標籤編輯器,選取其他物件則會轉而選取其他物件。

選擇物件:移動節點或路徑

一旦你選取物件,也可以移動。注意這個物件在選取動況可以被拖動/移動。簡單在選取物件附近拖動 (在容忍範圍內)。如果你在設定中選擇大拖動範圍,你在選擇節點時會有物件附近的大範圍,能讓你有很方便置放物件。

增加新節點/點或是路徑

啟動 App 時就啟用"簡單模式",這個設定能透過取消選取相對應的核取方塊,在主要選單中更動。

簡易模式

按著地圖畫面上的綠色浮動按鈕,能顯示選單。當你選擇其中一個項目時,你會被問到想在那個位置新建物件,持續平移和縮放到你想要的地圖畫面為止。

請看簡單模式下新增物件 來得到更多資訊。簡單模式為新安裝的預設值。

進階 (長按) 模式

在你創建節點或是路徑開始的地方長按,你會看到黑色"十字"圖樣。 * 如果你想要創建新的節點 (並沒有連到其他物件),請避開按到其他已有的物件。 * 如果你想延伸路徑,按在路徑的"容許區域" (或是路徑上的節點)內。容許區域會顯示在節點或是路徑周邊。

一旦你看到準星圖示,你有這些選擇:

簡單在你想增加節點的路徑上碰觸螢幕,要完成操作,請在最後一個節點碰觸兩次。如果最後的節點位於路徑或是節點,則片段會自動連到路徑或是節點。

你也可以使用選單項目:請見創建新物件 來獲得更多資訊。

增加區域

目前開放街圖並沒有如其他地理資訊系統一樣,有"區域"物件類型。線上編輯器 "iD" 編輯嘗試在現有 OSM 架構下,建立區域類型,目前看來在特定狀況下運作相當好,也有不能好好運作的時候。Vespucci 目前並沒有計畫像 iD 一樣做類似的事情,所以你必須知道路徑區域是怎麼構成的:

改善道路的幾何形狀

如果你放大到夠大的程度,選取夠長的路徑中間會看到小的"x"。拖動"x"會在路徑位置上創建新的節點。注意:要避免不小心創新節點,因此操作碰觸的容忍區域相當小。

剪下、複製和貼上

您可以複製選擇的節點和路徑,然後貼上一次或多次到一個新的位置。剪切將保留 OSM ID 和版本,但只能貼上一次。要貼上長按要貼上的位置(您會看到一個十字線標記的位置)。然後從選單中選擇“貼上”。

有效的增加地址

Vespucci 支援能更有效率在現地調查地址的功能,那就是預測門牌號碼功能 (分別在道路左側與右側作用),以及依據位置與上次使用的值自動添加 addr:street 或者 addr:place。在最佳情境下,能夠允許添加地址時不用輸入任何資訊。

可以長按 Address 來啟動新增標籤:

要直接新增單獨的地址節點的話,則是在預設的"簡單模式"切換到"地址"編輯模式(長按鎖按鈕),"新增地址節點"則會在該位置新增地址節點,而如果在建築外緣則會像前述那樣加出入口標籤。

門牌號碼預測,一般需求要在道路的兩側,至少兩間房屋號碼需要輸入到作業中,更多的號碼存在於資料中越好。

考慮用這個功能搭配自動下載模式。

增加轉​​彎限制

Vespucci 有個快速增加轉彎限制的功能。如果需要則可以自動切割路徑,並且詢問後重新選擇物件。

Vespucci"鎖定"模式

當紅色鎖定圖示顯示時,所有非編輯動作都可以做。除此之外,長按或是接近物件時,如果是OSM物件時會顯示詳細資訊視窗

儲存您的變更

(需要網路連線)

選擇您在下載時相同的按鈕或選單項目,現在選擇 "上傳資料到 OSM 的伺服器"。

Vespucci 支援 OAuth 2,OAuth 1.0a 認證機制以及傳統的帳號名稱與密碼方式。自從 2024 年 7 月 1 日開始 OpenStreetMap API 只支援 OAuth 2,而其他方式則只在私有站點的 API 或是其他使用 OSM 軟體的計畫。

認證 Vespucci 連結你帳號,需要你以你帳號與密碼先登入一次。如果你的 Vespucci 還未認證,會在上傳變動的資料時,要求你到 OSM 網站登入 (透過加密連線)。當你登入後,會要求你授權 Vespucci 以你帳號編輯。如果你想要在編輯前授權 OAuth 連接你帳號,請到選單中的"工具" 當中設定好。

如果您想要儲存您的工作,並且不能連入網際網路,您可以儲存成 JOSM 相容的 .osm 檔案,以後以 Vespucci 或 JOSM 任何一個上載。

在上傳解決衝突

Vespucci 有個簡單的衝突解決。不管怎樣,如果您于您的編輯察覺到有重要事件,將您的更改匯出到 .osc 檔案 (在"傳輸"選單中"匯出"的選單項目) 並且修復和上傳給 JOSM。請參閱有關詳細的説明 衝突解決

顯示附近興趣點

顯示附近興趣點可以在底部選單中間拉起選項。

更多主選單上這個或其他可用的選項能在這邊顯示主要地圖找到。

使用 GPS 與 GPX 軌跡

當在標準設定時,Vespucci 會嘗試打開 GPS (以及其他依據衛星定位的導航系統),如果不行才會退下來用"電信網路"來定位。這項行為預設你是在正常狀態使用你的 Android 裝置,只採用 GPX 產生的位置 (避免遭到追蹤),就是委婉寫做"改進定位準確度"選項關閉。如果你想啟用這選項,但想避免 Vespucci 退下來採用"電信網路位置",你應該在 進階設定關閉該選項。

碰觸 GPS按鈕 (通常在地圖顯示的左側) 則會以目前位置置中螢幕,而當你移動地圖顯示時,則會維持置中。手動移動螢幕或是編輯時則會關閉"跟隨GPS"模式,以及藍色GPS箭頭則從輪廓變實心箭頭。要快速回到"跟隨"模式,只要碰觸 GPS 按鈕或是按其他選單選項。如果裝置沒有目前位置的標記/箭頭則會顯示為黑色,如果有目前位置則會顯示為藍色。

要錄製 GPS 軌跡並且在裝置上顯示,你要在GPS 選單選擇"開始錄製GPX軌跡"。這會在螢幕上新增目前錄製軌跡圖層,你可以在 圖層控制上傳或是匯出軌跡。你可以新增本地 GPX 檔案與從 OSM API 下載軌跡變成其他圖層。

注意:預設 Vespucci 不會在錄製 GPX 軌跡時記錄高度,這是因為一些 Android 裝置的特殊問題。要啟用高度記錄,需要啟用高度記錄,或是安裝重力模組,或是更簡單到進階設定 設定 NMEA 輸入。

如何匯出 GPS 軌跡?

開啟圖層選單,接著點在"GPS錄製"旁邊的3點選單,最後選擇輸出GPX軌跡...。選擇那個資料夾來匯出,接著以.gpx的後綴命名檔案 (例如:MyTrack.gpx)。

備註、錯誤和待辦事項

Vespucci 支援下載、回應和關閉 OSM 註解 (先前的 OSM 臭蟲),以及相等功能由 OSMOSE 品質監控工具產生的"臭蟲"。兩者都能完整下載下來,或者你可以使用自動下載功能,馬下輔助你取得所在區域的物件。一旦編輯或關閉,你可以馬上上傳臭蟲或是註解,或是全部一次上傳。

接著我們支援能從 OSM 元素,從 GeoJSON 圖層,或是從 Vespucci 外部新增的"待辦事項",這能夠提供方便追蹤你想要完成的事項的方式。

註解和臭蟲會以小蟲子圖示 Bug 顯示在地圖上面,綠色代表關閉/解決,藍色代表被新增或是由你編輯過,而黃色表示仍然有效還沒有變動。待辦事項則會以黃色勾選框顯示。

OSMOSE 錯誤以及待辦事項的顯示會將受影響的元素有連結,以藍色呈現出來 (而待辦事頁則只會顯示相關的 OSM 元素),碰觸連結則會選擇元素,置中螢幕並且必要時先下載區域的資料。

篩選

除了全域時啟用顯示註解和臭蟲以外,你可以設定粗略顯示過瀘降低雜亂程度。你可以從任務圖層當中的圖層控制當中,設定過濾選項:

室內模式

室內繪圖由於有相當多的物件而且常常彼此重疊,因此是相當有挑戰性的事情。Vespucci 發展出室內模式,能夠允許你過濾其他不在同一層的所有物件,並且自動加上目前樓層資訊到新增加的物件上面。

這個模式可以透過長按鎖定鈕,請見鎖定、解鎖、切換模式,然後選擇對應的選單選項。

C-模式

在 C-模式下,只有擁有警告標示的物件才會顯示,讓檢視有特定問題或符合設定檢查的物件變得更容易。C-模式下啟動的內容編輯器,最符合的預設組合會自動套用。

這個模式可以透過長按鎖定鈕,請見鎖定、解鎖、切換模式,然後選擇對應的選單選項。

設定檢查

所有的驗證都能在設定"驗證設定/啟用驗登"當中被關閉/開啟。

"重新踏查"的設定允許你設定一段時間重新踏查特定的標籤組合的物件。"檢查"項目則視符合的預置而被呈現出來。你可以點項目來編輯項目,綠色選單按鈕則允許新增項目。

重新踏察選項

重新踏察列表擁有以下內容:

會與問題物件 existing tags 相比檢查。

在標準預設組合當中的_Annotations_ 群組中 ,含有物件能夠自動增加現在時間的 check_date 標籤。

檢查選項

檢查列表有兩個內容:

這次檢查會先決定符合的預置,接著檢查是否是預置推薦的"建議"鍵值。必須的選擇性則會擴大檢查物件標籤中的"選擇性"標籤。注意:目前連結的預置並不會檢查。

篩選

標籤為依據的篩選

在主選單能啟用過濾器,可以按過濾器的圖示變更。更多說明文件可以到這邊標籤過濾器

預置為依據的篩選

上述的替代方式,依據單一預設組合或是預先組合群組過濾物件。按過濾圖示會顯示預設組合選擇選單,類似 Vespucci 裡見到的選單。只要正常按一下就可以選擇單一預設組合,要選擇預設組合群組則長按 (正常按一下之後進入群組)。更多文件說明可到這裡這邊尋找預設組合過濾器

客製化 Vespucci

這款 app 很多方面都能自訂,如果你想要特別的功能但找不到的話,可以到 Vespucci 網站搜尋,尋找裝置上的額外資訊。

圖層設定

圖層設定可以藉由圖層控制來改變 (在右上角"漢堡"選項),所有其他設定可以透過主選項設定按鈕設定進入。可以啟動、關闢或暫時隱藏圖層。

可用的圖層種類:

更多資訊能在地圖顯示取得。

參數選項

整個敘述能在這裡設定找到

進階參數選項

整個敘述能在這裡進階設定找到

回報與解決問題

如果 Vespucci 當掉,或是偵測不一致的狀態,你會被詢問是否傳送當機報告。如果發生的話請寄送報告,但請一次描述特定狀況。如果你想提供更多資訊,或是開啟 issue 請求新功能或其他類似請求,請到這邊開:Vespucci issue tracker。主選單的"提供回饋"功能會開放新的 issue,不用額外輸入就有包含相關的 app 和裝置資訊。

如果你遇到困難,開啟 app 後當掉,你可以在支援快捷鍵的裝置當中以 安全 模式開啟:對著 app 圖示長按,然後在選單選擇 安全 模式。

如果你想討論 Vespucci 相關議題,你可以在開放街圖討論區開啟討論。