Skip to content

Commit 39ccc1b

Browse files
Rub21Rub21
committed
Update toml file for vtiles and create documentation
1 parent ed97cc8 commit 39ccc1b

File tree

8 files changed

+486
-57
lines changed

8 files changed

+486
-57
lines changed

‎DOC-VTILES.md‎

Lines changed: 261 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,261 @@
1+
# Tables and Zoom Levels for Tiler - Documentation and Standardization
2+
3+
This document lists all materialized tables (mv_*) used in TOML configuration files and proposes a standard zoom level schema to unify the configuration.
4+
5+
6+
### Standardize in gaps: 0‑2, 3‑5, 6‑7, 8‑9, 10‑12, 13‑15, 16‑20
7+
8+
### Simplification:
9+
10+
### Large areas by zoom level
11+
- 0‑2: 5000
12+
- 3‑5: 1000
13+
- 6‑7: 200
14+
- 8‑9: 100
15+
- 10‑12: 20
16+
- 13‑15: 5–10 (choose one and be consistent between water/admin)
17+
- 16‑20: 0–1 (0 for clean polygons, 1 if there are very dense geometries)
18+
19+
20+
### Transport lines / routes
21+
- 0‑2: 5000
22+
- 3‑5: 1000
23+
- 6‑7: 200
24+
- 8‑9: 100
25+
- 10‑12: 20
26+
- 13‑15: 5
27+
- 16‑20: 0
28+
29+
30+
## Current MView Values by Category
31+
32+
These tables document all current simplification values and area filters for each materialized view, extracted from SQL files in `/images/tiler-imposm/queries/ohm_mviews/`.
33+
34+
**Legend:**
35+
- `-` = Not applicable / No simplification / No area filter
36+
- ⚠️ = Detected inconsistency that should be standardized
37+
- **Derived** = View created from another mview (not directly from source table)
38+
39+
# Water Areas (water_areas)
40+
41+
| MView | Zoom Levels | Simplification (m) | Min Area (m²) | Function | Notes |
42+
|-------|-------------|-------------------|---------------|---------|-------|
43+
| `mv_water_areas_z0_2` | 0-2 | 5000 | 100,000,000 | create_area_mview_from_mview | |
44+
| `mv_water_areas_z3_5` | 3-5 | 1000 | 50,000,000 | create_area_mview_from_mview | |
45+
| `mv_water_areas_z6_7` | 6-7 | 200 | 1,000,000 | create_area_mview_from_mview | |
46+
| `mv_water_areas_z8_9` | 8-9 | 100 | 10,000 | create_area_mview_from_mview | |
47+
| `mv_water_areas_z10_12` | 10-12 | 20 | 100 | create_area_mview_from_mview | |
48+
| `mv_water_areas_z13_15` | 13-15 | 5 | - | create_area_mview_from_mview | |
49+
| `mv_water_areas_z16_20` | 16-20 | 0 | - | create_areas_mview | Base view |
50+
51+
52+
# Water Centroids (water_areas_centroids)
53+
54+
| MView | Zoom Levels | Simplification (m) | Min Area (m²) | Function | Notes |
55+
|-------|-------------|-------------------|---------------|---------|-------|
56+
| `mv_water_areas_centroids_z8_9` | 8-9 | - | - | create_mview_centroid_from_mview | Derived |
57+
| `mv_water_areas_centroids_z10_12` | 10-12 | - | - | create_mview_centroid_from_mview | Derived |
58+
| `mv_water_areas_centroids_z13_15` | 13-15 | - | - | create_mview_centroid_from_mview | Derived |
59+
| `mv_water_areas_centroids_z14_20` | 14-20 | - | - | create_mview_centroid_from_mview | Derived |
60+
61+
62+
# Water Lines (water_lines)
63+
64+
| MView | Zoom Levels | Simplification (m) | Min Area (m²) | Function | Notes |
65+
|-------|-------------|-------------------|---------------|---------|-------|
66+
| `mv_water_lines_z16_20` | 16-20 | 0 | - | create_lines_mview | Base view |
67+
| `mv_water_lines_z13_15` | 13-15 | 5 | - | create_mview_line_from_mview | Derived |
68+
| `mv_water_lines_z10_12` | 10-12 | 20 | - | create_mview_line_from_mview | Derived |
69+
| `mv_water_lines_z8_9` | 8-9 | 100 | - | create_mview_line_from_mview | Derived |
70+
71+
# Administrative Boundaries - Areas (admin_boundaries_areas)
72+
73+
| MView | Zoom Levels | Simplification (m) | Min Area (m²) | Function | Notes |
74+
|-------|-------------|-------------------|---------------|---------|-------|
75+
| `mv_admin_boundaries_areas_z0_2` | 0-2 | 5000 | - | create_areas_mview | |
76+
| `mv_admin_boundaries_areas_z3_5` | 3-5 | 1000 | - | create_areas_mview | |
77+
| `mv_admin_boundaries_areas_z6_7` | 6-7 | 200 | - | create_areas_mview | |
78+
| `mv_admin_boundaries_areas_z8_9` | 8-9 | 100 | - | create_areas_mview | |
79+
| `mv_admin_boundaries_areas_z10_12` | 10-12 | 20 | - | create_areas_mview | |
80+
| `mv_admin_boundaries_areas_z13_15` | 13-15 | 5 | - | create_areas_mview | |
81+
| `mv_admin_boundaries_areas_z16_20` | 16-20 | 1 | - | create_areas_mview | |
82+
83+
# Administrative Boundaries - Centroids (admin_boundaries_centroids)
84+
85+
| MView | Zoom Levels | Simplification (m) | Min Area (m²) | Function | Notes |
86+
|-------|-------------|-------------------|---------------|---------|-------|
87+
| `mv_admin_boundaries_centroids_z0_2` | 0-2 | - | - | create_admin_boundaries_centroids_mview | Derived |
88+
| `mv_admin_boundaries_centroids_z3_5` | 3-5 | - | - | create_admin_boundaries_centroids_mview | Derived |
89+
| `mv_admin_boundaries_centroids_z6_7` | 6-7 | - | - | create_admin_boundaries_centroids_mview | Derived |
90+
| `mv_admin_boundaries_centroids_z8_9` | 8-9 | - | - | create_admin_boundaries_centroids_mview | Derived |
91+
| `mv_admin_boundaries_centroids_z10_12` | 10-12 | - | - | create_admin_boundaries_centroids_mview | Derived |
92+
| `mv_admin_boundaries_centroids_z13_15` | 13-15 | - | - | create_admin_boundaries_centroids_mview | Derived |
93+
| `mv_admin_boundaries_centroids_z16_20` | 16-20 | - | - | create_admin_boundaries_centroids_mview | Derived |
94+
95+
# Administrative Boundaries - Lines (admin_boundaries_lines)
96+
97+
| MView | Zoom Levels | Simplification (m) | Min Area (m²) | Function | Notes |
98+
|-------|-------------|-------------------|---------------|---------|-------|
99+
| `mv_admin_boundaries_lines_z0_2` | 0-2 | 5000 | - | ST_SimplifyPreserveTopology | |
100+
| `mv_admin_boundaries_lines_z3_5` | 3-5 | 1000 | - | ST_SimplifyPreserveTopology | |
101+
| `mv_admin_boundaries_lines_z6_7` | 6-7 | 200 | - | ST_SimplifyPreserveTopology | |
102+
| `mv_admin_boundaries_lines_z8_9` | 8-9 | 100 | - | ST_SimplifyPreserveTopology | |
103+
| `mv_admin_boundaries_lines_z10_12` | 10-12 | 20 | - | ST_SimplifyPreserveTopology | |
104+
| `mv_admin_boundaries_lines_z13_15` | 13-15 | 5 | - | ST_SimplifyPreserveTopology | |
105+
| `mv_admin_boundaries_lines_z16_20` | 16-20 | 1 | - | ST_SimplifyPreserveTopology | |
106+
107+
# Administrative Boundaries - Maritime (admin_boundaries_maritime)
108+
109+
TODO: fix according to schema
110+
111+
| MView | Zoom Levels | Simplification (m) | Min Area (m²) | Function | Notes |
112+
|-------|-------------|-------------------|---------------|---------|-------|
113+
| `mv_admin_maritime_lines_z0_5_v2` | 0-5 ⚠️ | 2000 | - | create_lines_mview | Should be z0_2 + z3_5 |
114+
| `mv_admin_maritime_lines_z6_9` | 6-9 ⚠️ | 500 | - | create_lines_mview | Should be z6_7 + z8_9 |
115+
| `mv_admin_maritime_lines_z10_15` | 10-15 ⚠️ | 10 | - | create_lines_mview | Should be z10_12 + z13_15 |
116+
117+
118+
# Land Use - Areas (landuse_areas)
119+
120+
| MView | Zoom Levels | Simplification (m) | Min Area (m²) | Function | Notes |
121+
|-------|-------------|-------------------|---------------|---------|-------|
122+
| `mv_landuse_areas_z6_7` | 6-7 | 200 | 10,000,000 | create_areas_mview | |
123+
| `mv_landuse_areas_z8_9` | 8-9 | 100 | 1,000,000 | create_areas_mview | |
124+
| `mv_landuse_areas_z10_12` | 10-12 | 20 | 50,000 | create_areas_mview | |
125+
| `mv_landuse_areas_z13_15` | 13-15 | 5 | 10,000 | create_areas_mview | |
126+
| `mv_landuse_areas_z16_20` | 16-20 | 0 | - | create_areas_mview | |
127+
128+
# Land Use - Centroids (landuse_points_centroids)
129+
130+
| MView | Zoom Levels | Simplification (m) | Min Area (m²) | Function | Notes |
131+
|-------|-------------|-------------------|---------------|---------|-------|
132+
| `mv_landuse_points_centroids_z6_7` | 6-7 | - | - | create_points_centroids_mview | Derived |
133+
| `mv_landuse_points_centroids_z8_9` | 8-9 | - | - | create_points_centroids_mview | Derived |
134+
| `mv_landuse_points_centroids_z10_12` | 10-12 | - | - | create_points_centroids_mview | Derived |
135+
| `mv_landuse_points_centroids_z13_15` | 13-15 | - | - | create_points_centroids_mview | Derived |
136+
| `mv_landuse_points_centroids_z16_20` | 16-20 | - | - | create_points_centroids_mview | Derived |
137+
138+
# Land Use - Lines (landuse_lines)
139+
140+
TODO: fix according to schema
141+
142+
143+
| MView | Zoom Levels | Simplification (m) | Min Area (m²) | Function | Notes |
144+
|-------|-------------|-------------------|---------------|---------|-------|
145+
| `mv_landuse_lines_z14_20` | 14-20 ⚠️ | - | - | create_generic_mview | Should be z14_15 + z16_20 |
146+
147+
# Transport - Areas (transport_areas)
148+
149+
| MView | Zoom Levels | Simplification (m) | Min Area (m²) | Function | Notes |
150+
|-------|-------------|-------------------|---------------|---------|-------|
151+
| `mv_transport_areas_z10_12` | 10-12 | 20 | 50,000 | create_areas_mview | |
152+
| `mv_transport_areas_z13_15` | 13_15 | 5 | 10,000 | create_areas_mview | |
153+
| `mv_transport_areas_z16_20` | 16-20 | 0 | - | create_areas_mview | |
154+
155+
# Transport - Centroids (transport_points_centroids)
156+
157+
| MView | Zoom Levels | Simplification (m) | Min Area (m²) | Function | Notes |
158+
|-------|-------------|-------------------|---------------|---------|-------|
159+
| `mv_transport_points_centroids_z10_12` | 10-12 | - | - | create_points_centroids_mview | |
160+
| `mv_transport_points_centroids_z13_15` | 13-15 | - | - | create_points_centroids_mview | |
161+
| `mv_transport_points_centroids_z16_20` | 16-20 | - | - | create_points_centroids_mview | Derived |
162+
163+
164+
# Transport - Lines (transport_lines)
165+
166+
| MView | Zoom Levels | Simplification (m) | Min Area (m²) | Function | Notes |
167+
|-------|-------------|-------------------|---------------|---------|-------|
168+
| `mv_transport_lines_z5` | 5 | 1000 | - | create_transport_lines_mview | |
169+
| `mv_transport_lines_z6_7` | 6-7 | 200 | - | create_transport_lines_mview | |
170+
| `mv_transport_lines_z8_9` | 8-9 | 100 | - | create_transport_lines_mview | |
171+
| `mv_transport_lines_z10_12` | 10-12 | 20 | - | create_transport_lines_mview | |
172+
| `mv_transport_lines_z13_15` | 13-15 | 5 | - | create_transport_lines_mview | |
173+
| `mv_transport_lines_z16_20` | 16-20 | 0 | - | create_transport_lines_mview | |
174+
175+
176+
177+
# Buildings - Areas (buildings_areas)
178+
179+
| MView | Zoom Levels | Simplification (m) | Min Area (m²) | Function | Notes |
180+
|-------|-------------|-------------------|---------------|---------|-------|
181+
| `mv_buildings_areas_z14_15` | 14-15 | 5 | 5,000 | create_areas_mview | Starts showing at zoom 14|
182+
| `mv_buildings_areas_z16_20` | 16-20 | 0 | - | create_areas_mview | |
183+
184+
185+
# Buildings - Centroids (buildings_points_centroids)
186+
187+
| MView | Zoom Levels | Simplification (m) | Min Area (m²) | Function | Notes |
188+
|-------|-------------|-------------------|---------------|---------|-------|
189+
| `mv_buildings_points_centroids_z14_15` | 14-15 | - | - | create_points_centroids_mview | Derived |
190+
| `mv_buildings_points_centroids_z16_20` | 16-20 | - | - | create_points_centroids_mview | Derived |
191+
192+
# Amenities - Areas (amenity_areas)
193+
194+
| MView | Zoom Levels | Simplification (m) | Min Area (m²) | Function | Notes |
195+
|-------|-------------|-------------------|---------------|---------|-------|
196+
| `mv_amenity_areas_z14_15` | 14-15 | 5 | 5,000 | create_areas_mview | Starts showing at zoom 14 |
197+
| `mv_amenity_areas_z16_20` | 16-20 | 0 | - | create_areas_mview | |
198+
199+
# Amenities - Centroids (amenity_points_centroids)
200+
201+
| MView | Zoom Levels | Simplification (m) | Min Area (m²) | Function | Notes |
202+
|-------|-------------|-------------------|---------------|---------|-------|
203+
| `mv_amenity_points_centroids_z14_15` | 14-15 | - | - | create_points_centroids_mview | Derived |
204+
| `mv_amenity_points_centroids_z16_20` | 16-20 | - | - | create_points_centroids_mview | Derived |
205+
206+
# Other - Areas (other_areas)
207+
208+
| MView | Zoom Levels | Simplification (m) | Min Area (m²) | Function | Notes |
209+
|-------|-------------|-------------------|---------------|---------|-------|
210+
| `mv_other_areas_z8_9` | 8-9 | 100 | 1,000,000 | create_areas_mview | |
211+
| `mv_other_areas_z10_12` | 10-12 | 20 | 50,000 | create_areas_mview | |
212+
| `mv_other_areas_z13_15` | 13-15 | 5 | 5,000 | create_areas_mview | |
213+
| `mv_other_areas_z16_20` | 16-20 | 0 | - | create_areas_mview | |
214+
215+
# Other - Centroids (other_points_centroids)
216+
217+
| MView | Zoom Levels | Simplification (m) | Min Area (m²) | Function | Notes |
218+
|-------|-------------|-------------------|---------------|---------|-------|
219+
| `mv_other_points_centroids_z8_9` | 8-9 | - | - | create_points_centroids_mview | Derived |
220+
| `mv_other_points_centroids_z10_12` | 10-12 | - | - | create_points_centroids_mview | Derived |
221+
| `mv_other_points_centroids_z13_15` | 13-15 | - | - | create_points_centroids_mview | Derived |
222+
| `mv_other_points_centroids_z16_20` | 16-20 | - | - | create_points_centroids_mview | Derived |
223+
224+
# Other - Lines (other_lines)
225+
226+
| MView | Zoom Levels | Simplification (m) | Min Area (m²) | Function | Notes |
227+
|-------|-------------|-------------------|---------------|---------|-------|
228+
| `mv_other_lines_z14_15` | 14-15 | 5 | - | create_mview_line_from_mview | Derived |
229+
| `mv_other_lines_z16_20` | 16-20 | 0 | - | create_lines_mview | Base view |
230+
231+
232+
# Places - Areas (place_areas)
233+
234+
TODO: fix according to schema
235+
236+
| MView | Zoom Levels | Simplification (m) | Min Area (m²) | Function | Notes |
237+
|-------|-------------|-------------------|---------------|---------|-------|
238+
| `mv_place_areas_z14_20` | 14-20 ⚠️ | - | - | create_place_areas_mview | Should be z14_15 + z16_20 |
239+
240+
# Places - Centroids (place_points_centroids)
241+
TODO: fix according to schema
242+
243+
244+
| MView | Zoom Levels | Simplification (m) | Min Area (m²) | Function | Notes |
245+
|-------|-------------|-------------------|---------------|---------|-------|
246+
| `mv_place_points_centroids_z0_2` | 0-2 | - | - | create_place_points_centroids_mview | |
247+
| `mv_place_points_centroids_z3_5` | 3-5 | - | - | create_place_points_centroids_mview | |
248+
| `mv_place_points_centroids_z6_10` | 6-10 ⚠️ | - | - | create_place_points_centroids_mview | Wide range |
249+
| `mv_place_points_centroids_z11_20` | 11-20 ⚠️ | - | - | create_place_points_centroids_mview | Very wide range |
250+
251+
### Routes - Lines (routes_indexed)
252+
253+
| MView | Zoom Levels | Simplification (m) | Min Area (m²) | Function | Notes |
254+
|-------|-------------|-------------------|---------------|---------|-------|
255+
| `mv_routes_indexed_z5` | 5 | 1000 | - | create_mv_routes_by_length | |
256+
| `mv_routes_indexed_z6_7` | 6-7 | 200 | - | create_mv_routes_by_length | |
257+
| `mv_routes_indexed_z8_9` | 8-9 | 100 | - | create_mv_routes_by_length | |
258+
| `mv_routes_indexed_z10_12` | 10-12 | 20 | - | create_mv_routes_by_length | |
259+
| `mv_routes_indexed_z13_15` | 13-15 | 5 | - | create_mv_routes_by_length | |
260+
| `mv_routes_indexed_z16_20` | 16-20 | 0 | - | create_mv_routes_by_length | |
261+

