Osmosis 0.46详细使用说明

原文地址：http://wiki.openstreetmap.org/wiki/Osmosis/Detailed_Usage_0.46
#全局选项

Short Option	Long Option	Description
-v	-verbose	需要输出日志的时候需要使能此选项
-v x	-verbose x	x是个正数，表示输出日志的任务数量, 0等同于-v参数选项.
-q	-quiet	不需要输出日志的时候需要使能此选项.
-q x	-quiet x	x是一个正数，用于表示不输出日志的任务数量, 0等同于-q参数选项.
-p < plugin_class >	-plugin < plugin_class >	运行加载外部插件. < plugin_class > 是基于 com.bretth.osmosis.core.plugin.PluginLoader接口的插件名称. 这个选项可以有多个，用于指定不同的插件.

#默认参数
有些处理任务可以使用默认参数，因此在任务描述中，只要将参数设置成"default"即可。
例如，–read-xml 任务可以使用默认参数。如下两种写法，作用等效：

osmosis --read-xml file=myfile.osm --write-null
osmosis --read-xml myfile.osm --write-null

#内部任务处理
从发行版0.31开始，所有的任务默认都是0.6版本.

0.6版本任务首次被引入是在0.30发行版. 0.5 版本任务0.5版本任务在0.36版本被抛弃. 0.4版本任务在0.22版本被抛弃.

#数据库处理任务API
本任务主要提供OSM数据导入数据库表的API接口．这个处理任务只支持０.6版本的数据库，并且支持PostgreSQL和MySQL．但是我们强烈推荐使用PostgreSQL数据库，因为我们在这上面进行了大量测试．
–read-apidb (–rd)
在特定时刻通过数据库API读取数据库内容

管道描述符

管道	描述符
输出管道０	数据输出流

可选描述符

可选项	描述符	有效值范围	默认值
authFile	数据库登录证书文件名.		N/A
host	数据库服务器地址.		localhost
database	数据库名.		osm
user	数据库用户名.		osm
password	数据库密码.		(blank)
dbType	数据库使用类型.	postgresql, mysql	postgresql
validateSchemaVersion	如果等于yes,那么在访问数据库之前，处理任务将对当前模式进行校验.	yes, no	no
allowIncorrectSchemaVersion	如果validateSchemaVersion参数等于yes的话,这个选项控制模式校验失败的处理. 如果参数值为yes, 将显示出一个警告，程序继续运行. 如果这个选项参数值为no, 出现错误的时候，程序将终止.	yes, no	yes
readAllUsers	如果设置为yes, 用户公开编辑标志将被忽略，用户信息将被附加到每个实体.	yes, no	no
snapshotInstant	定义生成数据的时间点.	format is “yyyy-MM-dd_HH:mm:ss”	(当前时间)

–read-apidb-current (–rdcur)

读取API数据库的当前内容。 请注意，此任务不能用作复制的起点，因为它不会生成一致的快照。

管道	描述符
输出管道.0	处理一个实体流.

选项	描述符	有效值范围	默认值
authFile	包含数据库登录凭证的文件的名称（有关详细信息，请参阅数据库登录凭证）.	N/A
host	数据库主机服务器地址.		localhost
database	数据库实例.		osm
user	数据库用户名.		osm
password	数据库密码.		(blank)
dbType	数据库使用类型．	postgresql, mysql	postgresql
validateSchemaVersion	如果参数值为yes,该处理任务将会在访问数据库之前对数据库模式进行校验.	yes, no	yes
allowIncorrectSchemaVersion	如果validateSchemaVersion参数等于yes的话,这个选项控制模式校验失败的处理. 如果参数值为yes, 将显示出一个警告，程序继续运行. 如果这个选项参数值为no, 出现错误的时候，程序将终止.	yes, no	yes
readAllUsers	如果设置为yes, 用户公开编辑标志将被忽略，用户信息将被附加到每个实体.	yes, no	no

–write-apidb (–wd)
填充一个空白数据库

管道	描述符
输入管道.0	处理一个实体流.

可选项	描述符	有效值	默认值
authFile	包含数据库登录凭证的文件的名称（有关详细信息，请参阅数据库登录凭证）.		N/A
host	数据库主机服务器地址.		localhost
database	数据库实例.		osm
user	数据库用户名.		osm
password	数据库密码.		(blank)
dbType	数据库使用的类型. (支持修订版 >= 15078, 版本 > 3.1)	postgresql, mysql	postgresql
validateSchemaVersion	如果参数值为yes,该处理任务将会在访问数据库之前对数据库模式进行校验.	yes, no	yes
allowIncorrectSchemaVersion	如果validateSchemaVersion参数等于yes的话,这个选项控制模式校验失败的处理. 如果参数值为yes,将显示出一个警告，程序继续运行. 如果这个选项参数值为no,出现错误的时候,程序将终止.	yes,no	yes
lockTables	如果指定为yes,表将在导入期间锁定.这提供了可衡量的性能改进,但是阻止了并发查询.	yes,no	yes
populateCurrentTables	如果指定了yes,则将在最初的历史记录表填充后填充当前表.如果只需要历史记录表，这将使进口时间减少大约80％.	yes,no	yes

–read-apidb-change (–rdc)
通过数据库API读取特定时间间隔的更改。

管道	描述符
输出管道.0	处理一个实体流.

选项	描述符	有效值	默认值
authFile	包含数据库登录凭证的文件的名称（有关详细信息，请参阅数据库登录凭证）.		N/A
host	数据库主机服务器地址.		localhost
database	数据库实例.		osm
user	数据库用户名.		osm
password	数据库密码.		(blank)
dbType	数据库使用类型.	postgresql, mysql	postgresql
validateSchemaVersion	如果参数值为yes,该处理任务将会在访问数据库之前对数据库模式进行校验.	yes, no	yes
allowIncorrectSchemaVersion	如果validateSchemaVersion参数等于yes的话,这个选项控制模式校验失败的处理. 如果参数值为yes,将显示出一个警告，程序继续运行. 如果这个选项参数值为no,出现错误的时候,程序将终止.	yes, no	yes
readAllUsers	如果设置为yes，用户公共编辑标志将被忽略，用户信息将被附加到每个实体．	yes, no	no
intervalBegin	定义生成更改集的时间间隔的开始时间.	格式 “yyyy-MM-dd_HH:mm:ss”	(1970)
intervalEnd	定义生成更改集的时间间隔的结束时间.	格式 “yyyy-MM-dd_HH:mm:ss”	(now)
readFullHistory	只限于0.6版本.如果设置为yes，则会生成指定时间间隔的完整历史记录，而不是在该间隔中修改的每个实体的单个更改．这对于标准更改集没有用处，如果正在生成具有完整历史记录的数据库副本，则这很有用．更改使用此选项生成的文件很可能无法被支持*.osc文件格式的大多数工具处理．	yes,no	no

–write-apidb-change (–wdc)
将变更集应用于现有的填充API数据库。

管道	描述符
输入管道.0	产生一个改变数据流.

选项	描述符	有效值范围	默认值
authFile	包含数据库登录凭证的文件的名称（有关详细信息，请参阅数据库登录凭证）.		N/A
host	数据库主机服务器地址.		localhost
database	数据库实例.		osm
user	数据库用户名.		osm
password	数据库密码.		(blank)
dbType	数据库使用类型．	postgresql, mysql	postgresql
validateSchemaVersion	如果参数值为yes,该处理任务将会在访问数据库之前对数据库模式进行校验.	yes, no	yes
allowIncorrectSchemaVersion	如果validateSchemaVersion参数等于yes的话,这个选项控制模式校验失败的处理. 如果参数值为yes,将显示出一个警告，程序继续运行. 如果这个选项参数值为no,出现错误的时候,程序将终止.	yes, no	yes
populateCurrentTables	如果指定了yes,则将在最初的历史记录表填充后填充当前表. 如果在导入过程中只填充历史记录表,这很有用.	yes,no	yes

–truncate-apidb (–td)
截断API数据库中的所有当前表和历史表.

管道	描述符
没有管道

选项	描述符	有效值范围	默认值
authFile	包含数据库登录凭证的文件的名称（有关详细信息，请参阅数据库登录凭证）.		N/A
host	数据库主机服务器地址.		localhost
database	数据库实例.		osm
user	数据库用户名.		osm
password	数据库密码.		(blank)
dbType	数据库使用类型.	postgresql, mysql	postgresql
validateSchemaVersion	如果参数值为yes,该处理任务将会在访问数据库之前对数据库模式进行校验.	yes, no	yes
allowIncorrectSchemaVersion	如果validateSchemaVersion参数等于yes的话,这个选项控制模式校验失败的处理. 如果参数值为yes,将显示出一个警告，程序继续运行. 如果这个选项参数值为no,出现错误的时候,程序将终止.	yes, no	yes

#MySQL Tasks
MySQL任务将与支持OSM API的MySQL模式一起使用．请注意，这些任务没有0.6版本．相反，他们被替换为“apidb”任务．

–read-mysql (–rm)
在特定时刻读取MySQL数据库数据内容

管道	描述符
输出管道.0	产生一个实体流.

选项	描述符	有效值范围	默认值
authFile	包含数据库登录凭证的文件的名称（有关详细信息，请参阅数据库登录凭证）.		N/A
host	数据库主机服务器地址.		localhost
database	数据库实例名.		osm
user	数据库用户名.		osm
password	数据库密码.		(blank)
validateSchemaVersion	如果参数值为yes,该处理任务将会在访问数据库之前对数据库模式进行校验.	yes, no	yes
allowIncorrectSchemaVersion	如果validateSchemaVersion参数等于yes的话,这个选项控制模式校验失败的处理. 如果参数值为yes,将显示出一个警告，程序继续运行. 如果这个选项参数值为no,出现错误的时候,程序将终止.	yes, no	yes
readAllUsers	如果设置为yes，用户公共编辑标志将被忽略，用户信息将被附加到每个.	yes, no	no
snapshotInstant	定义生成数据快照的时间点。	格式 “yyyy-MM-dd_HH:mm:ss”	(现在)

