播种¶

方法¶

maproxy不逐级为切片金字塔排序，而是先遍历切片金字塔的深度。它从第一个缩放级别开始，通过检查每个字幕是否与覆盖范围相交来确定是否需要为下一个缩放级别中的分片播种。它递归地为下面的所有图块重复此步骤，直到达到种子的最后一个缩放级别。只有这样，在返回到父图块之前，图块实际上是播种的。

下面显示了为具有三个级别的简单缓存种子分片的顺序：

Level 0 with 1 tile:

          21

Level 1 with 4 tiles:

         5  10
        15  20

Level 2 with 16 tiles:

      1  2  6  7
      3  4  8  9
     11 12 16 17
     13 14 18 19

此方法已优化为有效 with 您的操作系统和地理空间数据库的缓存，因为同一区域是直接连续多个比例请求的。

它还可以有效地对复杂的封面进行检查，因为字幕可以在早期被拒绝。

选项¶

-s <seed.yaml>, --seed-conf==<seed.yaml>¶

种子配置。还可以将配置作为最后一个参数传递给 mapproxy-seed

-f <mapproxy.yaml>, --proxy-conf=<mapproxy.yaml>¶

要使用的maproxy配置。这个文件应该描述种子配置引用的所有缓存和网格。

-c N, --concurrency N¶

并发种子工作者的数目。种子工具的某些部分是CPU密集型的（图像分割和编码），使用此选项将负载分布在多个CPU上。要限制对源WMS的并发请求，请参见 concurrent_requests

-n, --dry-run¶

这将模拟种子/清理过程，而无需请求、创建或移除任何块。

--summary¶

打印所有播种和清理任务的摘要并退出。

--quiet¶

减少进度记录器的输出。

-i, --interactive¶

打印每个播种和清理任务的摘要并询问 mapproxy-seed 应该设定/清除该任务。它将在开始前查询每个任务。

--seed=<task1,task2,..>¶

只为指定的种子设定任务设定种子。可以使用逗号分隔名称列表选择多个任务，也可以使用 --seed 多次选择。你可以使用 ALL 选择所有任务。这将禁用所有清理任务，除非同时使用 --cleanup 选择权。

--cleanup=<task1,task2,..>¶

仅清理命名任务。可以使用逗号分隔名称列表选择多个任务，也可以使用 --cleanup 多次选择。你可以使用 ALL 选择所有任务。这将禁用所有种子设定任务，除非同时使用 --seed 选择权。

--continue¶

