The file examples.json
is a JSON array of named examples. Each example consists of:
- a
center
lon,lat - a
zoom
level - a
name
that must be a simple slug e.g.null-island
- a
description
to explain the cartographic feature under test. - an array of string
tags
that 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.pbf
covered areas and snapshot date from OSM. - The
maplibre-gl-js
version. - The font glyphs and sprite assets used by the style.