Planisfy
Api

Glyphs and Fonts API

Serve MapLibre glyph PBF ranges from the configured Planisfy glyph backend.

Glyphs and Fonts API

Planisfy proxies glyph PBF files from GLYPHS_INTERNAL_URL.

Route

MethodRouteDescription
GET/fonts/v1/{fontstack}/{range}.pbfMapLibre glyph PBF range.

{range} must be a valid glyph range such as 0-255.pbf. The API strips the .pbf suffix before requesting the configured glyph backend.

Example

curl "https://api.example.com/fonts/v1/Noto%20Sans%20Regular/0-255.pbf" \
  --output 0-255.pbf

MapLibre normally reads this route from the published style glyphs property.

Auth and caching

Glyphs can load anonymously when used by public styles. Responses use Content-Type: application/x-protobuf, Access-Control-Allow-Origin: *, and Cache-Control: public, max-age=86400.

Common errors

CodeMeaning
VALIDATION_ERRORInvalid glyph range or unsafe fontstack.
NOT_FOUNDThe configured font backend does not have the requested range.
INTERNAL_ERRORThe font backend is unavailable.

On this page