basemap layers updates [#1] (#18)

protomaps · Dec 28, 2023 · ece5dd5 · ece5dd5
1 parent 0db2256
commit ece5dd5
Showing 1 changed file with 30 additions and 9 deletions.
diff --git a/basemaps/layers.md b/basemaps/layers.md
@@ -20,23 +20,33 @@ For the previous version of the layers, see [Layers Version 2](/basemaps/layers_
 
 ## boundaries
 
-`kind`
+| Key                    | Values                                    | Description |
+| ---------------------- | ----------------------------------------- | ----------- |
+| `pmap:kind`            | `country`, `region`, `county`, `locality` |             |
+| `pmap:kind_detail`     |                                           |             |
+| `pmap:min_admin_level` |                                           |             |
+| `pmap:brk_a3`          |                                           |             |
+| `disputed`             | boolean                                   |             |
 
 ## buildings
 
 
 Buildings from OpenStreetMap.
 
-| Key |      Values |  Description |
-| ------------- | :-----------: | ----: |
-| `pmap:kind` | `building`, `building_part`| Whether it is a whole building or one part. |
-| `height` |   number | May be quantized at low zoom levels. |
-| `min_height` |   number | May be quantized at low zoom levels. |
-| `layer` | integer | Layer position relative to other buildings. |
+| Key          |             Values            |                                  Description |
+| ------------ | :---------------------------: | -------------------------------------------: |
+| `pmap:kind`  |  `building`, `building_part`  |  Whether it is a whole building or one part. |
+| `height`     |             number            |         May be quantized at low zoom levels. |
+| `min_height` |             number            |         May be quantized at low zoom levels. |
+| `layer`      |            integer            |  Layer position relative to other buildings. |
 
 ## earth
 
-`kind`
+Polygons from the Natural Earth 50m `land` theme for z0-z4, 10m for z5, preprocessed land polygons from [OSMCoastline](https://osmdata.openstreetmap.de) for z6+.
+
+| Key         |   Values  |  Description |
+| ----------- | :-------: | -----------: |
+| `pmap:kind` |  `earth`  |              |
 
 ## landuse
 
@@ -77,5 +87,16 @@ physical_point will be deprecated in v4.0.
 
 ## water
 
-`kind`
+Polygons from the Natural Earth 50m `lakes` and `ocean` themes for z0-z4, 10m for z5, preprocessed land polygons from [OSMCoastline](https://osmdata.openstreetmap.de) for z6+.
+
 
+| Key                |                    Values                    |  Description |
+| ------------------ | :------------------------------------------: | -----------: |
+| `pmap:kind`        |  `water`, `lake`, `playa`, `ocean`, `other`  |              |
+| `pmap:kind_detail` |                                              |              |
+| `reservoir`        |                                              |              |
+| `alkaline`         |                                              |              |
+| `intermittent`     |                                              |              |
+| `bridge`           |                                              |              |
+| `tunnel`           |                                              |              |
+| `layer`            |                                              |              |