在开始之前:大多数屏幕的菜单中都有指向设备内置帮助系统的链接,可让您直接访问与当前上下文相关的信息,您也可以轻松导航回此文本。如果您使用的是较大的设备,例如平板电脑,您可以在单独的分屏窗口中打开帮助系统。所有帮助文本及更多内容(常见问题解答、教程)也可以在 Vespucci文档网站 上找到。在支持快捷操作的设备上,您还可以通过长按应用图标并选择“帮助”来直接启动帮助查看器。

Vespucci 介绍

Vespucci是一款功能齐全的OpenStreetMap编辑器,支持桌面编辑器提供的大多数操作。它已在Google Android 2.3至14.0(不再支持4.1之前的版本)及各种基于AOSP的系统上成功通过测试。需要提醒的是:尽管移动设备的性能已可媲美桌面设备,但较旧的设备尤其内存非常有限且往往运行缓慢。使用Vespucci时应考虑此因素,例如将编辑区域控制在合理范围内。

使用 Vespucci 编辑

根据屏幕大小和设备的新旧,编辑操作可以使用顶部栏的图标、顶部栏右侧的下拉菜单、底部栏(如果有的话)或通过菜单进行。

下载 OSM 数据

选择传输图标Transfer或"传输"菜单项。这将显示十一个选项:

下载数据到设备,最简单方法是拉到要编辑的地方,然后选择“下载当前视图”。 缩放的话,可以使用两只手指、缩放按钮或音量键。 Vespucci 会下载当前看到这片区域的数据。 下载数据不需要身份验证。

在未锁定状态下,当您放大到足以启用编辑的级别时,所有未下载区域将相对于已下载区域显示为暗色。此举旨在避免在未显示区域中不慎添加重复对象。在锁定状态下,暗色显示功能将被禁用;此行为可通过高级首选项更改为始终启用暗色显示。

若需使用非标准OSM API入口,或以_MapSplit_格式使用离线数据,可通过图层控制中数据层的_配置..._项添加或更改条目。

编辑

锁定、解锁,模式切换

为避免手滑,Vespucci 启动的时候是“锁定”模式,该模式仅允许缩放和移动地图。 点击 Locked 锁定图标解锁编辑。

长按锁定图标或地图显示溢出菜单中的_模式_菜单,将显示提供4个选项的菜单:

若您在支持快捷操作的Android设备上使用Vespucci(通过长按应用图标),可直接启动至_地址_和_室内_模式。

单击,双击和长按

默认情况下,可选择的节点和路径周围有一个橙色区域,大致指示出一个范围,点击这个范围都可以选择到这个物件。三个选择:

如果你要编辑的地方很密,放大地图来编辑,或者换大屏幕。

Vespucci 有撤销和重做的功能(类似电脑上的 Ctrl + Z 和 Ctrl + Y),编辑的时候尽管随便尝试,但不要把你练习的数据 po 上网。

选择与取消选择(单击与“选择菜单”)

点了一个物件,它高亮显示了,这个时候是“选择”,再点一下物件以外的空白区域,那就是“取消选择”。 如果要多选物件,先点一个物件,然后双击这个物件,就能连续点后面的物件了。双击一个物件将启动多选模式

请注意,如果你尝试选择一个物件,而这个范围里有多个物件(例如路径上的一个节点或其他重叠对象),软件会显示一个菜单,你再从菜单里选择你要的那个物件。

你选了一个物件,它周围会有细黄色边框。这个黄色边框不一定看得清,要看你的地图背景和放得够不够大。 选择了之后,会弹出一个通知,你要确认选择。

选完了,会有一个这个物件可以用的操作列表(以按钮或菜单项的形式):有关详细信息,请参阅已选择节点已选择路径以及已选择关系

选择对象:编辑标签

选择了一个物件,再点它一次,会打开标签编辑器,可以编辑与该物件关联的标签。

请注意,对于重叠的物件(例如路径上的节点),再点它一次,又会出现菜单,这个时候你要再选一次这个物件,才会打开标签编辑器。如果你在第二次出现菜单的时候,选择了另一个对象,那就变成是首次选中另一个对象,不会打开另一个对象的标签编辑器。

选择物件:移动节点或路径