继续中断的种子进程。如果进度文件 (--progress-file ）找不到。只有在上一个种子是用 --progress-file 或 --continue 选择权。

--progress-file¶

文件名，其中maproxy存储 --continue 选择权。默认为 .mapproxy_seed_progress 在当前工作目录中。mapproxy将在成功种子后删除该文件。

--duration¶

在此持续时间之后停止播种进程。此选项接受以下格式的持续时间：120s、15m、4h、0.5d将此选项与 --continue 恢复播种。仅适用于Linux和Unix系统。

--reseed-file¶

创建的文件 mapproxy-seed 在新播种开始时。

--reseed-interval¶

只有在以下情况下才开始播种 --reseed-file 比此持续时间早。此选项接受以下格式的持续时间：120s、15m、4h、0.5d将此选项与 --continue 恢复播种。默认情况下，

--use-cache-lock¶

锁定每个缓存以防止多个并行 mapproxy-seed 在同一缓存上工作的调用。它不会锁定maproxy的正常操作。

--log-config¶

要使用的日志配置文件。

实例¶

并发性为4的种子：：

mapproxy-seed -f mapproxy.yaml -c 4 seed.yaml

打印所有种子任务的摘要并退出：

mapproxy-seed -f mapproxy.yaml -s seed.yaml --summary --seed ALL

以交互方式选择应为哪些任务设定种子：：

mapproxy-seed -f mapproxy.yaml -s seed.yaml -i

为任务1和任务2设定种子，并同时为2清理任务3:：

mapproxy-seed -f mapproxy.yaml -s seed.yaml -c 2 --seed task1,task2 \
 --cleanup task3

例子¶

seeds:
  myseed1:
    [...]
  myseed2
    [...]

cleanups:
  mycleanup1:
    [...]
  mycleanup2:
    [...]

coverages:
  mycoverage1:
    [...]
  mycoverage2:
    [...]

caches¶

包含应为此任务设定种子的缓存的列表。这些名称应该与maproxy配置中的缓存名称匹配。

grids¶

一个列表，其中应为 caches . 这些名称应该与maproxy配置中的网格名称匹配。此任务的所有缓存都需要支持您在此处指定的网格。默认情况下，将为所有配置的缓存共用的网格设定种子。

levels¶

应输入的级别列表，或带有 from 和 to 定义了一系列级别。你可以省略 from 从0级开始，或者可以省略 to 播种到最后一层。默认情况下，将为所有级别设定种子。

实例：

# seed multiple levels
levels: [2, 3, 4, 8, 9]

# seed a single level
levels: [3]

# seed from level 0 to 10 (including level 10)
levels:
  to: 10

# seed from level 3 to 6 (including level 3 and 6)
levels:
  from: 3
  to: 6

coverages¶

包含覆盖范围名称的列表。将种子面积限制在覆盖范围内。默认情况下，网格的整个覆盖范围将被播种。

refresh_before¶

重新生成所有早于给定日期的切片。日期可以是绝对的，也可以是相对的。默认情况下，不会刷新现有的平铺。

maproxy还可以使用文件的最后修改时间。文件路径应该相对于代理配置或绝对路径。

实例：

# absolute as ISO time
refresh_before:
  time: 2010-10-21T12:35:00

# relative from the start time of the seed process
refresh_before:
  weeks: 1
  days: 7
  hours: 4
  minutes: 15

# modification time of a given file
refresh_before:
  mtime: path/to/file

例子¶

seeds:
  myseed1:
    caches: [osm_cache]
    coverages: [germany]
    grids: [GLOBAL_MERCATOR]
    levels:
      to: 10

  myseed2
    caches: [osm_cache]
    coverages: [niedersachsen, bremen, hamburg]
    grids: [GLOBAL_MERCATOR]
    refresh_before:
      weeks: 3
    levels:
      from: 11
      to: 15

caches¶

一个包含要在其中清除旧切片的缓存的列表。这些名称应该与maproxy配置中的缓存名称匹配。

grids¶

带有网格名称的列表 caches 要清理的位置。这些名称应该与maproxy配置中的网格名称匹配。此任务的所有缓存都需要支持您在此处指定的网格。默认情况下，将使用所有配置的缓存共用的网格。

levels¶

或者是应该清除的级别列表，或者是带有 from 和 to 定义了一系列级别。你可以省略 from 从0级开始，或者可以省略 to 清理到最后一层。默认情况下，将清除所有级别。

实例：

# cleanup multiple levels
levels: [2, 3, 4, 8, 9]

# cleanup a single level
levels: [3]

# cleanup from level 0 to 10 (including level 10)
levels:
  to: 10

# cleanup from level 3 to 6 (including level 3 and 6)
levels:
  from: 3
  to: 6

coverages¶

包含覆盖范围名称的列表。将清理区域限制在覆盖范围内。默认情况下，网格的整个覆盖范围将被清除。

remove_all¶

设置为“真”时，无论何时创建切片，都要删除所有切片。你仍然用 levels 和 coverage 选项。使用此选项，maproxy将尝试以更有效的方式删除图块。例如：它将删除 file 缓存而不是将每个图块与时间戳进行比较。

remove_before¶

删除所有早于给定日期的切片。日期可以是绝对的，也可以是相对的。 remove_before 默认为种子进程的开始时间，以便新创建的图块不会被删除。

maproxy还可以使用文件的最后修改时间。文件路径应该相对于代理配置或绝对路径。

实例：

# absolute as ISO time
remove_before:
  time: 2010-10-21T12:35:00

# relative from the start time of the seed process
remove_before:
  weeks: 1
  days: 7
  hours: 4
  minutes: 15

# modification time of a given file
remove_before:
  mtime: path/to/file

例子¶

cleanups:
  highres:
    caches: [osm_cache]
    grids: [GLOBAL_MERCATOR, GLOBAL_SPERICAL]
    remove_before:
      days: 14
    levels:
      from: 16
  old_project:
    caches: [osm_cache]
    grids: [GLOBAL_MERCATOR]
    coverages: [mypolygon]
    levels:
      from: 14
      to: 18

例子¶

coverages:
  germany:
    datasource: 'shps/world_boundaries_m.shp'
    where: 'CNTRY_NAME = "Germany"'
    srs: 'EPSG:900913'
  switzerland:
    datasource: 'polygons/SZ.txt'
    srs: 'EPSG:900913'
  austria:
    bbox: [9.36, 46.33, 17.28, 49.09]
    srs: 'EPSG:4326'

种子¶

包含带有层/视图映射的字典。：：

seeds:
    cache1:
        views: ['world', 'germany', 'oldb']
    cache2:
        views: ['world', 'germany']
        remove_before:
            time: '2009-04-01T14:45:00'
            # or
            minutes: 15
            hours: 4
            days: 9
            weeks: 8

remove_before ：

如果存在，请重新创建早于日期或时间增量的切片。播种过程结束时，所有旧的切片都将被移除。

您可以定义固定时间或时间增量。这个 time 是一个类似于ISO的日期字符串（没有时区，没有缩写）。要定义时间增量，请使用一个或多个 seconds ， minutes ， hours ， days 或 weeks 条目。

意见¶

包含包含所有视图的字典。每个视图都描述了覆盖范围/地理范围以及应该播种的级别。

其他选项¶

srs ：

带有SRS的列表。如果层包含多个SRS的缓存，则只会为与此列表中某个SRS匹配的缓存设定种子。

res ：

在缓存此解决方案之前进行种子设定。

或

level ：

缓存该层之前的数字，或具有应缓存的级别范围的元组。

views:
  germany:
    datasource: 'shps/world_boundaries_m.shp'
    where: 'CNTRY_NAME = "Germany"'
    srs: 'EPSG:900913'
    level: [0, 14]
    srs: ['EPSG:900913', 'EPSG:4326']
  switzerland:
    datasource: 'polygons/SZ.txt'
    srs: EPSG:900913
    level: [0, 14]
    srs: ['EPSG:900913']
  austria:
    bbox: [9.36, 46.33, 17.28, 49.09]
    srs: EPSG:4326
    level: [0, 14]
    srs: ['EPSG:900913']

seeds:
  osm:
    views: ['germany', 'switzerland', 'austria']
    remove_before:
      time: '2010-02-20T16:00:00'
  osm_roads:
    views: ['germany']
    remove_before:
      days: 30