mkgmap-splitter - 云端在线

程序：

您的姓名

mkgmap-splitter - mkgmap 的图块分割器

概要

mkgmap 拆分器 [选项] 文件.osm > 拆分器.log

商品描述

mkgmap 拆分器 将包含大型映射良好区域的 .osm 文件拆分为多个
较小的图块，以适应用于 Garmin 地图格式的最大尺寸。 那里
至少需要两个处理阶段。 第一阶段是计算面积
根据节点的分布，每个图块都应该覆盖。 第二阶段写出
将原始 .osm 文件中的节点、方式和关系转换为单独的较小的 .osm
文件，第一阶段计算的每个区域一个。 带选项
--保持完整=真，另外两个阶段用于避免断路和多边形。

最重要的两个功能是：

· 可变大小的瓷砖，以防止大量的小文件。

· 瓷砖完全连接，没有重叠或间隙。

如果您打算分割大片区域，您的计算机将需要大量内存。 一些
选项允许配置您需要多少内存。 使用默认参数，您需要
每个节点和方式大约 4-5 个字节。 这听起来不多，但大约有 1700
整个星球文件中的百万个节点，因此您无法一次处理整个星球
使用此实用程序在 32 位机器上传递文件，因为最大 Java 堆空间为 2G。 它
使用 64 位 java 和大约 7GB 的堆或多次传递是可能的。

Cloudmade 或 Geofabrik 的欧洲提取物可以在 2G 限制内处理，如果您
有足够的内存。 使用默认选项，欧洲被分成大约 750 个图块。
欧洲提取物大约是完整行星文件大小的一半。

另一方面，一个国家，即使是像德国或英国这样的地图完善的国家，也会
可以在一台普通的机器上，甚至是上网本上。

用法

拆分器需要 java 1.6 或更高版本。 基本用法如下。

mkgmap 拆分器 文件.osm > 拆分器.log

如果您的计算机内存少于 2 GB，则应减少 -Xmx 选项
设置 JAVA_OPTS 环境变量。

JAVA_OPTS="-Xmx512米" mkgmap 拆分器 文件.osm > 拆分器.log

这将产生许多 .osm.pbf 文件，这些文件可以被 地图（1）。 有
还产生了其他文件：

这款 模板.args file 是一个可以与 -c 选项 地图 那会的
编译所有文件。 您可以按原样使用它，也可以复制并编辑它以包含
你自己的选择。 例如，不是每个描述都是“OSM Map”，而是“NW
苏格兰”。

这款 区域列表 文件是计算出的边界框列表。 如果你想要你
可以在后续调用拆分器时使用它 --拆分文件 使用选项
与上次完全相同的区域。 如果您定期生成地图，这可能很有用
并希望每个月的瓷砖区域都保持不变。 避免也很有用
每次重新生成文件所需的时间（目前大约是整个文件的三分之一）
执行拆分所需的时间）。 当然，如果地图增长到足以使其中一个图块
溢出，您将不得不再次重新计算面积。

这款 区域.poly 文件包含计算区域的边界多边形。 查看选项
--多边形文件 如何使用。

这款 密度输出.txt 当没有给出拆分文件并且包含调试时写入文件
仅供参考。

您还可以使用 gzip 或 bz2 压缩的 .osm 文件作为输入文件。 注意
这会大大减慢分离器的速度（对于 bz2 尤其如此），因为
解压缩 .osm 文件可能会占用大量 CPU 资源。 如果你很可能是
多次处理一个文件，您最好将文件转换为以下文件之一
二进制格式 pbf 或 o5m。 o5m 格式读取速度更快，但需要更多空间
在磁盘上。

配置

有许多选项可以微调您可能想要尝试的内容。

--边界标签=绳子
关系的标记值的逗号分隔列表。 用于过滤多边形
问题列表处理的边界关系。 另见选项
--通缉管理员级别. 默认值：使用排除列表

--缓存=绳子
已弃用，现在什么都不做

--描述=绳子
设置要写入的描述 模板.args 文件中。

--geonames-文件=绳子
用于确定切片名称的 GeoNames 文件的名称。 通常
城市15000.zip 来自地名 ⟨http://download.geonames.org/export/dump⟩。