–read-mysql-current (–rmcur)
读取MySQL数据库的当前内容。 请注意，此任务不能用作复制的起点，因为它不会生成一致的快照。

管道	描述符
输出管道.0	处理一个数据流.

选项	描述符	有效值范围	默认值
authFile	包含数据库登录凭证的文件的名称（有关详细信息，请参阅数据库登录凭证）.		N/A
host	数据库主机服务器地址.		localhost
database	数据库实例名.		osm
user	数据库用户名.		osm
password	数据库密码.		(blank)
validateSchemaVersion	如果参数值为yes,该处理任务将会在访问数据库之前对数据库模式进行校验.	yes, no	yes
allowIncorrectSchemaVersion	如果validateSchemaVersion参数等于yes的话,这个选项控制模式校验失败的处理. 如果参数值为yes,将显示出一个警告，程序继续运行. 如果这个选项参数值为no,出现错误的时候,程序将终止.	yes, no	no

–write-mysql (–wm)
填充一个空的MySQL数据库

管道	描述符
输入管道.0	读取一个实体数据流.

选项	描述符	有效值范围	默认值
authFile	包含数据库登录凭证的文件的名称（有关详细信息，请参阅数据库登录凭证）.		N/A
host	数据库服务器地址.		localhost
database	数据库实例名.		osm
user	数据库用户名.		osm
password	数据库密码.		(blank)
validateSchemaVersion	如果参数值为yes,该处理任务将会在访问数据库之前对数据库模式进行校验.	yes, no	yes
allowIncorrectSchemaVersion	如果validateSchemaVersion参数等于yes的话,这个选项控制模式校验失败的处理. 如果参数值为yes,将显示出一个警告，程序继续运行. 如果这个选项参数值为no,出现错误的时候,程序将终止.	yes, no	yes
lockTables	如果指定为yes,表将在导入期间锁定. 这提供了可衡量的性能改进,但是阻止了并发查询.	yes, no	yes
populateCurrentTables	如果指定了yes，则将在最初的历史记录表填充后填充当前表。 如果只需要历史记录表，这将使进口时间减少大约80％。	yes, no	yes

–read-mysql-change (–rmc)
从MySQL数据库读取特定时间间隔的更改。

管道	描述符
输出管道.0	处理一个输出流.

选项	描述符	有效值范围	默认值
authFile	包含数据库登录凭证的文件的名称（有关详细信息，请参阅数据库登录凭证）.		N/A
host	数据库服务器地址.		localhost
database	数据库实例名.		osm
user	数据库用户名.		osm
password	数据库密码.		(blank)
validateSchemaVersion	如果参数值为yes,该处理任务将会在访问数据库之前对数据库模式进行校验.	yes, no	yes
allowIncorrectSchemaVersion	如果validateSchemaVersion参数等于yes的话,这个选项控制模式校验失败的处理. 如果参数值为yes,将显示出一个警告，程序继续运行. 如果这个选项参数值为no,出现错误的时候,程序将终止.	yes, no	yes
readAllUsers	如果设置为yes，用户公共编辑标志将被忽略，用户信息将被附加到每个实体.	yes, no	no
intervalBegin	定义生成更改集的时间间隔的开始.	格式"yyyy-MM-dd_HH:mm:ss"	(1970)
intervalEnd	定义生成变更集的时间间隔的结束.	format is “yyyy-MM-dd_HH:mm:ss”	(now)
readFullHistory	只有0.6版本支持. 如果设置为yes，则会生成指定时间间隔的完整历史记录，而不是在该间隔中修改的每个实体的单个更改。 这对于标准更改集没有用处，如果正在生成具有完整历史记录的数据库副本，则这很有用。 更改使用此选项生成的文件很可能无法被支持* .osc文件格式的大多数工具处理。	yes, no	no

–write-mysql-change (–wmc)
将变更集应用于现有的已填充MySQL数据库.

管道	描述符
输入管道.0	处理一个输入数据流.

选项	描述符	有效值范围	默认值
authFile	包含数据库登录凭证的文件的名称（有关详细信息，请参阅数据库登录凭证）.		N/A
host	数据库服务器地址.		localhost
database	数据库实例名.		osm
user	数据库用户名.		osm
password	数据库密码.		(blank)
validateSchemaVersion	如果参数值为yes,该处理任务将会在访问数据库之前对数据库模式进行校验.	yes, no	yes
allowIncorrectSchemaVersion	如果validateSchemaVersion参数等于yes的话,这个选项控制模式校验失败的处理. 如果参数值为yes,将显示出一个警告，程序继续运行. 如果这个选项参数值为no,出现错误的时候,程序将终止.	yes, no	yes
populateCurrentTables	如果指定了yes，则将在最初的历史记录表填充后填充当前表.如果在导入过程中只填充历史记录表,这很有用.	yes, no	yes

–truncate-mysql (–tm)
截断MySQL数据库中的所有当前表和历史表。

管道	描述符
无管道

选项	描述符	有效值范围	默认值
authFile	包含数据库登录凭证的文件的名称（有关详细信息，请参阅数据库登录凭证）.		N/A
host	数据库服务器地址.		localhost
database	数据库实例名.		osm
user	数据库用户名.		osm
password	数据库密码.		(blank)
validateSchemaVersion	如果参数值为yes,该处理任务将会在访问数据库之前对数据库模式进行校验.	yes, no	yes
allowIncorrectSchemaVersion	如果validateSchemaVersion参数等于yes的话,这个选项控制模式校验失败的处理. 如果参数值为yes,将显示出一个警告，程序继续运行. 如果这个选项参数值为no,出现错误的时候,程序将终止.	yes, no	yes

#XML Tasks
xml任务用于读写“osm”数据文件和“osc”变更集文件.

–read-xml (–rx)
读取OSM XML文件的当前内容.

管道	描述符
输出管道.0	处理一个输出实体流.

选项	描述符	有效值范围	默认值
file (default)	将要被读取的osm文件的文件名， “-” 代表STDIN.		dump.osm
enableDateParsing	如果设置为yes,则osm xml文件中的日期将被解析,否则所有日期将被设置为大约等于应用程序启动的单个时间. 如果输入文件不包含时间戳,那么将其设置为no才有用. 它用来提高性能,但日期分析现在开销很低.	yes, no	yes
compressionMethod	指定用于压缩文件的压缩方法. 如果指定了“auto”，压缩方法将从文件名（* .gz = gzip，* .bz2 = bzip2）自动确定.	auto, none, gzip, bzip2	auto

–fast-read-xml (no short option available)
只有0.6支持. 根据–read-xml任务，但使用STAX XML解析器而不是SAX来提高性能。 这已经经历了可靠的测试，应该是可靠的，但是所有xml处理任务还没有被重新编写来使用新的实现，因此这不是默认的。

–write-xml (–wx)
将数据写到OSM的XML文件中.

管道	描述符
输入管道.0	处理一个实体数据输入流.

选项	描述符	有效值范围	默认值
file (default)	将要被写入的osm文件的文件名，, “-” 代表STDOUT.		dump.osm
compressionMethod	指定用于压缩文件的压缩方法。 如果指定了“auto”，压缩方法将从文件名自动确定（* .gz = gzip，* .bz2 = bzip2）.	auto, none, gzip, bzip2	auto

–read-xml-change (–rxc)
读取OSM XML数据修改文件中的内容.

管道	描述符
输出管道.0	处理一个输出数据流.

选项	描述符	有效值范围	默认值
file (default)	将要被读取的osm修改文件名, “-” 代表 STDIN.		change.osc
enableDateParsing	如果设置为yes，则osm xml文件中的日期将被解析，否则所有日期将被设置为大约等于应用程序启动的单个时间。 如果输入文件不包含时间戳，那么将其设置为no才有用。 它用来提高性能，但日期分析现在开销很低.	yes, no	yes
compressionMethod	指定用于压缩文件的压缩方法。 如果指定了“auto”，压缩方法将从文件名自动确定（* .gz = gzip，* .bz2 = bzip2）.	auto, none, gzip, bzip2	auto

–write-xml-change (–wxc)
将修改写入OSM XML修改文件中

管道	描述符
输入管道.0	处理一个输入流.

选项	描述符	有效值范围	默认值
file (default)	将要被写入的osm文件的文件名, “-” 表示 STDOUT.		change.osc
compressionMethod	指定用于压缩文件的压缩方法。 如果指定了“auto”，压缩方法将从文件名自动确定（* .gz = gzip，* .bz2 = bzip2）.	auto, none, gzip, bzip2	auto

#地区过滤任务
这些任务可以用来通过基于感兴趣的位置进行过滤来检索数据。

–bounding-box (–bb)
提取经纬度坐标定义的特定边界框内的数据。

可参照 : Osmosis#Extracting_bounding_boxes

管道	描述符
输入管道.0	处理一个输入流.
输出管道.0	处理一个输出流.

