Zh-hans:Osmosis

From OpenStreetMap Wiki
Jump to: navigation, search
可用语言 — Osmosis
· Afrikaans · Alemannisch · aragonés · asturianu · azərbaycanca · Bahasa Indonesia · Bahasa Melayu · Bân-lâm-gú · Basa Jawa · Baso Minangkabau · bosanski · brezhoneg · català · čeština · dansk · Deutsch · eesti · English · español · Esperanto · estremeñu · euskara · français · Frysk · Gaeilge · Gàidhlig · galego · Hausa · hrvatski · Igbo · interlingua · Interlingue · isiXhosa · isiZulu · íslenska · italiano · Kiswahili · Kreyòl ayisyen · kréyòl gwadloupéyen · Kurdî · latviešu · Lëtzebuergesch · lietuvių · magyar · Malagasy · Malti · Nederlands · Nedersaksies · norsk bokmål · norsk nynorsk · occitan · Oromoo · oʻzbekcha/ўзбекча · Plattdüütsch · polski · português · português do Brasil · română · shqip · slovenčina · slovenščina · Soomaaliga · suomi · svenska · Tiếng Việt · Türkçe · Vahcuengh · vèneto · Wolof · Yorùbá · Zazaki · српски / srpski · беларуская · български · қазақша · македонски · монгол · русский · тоҷикӣ · українська · Ελληνικά · Հայերեն · ქართული · नेपाली · मराठी · हिन्दी · অসমীয়া · বাংলা · ਪੰਜਾਬੀ · ગુજરાતી · ଓଡ଼ିଆ · தமிழ் · తెలుగు · ಕನ್ನಡ · മലയാളം · සිංහල · ไทย · မြန်မာဘာသာ · ລາວ · ភាសាខ្មែរ · ⵜⴰⵎⴰⵣⵉⵖⵜ · አማርኛ · 한국어 · 日本語 · 中文(简体)‎ · 吴语 · 粵語 · 中文(繁體)‎ · ייִדיש · עברית · اردو · العربية · پښتو · سنڌي · فارسی · ދިވެހިބަސް
Sub pages
Installation
Detailed Usage
Examples
Benchmarking / Tuning
Development
Writing Plugins

Osmosis 是用于处理OSM数据的Java命令行应用程序,包括许多插件式的组件。比如读写数据库和文件的组件、继承和修改数据源的组件、对数据排序管理的组件等,避免了实现常用功能而重复性编写代码。

目前主要功能有:

  • 从数据库中生成指定区域的osm数据
  • 导入区域的osm数据到数据库
  • 生成变化数据集数据库更新记录表
  • 应用变化数据集到本地数据库
  • 比较区域oms数据生成变化数据集
  • 区域oms数据重排序
  • 抽取指定矩形或多边形范围内数据

Osmosis提供库的形式集成到其他Java应用中 [1]

当前状态

Osmos 目前大部分的代码库不太可能会被彻底改变。 新功能以新任务的形式,在不同时期会被进行说明 plugins, 但是已存在的功能不太会被移除掉. 欢迎提交任何 BUG

当前的版本只支持API 0.6 OSM data model

下载

最新稳定版本

请保证在任何时候都使用以下的稳定版本

开发编译版本

在使用前,你应该去查看它最新的功能或修正的错误。“不能保证其稳定性”。

定期编译包是创建在持续整合的服务器上,上面包括了很容易被识别的SVN版本号。

老风格的nightly builds 还依然有效,但是只能在持续集合包无效的情况下使用。

http://dev.openstreetmap.org/~bretth/osmosis-build/


Java 1.5

对于那些不能安装Java 1.6 运行时的情况,可以查考以下的兼容 1.5 的版本。目前已经确认一些问题存在于部分老款的Mac 系统。

支持 API 0.5

0.35版本是最后一个支持 API 0.5。

DB Schema

(see Osmosis/PostGIS_Setup)

Database schema在 script/contrib 目录下可以找到与API相匹配的创建脚本。

在Osmosis 发行包中的script 目录里,可以找到用来创建simple模式和snapshot模式的数据库模式创建脚本(osmosis 0.39 ff)。

Subversion

subversion 库 地址: http://svn.openstreetmap.org/applications/utils/osmosis/

(更多的内容参见Osmosis 安装指南分页 Osmosis/Installation 。)


使用

详细使用说明

以下链接包含了所有完整的任务明细和使用说明:

以下链接包含了一些老版本的使用说明:

追求最大的性能,可以参考 Tuning and Benchmarking.

OSMembrane 也包含了在前端使用Osmosis 的说明。

使用案例

(更多内容参见 Osmosis/Examples.)

导入一个planet 文件到本地的PostgreSQL 数据库。

osmosis --read-xml file="planet.osm" --write-apidb host="x" database="x" user="x" password="x"


从本地的PostgreSQL 数据库导出一个planet 文件。

osmosis --read-apidb host="x" database="x" user="x" password="x" --write-xml file="planet.osm"

从两个planet 文件得出差异集。第一个文件是变化后数据,第二个文件是变化前数据。