如果选择了一个物件,它就可以被移动。 请注意,物件只有在被选择时,才能移动。你不用很精准按住,只需在所选物件附近(以其为中心,一个圆形区域都是拖动区域)拖动屏幕,即可移动物件的位置。在首选项中调大拖动区域,所选节点周围的可拖动区域就会变大,更容易定位物件。

添加新节点或路径

首次以“简单模式”启动应用程序时,可以在主菜单取消选中相应的复选框进行更改。

简单模式

按住地图画面上的绿色大浮动按钮,会弹出一个菜单。 选择其中一项后,再点一下地图上对应的位置即可创建物件。在点击之前,不会影响你调整地图视图、平移和缩放地图。

更多信息请参见在简易操作模式下新建对象。简易模式是新安装的默认模式。

高级(长按)模式

长按你希望节点所在的位置或路径开始的位置。 屏幕上会出现一个黑色的“十字准线”符号,十字准线出现之后,手不要放开,可以拖到你要瞄准的地方。这个时候可以松开手。 * 如果要创建新节点(不连接到物件),长按的时候远离现有物件,在空的地方按。 * 如果要延长路径,请在路径的“容差区”内(或路径的节点)触摸,这个容差区显示在节点或路径周围。

看到十字准线符号后,有几个选项:

你可以连续点屏幕,来一直添加路径的节点。添加完了,请双击最后一个节点。如果最后一个节点位于已有的路径或节点上,那就不用双击了,这个片段会自动连接到已有的路径或节点。

你也可以使用菜单项目:请参阅创建新物件了解更多信息。

添加区域

与其他地理数据系统不同,OpenStreetMap 目前没有“区域”这种物件类型。 网页编辑器“iD”它是从底层 OSM 元素中制造一个抽象的区域,这在某些情况下效果很好,在其他情况下则不然。 Vespucci 不打算这样子搞,所以你需要了解一下区域的表示方式:

改善路径的几何形状

选择一条路径之后,如果你放大得足够大,可以看到路径中间有个小叉。拖动那个小叉就能在小叉的位置增加一个节点。这样子就能很方便让一条路径的形状变得更加正确。注意了,为避免平时意外创建节点,那个小叉能点到的区域很小,你没那么容易按到。

剪切、复制和粘贴

您可以复制选中的节点和路径,然后在新位置粘贴一次或多次。剪切操作将保留osm id和版本号,因此只能粘贴一次。粘贴时需长按目标位置(此时会显示标记位置的十字准星),然后从菜单中选择"粘贴"。

高效地添加地址

Vespucci 能高效地预测门牌号(街道左右两侧是单独的,不会联合预测),并根据上次使用的值以及它们有多近,自动添加 addr:street 或者 addr:place 的标签,通过这个功能可以提高测量地址的效率。在最好的情况下,不用打字就能添加地址。

长按Address即可触发添加标签的功能:

直接添加单个地址节点,可以从默认的“简单模式”切换到“地址”编辑模式(长按锁定按钮)。“添加地址节点”将在该位置添加一个地址节点。如上所述,如果它在建筑轮廓上,则会添加入口标签。

门牌号预测的功能,通常需要在道路的两个单侧各输入至少两个门牌号才能生效,能输入的门牌号越多则越好。这段的意思是,比如一条街,你站在街头(相对街尾),左手门牌 001,右手门牌 002,整条街 100 个门,左手全是单数,右手全是双数。没有要求你准确找到街头街尾的位置,但是你至少找到单数侧任意两个门牌的准确位置以及双数侧任意两个门牌的准确位置(同侧门牌越远越好)。比如说你找到 15 号和 65 号,软件就能自动等距补齐 001 到 015 的门牌号、015 至 065、065 至 099。但因为是等距,肯定是不准确的,如果之后你又能发现 085 的准确位置,那么 085 附近的就能更准确了。这个功能意义在于,你不用重复登记一百次门牌号,你只需要等差数列去登记,让自动补齐的门牌基本对应实际,你就可以收工了。

用这个功能的时候,你最好打开自动下载模式。

添加转向限制

Vespucci 有一种快速添加转弯限制的方法。如有必要,它会自动拆分路径,并要求你重新选择元素。转弯限制,就是某个路口不允许右转的这种情况。