--保持完整=布尔
使用 VHDL 语言编写 --保持完整=假 禁用两个额外的程序阶段之间
拆分和最终分发阶段（不推荐）。 第一阶段，称为
gen-problem-list，检测跨越边界的所有方式和关系
一个或多个输出文件。 第二阶段，称为处理问题列表，收集
这些方式和关系的坐标并计算所有输出文件
被交叉或封闭。 信息被传递到最后的 dist 阶段
三个临时文件。 这避免了破碎的多边形，但请注意，它需要
至少额外读取两次输入文件。

不要指定它 - 重叠 除非你有充分的理由这样做。

默认值：true

--mapid=INT
设置拆分文件的文件名。 在示例中，第一个文件将被调用
63240001.osm.pbf 下一个是 63240002.osm.pbf 等等。

默认值：63240001

--最大面积=INT
加工过程中单程可加工的最大区域数
第二阶段处理。 这必须是 1 到 4096 之间的数字。更高的数字
意味着更少的源文件传递，因此更快的整体处理，但
还需要更多的内存。 如果您发现内存不足但又不想
增加你的 --最大节点 值，请尝试减少此值。 改变这将
对分割的结果没有影响，纯粹是为了让你权衡内存
为了性能。 注意第一阶段的处理有固定的内存
不管这设置为什么，因此如果您的内存不足
前 区域列表 生成文件，您需要增加您的 -Xmx
值或减小您尝试拆分的输入文件的大小。

默认值：512

--最大节点=INT
可以在任何结果文件中的最大节点数。 默认的
相当保守，您可以在获得任何“地图”之前将其增加很多
太大'的消息。 没有做过多少实验。 还有这个越大
值，分裂阶段需要的内存越少。

默认值：1600000

--最大线程=折扣值
使用的最大线程数 mkgmap 拆分器.

默认值：4（自动）

--混合=布尔
如果输入 osm 文件具有混合的节点、方式和关系，则指定此项
id 没有严格排序。 要提高性能，请使用 反渗透 分类
功能。

默认值：false

--无修剪=布尔
不要修剪瓷砖边缘的空白区域。 当这个选项被忽略时
--多边形文件 用来。

默认值：false

--num-tiles=折扣值绳子
未给出拆分文件时使用的目标值。 分裂是这样完成的
生产给定数量的瓷砖。 这 --最大节点 如果这个值被忽略
给出了选项。

--输出=绳子
写入输出文件的格式。 可能的值为 xml、pbf、
o5m，并模拟。 默认为 pbf，它产生最小的文件大小。
o5m 格式写入速度更快，但会创建大约 40% 的文件。 这
模拟选项用于调试目的。

--输出目录=径
拆分器应将输出文件写入的目录。 如果指定
目录路径不存在， mkgmap 拆分器 试图创造它。 默认为
当前工作目录。

--重叠=绳子
自 r279 起已弃用。 和 --保持完整=假, mkgmap 拆分器 应包括
边界框外的节点，因此 地图 可以整齐地准确裁剪
边界。 此参数控制重叠的大小。 它以地图为单位，一个
使用默认值 2000，这意味着大约 0.04 度的纬度或经度。
If --保持完整=真 是活跃的并且 - 重叠 给出，将打印警告
因为这种组合很少有意义。

--多边形描述文件=径
一个 osm 文件 (.o5m, .pbf, .osm) 用命名方式描述边界多边形
OSM 方式具有标签名称和 mapid。

--多边形文件=径
包含渗透多边形文件格式的边界多边形的文件的名称
. mkgmap 拆分器 在计算面积时使用此文件。 它首先计算
使用给定的网格 - 解析度. 读取输入文件，对于每个节点，一个
相关网格区域的计数器增加。 如果输入文件包含一个
边界框，这适用于网格，以便边界框外的节点
被忽略。 接下来，如果指定，边界多边形用于将这些网格归零
边界多边形区域之外的元素。 如果多边形区域描述
一个不超过 40 个顶点的直线区域， mkgmap 拆分器 将尝试
创建完全适合该区域的输出文件，否则它将近似
带有矩形的多边形区域。

--precomp-海=径
包含预编译海图的目录的名称。 如果给出， mkgmap-
分离器 将使用与预编译的海图相同的方式 地图 做。 用
如果您想使用多边形文件或 --无修剪=真 和 地图 创建空
*.img 文件结合以“单个文件中没有足够的空间”开头的消息
所有输入数据的 garmin 地图”。

--问题文件=径
包含已知会导致问题的方式和关系的文件的名称
在拆分过程中。 使用此选项，如果 --保持完整 需要太多时间或
记忆和 - 重叠 不能解决你的问题。