osmosis --read-xml file="planet1.osm" --read-xml file="planet2.osm" --derive-change --write-xml-change file="planetdiff-1-2.osc"

从一个planet 文件和本地PostgreSQL 数据库中得出差异集。

osmosis --read-xml file="planet1.osm" --read-apidb host="x" database="x" user="x" password="x" --derive-change --write-xml-change file="planetdiff-1-2.osc"

应用一个差异集到planet 文件上。

osmosis  --read-xml-change file="planetdiff-1-2.osc" --read-xml file="planet1.osm" --apply-change --write-xml file="planet2.osm" or
osmosis  --read-xml file="planet1.osm" --read-xml-change file="planetdiff-1-2.osc" --apply-change --write-xml file="planet2.osm" for the older version

整理出指定内容的planet 文件。

osmosis --read-xml file="data.osm" --sort type="TypeThenId" --write-xml file="data-sorted.osm"

以上的例子都使用了 默认管道连接特性,然而读写planet文件的命令行可以写成两种方式。第一种就是使用默认管道连接,第二种准确的来说就是通过被命名的"mypipe"的管道来连接两个部件。默认管道连接将以指定顺序来跑完每个任务。而每个任务需要把它的输出流放到一个堆栈上,而且每个任务需要从堆栈上把数据放到它的输入流。正是因为基于堆栈的方式,所以需要使用"--apply-change" 参数的例子会首先去读取差异文件,而后--apply-change 任务会先从堆栈取得数据文件,再然后去改变文件。

osmosis --read-xml file="planetin.osm" --write-xml file="planetout.osm"
osmosis --read-xml file="planetin.osm" outPipe.0="mypipe" --write-xml file="planetout.osm" inPipe.0="mypipe"


通过Osmosis/Polygon Filter File Format 文件来导出一个地区 :

osmosis --read-xml file="planet-latest.osm" --bounding-polygon file="country2pts.txt" --write-xml file="germany.osm"


导出指定标签的ways。通过指定 --used-node 将只导出那些被过滤出来的ways所需要使用的nodes。Relations 则不受影响。

osmosis --read-xml city.osm --way-key-value keyValueList="railway.tram,railway.tram_stop" --used-node --write-xml city_tram.osm


对于一些大数据(就像 planet 文件),通常会因为内存的限制造成一个分段错误。在--used-node后加上idTrackerType=BitSet这个参数,可能可以帮助解决这个现象:

osmosis --read-xml city.osm --way-key-value keyValueList="railway.tram,railway.tram_stop" --used-node idTrackerType=BitSet --write-xml city_tram.osm

记住,--way-key-value--node-key-value 不能被同时使用。可以去多跑几次去创建两个(或以上)的文件,然后再合并(merge)在一起(对于n个文件,你需要n-1个merge命令):

osmosis --rx 1.osm --rx 2.osm --rx 3.osm --merge --merge --wx merged.osm

只有从0.22版本开始 的 0.5 任务 才有效。


导出指定区域

这是一个从巨大的下载文件来提取OSM XML 子集的基本用例。你可以去下载整个地球的OSM (planet.osm) ,只是想提取某些区域,或是从下载的国家分量包里只获取某个城市。最简单的就是导出一个矩形大小的范围。

这是一个从Germany或者是world osm上导出Nürnberg 以及 周边地区的例子:

 bzcat downloaded.osm.bz2 | osmosis\
  --read-xml enableDateParsing=no file=-\
  --bounding-box top=49.5138 left=10.9351 bottom=49.3866 right=11.201 --write-xml file=-\
  | bzip2 > extracted.osm.bz2

在这里需要使用 bzip2直接来进行压缩和解压缩,这比内置的解压程序更高效。

最简单的就是双击你想获取的莫个坐标范围的地方,再点击"Permalink" 从URL上来抓取数据。

Windows 注意事项

如果你想要好的表现,可以尝试bzcat 这个For Windows的工具。然而 /dev/stdin在Windows上不是一个有效的路径. 尝试使用CONIN$ 来代替它.

获取帮助 报告BUG

想要获取在使用osmosis 过程中遇到的问题答案,osmosis 开发邮件列表是最好的地方。

http://lists.openstreetmap.org/listinfo/osmosis-dev

在开票前,请在开发邮件列表讨论下可能潜在的bugs。如果你不确定是否已经发现了一个bug,尝试去登陆到OSM trac的"osmosis"部分。

http://trac.openstreetmap.org/query?component=osmosis

另请参阅

  • 想了解用osmosis 所描述的差异方面的详细内容,参见OsmChange
  • 想了解更多复杂的例子,参见 Osmosis/Examples.
  • 想要尝试去写自己的任务,参见Osmosis/WritingPlugins
  • 想了解完整的命令和参数集,参见 Osmosis/Detailed Usage.
  • Osm2pgsql 同样能够对postgis数据库进行导出工作
  • 感谢 Osmosis, Osm2postgresql 能够仅仅通过一句命令,就可以安装 postgresql & postgis 和你自己的OSM数据。