Vespucci "锁定" 模式

当显示红色锁定标志时,不能编辑。 这时长按 OpenStreetMap 物件或周围,将显示其详细信息。

保存您的变更

“(需要网络连接)”

下载数据的时候点了哪些菜单,现在就怎么点,然后选择“将数据上传到 OSM 服务器”。

Vespucci支持OAuth 2、OAuth 1.0a授权及经典的用户名密码验证方式。自2024年7月1日起,标准OpenStreetMap API仅支持OAuth 2,其他验证方式仅适用于私有部署的API或复用OSM软件的其他项目。

授权Vespucci代表您访问账户需要您使用显示名称和密码执行一次性登录。若尝试上传修改数据时Vespucci安装未获授权,系统将提示您登录OSM网站(通过加密连接)。登录成功后,系统将要求您授权Vespucci使用您的账户进行编辑。若您希望在编辑前预先授权OAuth访问账户,可在"工具"菜单中找到对应选项。

如果要保存作业,但这时不能上网,可以保存到 .osm 文件中,这种文件格式与 JOSM 兼容。有网之后,可以使用 Vespucci 或 JOSM 上传。

上传时解决冲突

Vespucci 有一个简单的冲突解决器。 但如果你怀疑你的编辑存在重大问题,请将你的更改导出到 .osc 文件(“传输”菜单里有个“导出”),并在电脑上使用 JOSM 修复,然后上传。 请参阅冲突解决的详细帮助。

附近兴趣点显示

通过上拉底部菜单栏中上部的拖动手柄,即可显示附近兴趣点界面。

有关此功能及主显示屏上其他可用功能的更多信息,请参见主地图显示

使用 GPS 与 GPX 轨迹

在标准设置下,Vespucci 将尝试启用设备上的 GPS(以及其他基于卫星的导航系统)。如果不行,则会用基站位置来定位。 此行为假定您在正常使用中将您的 Android 设备本身配置为仅使用 GPX 生成的位置(以避免跟踪),即您已关闭委婉命名的“提高位置准确性”选项。 如果您想启用该选项但又想避免 Vespucci 回退到“网络位置”,您应该关闭高级首选项中的相应选项。(太长不看版:这段可以跳过不看的,第二句开始就谷歌翻译了,我完全没理解什么意思,又想关 GPS 避免政府跟踪,又想软件不要只用模糊定位?咋那么矫情呢?)

点击GPS按钮(通常位于地图显示左侧)将使屏幕居中显示当前位置,移动时地图将自动平移保持居中。手动移动屏幕或编辑操作将禁用"GPS跟随"模式,此时蓝色GPS箭头会从轮廓变为实心箭头。如需快速返回跟随模式,只需再次点击GPS按钮或重新勾选相应菜单选项。若设备未获取当前位置,定位标记/箭头显示为黑色;获取到当前位置时则显示为蓝色。

要记录 GPX 轨迹,并将其显示在您的设备上,请选择 GPS 菜单中的“开始 GPX 轨迹”项。 当前已记录的轨迹会作为一个图层显示出来,你可以从[图层控制](Main%20map%20display.md)中上传和导出轨迹。 可以将本地 GPX 文件以及从 OSM API 下载的轨迹添加为图层。

注意:默认情况下,Vespucci 不会把高程数据记录进 GPX 轨迹,这是由于某些 Android 特定问题造成的。要启用高程记录,请安装重力模型,或者更简单地,转到 高级首选项 并配置 NMEA 输入。(感觉像甩锅,隔壁 OpenCamera 都能在录像中持续记录海拔高度,虽然安卓手机的 GPS 海拔高度误差大得几乎不可用就是了)

如何导出GPX轨迹?

打开图层菜单,点击"GPX录制"旁的三点菜单,然后选择导出GPX轨迹…。选择导出轨迹的目标文件夹,输入以.gpx为后缀的文件名(例如:MyTrack.gpx)。

注释、问题与待办事项

Vespucci 支持下载、评论和关闭 OSM 注释(以前称为 OSM bugs)以及由 OSMOSE 质量保证工具 生成的“错误”。这两样都能完整下载,或者你可以使用自动下载工具访问你附近区域中的项目。编辑或关闭后,你可以立即上传错误或注释,也可以一次上传所有内容。

