Zarafshan City Map
Зарафшан дом за домом — в 3D.
Простыми словами
- Что это
- Объёмная карта города Зарафшан: микрорайоны, дома с этажами и подъездами, улицы — и прогулка по городу «своими глазами».
- Для кого
- Сделана по заказу для команды, которая работает с жилым фондом города. Часть карты открыта для всех.
- Что это даёт
- Можно найти дом по адресу, узнать, что рядом, и проложить пешеходный маршрут. Команда заказчика правит данные в панели, а служебная информация посторонним не видна.
Карта города Зарафшан — 3D-карта с границами микрорайонов, домами с этажами и подъездами, объектами OpenStreetMap и собственными точками. Гости могут искать по адресу, определять своё местоположение, строить пешеходный маршрут и смотреть, что находится рядом; на отдельной странице город отрисован в полноценном 3D — с тенями, текстурами фасадов и деревьями.
Бизнес-контекст
Клиенту нужна была рабочая карта жилого фонда Зарафшана — микрорайоны, дома, подъезды и собственные показатели — на открытых данных, причём коммерческие поля скрыты от случайных посетителей.
Проблема
Данные о городе — дома, подъезды, махалли, предприятия — хранятся в бумажных паспортах, таблицах и в головах людей, а обычные карты не показывают того, что нужно местной команде.
Решение
Карта на MapLibre GL и React, 3D-прогулка на three.js и панель редактирования на PHP поверх базы данных MySQL. Команда сама редактирует дома, здания, места и показатели; изменения сразу появляются на карте, а каждая правка записывается в журнал.
Что я сделал
Сделал в одиночку для клиента — обработка данных, карта, 3D-город, панель редактирования и API.
Архитектура
- Публичная гостевая карта и рабочий режим после входа на одной странице; закрытые поля никогда не уходят с сервера к гостям
- Два рендерера на одних данных: MapLibre GL для карты и отдельная сцена three.js для 3D-города
Backend
- PHP API v1 только для чтения: метаданные, слои в GeoJSON, дома с постраничной выдачей, районы, махалли, поиск по адресу, «что рядом»
- Панель редактирования: дома, здания, фото, места, показатели и журнал изменений с «до/после» и отменой
- Скрипты импорта: OpenStreetMap через Overpass, база домов клиента, подъезды, махалли, дороги
Frontend и приложения
- Карта на MapLibre GL: слои, картограмма по показателю, собственные точки и заметки, прогулка по улицам от первого лица
- Город на three.js: 1 133 здания, 918 дорог реальной ширины, тени, текстуры фасадов, дневное и вечернее освещение
База данных
- MySQL; 487 из 562 записей о домах сопоставлены с контурами зданий, 1 370 подъездов размещены вдоль фасадов
- 37 домов, разбитых на несколько полигонов OSM, снова объединены в одно здание
Безопасность
- Гости не видят показателей, заметок и служебных полей
- API: открытые эндпоинты без ключа, городские данные — только с ключом, выданным в панели
- Конфиденциальная выписка из кадастра никогда не присоединяется к публичному API — это проверяет тест
Выпуск и эксплуатация
- Изменения из панели видны при следующей загрузке страницы — без пересборки и повторного деплоя
Технические решения и компромиссы
- Данные клиента важнее OSM — Где база домов клиента расходится с OpenStreetMap — этажность, номера домов, — используются данные клиента: они собраны на месте. (Компромисс: Исправления остаются в базе клиента; сам OSM станет лучше, только если их туда передать.)
- Второй рендерер вместо борьбы с первым — MapLibre не умеет отбрасывать тени и накладывать текстуры фасадов в метрах, поэтому реалистичный город — отдельная страница на three.js, построенная на тех же данных. (Компромисс: Нужно поддерживать два рендерера.)
- Приватность через отсутствие связи — Публичный API вообще не связан с выпиской из кадастра с персональными данными, а не просто скрывает список полей; это проверяет тест. (Компромисс: Публичные пользователи получают только сводку по дому.)
- Только легальные источники данных — Данные Yandex Maps и 2GIS не использовались — их условия запрещают извлечение; геоданные взяты из OpenStreetMap по ODbL. (Компромисс: Меньше готовых мест; пробелы клиент заполняет в панели.)
Основные модули
- 3D-карта с границами микрорайонов
- Дома: этажи, подъезды, квартиры, махалля
- Объекты OpenStreetMap
- Поиск по адресу, «где я», пешеходные маршруты, места рядом
- Хороплет по собственным показателям
- Собственные точки и заметки
- Прогулка по улицам от первого лица
- Настоящая 3D-страница: тени, текстуры фасадов, деревья
- Панель редактирования: дома, здания, фото, места, показатели
- Журнал изменений
- RU · UZ
Результаты
- 1 133 здания и 918 дорог в 3D-городе
- 487 записей о домах сопоставлены с контурами, размещено 1 370 подъездов
- Геоданные из выгрузки OpenStreetMap от 26 сентября 2026 года
c1.orax1.vip
Boburbek