osmgl 0.16.0 → 0.18.0

package/README.md

@@ -423,6 +423,28 @@ new OsmGL.Map({ icons: { taxi: '<svg viewBox="0 0 24 24">…</svg>' } })
 Настоящего шейпинга нет: перо двигается по `advance`. Кириллице, латинице и таджикскому
 этого достаточно, арабский и иврит потребуют отдельного прохода.
 
+### Пороги подробности по зуму
+
+Чтобы телефон не захлёбывался на общем плане города, подробность включается ступенями
+(30.09.2026, одинаково в вебе, на Android и в iOS):
+
+| Зум | Дома | Дороги | Детальные 3D-объекты |
+|-----|------|--------|----------------------|
+| до 15 | нет | линии | нет |
+| 15–16 | плоские (`building-flat`, цвет крыши) | линии | нет |
+| с 16 | объём, растёт до полной высоты к 16.8 | асфальт (полотно), разметка с 16.5 | нет |
+| с 17 | объём | асфальт | есть |
+
+На z15 кадр захватывает вчетверо больше города, чем на z16, а стены с окнами, тени и асфальт
+на этом зуме не разглядеть. Плоский дом берёт цвет крыши объёмного слоя ссылкой
+`{ from: 'building', property: 'roofColor' }` (поле `property` у `ColorFrom`), поэтому его красят
+те же темы и на пороге z16 нет шва. Тайлы полотна на z15 больше не запрашиваются
+(`minzoom` источника 16). Ниже порога моделей маска замены снимается, и на месте модели стоит
+обычный дом.
+
+Тесселяцию зданий это не экономит: тайл z14 — потолок источника, и воркер собирает в нём здания
+на всех зумах выше. Экономится отрисовка: стены, окна, скругления и проход теней.
+
 ### Иерархия подписей мест
 
 Во всех пяти стилях места делятся по КЛАССУ, а не по рангу. Ранг в тайлах navigram — порядковый