Skip to content

Styles

/maps/style/{name}.json returns a Mapbox GL style document, consumed by maps-js.

Supported styles

Style Notes
streets.json The default street map.
streets_next.json Like streets, but its openmaptiles source points at the splitted streets tileset (STREETS_MBTILES_FILENAME) when one is configured.

Deprecated styles

Still served for backwards compatibility, but not actively maintained. Don't build new integrations on these:

streets-light.json, streets_classic.json, streets_satellite.json, eci-grey-streets.json.

Label localization

Layers whose text-field is the placeholder ${wgs_localization} are rewritten per request to a localized expression. The language is taken from the ?language= query parameter, falling back to the Accept-Language header.

  • With a language, labels resolve to coalesce(name:{lang}, name_int).
  • Without one, labels use name_int.
  • A non-latin name:nonlatin is appended on a second line when it differs from the localized name.
  • Khmer (km) falls back to no language.

Sprites and glyphs

The style's sprite URL is versioned by DEFAULT_STYLE_VERSION (/maps/assets/styles/streets-v{N}/sprites/sprite), which lets new sprite assets be deployed and then activated by bumping the version. Glyphs are served from /maps/assets/{fontstack}/{range}.pbf. See Deploying.

Capabilities

Styles carry a capabilities array (e.g. 3d-buildings). satellite is appended when the project token holds the MAP_SATELLITE product; satellite tiles and the streets_satellite style require that product.