---
name: "mapcache_detail"
section: "1"
platform: "linux"
package: "mapcache-tools"
version: "1.14.1-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/mapcache_detail"
---

# mapcache\_detail(1)

coverage analysis tool for SQLite caches

## NAME

mapcache\_detail - coverage analysis tool for SQLite caches

## SYNOPSIS

FC**mapcache\_detail**F\[0\]  \[*options*\]

## DESCRIPTION

**mapcache\_detail** is a coverage analysis tool for SQLite caches.

## OPTIONS

- FC**-c**F\[0\], FC**--config**F\[0\] *file*

  Configuration file (/path/to/mapcache.xml)

- FC**-D**F\[0\], FC**--dimension**F\[0\] *DIMENSION\_NAME=VALUE*

  Set the value of a dimension: format DIMENSIONNAME=VALUE. Can be used multiple times for multiple dimensions

- FC**-t**F\[0\], FC**--tileset**F\[0\] *name*

  Tileset to analyze

- FC**-g**F\[0\], FC**--grid**F\[0\] *name*

  Grid to analyze

- FC**-e**F\[0\], FC**--extent**F\[0\] *minx,miny,maxx,maxy*

  Extent to analyze: format minx,miny,maxx,maxy. Cannot be used with FC**--ogr-datasource**F\[0\]

- FC**-d**F\[0\], FC**--ogr-datasource**F\[0\] *data source*

  OGR data source to get features from. Cannot be used with FC**--extent**F\[0\].

- FC**-l**F\[0\], FC**--ogr-layer**F\[0\] *layer*

  OGR layer inside OGR data source. Cannot be used with FC**--ogr-sql**F\[0\].

- FC**-w**F\[0\], FC**--ogr-where**F\[0\] *filter*

  Filter to apply on OGR layer features. Cannot be used with FC**--ogr-sql**F\[0\].

- FC**-s**F\[0\], FC**--ogr-sql**F\[0\] *SQL query*

  SQL query to filter inside OGR data source. Cannot be used with FC**--ogr-layer**F\[0\] or FC**--ogr-where**F\[0\].

- FC**-z**F\[0\], FC**--zoom**F\[0\] *minzoom,maxzoom*

  Set min and max zoom levels to analyze, separated by a comma, eg: 12,15

- FC**-q**F\[0\], FC**--query**F\[0\] *value*

  Set query for counting tiles in a rectangle. Default value works with default schema of SQLite caches.

- FC**-o**F\[0\], FC**--short-output**F\[0\]

  Only existing SQLite files are reported, missing SQLite files are still taken into account for level and global coverage.

## EXAMPLE

Analyze tile coverage of tileset osm with the g grid. Default extent is the whole world and default zoom level is 0:

```
FC
        mapcache_detail --config mapcache.xml --tileset osm --grid g
      F[0]
```

Same as beforehand, with explicit zoom levels 9 to 12 and explicit extent covering Switzerland:

```
FC
        mapcache_detail --config mapcache.xml --tileset osm --grid g --zoom 9,12 --extent 663000,5751230,1167680,6075050
      F[0]
```