| 选项 | 描述符 | 有效值范围 | 默认值 |
|–|--|–|
|left | 区域左侧的经度值. | -180 to 180 |-180|
|right | 区域右侧的经度值. | -180 to 180 |180|
|top | 区域顶端的纬度值. |-90 to 90| 90|
|bottom | 区域低端的纬度值. |-90 to 90 |-90|
|x1 | 盒子左边缘的滑动地图坐标. ||
|y1 | 盒子上边缘的滑动地图坐标. ||
|x2 | 盒子右边的滑动地图坐标. | x1 |
|y2 | 盒子底部边缘的滑动地图坐标. | y1 |
|zoom | 滑动地图缩放. | 12 |
|completeWays| 包含边界框中至少有一个节点的所有可用节点. 取代级联关系. |yes, no |no|
|completeRelations | 包含所有可用的关系，这些关系是在边界框中至少有一个成员的关系的成员。 意味着完整的方式。 取代级联关系. |yes, no| no|
|cascadingRelations | 如果选择一个关系包括所有的父母， 如果没有这个标志，包含关系的父代是否被包含，可以取决于它们出现的顺序 - 如果父关系被处理，但是在不知道它将通过 孩子的关系，那么它不包括在内. 有了这个标志，在作出决定之前，所有关系都会被读取。 如果completeWays或者completeRelations被设置，那么这个标志不是必需的，并且将被忽略，因为这些标志自动地创建所有关系的临时列表，从而允许正确的父母选择. 但是，级联关系使用的资源少于这些选项，因为它只需要临时存储关系. |yes, no| no|
|idTrackerType | 指定用于跟踪所选id的内存机制。 对于非常大的边界框（其中节点数大于最大节点ID的1/32），BitSet更有效，对于所有更小的边界框，IdList将更有效。 Dynamic将整个ID范围分成小段，并选择最有效的IdList或BitSet。|BitSet, IdList, Dynamic| Dynamic |
|clipIncompleteEntities | 指定在遇到与其他实体缺少关系的实体时行为应该是什么。 例如，缺少节点的方式以及与失踪成员的关系。 这通常发生在选择区域的边界处，但也可能由于数据库中的参照完整性问题或星球文件快照创建中的不一致性而发生。 如果设置为true，则修改实体以删除缺少的引用，否则保持不变. |true, false |false|
如果使用纬度/经度和滑动的地图坐标，那么纬度/经度坐标被滑动地图坐标覆盖。

–bounding-polygon (–bp)
在由多边形文件加载的一系列经纬度坐标定义的多边形内提取数据.

MapRoom网站描述了多边形文件的格式，但有两个例外:

这个任务中增加了一个特殊的扩展来支持负多边形，这些扩展是通过增加一个“！”来定义的。 字符在文件内多边形标题的名称之前。 查看“多边形过滤器文件格式”页面上的示例，以更好地了解如何使用负面多边形.
多边形定义中的第一个坐标对不是在MapRoom网站上定义的多边形质心; 这是第一个多边形点。 质心坐标不是渗透所需要的（也不是他们所期望的，但是如果存在的话它们不会破坏东西，并且被计算为多边形轮廓的一部分）。
“多边形过滤器文件格式”页面提供了一个明确的示例。
你可以在OSM-Subversion中找到欧洲国家的多边形

管道	描述符
输入管道.0	处理一个输入流.
输出管道.0	处理一个输出流.

选项	描述符	有效值范围	默认值
file	包含多边形定义的文件。		polygon.txt
completeWays	请参阅 - 对于框的文档.	yes, no	no
completeRelations	请参阅 --bounding-box文档.	yes, no	no
cascadingRelations	请参阅 --bounding-box文档.	yes, no	no
idTrackerType	请参阅–bounding-box文档.	BitSet, IdList, Dynamic	Dynamic
clipIncompleteEntities	请参阅–bounding-box.	true, false	false

#更改集派生和合并
这些任务提供osm和osc文件之间的粘合，允许从osm文件导出和合并更改.

–derive-change (–dc)
比较两个数据源并产生差异的变化集.

请注意，此任务要求输入流首先按类型排序，然后按ID排序.

管道	描述符
输入管道.0	处理一个输入流.
输入管道.1	处理一个输入流.
输出管道.0	处理一个输出流.

选项	描述符	有效值范围	默认值
bufferCapacity	输入缓冲区的大小。 这是根据要存储的实体对象的数量来定义的。 一个实体对应于一个OSM类型，比如一个节点.	正数	20

–apply-change (–ac)
将更改流应用于数据流.

请注意，此任务要求输入流首先按类型排序，然后按ID排序.

#管道	描述符
输入管道.0	处理输入数据流.
输入管道.1	处理输入数据流.
输出管道.0	处理输出数据流.

选项	描述符	有效值范围	默认值
bufferCapacity	输入缓冲区的大小。 这是根据要存储的实体对象的数量来定义的。 一个实体对应于一个OSM类型，比如一个节点。	正数	20

管道控制
这些任务允许管道结构被操纵。 这些任务不会对通过流水线的数据进行任何操作。

–write-null (–wn)
丢弃所有输入数据。 这对于渗透性能测试和测试输入文件的完整性是有用的。

管道	描述符
输入管道.0	处理一个输入管道.

选项	描述符	有效值范围	默认值
无参数

–write-null-change (–wnc)
丢弃所有输入更改数据。 这对于渗透性能测试和测试输入文件的完整性是有用的.

管道	描述符
输入管道.0	处理一个输入流数据.

选项	描述符	有效值范围	默认值
无参数

–buffer (–b)
允许将流水线处理分割到多个线程中。 输入任务的线程将数据发送到固定容量的缓冲区，并在缓冲区填充时阻塞。 此任务创建一个新的线程，如果没有可用的数据，则从缓冲区中读取数据块。 如果有多个CPU可用并且多个任务消耗大量的CPU，这是非常有用的.

管道	描述符
输入管道.0	处理输入流.
输出管道.0	处理输出流.

选项	描述符	有效值范围	默认值
bufferCapacity (default)	.	存储缓冲区的大小。 这是根据要存储的实体对象的数量来定义的。 一个实体对应于一个OSM类型，比如一个节点	100

–buffer-change (–bc)
按缓冲区而不是变化流。

管道	描述符
输入管道.0	处理输入流.
输出管道.0	处理输出流.

选项	描述符	有效值范围	默认值
bufferCapacity (default)	存储缓冲区的大小。 这是根据要存储的更改对象的数量来定义的。 更改对象由一个具有关联操作的实体组成。		100

–log-progress (–lp)
使用定期在信息级别的jdk日志记录进度信息。 这可以插入到管道中，以便跟踪长时间运行的任务的进度.

管道	描述符
输入管道.0	处理一个输入流.
输出管道.0	处理一个输出流.

选项	描述符	有效值范围	默认值
interval	以秒为单位的更新时间间隔.		5
label	这个特定记录器的日志消息将被加上前缀的标签.		empty string

–log-progress-change(–lpc)
以定期的间隔在信息级别使用jdk日志记录更改流的进度。 这可以插入到管道中，以便跟踪长时间运行的任务的进度。

管道	描述符
输入管道.0	处理输入流.
输出管道.0	处理输出流.

选项	描述符	有效值范围	默认值
interval	以秒为单位的更新时间间隔.		5
label	这个特定记录器的日志消息将被加上前缀的标签.		empty string

–tee (–t)
接收单个数据流并将其发送到多个目的地。 如果您想读取单个数据源并在其上应用多个操作，这非常有用.

管道	描述符
输入管道.0	处理输入流.
输出管道.0	处理输出流.
…

输出管道.n-1 (n表示输出管道序号) 处理输出流。

选项	描述符	有效值范围	默认值
输出管道编号(default)	数据写入的目标管道号.		2

–tee-change (–tc)
接收单个更改数据流并将其发送到多个目标。 如果您想要读取单个更改数据源并在其上应用多个操作，则这非常有用。

管道	描述符
输入管道.0	处理输入流.
输出管道.0	处理输出流.
…

输出管道.n-1 (n表示输出管道序列号) 处理输出流.

选项	描述符	有效值范围	默认值
输出管道序号值(默认)	数据写入的目标管道序号.		2

–read-empty (–rem)
产生一个空的实体流。 这可以与–merge任务一起使用，将更改流转换为实体流。

管道	描述符
输出管道.0	处理输出流.

选项	描述符	有效值范围	默认值
无参数

–ready-empty-change (–remc)
产生一个空的数据变化流.

管道	描述符
输出管道.0	处理一个数据变化流.

#Set Manipulation Tasks
这些任务允许执行批量操作，这些批量操作在数据流的组合上操作，使得它们以某种方式被组合或重新布置.

–sort (–s)
根据指定的顺序对实体流中的所有数据进行排序。 这使用基于文件的合并排序，将内存使用量降到最低，并允许对任意大的数据集进行排序.

管道	描述符
输入管道.0	处理输入流.
输出管道.0	处理输出流.

选项	描述符	有效值范围	默认值
类型(默认值)	要应用于数据的顺序.	TypeThenId - 这指定按实体类型（例如节点之前的节点），然后由实体ID排序。 这是一个星球文件包含的顺序.	TypeThenId

–sort-change (–sc)
根据指定的顺序对更改流中的所有数据进行排序。 这使用基于文件的合并排序，将内存使用量降到最低，并允许对任意大的数据集进行排序.

管道	描述符
输入管道.0	处理输入流.
输出管道.0	处理输出流.

选项	描述符	有效值范围	默认值
类型(默认值)	要应用于数据的顺序.	streamable - 这指定按实体类型（例如节点之前的节点），然后由实体ID排序。 这允许更改应用于xml文件。 seekable - 这样对数据进行排序，以便在不违反参照完整性的情况下将其应用于数据库.	streamable

–merge (–m)
合并两个数据源的内容。

注意:此任务要求输入流首先按类型排序，然后按ID排序.

管道	描述符
输入管道.0	处理输入流.
输入管道.1	处理输入流.
输出管道.0	处理输出流.

选项	描述符	有效值范围	默认值
conflictResolutionMethod	用于解决来自两个源的数据之间的冲突的方法.	version - 选择最高版本的实体，如果两个版本相同，则选择第二个输入源. timestamp - 选择具有最新时间戳的实体. lastSource - 从第二个输入源中选择实体.	version
bufferCapacity	输入缓冲区的大小。 这是根据要存储的实体对象的数量来定义的。 一个实体对应于一个OSM类型，比如一个节点.	正整数	20
boundRemovedAction	指定合并任务如何将绑定实体的输出压缩到结果流中时执行的操作（请参见下文）。	ignore - 继续安静地处理. warn - 继续处理，但向日志发出警告. fail - 中断处理.	warn