‎images/tiler-server/config/providers/admin_boundaries_lines.toml‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,7 @@ FROM
1818
WHERE
1919
geometry && !BBOX!
2020
"""
21+
2122
[[providers.layers]]
2223
name = "admin_boundaries_lines_z3_5"
2324
geometry_fieldname = "geometry"

‎images/tiler-server/config/providers/admin_boundaries_maritime.toml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ SELECT
1919
official_name,
2020
{{LENGUAGES}}
2121
FROM
22-
mv_admin_maritime_lines_z0_5
22+
mv_admin_maritime_lines_z0_5_v2
2323
WHERE
2424
geometry && !BBOX!
2525
"""

‎images/tiler-server/config/providers/other_lines.toml‎

Lines changed: 32 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
[[providers.layers]]
2-
name = "other_lines"
2+
name = "other_lines_z14_15"
33
geometry_fieldname = "geometry"
44
geometry_type = "linestring"
55
id_fieldname = "osm_id"
@@ -16,13 +16,42 @@ SELECT
1616
end_decdate,
1717
{{LENGUAGES}}
1818
FROM
19-
mv_other_lines_z14_20
19+
mv_other_lines_z14_15
20+
WHERE
21+
geometry && !BBOX!
22+
"""
23+
24+
[[providers.layers]]
25+
name = "other_lines_z16_20"
26+
geometry_fieldname = "geometry"
27+
geometry_type = "linestring"
28+
id_fieldname = "osm_id"
29+
sql = """
30+
SELECT
31+
ST_AsMVTGeom(geometry, !BBOX!) AS geometry,
32+
osm_id,
33+
name,
34+
class,
35+
type,
36+
start_date,
37+
end_date,
38+
start_decdate,
39+
end_decdate,
40+
{{LENGUAGES}}
41+
FROM
42+
mv_other_lines_z16_20
2043
WHERE
2144
geometry && !BBOX!
2245
"""
2346
#######Maps
2447
[[maps.layers]]
2548
name = "other_lines"
26-
provider_layer = "osm.other_lines"
49+
provider_layer = "osm.other_lines_z14_15"
2750
min_zoom = 14
51+
max_zoom = 15
52+
53+
[[maps.layers]]
54+
name = "other_lines"
55+
provider_layer = "osm.other_lines_z16_20"
56+
min_zoom = 16
2857
max_zoom = 20

0 commit comments

Comments
 (0)