The file examples.json is a JSON array of named examples. Each example consists of:
- a
centerlon,lat - a
zoomlevel - a
namethat must be a simple slug e.g.null-island - a
descriptionto explain the cartographic feature under test. - an array of string
tagsthat group examples e.g.buildings,national-parks
Required query parameters:
?left=abc123&right=61: The Artifact SHA or PR# to display on each side of the comparison.
Optional query parameters:
?name=null-island: run only the named example.?tag=national-parks: run only one tag.?showDifferencesOnly: run the tests, but only display where the pixels don't match.
The tile archive and named style layers are the only versioned artifacts. Non-versioned parts that affect the test run:
- The current
examples.json - The
smalltestregion.osm.pbfcovered areas and snapshot date from OSM. - The
maplibre-gl-jsversion. - The font glyphs and sprite assets used by the style.