Skip to content

Commit

Permalink
Update empty-tiles.md with maplibregl support for empty tile content
Browse files Browse the repository at this point in the history
Since Maplibre GL v4.0.0 an empty response with 200 or 204 will be treated as a transparent tile
  • Loading branch information
andrewharvey authored Jan 28, 2025
1 parent 72f2a81 commit 6374725
Showing 1 changed file with 3 additions and 4 deletions.
7 changes: 3 additions & 4 deletions docs/operator-guide/empty-tiles.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,12 +46,13 @@ Pros:

- ✔️ Supported in ArcGIS Pro and QGIS
- ✔️ Supported by ArcGIS Online, Leaflet, and OpenLayers
- ✔️ Supported by maplibre [since v4.0.0](https://github.com/maplibre/maplibre-gl-js/blob/main/CHANGELOG.md#-bug-fixes-29)
- ✔️ Supported by [HTTP RFC](https://www.rfc-editor.org/rfc/rfc9110.html#name-200-ok), which allows 0 byte `200 Ok` responses as long as the message framing indicates this (via `Content-length=0` response header
- ✔️ Recommended option from OGC Tile API

Cons:

- ❌ Not supported by maplibre/mapbox
- ❌ Not supported by mapbox gl
-[HTTP RFC](https://www.rfc-editor.org/rfc/rfc9110.html#name-200-ok) suggests that while valid, servers "ought to return 204 No content"

## 204 No Content
Expand All @@ -62,15 +63,13 @@ Pros:

- ✔️ Supported in ArcGIS Pro and QGIS
- ✔️ Supported by Leaflet and OpenLayers
- ✔️ Supported by maplibre [since v4.0.0](https://github.com/maplibre/maplibre-gl-js/blob/main/CHANGELOG.md#-bug-fixes-29)
- ✔️ Supported by [HTTP RFC](https://www.rfc-editor.org/rfc/rfc9110.html#name-200-ok): "server ought to return 204 No content"
- ✔️ Recommended option from OGC Tile API

Cons:

- ❌ Not supported by ArcGIS Online
- ❌ Not supported by maplibre
- https://github.com/maplibre/maplibre-gl-js/pull/2325
- https://github.com/maplibre/maplibre-gl-js/pull/1586
- ❌ Not supported by mapbox gl
- https://github.com/mapbox/mapbox-gl-js/issues/9304
- Not always cached by browser
Expand Down

0 comments on commit 6374725

Please sign in to comment.