此外,我们支持可通过OSM元素、GeoJSON图层或在Vespucci外部创建的"待办事项",这为持续追踪待完成工作提供了便捷方式。

地图上的注释和问题以小型错误图标Bug表示:绿色表示已关闭/解决,蓝色表示由您创建或编辑,黄色表示仍处于活动状态且未被修改。待办事项则使用黄色复选框图标。

OSMOSE问题与待办事项显示功能会以蓝色链接指向受影响元素(待办事项仅在关联OSM元素时显示链接),点击该链接将选中对象、将屏幕居中显示于该对象,并在必要时预先下载区域。

筛选

除了全局启用注释和错误显示之外,你还可以设置过滤的程度以减少混乱。过滤器配置可以从任务图层的图层控制里面去配置:

室内模式

在室内画地图很难,因为经常会有很多物件重叠。Vespucci 有一个专用的室内模式,可以过滤出只在同一级别的物件,并自动把当前楼层添加到新创建的物件属性里。

该模式可以通过长按锁定按钮来启用,参见锁定、解锁、模式切换并选择相应的菜单项。

C 模式

在 C 模式下,仅显示设置了警告标志的物件,很容易发现具有特定问题或匹配可配置检查的物件。 如果选择了一个物件,并且在 C 模式下启动了属性编辑器,则将自动应用最佳匹配预设。

该模式可以通过长按锁定按钮来启用,参见锁定、解锁、模式切换并选择相应的菜单项。

设置检查

所有验证可在首选项的"验证器设置/启用验证"中禁用/启用。

"重新调查"条目配置允许设置标签组合需重新调查的时限。"检查"条目指通过匹配预设确定应在对象上存在的标签。点击条目即可编辑,绿色菜单按钮允许添加条目。

重新调查条目

重新调查含有以下属性的条目:

KeyValue 会根据相关对象的 existing 标签进行检查。

标准预设中的 Annotations 组里面包含了一个项目,这个项目可以自动添加带有当前日期的 check_date 的标签。

检查条目

检查条目具有以下两个属性:

此检查首先确定已匹配上的预设,然后根据预设检查 关键字 是否是此物件的“推荐”关键字,必选项 将检查扩展到物件的选项。注意:当前链接的预设未检查。

筛选

基于标签的过滤器

过滤器可以从主菜单启用,然后点击过滤器图标修改过滤的配置。更多文档可以在这里找到标签过滤器

基于预设的过滤器

上述的替代方法,是根据单个预设或预设组来过滤物件。点击过滤器图标将显示一个预设选择对话框,类似于 Vespucci 其他地方使用的对话框。单个预设可以通过正常单击选择,预设组要长按才能选择(单击则是进入组)。 更多文档可以在这里找到预设过滤器

自定义 Vespucci

可以自定义应用程序的许多方面,如果您正在寻找特定的东西但找不到它,可以在Vespucci 网站 搜索,网站上还包含有关设备上可用内容的附加信息。

图层设置

图层设置可以通过图层控件(右上角的“汉堡”菜单)进行更改,所有其他设置都可以通过主菜单首选项按钮进行访问。 图层可以启用、禁用和暂时隐藏。

可用的图层类型:

更多信息可以在地图显示部分找到。

首选项

完整的描述可以在这里找到首选项

高级首选项

完整的描述可以在这里找到高级首选项

问题报告与解决

如果 Vespucci 出现崩溃,或者它检测到不一致的状态,您将被要求发送崩溃转储文件。如果发生这种情况,请按下面说的来做,每种情况只做一次就行。如果你想为功能请求或类似内容提供进一步的打字说话或开启一个 Github 的 issue,请在此处进行:[Vespucci 问题跟踪器](https://github.com/MarcusWolschon/osmeditor4android/issues)。主菜单中的“提供反馈”功能将开启一个 Github 的 issue ,并包含相关的应用程序和设备信息,而无需额外输入。

若应用崩溃后启动困难,可在支持快捷操作的设备上尝试以_安全_模式启动:长按应用图标,然后从菜单中选择_安全_。

若需讨论Vespucci相关主题,您可在OpenStreetMap forum发起讨论。