##绑定的实体处理
从版本0.40开始，此任务对在流开始处出现的绑定实体进行特殊处理。 处理过程如下:

如果两个实体流都没有绑定实体，则没有绑定实体被发送到输出流。
如果两个实体流都有一个绑定实体，则对应于两个源边界联合的绑定实体将被发射到输出流。
如果一个源有一个绑定实体，但另一个没有：
如果没有绑定的源是空的（没有任何实体），则将第一个源的原始绑定传递给输出流。
如果没有绑定的源不是空的，那么没有绑定被发送到输出流。 此外，还会执行由“boundRemovedAction”关键字参数（见上文）指定的操作。

–merge-change (–mc)
合并两个变更集的内容。

注意：此任务要求输入流首先按类型排序，然后按ID排序。

管道	描述符
输入管道.0	处理输入数据流.
输入管道.1	处理输入数据流.
输出管道.0	处理输出数据流.

选项	描述符	有效值范围	默认值
conflictResolutionMethod	用于解决来自两个源的数据之间的冲突的方法.	version - 选择最高版本的实体，如果两个版本相同，则选择第二个输入源. timestamp - 选择具有最新时间戳的实体. lastSource - 从第二个输入源中选择实体.	version

–append-change (–apc)
将多个更改流合并为一个更改流。 来自每个输入的数据按顺序消耗，以便结果是来自每个来源的数据的连接。 这个输出流将不被排序，可能需要通过–sort-change任务来提供.

此任务旨在用于完整的历史记录更改文件。 如果正在使用增量更改文件（即，每个文件每个实体只有一个更改），那么 - 合并更改任务可能更合适.

管道	描述符
输入管道.0	处理一个输入流.
…
输入管道.n-1	处理一个改变数据流.
输出管道.0	处理一个改变数据流.
选项	描述符
–	–
sourceCount	要添加的更改流的数量.
bufferCapacity	输入缓冲区的大小。 这是根据要存储的实体对象的数量来定义的。 一个实体对应于一个OSM类型，比如一个节点。

–simplify-change (–simc)
将“完整历史”更改流折叠为“三角洲”更改流。 此操作的结果是保证每个实体最多包含一个更改的更改流。

例如，如果在单个更改文件中创建和修改实体，则此任务将使用修改操作的数据将其修改为单个创建操作。

管道	描述符
输入管道.0	处理一个变化的数据输入流.
输出管道.0	处理一个变化的数据输出流.

选项	描述符	有效值范围	默认值
N/A