问题文件的语法：

道路： ＃ 评论...
相对： ＃ 评论...

例：

方式：2784765 #Ferry Guernsey - Jersey

--问题报告=径
用于写入生成的问题列表的文件名
--保持完整. 如果参数被忽略 --保持完整=假. 您可以重复使用
这个文件与 --问题文件 参数，但仅当您使用相同的参数时才执行此操作
的值 --最大节点 和 - 解析度.

--分辨率=INT
第一阶段生成的密度图的分辨率。 之间的值
1 和 24。默认值为 13。将值增加到 14 需要四倍以上
分裂阶段的记忆。 如果 a --拆分文件 给出。

--搜索限制=INT
拆分算法中的搜索限制。 较高的值可能会找到更好的分割，但需要
更长的时间。

默认值：200000

--拆分文件=径
使用之前计算的瓷砖区域，而不是从头开始计算它们。
该文件可以是 .list 或 .kml 格式。

--状态频率=INT
显示 JVM 每次使用的内存量 --状态频率 秒。 设置 =0
禁用。

默认值：120

--停止后=绳子
调试：在给定的程序阶段后停止。 可以拆分，生成问题列表，或
处理问题列表。 默认是 dist，这意味着执行所有阶段。

--想要的管理员级别=绳子
指定应保持的边界关系的最低 admin_level 值
完全的。 用于过滤问题列表处理的边界关系。 这
默认值 5 表示边界关系在
admin_level 为 5 或更高 (5..11)。 如果参数被忽略
--保持完整=假. 默认值：5

--写入-kml=径
要写出区域的 kml 文件的名称。 这除了
区域列表 （总是写出来的）。

特殊选项

- 版
如果参数 - 版 在选项中的某处找到， mkgmap 拆分器 将
只需打印版本信息并退出。 版本信息如下所示：

splitter 279 compiled 2013-01-12T01:45:02+0000

- 帮帮我 如果参数 - 帮帮我 在选项中的某处找到， mkgmap 拆分器 将
打印所有已知正常选项的列表以及简短的帮助并退出。

TUNING

调整以获得最佳性能

给正在使用的人的一些提示 mkgmap 拆分器 拆分大文件。

·为了更快的处理 --保持完整=真, 将输入文件转换为o5m格式
使用：

渗透转换 --drop-版本 文件.osm -o=文件.o5m

· 选项 --drop-版本 是可选的，它将文件减少到所需的数据
by mkgmap 拆分器 和 地图.

· 如果您仍然遇到性能不佳的情况，请查看 拆分器.log. 搜索这个词
分发。 您可能会在下一行中找到类似的内容：

1502 次处理 3 个区域，一次处理 501 个区域

这意味着 splitter 必须读取输入文件输入 XNUMX 次，因为 --最大面积
参数远小于区域数。 如果你有足够的堆，设置
--最大面积 value 为高于区域数量的值，例如
--最大面积=2048。 执行 mkgmap 拆分器 再一次，你应该找到

一次处理1502个区域

· 更多的区域需要更多的内存。 确保 mkgmap 拆分器 有足够的堆
（增加 -Xmx 参数），这样它就不会在垃圾中浪费太多时间
收集器 (GC)，但为系统 I/O 缓存保留尽可能多的内存。

· 如果可用，使用两个不同的磁盘作为输入文件和输出目录，尤其是。 当你
使用 o5m 格式进行输入和输出。

·如果你使用 地图 r2415或更高版本和磁盘空间无关，考虑使用
--输出=o5m 以加快处理速度。

针对低内存需求进行调优

如果您的机器的可用内存少于 1 GB（例如上网本），您仍然可以使用 mkgmap-
分离器, 但如果你使用参数，你可能需要耐心 --保持完整 和
想要分割一个文件，如 德国.osm.pbf 或更大的。 如果需要，减少数量
平行加工区增加到 50 --最大面积 范围。 你必须使用
--保持完整=假 当分裂像欧洲这样的地区时。

附注

· 可以输出的区域数量不再有上限（以前是
它是 255）。 更多的区域只是意味着可能需要通过 .osm 进行更多的传递
文件，因此拆分器将需要更长的时间才能运行。

· 一个方法或关系可以属于多少个区域不再有限制（以前是
它是 4）。

使用 onworks.net 服务在线使用 mkgmap-splitter