–convert-change-to-full-history (–cctfh)
Translates a change stream into a “full-history” stream (an entity stream potentially containing multiple entity versions; visible is available in the “meta tags”.

管道	描述符
inPipe.0	Consumes a change stream.
outPipe.0	Produces an entity stream.
选项	描述符
N/A

#数据操作任务
这些任务允许对通过管道传递的实体进行操作.

–node-key (–nk)
给定一个“关键”标签列表，这个过滤器只传递那些至少有一个标签设置的节点。

请注意，此过滤器只能在节点上运行。 所有的方式和关系都被过滤掉了。

该过滤器只能在版本> = 0.30（或主开发分支）中使用。

管道	描述符
输入管道.0	处理一个输入数据流.
输出管道.0	处理一个输出数据流.

选项	描述符	有效值范围	默认值
keyList	逗号分隔的所需键列表		N/A

–node-key-value (–nkv)
给定一个“key.value”标签的列表，这个过滤器只传递那些至少有一个标签被设置的节点。

注意：此过滤器只能在节点上运行。 所有的方式和关系都被过滤掉了。

该过滤器只能在版本> = 0.30（或主开发分支）中使用。

管道	描述符
输入管道.0	处理一个输入数据流.
输出管道.0	处理一个输出数据流.

选项	描述符	有效值范围	默认值
keyValueList	逗号分隔的所需key.value组合列表		N/A
keyValueListFile	包含所需key.value组合列表的文件，每行一个		N/A

–way-key (–wk)
给定一个“关键”标签列表，这个过滤器只传递至少有一个这些标签设置的方式。

注意：这个过滤器只能用途。 所有的节点和关系都是未经修改的传递。

此过滤器目前仅在（或主开发分支）中可用。

管道	描述符
输入管道.0	处理一个输入数据流.
输出管道.0	处理一个输出数据流.

选项	描述符	有效值范围	默认值
keyList	逗号分隔的所需键列表		N/A

–way-key-value (–wkv)
给定一个“key.value”标签的列表，这个过滤器只传递那些至少有一个标签设置的方法。

注意：这个过滤器只能用途。 所有的节点和关系都是未经修改的传递。

管道	描述符
输入管道.0	处理一个输入数据流.
输出管道.0	处理一个输出数据流.

选项	描述符	有效值范围	默认值
keyValueList	逗号分隔的所需key.value组合列表	highway.motorway,highway.motorway_link,highway.trunk,highway.trunk_link	(这适用于keyValueList和keyValueListFile都丢失的情况)
keyValueListFile	包含所需key.value组合列表的文件，每行一个		N/A

–tag-filter (–tf)
根据实体类型过滤实体，并根据实体标签进行过滤。 可以接受或拒绝符合过滤规范的实体.

管道	描述符
输入管道.0	产生一个实体输入流.
输出管道.0	产生一个实体输出流.

选项	描述符	有效值范围	默认值
filter mode (default)	指定接受/拒绝行为的两字段短划分字符串以及此过滤器在其上运行的实体类型.	accept-nodes, accept-ways, accept-relations, reject-nodes, reject-ways, reject-relations	empty string

所有关键字参数都以“key = value”的形式解释为标签模式。 当实体具有与这些模式中的一个匹配的标签时，根据过滤器模式接受或拒绝该实体。 每个标记过滤器任务只过滤在其模式字符串中指定的实体类型，传递所有其他实体类型而不触及它们。 如果未指定标记模式，则筛选器会匹配给定类型的所有实体。 在特定的标记模式中，可以使用逗号分隔的列表为单个键指定多个值。 *（单个星号）的通配符值匹配任何值.

值列表分隔符，键/值分隔符和通配符（分别为=，*）可以包含在使用以下转义序列的键或值中：

转义序列替换为：
%a *
%c ,
%e =
%s space
%% literal ‘%’ symbol

在实践中，只有有限的情况下，你必须逃避这些角色：

= 必须在标签键中转义
, 必须在标签值中转义

• 只需要对由单个标签组成的标签值进行转义 *
  % 空间必须永远逃脱.
  使用示例：

osmosis \
  --read-xml input.osm \
  --tf accept-ways highway=* \ 
  --tf reject-ways highway=motorway,motorway_link \
  --tf reject-relations \
  --used-node \
  --write-xml output.osm

这将保持只有标签高速公路=（任何东西）的方式，然后在这些保留的方式中，它将拒绝高速公路标签具有高速公路或高速公路链路的值。 所有的关系都被丢弃，然后所有不在路上的节点都被丢弃。 剩下的实体用XML写出来。 换句话说，它会生成一个文件，其中包含除高速公路或高速公路链接以外的所有高速公路以及组成这些高速公路的节点。

请注意，每个标签过滤器任务可以接受多个标签模式，并且如果匹配任何提供的标签模式，将接受/拒绝一个实体。 例如，以下命令将生成一个文件，其中包含所有具有舒适性，运动或休闲标签的POI节点：

osmosis \
 --read-pbf switzerland.osm.pbf \
 --tf accept-nodes sport=* amenity=* leisure=* \
 --tf reject-ways \
 --tf reject-relations \
 --write-xml switzerland-poi.osm.xml

您可能需要处理两个独立的实体流，并在过滤后合并它们，尤其是在涉及使用节点的任务时。 如果合并的两个输入来自同一个线程（例如，使用tee任务，然后是合并任务），渗透将遇到死锁，操作将永远不会结束。 解决这个死锁问题的一个办法是在两个单独的任务中读取数据。 以下命令将生成一个输出文件，其中包含所有舒适节点，以及所有高速公路和高速公路引用的任何节点。

../osmosis/bin/osmosis \ 
  --rx input.osm \
  --tf reject-relations \
  --tf accept-nodes amenity=* \
  --tf reject-ways \
  \
  --rx input.osm \
  --tf reject-relations \
  --tf accept-ways highway=motorway \
  --used-node \ 
  \
  --merge \
  --wx amenity-and-motorway.osm
--used-node (--un)

将节点的输出限制为在方式和关系中使用的节点的输出。

管道	描述符
输入管道.0	处理一个实体输入流.
输出管道.0	处理一个实体输出流.

选项	描述符	有效值范围	默认值
idTrackerType	指定用于跟踪所选id的内存机制。 对于非常大的边界框（其中节点数大于最大节点ID的1/32），BitSet更有效，对于所有更小的边界框，IdList将更有效.	BitSet, IdList, Dynamic	Dynamic

–used-way (–uw)
限制在关系中使用的方式的输出。

管道	描述符
输入管道.0	处理一个实体输入流.
输出管道.0	处理一个实体输出流.

选项	描述符	有效值范围	默认值
idTrackerType	指定用于跟踪所选id的内存机制。 对于非常大的边界框（其中节点数大于最大节点ID的1/32），BitSet更有效，对于所有更小的边界框，IdList将更有效.	BitSet, IdList, Dynamic	Dynamic

–tag-transform (–tt)|
根据变换文件中指定的规则变换输入流中的变量.

更多的细节可以在Osmosis / TagTransform文档中找到.

管道	描述符
输入管道.0	处理一个实体输入流.
输出管道.0	处理一个实体输出流.

选项	描述符	有效值范围	默认值
file	包含转换描述的文件的名称.		transform.xml
stats	要输出匹配命中次数统计的文件的名称.		N/A

#PostGIS Tasks (Snapshot Schema)
渗透提供了PostGIS模式来存储OSM数据的快照。 数据的所有地理空间方面均使用PostGIS几何数据类型进行存储。 节点位置总是作为一个点存储。 方法与正常API模式中的节点相关，但是也可以选择添加边界框和/或完整的字符串列以允许在其上执行一组完整的地理空间操作。

请注意，所有标签都存储在hstore列中。 如果需要单独的标签表，请选中“简单模式”任务。

要在此模式上执行查询，请参阅#Dataset任务。

模式创建脚本可以在osmosis分发中的脚本目录中找到。 这些脚本是:

pgsnapshot_schema_0.6.sql - 构建最小的模式.
pgsnapshot_schema_0.6_action.sql - 添加可选的“动作”表格，允许派生表格在应用差异时保持最新.
pgsnapshot_schema_0.6_bbox.sql - 将可选的bbox列添加到路表.
pgsnapshot_schema_0.6_linestring.sql - 将可选的linestring列添加到路表.
pgsnapshot_load_0.6.sql - 示例数据加载脚本适合加载由.txt创建的COPY文件 --write-pgsql-dump任务.
Osmosis_PostGIS_Setup描述了设置Postgresql / PostGIS用于渗透的过程。

–write-pgsql (–wp)
使用“简单”模式填充空的PostGIS数据库。 模式创建脚本在osmosis脚本目录中可用。

模式具有许多可选的列和表，可以使用其他模式创建脚本进行选择性安装。 此任务查询模式以自动检测哪些功能被安装。

管道	描述符
输入管道.0	处理一个实体管道输入流.

选项	描述符	有效值范围	默认值
authFile	包含数据库登录凭证的文件的名称（有关详细信息，请参阅数据库登录凭证）.		N/A
host	数据库服务器地址.		localhost
database	数据库示例名.		osm
user	数据库用户名.		osm
password	数据库密码.		(blank)
postgresSchema	Postgresql上使用的数据库模式。 该值被预先设定为search_path变量.		(blank)
validateSchemaVersion	如果指定了yes，则任务将在访问数据库之前验证当前的模式版本.	yes, no	yes
allowIncorrectSchemaVersion	如果validateSchemaVersion为yes，则此选项控制架构版本检查失败的结果。 如果该选项为是，则显示警告并继续执行。 如果该选项为否，则显示错误，程序中止.	yes, no	yes
nodeLocationStoreType	如果路线表中至少有一个linetring或bbox列存在，此选项才会生效。 几何建造者需要知道所有节点的位置。 该选项指定如何临时存储这些节点。 如果您有大量的内存（至少64GB的系统内存，64位的JVM以及至少50GB的JVM RAM，使用-Xmx选项指定），您可以使用“InMemory”选项。 否则，您必须选择“TempFile”选项，该选项比依靠默认的数据库几何构建实现要慢得多，但仍然更快，或者对于较小的数据集更有效的“CompactTempFile”选项.	“InMemory”, “TempFile”, “CompactTempFile”	“CompactTempFile”
keepInvalidWays	无效的方式是少于两个节点的方式。 这些方法会生成无效的线串，这在运行空间查询时可能会导致问题。 如果这个选项被设置为“否”，那么它们将被无声地丢弃。 请注意，无效的线串可能来自其他来源，如在同一位置的多个节点的方式，但这些目前尚未检测到，将包括.	yes, no	yes

–write-pgsql-dump (–wpd)
使用COPY语句写入一组适合于使用“简单”模式加载PostGIS数据库的数据文件。 模式创建脚本在osmosis脚本目录中可用。 加载脚本也可以调用COPY语句，并适当更新所有索引和特殊索引支持列。 这个选项应该用在大量的导入数据上（比如星球文件），因为它比 --write-pgsql

管道	描述符
输入管道.0	处理一个输入管道流.

选项	描述符	有效值范围	默认值
directory	将数据文件写入的目录的名称.		pgimport
enableBboxBuilder	如果指定了yes，则任务将使用基于java的解决方案构建bbox几何列，而不是运行导入后查询。 与查询方法相比，使用此选项可显着提高性能.	yes, no	no
enableLinestringBuilder	按照enableBboxBuilder选项，但是用于linestring几何列.	yes, no	no
nodeLocationStoreType	如果启用了enableBboxBuilder和enableLinestringBuilder选项中的至少一个，此选项才会生效。 几何构建器实现都需要知道所有节点的位置。 该选项指定如何临时存储这些节点。 如果您有大量的内存（至少64GB的系统内存，64位的JVM以及至少50GB的JVM RAM，使用-Xmx选项指定），您可以使用“InMemory”选项。 否则，您必须选择“TempFile”选项，该选项比依靠默认的数据库几何构建实现要慢得多，但仍然更快，或者对于较小的数据集更有效的“CompactTempFile”选项.	“InMemory”, “TempFile”, “CompactTempFile”	“CompactTempFile”
keepInvalidWays	无效的方式是少于两个节点的方式。 这些方法会生成无效的线串，这在运行空间查询时可能会导致问题。 如果这个选项被设置为“否”，那么它们将被无声地丢弃。 请注意，无效的线串可能来自其他来源，例如在同一位置有多个节点的方式，但这些目前尚未检测到并将包括在内。	yes, no	yes

–truncate-pgsql (–tp)
用“简单”模式截断PostGIS中的所有表格.

管道	描述符
没有输出管道

选项	描述符	有效值范围	默认值
authFile	包含数据库登录凭证的文件的名称（有关详细信息，请参阅数据库登录凭证）.		N/A
host	数据库服务器地址.		localhost
database	数据库实例.		osm
user	数据库用户名.		osm
password	数据库密码.		(blank)
postgresSchema	Postgresql上使用的数据库模式。 该值被预先设定为search_path变量.		(blank)
validateSchemaVersion	如果指定了yes，则任务将在访问数据库之前验证当前的模式版本.	yes, no	yes
allowIncorrectSchemaVersion	如果validateSchemaVersion为yes，则此选项控制架构版本检查失败的结果。 如果该选项为是，则显示警告并继续执行。 如果该选项为否，则显示错误，程序中止。	yes, no	yes

–read-pgsql (–rp)
读取PostGIS数据库中“simple”表单的内容

管道	描述符
输出管道.0	处理一个输出表单.

选项	描述符	有效值范围	默认值
authFile	包含数据库登录凭证的文件的名称（有关详细信息，请参阅数据库登录凭证）.
host	数据库服务器地址.		localhost
database	数据库实例名.		osm
user	数据库用户名.	osm
password	数据库密码.		(blank)
postgresSchema	Postgresql上使用的数据库模式。 该值被预先设定为search_path变量.		(blank)
validateSchemaVersion	如果指定了yes，则任务将在访问数据库之前验证当前的模式版本.	yes, no	yes
allowIncorrectSchemaVersion	如果validateSchemaVersion为yes，则此选项控制架构版本检查失败的结果。 如果该选项为是，则显示警告并继续执行. 如果该选项为否，则显示错误，程序中止.	yes, no	yes

–write-pgsql-change (–wpc)|
使用“简单”模式将更改写入PostGIS数据库。

管道	描述符
输入管道.0	处理一个变化数据流.

选项	描述符	有效值范围	默认值
authFile	包含数据库登录凭证的文件的名称（有关详细信息，请参阅数据库登录凭证）.		N/A
host	数据库服务器地址.		localhost
database	数据库名.		osm
user	数据库用户名.		osm
password	数据库密码.		(blank)
postgresSchema	Postgresql上使用的数据库模式。 该值被预先设定为search_path变量.		(blank)
validateSchemaVersion	如果指定了yes，则任务将在访问数据库之前验证当前的模式版本.	yes, no	yes
allowIncorrectSchemaVersion	如果validateSchemaVersion为yes，则此选项控制架构版本检查失败的结果。 如果该选项为是，则显示警告并继续执行。 如果该选项为否，则显示错误，程序中止.	yes, no	yes
keepInvalidWays	无效的方式是少于两个节点的方式。 这些方法会生成无效的线串，这在运行空间查询时可能会导致问题。 如果这个选项被设置为“否”，那么它们将被无声地丢弃。 请注意，无效的线串可能来自其他来源，如在同一位置的多个节点的方式，但这些目前尚未检测到，将包括.	yes, no	yes

#PostGIS Tasks (Simple Schema)
这实际上是快照模式的旧版本，其中标签仍然存储在单独的标签表格而不是hstore列中。 建议在可能的情况下使用较新的“快照架构”版本的这些任务，因为它们提供了更好的性能。

要在此模式上执行查询，请参阅#Dataset任务。

模式创建脚本可以在osmosis分发中的脚本目录中找到。 这些脚本是:

pgsimple_schema_0.6.sql - 构建最小的模式。
pgsimple_schema_0.6_action.sql - 添加可选的“动作”表，该表允许派生表在应用差异时保持最新。
pgsimple_schema_0.6_bbox.sql - 将可选的bbox列添加到路表。
pgsimple_schema_0.6_linestring.sql - 将可选的linestring列添加到路表。
pgsimple_load_0.6.sql - 适用于加载由–write-pgsimp-dump任务创建的COPY文件的示例数据加载脚本。
Osmosis_PostGIS_Setup描述了设置Postgresql / PostGIS用于渗透的过程。

–write-pgsimp (–ws)
使用“简单”模式填充空的PostGIS数据库。 模式创建脚本在osmosis脚本目录中可用。

模式具有许多可选的列和表，可以使用其他模式创建脚本进行选择性安装。 此任务查询模式以自动检测哪些功能被安装。

管道	描述符
输入管道.0	处理一个实体数据流.

选项	描述符	有效值范围	默认值
authFile	包含数据库登录凭证的文件的名称（有关详细信息，请参阅数据库登录凭证）.		N/A
host	数据库服务器地址		localhost
database	数据库名.		osm
user	数据库用户名.		osm
password	数据库密码.		(blank)
validateSchemaVersion	如果指定了yes，则任务将在访问数据库之前验证当前的模式版本.	yes, no	yes
allowIncorrectSchemaVersion	如果validateSchemaVersion为yes，则此选项控制架构版本检查失败的结果。 如果该选项为是，则显示警告并继续执行。 如果该选项为否，则显示错误，程序中止.	yes, no	yes
nodeLocationStoreType	如果路线表中至少有一个linetring或bbox列存在，此选项才会生效。 几何建造者需要知道所有节点的位置。 该选项指定如何临时存储这些节点。 如果您有大量内存（至少6GB系统内存，64位JVM和至少4GB的使用-Xmx选项指定的JVM RAM），则可以使用“InMemory”选项。 否则，您必须选择“TempFile”选项，该选项比依赖默认数据库几何构建实现要慢得多，但仍然更快，或者对于较小数据集更有效的“CompactTempFile”选项。	“InMemory”, “TempFile”, “CompactTempFile”	“CompactTempFile”

–write-pgsimp-dump (–wsd)
使用COPY语句写入一组适合于使用“简单”模式加载PostGIS数据库的数据文件。 模式创建脚本在osmosis脚本目录中可用。 加载脚本也可以调用COPY语句，并适当更新所有索引和特殊索引支持列。 这个选项应该用在大的导入数据上（比如planet文件），因为它比–write-pgsql快得多

管道	描述符
输入管道.0	处理一个实体输入管道流.

选项	描述符	有效值范围	默认值
directory	将数据文件写入的目录的名称.		pgimport
enableBboxBuilder	如果指定了yes，则任务将使用基于java的解决方案构建bbox几何列，而不是运行导入后查询。 与查询方法相比，使用此选项可显着提高性能。	yes, no	no
enableLinestringBuilder	按照enableBboxBuilder选项，但是用于linestring几何列。	yes, no	no
nodeLocationStoreType	如果启用了enableBboxBuilder和enableLinestringBuilder选项中的至少一个，此选项才会生效。 几何构建器实现都需要知道所有节点的位置。 该选项指定如何临时存储这些节点。 如果您有大量内存（至少6GB系统内存，64位JVM和至少4GB的使用-Xmx选项指定的JVM RAM），则可以使用“InMemory”选项。 否则，您必须选择“TempFile”选项，该选项比依靠默认的数据库几何构建实现要慢得多，但仍然更快，或者对于较小的数据集更有效的“CompactTempFile”选项.	“InMemory”, “TempFile”, “CompactTempFile”	“CompactTempFile”

–truncate-pgsimp (–ts)
用“简单”模式截断PostGIS中的所有表格。

管道	描述符
没有输入输出管道

选项	描述符	有效值范围	默认值
authFile	包含数据库登录凭证的文件的名称（有关详细信息，请参阅数据库登录凭证）.		N/A
host	数据库服务器地址		localhost
database	数据库名.		osm
user	数据库用户名.		osm
password	数据库密码.		(blank)
validateSchemaVersion	如果指定了yes，则任务将在访问数据库之前验证当前的模式版本.	yes, no	yes
allowIncorrectSchemaVersion	如果validateSchemaVersion为yes，则此选项控制架构版本检查失败的结果。 如果该选项为是，则显示警告并继续执行。 如果该选项为否，则显示错误，程序中止.	yes, no	yes

–read-pgsimp (–rs)
用“简单”模式读取PostGIS数据库的内容.

管道	描述符
输出管道.0	处理一个输出表单.

选项	描述符	有效值范围	默认值
authFile	包含数据库登录凭证的文件的名称（有关详细信息，请参阅数据库登录凭证）.		N/A
host	数据库服务器地址		localhost
database	数据库名.		osm
user	数据库用户名.		osm
password	数据库密码.		(blank)
validateSchemaVersion	如果指定了yes，则任务将在访问数据库之前验证当前的模式版本.	yes, no	yes
allowIncorrectSchemaVersion	如果validateSchemaVersion为yes，则此选项控制架构版本检查失败的结果。 如果该选项为是，则显示警告并继续执行。 如果该选项为否，则显示错误，程序中止.	yes, no	yes

–write-pgsimp-change (–wsc)
使用“简单”模式将更改写入PostGIS数据库。

管道	描述符
输入管道.0	处理一个变化数据流.

选项	描述符	有效值范围	默认值
authFile	包含数据库登录凭证的文件的名称（有关详细信息，请参阅数据库登录凭证）.		N/A
host	数据库服务器地址		localhost
database	数据库名.		osm
user	数据库用户名.		osm
password	数据库密码.		(blank)
validateSchemaVersion	如果指定了yes，则任务将在访问数据库之前验证当前的模式版本.	yes, no	yes
allowIncorrectSchemaVersion	如果validateSchemaVersion为yes，则此选项控制架构版本检查失败的结果。 如果该选项为是，则显示警告并继续执行。 如果该选项为否，则显示错误，程序中止.	yes, no	yes

#API Tasks
这些任务提供了与OSM API直接交互的能力。 这是由JOSM等编辑器直接使用的API。

–read-api（–ra）
从API中检索边界框的内容。 这受限于API施加的边界框大小限制.

管道	描述符
输出管道.0	处理一个实体输出流.

选项	描述符	有效值范围	默认值
left	盒子左边的经度。	-180 to 180	-180
right	盒子右边的经度.	-180 to 180 180
top	盒子顶边的纬度.	-90 to 90	90
bottom	盒子底边的纬度.	-90 to 90	-90
url	服务API的地址.		http://www.openstreetmap.org/api/0.6

–upload-xml-change
通过HTTP将变更集上载到现有的已填充API服务器。
since Osmosis 0.31.3
Support: User:MarcusWolschon

管道	描述符
输入管道.0	处理一个可变的数据流

选项	描述符	有效值范围	默认值
server	服务器上传地址.		http://api.openstreetmap.org/api/0.6
user	API接口用户名.		参数值
password	API接口密码.		参数值

#Dataset Tasks
数据集任务是那些在由多个数据存储公开的通用数据集接口上执行的任务。 例如#PostGIS任务。 这些任务允许以存储方法不可知的方式执行数据查询和数据操作.

–dataset-bounding-box (–dbb)
提取经纬度坐标定义的特定边界框内的数据。 这与“绑定”框任务不同，它在数据集上操作而不是实体流，换句话说，它使用底层数据库的功能来执行空间查询，而不是检查完整流中的所有节点。

这个实现将永远不会在方框边界处裁剪方式，并且根据底层实现可以检测穿过方框而不在方框内的任何节点的方式。

管道	描述符
输入管道.0	处理一个数据表单.
输入管道.0	处理一个实体数据流.

选项	描述符	有效值范围	默认值
left	盒子左边的经度。	-180 to 180	-180
right	盒子右边的经度.	-180 to 180 180
top	盒子顶边的纬度.	-90 to 90	90
bottom	盒子底边的纬度.	-90 to 90	-90
completeWays	所有道路包含的节点.	yes, no	no

–dataset-dump (–dd)
Converts an entire dataset to an entity stream.

管道	描述符
输入管道.0	处理一个数据表单.
输入管道.0	处理一个实体数据流.

选项	描述符	有效值范围	默认值
无参数

#Reporting Tasks
这些任务提供了管道处理的数据的摘要。

–report-entity (–re)
产生每个实体类型和最后修改它们的用户的总结报告。

管道	描述符
输入管道.0	处理一个实体数据流.

选项	描述符	有效值范围	默认值
file (default)	将要写入报告的文件名.		entity-report.txt

–report-integrity (–ri)
生成数据源中参照完整性问题的列表.

管道	描述符
输入管道.0	处理一个输入实体流.

选项	描述符	有效值范围	默认值
file (default)	将要写入报告中的文件名.		integrity-report.txt

#Replication Tasks
这些任务用于复制数据存储之间的更改。 他们通常使用更改流，因此可以根据要执行的工作与其他更改流任务结合使用。 但是，某些任务与复制流一起工作，这些流是传播附加复制状态跟踪元数据的更改流。 生产和消费复制流的任务不能连接到支持标准变更流的任务。

有两种主要类型的更改文件：

Delta - 包含对更新数据集的最小更改。 这意味着每个实体最多可以有一次更改。
完整的历史 - 包含全套的历史变化。 这意味着每个实体可能会有多个更改。 请注意，复制流任务适用于完整历史数据。
所有的更改任务都支持“delta”风格的变更集。 有些任务不支持“完整历史”更改文件。

有关渗透的更多技术信息，请阅读渗透/复制。

–merge-replication-files (–mrf)
从服务器中检索一组由复制序列号命名的复制文件，将它们组合成较大的时间间隔，对结果进行排序并跟踪当前时间戳。 这是用于基于分钟文件创建聚合的小时和天复制文件的任务。

这个任务产生的变化是完整的历史变化。

管道	描述符
N/A

选项	描述符	有效值范围	默认值
workingDirectory (default)｜包含当前配置和状态的文件目录.｜｜(当前目录)｜

–merge-replication-files-init (–mrfi)
初始化工作目录以包含–merge-replication-files任务使用所需的文件。 此任务必须运行一次以创建目录结构和手动编辑的配置文件以包含所需的设置.

管道	描述符
n/a

选项	描述符	有效值范围	默认值
workingDirectory (default)｜包含当前配置和状态的文件目录.｜｜(当前目录)｜

注意：这将在中创建一个configuration.txt和一个download.lock文件。 然后，您需要手动编辑configuration.txt文件，并将URL更改为分钟或小时复制（例如：baseUrl = http：//planet.openstreetmap.org/replication/minute/，对于web或baseUrl = file： ///您的/复制文件夹为本地文件系统）您将需要编辑配置文件以指定时间间隔来分组更改。

如果不存在state.txt文件，则第一次调用将导致最新的状态文件被下载。 如果你想从一个已知点开始，你需要从http://planet.openstreetmap.org/replication/minute/下载你想要复制的开始日期的状态文件，把它放到你的名为state的中 。文本。 您可以使用复制序列工具来查找匹配的文件。 至少比您的开始日期早一个小时，以避免遗漏更改。

–read-change-interval (–rci)
从服务器中检索按日期命名的一组更改文件，将它们合并到单个流中，并跟踪当前时间戳。

此任务产生的更改通常是增量更改（取决于源数据）。

管道	描述符
输出管道.0	处理一个输出变化流.

选项	描述符	有效值范围	默认值
workingDirectory (default)｜包含当前配置和状态的文件目录.｜｜(当前目录)｜

–read-change-interval-init (–rcii)
Initialises a working directory to contain files necessary for use by the --read-change-interval task. This task must be run once to create the directory structure and the configuration file manually edited to contain the required settings.

管道	描述符
n/a

选项	描述符	有效值范围	默认值
workingDirectory (default)｜包含当前配置和状态的文件目录.｜｜(当前目录)｜
initialDate	从开始复制的时间戳。 只有在这个时间戳后包含数据的变更集才会被下载。 请注意，与大多数接受日期的任务不同，此日期以UTC指定.	format is “yyyy-MM-dd_HH:mm:ss”	N/A

–read-replication-interval (–rri)
从服务器中检索一组由复制序列号命名的复制文件，将它们合并为一个流，对结果进行排序并跟踪当前时间戳。 可用，因为渗透0.32。

这个任务产生的变化通常是完整的历史变化（取决于源数据）。

管道	描述符
输出管道.0	处理一个变化数据流.

选项	描述符	有效值范围	默认值
workingDirectory (default)｜包含当前配置和状态的文件目录.｜｜(当前目录)｜

–read-replication-interval-init (–rrii)
初始化工作目录以包含-read-replication-interval任务所需的文件。 此任务必须运行一次以创建目录结构和手动编辑的配置文件以包含所需的设置。

管道	描述符
n/a

选项	描述符	有效值范围	默认值
workingDirectory (default)｜包含当前配置和状态的文件目录.｜｜(当前目录)｜

注意：这将在中创建一个configuration.txt和一个download.lock文件。 然后，您需要手动编辑configuration.txt文件，并将url更改为分钟或小时复制（例如：baseUrl = http：//planet.openstreetmap.org/minute-replicate for web或baseUrl = file：/ //本地文件系统的your / replicate-folder）

如果不存在state.txt文件，则第一次调用–read-replication-interval会导致最新的状态文件被下载。 如果你想从一个已知点开始，你需要从http://planet.openstreetmap.org/minute-replicate下载你想要复制的开始日期的状态文件，把它放到名字状态的中。 文本。 您可以使用复制序列工具来查找匹配的文件。 至少比您的开始日期早一个小时，以避免遗漏更改。

–read-replication-lag (–rrl)
这个任务接受复制工作目录中的state.txt，并比较它的时间戳（这是下载的最后一个块的时间戳）和服务器的时间戳记state.txt（这是最后一个块的时间戳 服务器已经生成）。 然后计算差异并将其打印到标准输出。 使用-q选项运行渗透将防止显示日志输出，除非发生错误。

示例调用可能如下所示：

osmosis -q --read-replication-lag humanReadable=yes workingDirectory=/osm/diffs

管道	描述符
n/a

选项	描述符	有效值范围	默认值
workingDirectory (default)｜包含当前配置和状态的文件目录.｜｜(当前目录)｜
humanReadable	以可读的格式打印复制延迟	yes, no	no

–receive-replication (–rr)
从通常由–send-replication-data任务提供的HTTP服务器读取复制数据馈送。 它直接将数据通过复制流传递给支持使用复制扩展（例如–replication-to-change）的更改的任务。 这适用于要求访问高度当前数据的客户端 - 现有的–replicate-change-interval无法通过轮询技术实现。

与所有的复制流任务一样，它使用一种以多个序列向下游任务发送数据的恒定流技术。 每个序列将包含一个初始化/完整的方法调用。 初始化方法是交换状态信息的地方，完整的调用是数据被保存/提交的地方。 在管道关闭之前，最终的释放方法调用将不会发生。

可用，因为渗透0.41。

管道	描述符
输出管道.0	使用复制扩展生成更改流.

选项	描述符	有效值范围	默认值
host	待连接服务器的地址.		localhost
port	待连接服务器端口号 (0表示自动分配端口号).		0
pathPrefix	要连接到的URL的主要路径。 只有当复制服务器在将URL映射到子路径的Web服务器后面进行代理时，才需要这样做。 在这种情况下，路径通常是“复制”.

–replicate-apidb (–repa)
此任务为消费者提供复制文件以供下载。 它主要针对生产API数据库运行，并在地球服务器上提供结果。 此任务必须与支持复制扩展（例如–write-replication）的接收器任务一起使用。 默认情况下，它将从数据库中提取一组数据并将其传递到下游，但可以通过设置迭代参数以连续循环模式运行。

所有更改将按类型，然后id，然后版本进行排序。

此任务的行为在版本0.41中更改为将数据发送到单独的接收器任务。 此前，写入复制功能已被纳入此任务。

管道	描述符
输出管道.0	使用复制扩展生成更改流.

选项	描述符	有效值范围	默认值
authFile	包含数据库登录凭证的文件的名称（有关详细信息，请参阅数据库登录凭证）.		N/A
host	数据库服务器地址		localhost
database	数据库名.		osm
user	数据库用户名.		osm
password	数据库密码.		(blank)
validateSchemaVersion	如果指定了yes，则任务将在访问数据库之前验证当前的模式版本.	yes, no	yes
allowIncorrectSchemaVersion	如果validateSchemaVersion为yes，则此选项控制架构版本检查失败的结果。 如果该选项为是，则显示警告并继续执行。 如果该选项为否，则显示错误，程序中止.	yes, no	yes
readAllUsers	如果设置为yes，用户公共编辑标志将被忽略，用户信息将被附加到每个实体.	yes, no	no
iterations	要执行的复制间隔的数量。 0意味着无限.		1
minInterval	复制间隔之间等待的最小间隔，以毫秒为单位。 非零值可防止任务在紧密循环中运行，并对生成的复制间隔的速率设置上限。		0
maxInterval	如果没有可用的数据，则在复制间隔之间等待的最大时间间隔（以毫秒为单位）。 非零值可防止在闲置期间生成大量空文件，但可能会导致客户端认为如果设置得太高，他们就会滞后于服务器。 请注意，由于处理间隔所用的时间，间隔可能仍会超过此值.		0

–replication-to-change (–rtc)
将复制流转换为标准更改流。 复制流使用最后的sink任务来存储状态，因此该任务使用标准state.txt文件跟其他任务（如-read-replication-interval）类似的方式跟踪状态。 然后将更改数据发送到标准的下游更改任务。

下游任务必须支持并非全部改变宿任务所做的多个序列。 例如，–write-xml-change接收多个序列是没有意义的，因为它将保持打开相同的XML文件并覆盖前一个序列的数据。 其他任务如–write-pgsql-change将更改写入数据库，并且可以支持多个序列，而不会覆盖以前的数据。

管道	描述符
输入管道.0	使用复制扩展来使用更改流.
输出管道.0	生成（标准）更改流.

选项	描述符	有效值范围	默认值
workingDirectory (default)｜包含当前配置和状态的文件目录.｜｜(当前目录)｜

–send-replication-sequence (–srs)
公开一个HTTP服务器，该服务器将复制序列号发送给连接的客户端，以便在新复制数据可用时通知他们。数据以流畅的方式发送，连接保持打开状态，新的记录将作为新的复制号码被创建。

这个任务不是为了消费者的直接消费。它由其他任务使用，例如–send-replication-data将实际复制数据发送给客户端。它通过插入连续复制管道的中间来检测新的复制数量。例如，它可以插入以循环模式运行的–replicate-apidb和–write-replication之间，只要–replicate-apidb保持复制流处于打开状态，就会运行。

此任务提供的网址是：

/ statistics - 显示服务器的全局计数器。
/ sequenceNumber / current - 返回当前序列号。这个号码是保证可用。
/ sequenceNumber / current / tail - 如上所述，但连接保持打开状态，新的序列号在可用时返回。
/ sequenceNumber / - 返回由指定的序列号。如果该号码还不可用，它将被阻止，但是如果比当前号码大1，则会出错。这个功能本身并没有用处，但是与其他网址保持一致。
/ sequenceNumber / / tail - 按照上面的说明，但连接保持打开状态，新的序列号在可用时返回。
所有数据都是使用HTTP分块编码发送的。每个序列号都在其自己的块内发送。

可用自渗透0.41。

管道	描述符
输入管道.0	使用复制扩展来使用更改流.
输出管道.0	使用复制扩展生成更改流.

选项	描述符	有效值范围	默认值
port (default)	侦听新连接的TCP端口（0将动态分配一个端口）.		0

–send-replication-data (–srd)
公开一个HTTP服务器，该服务器将复制数据发送到可用的连接客户端，从而避免了客户端轮询的需要。数据以流畅的方式发送，连接保持打开状态，并且创建新的复制数据时发送新的记录。它适用于复制间隔小于1分钟并且–read-replication-interval任务不合适的情况。

此任务发送的数据可以由–receive-replication任务使用。

此任务提供的网址是：

/ replicationState / current - 返回当前复制序列的状态。与此状态相关的数据保证可用。
/ replicationState / current / tail - 如上所述，但连接保持打开状态，并且在状态信息变为可用时返回新的状态信息。
/ replicationState / - 返回由标识的序列的状态。如果该号码还不可用，它将被阻止，但是如果比当前号码大1，则会出错。
/ replicationState / / tail - 如上所述，但连接保持打开状态，并且在状态变为可用时返回新的状态数据。
/ replicationState / - 返回指定时间或之前的复制序列的状态。
/ replicationState / / tail - 如上所述，但连接保持打开状态，并且在可用时返回新的状态信息。
/ replicationData / current - 返回当前复制序列的状态和数据。
/ replicationData / current / tail - 如上所述，但是连接保持打开状态，新的状态数据和关联数据在可用时返回。
/ replicationData / - 返回由标识的序列的状态和数据。如果该号码还不可用，它将被阻止，但是如果比当前号码大1，则会出错。
/ replicationData / / tail - 如上所述，但连接保持打开状态，新状态数据和关联数据在可用时返回。
/ replicationData / - 返回指定时间或之前的复制序列的状态和数据。
/ replicationData / / tail - 如上所述，但是连接保持打开状态，并且在状态数据和关联数据可用时返回。
统计信息和复制状态URL以“文本/纯文本”格式提供数据，并且可以直接在Web浏览器中查看。复制数据URL以“application / octet-stream”格式提供数据，必须将其视为二进制数据，状态“标题”包含java属性格式的数据，复制数据本身使用gzip压缩以* .osc格式编码。

所有数据都是使用HTTP分块编码发送的，但不能认为数据与块对齐。每组状态数据和复制数据前面都有一个由CRLF对终止的基数为10的ASCII长度字段。

可用自渗透0.41。

管道	描述符
N/A

选项	描述符	有效值范围	默认值
workingDirectory (default)｜包含当前配置和状态的文件目录.｜｜(当前目录)｜
port	侦听新连接的TCP端口（0将动态分配一个端口）.		0
notificationPort	–send-replication-sequence任务将用于获取更新序列号的TCP端口.		80

–write-replication (–wr)
将复制流保留到复制数据目录中。 它通常用于生成在地球服务器上生成的已排序的压缩XML和状态文件，并可供客户端使用。 多个复制序列将被写入单独的连续编号的文件以及相应的状态文本文件。 这适用于诸如–replicate-apidb之类的任务。

从服务器中检索一组由复制序列号命名的复制文件，将它们合并为一个流，对结果进行排序并跟踪当前时间戳。 可用的渗透0.41（功能之前建立 - 重复 - apidb）。

管道	描述符
输入管道.0	使用复制扩展来使用更改流.

选项	描述符	有效值范围	默认值
workingDirectory (default)｜包含当前配置和状态的文件目录.｜｜(当前目录)｜

#PBF Binary Tasks
二进制任务用于读取和写入二进制PBF（Google协议缓冲区）文件。

–read-pbf (–rb)
读取OSM二进制文件的当前内容。

管道	描述符
输出管道.0	处理一个实体数据流.

选项	描述符	有效值范围	默认值
file (default)	带读取文件的文件名.		dump.osmbin

–read-pbf-fast (–rbf)
读取OSM二进制文件的当前内容。 这与标准的–read-pbf任务相同，只是它允许使用多个工作线程来提高性能。

管道	描述符
输出管道.0	处理一个实体数据流.

选项	描述符	有效值范围	默认值
file (default)	待读取文件文件名		dump.osm.pbf
workers	使用的工作线程数目.	>= 1	1

–write-pbf (–wb)
将数据写入一个OSM文件中.

管道	描述符
输入管道.0	处理一个输入实体数据流

选项	描述符	有效值范围	默认值
file (default)	待写入文件的文件名.		dump.osm.pbf
batchlimit	压缩时使用块大小。 这是一个合理的默认值。 批量限制太大可能导致文件超出定义的文件大小限制.	Integer value.	8000
omitmetadata	省略OSM实体上的非地理元数据。 这包括对实体的上次编辑的版本号和时间戳，以及最后一个修改器的用户名和ID。 导出到不需要此数据的软件时，省略此元数据可以节省15％的文件大小.	true, false	false
usedense	节点可以以常规格式或密集格式表示。 密集的格式大约小30％，但更复杂。 为了更容易与未来选择不实现密集格式的软件进行互操作，密集格式可能被禁用.	true, false	true
granularity	用于存储坐标的粒度或精度。 100纳米的默认值是OSM使用的最高精度，相当于赤道约1.1厘米。 在当前的渗透实施中，粒度必须是100的倍数。如果地图数据将被导出到不需要全部精度的软件，则将粒度增加到10000毫微克可以节省约10％的文件大小，而 仍然有1.1米的精度.	Integer value.	100
compress	'deflate’在每个块上使用deflate压缩。 'none’禁用压缩。 这些文件的写入速度是写入速度的两倍，并且是两倍的大小.	deflate, none	deflate

#Plugin Tasks
以下任务包含在插件中。

可以通过在下面的一个步骤中安装指定的插件，或者通过“-P”选项将其添加到命令行来将它们添加到渗透。

要安装这些任务，请将指定的zip文件复制到

~/.openstreetmap/osmosis/plugins (Linux) or
"C:\\Documents and Settings\\(Username)\\Application Data\\Openstreetmap\\Osmosis\\Plugins" (english Windows) or
"C:\\Dokumente und Einstellungen\\

(Username)\Anwendungsdaten\Openstreetmap\Osmosis\Plugins" (german Windows) or 当前目录 or 当前目录中的子目录插件编写自己的插件, 参照 Osmosis/WritingPlugins.

–write-osmbin-0.6
写入Osmbin 1.0版的目录

plugin-zip: libosm_osmosis_plugins.zip (Part of Traveling Salesman)
download: Traveling Salesman on Sourceforge (soon)
documentation: Traveling Salesman - Wiki

管道	描述符
输入管道.0	处理一个实体输入流.

选项	描述符	有效值范围	默认值
dir	要写入的目录的名称。 将在需要时创建。 如果存在osmbin-data，将追加/更新.	有效的目录名.	none

示例:

java -classpath lib/jpf.jar:lib/commons-logging-1.0.4.jar:lib/osmosis.jar org.openstreetmap.osmosis.core.Osmosis --read-xml file="../Desktop/hamburg.osm.bz2" --write-osmbin-0.6 dir="../osmbin-map"
--dataset-osmbin-0.6

读取/写入到Osmbin 1.0版的目录，并提供随机访问以进一步完成任务

plugin-zip：libosm_osmosis_plugins.zip（Traveling Salesman的一部分）
下载：在Sourceforge旅游推销员
文档：旅行推销员 - 维基
这个任务还没有完成。 它提供了随机访问，但批量方法iterate（）和iterateBoundingBox（）尚未实现。

管道	描述符
输入管道.0	处理一个实体输入流.

选项	描述符	有效值范围	默认值
dir	要写入的目录的名称。 将在需要时创建。 如果存在osmbin-data，将追加/更新.	任何有效的目录名.	none

示例:

java -classpath lib/jpf.jar:lib/commons-logging-1.0.4.jar:lib/osmosis.jar org.openstreetmap.osmosis.core.Osmosis --read-xml file="../Desktop/hamburg.osm.bz2" --dataset-osmbin-0.6 dir="../osmbin-map"

–reindex-osmbin-0.6
在Osmbin 1.0版本中为一个目录重新创建.idx文件

plugin-zip：libosm_osmosis_plugins.zip（Traveling Salesman的一部分）
下载：在Sourceforge旅游推销员
文档：旅行推销员 - 维基
这个任务也可以运行standalong。 作为java -jar libosm.jar org.openstreetmap.osm.data.osmbin.v1_0.OsmBinV10Reindexer（directory-name）

选项	描述符	有效值范围	默认值
dir	要重建索引的目录的名称.	任何有效的目录名.	none

–read-osmbin-0.6
从Osmbin版本1.0格式的目录中读取。

plugin-zip：TravelingSalesman_OsmosisPlugins.zip

下载：在Sourceforge旅游推销员

管道	描述符
输出管道.0	创建一个实体流.

选项	描述符	有效值范围	默认值
dir	待读取的文件目录名.	任何有效的目录名.	none

–induce-ways-for-turnrestrictions (-iwtt)
将所有具有转弯限制的交叉口从一个节点转换成等同数量的只能在转弯限制允许的情况下行驶的单向街道。 这意味着对于无法在图形节点上处理限制/成本的路由器的预处理步骤。

状态：计划任务

文档：在Traveling Salesman Wiki中

plugin-zip：TravelingSalesman_OsmosisPlugins.zip

下载：在Sourceforge旅游推销员

–simplify
简化插件过滤掉一些元素以简化数据。 目前，这只是一种极其粗糙的简化形式。 它将所有节点从各种方式的开始和结束节点中删除。

源代码和构建脚本：http://svn.openstreetmap.org/applications/utils/osmosis/plugins/simplify/
Some more information: README.txt

管道	描述符
输入管道.0	处理输入流.
输出管道.0	处理输出流.

目前的简化任务没有选择

#Database Login Credentials
所有数据库任务至少接受四个参数，这些参数是:

authFile
host
database
user
password
dbType

如果没有参数传递，则应用主机，数据库，用户和密码的默认值。

如果提供authFile，则必须指向具有名称值对（指定主机，数据库，用户和密码）的属性文件。 例如:

host=localhost
database=osm
user=osm
password=mypassword
dbType=postgresql

请注意，属性文件不必包含所有参数，它可能只包含密码，而在命令行中分别指定其他参数。

命令行参数将覆盖authFile参数，而authFile参数将覆盖默认的参数值。

#Munin Plugin
再加上-read-replication-lag-Task Osmosis 0.36包含一个munin插件，它描绘了复制延迟，这是本地状态文件和服务器状态之间的时间差异。

要启用它，找到你的发行版中的munin文件。 它们位于名为“script / munin /”的子目录中，并按照以下说明进行操作：

copy "osm-replication-lag" to "/usr/share/munin/plugins"
make "/usr/share/munin/plugins/osm-replication-lag" executable
symlink "/usr/share/munin/plugins/osm-replication-lag" to "/etc/munin/plugins"
copy "osm-replication.conf" to "/etc/munin/plugin-conf.d"
edit "/etc/munin/plugin-conf.d/osm-replication.conf" and set the workingDirectory
restart the munin-node