Protomaps: как раздавать свои карты через PMTiles и Bunny.net, хранение мира около $5 в месяц
Автор блога по имени Bruce, студент-информатик ETH Zurich, рассказывает, как самостоятельно раздавать тайлы карт (фрагменты карты, из которых собирается изображение) вместо платных коммерческих API. Поводом стал его проект Mapboard: при подготовке к нему он наткнулся на Protomaps. Его довод: для некоммерческих проектов коммерческие API становятся непомерно дорогими, если сайт вдруг станет популярным. Например, Mapbox берёт $5 за 1000 загрузок карты после исчерпания бесплатного лимита (размер лимита в тексте не указан).
Основа подхода, формат PMTiles из экосистемы Protomaps. Это один файл с тайлами, к которому обращаются через HTTP Range-запросы (запросы части файла), поэтому его можно просто положить в хранилище. Если CDN умеет кешировать Range-запросы к большим файлам, ничего, кроме скачивания и загрузки файла, делать не нужно. Для остальных, например Cloudflare, автор предлагает периферийную функцию (edge function), которая переводит привычные пути вида x/y/z в Range-запросы. Карту мира можно взять на странице сборок как ежедневную сборку; а с помощью консольной утилиты можно вырезать только нужный прямоугольник координат или отдельные уровни масштаба и получить файл заметно меньше.
В качестве CDN автор рекомендует Bunny.net (ссылка в тексте партнёрская). Сервис поддерживает Range-запросы, по умолчанию не собирает персональные данные, зарегистрирован в ЕС и недорого даёт доступ к глобальной сети CDN и периферийных хранилищ. Цены зависят от региона и степени репликации: обычно $0,01 за ГБ трафика в Европу и Северную Америку ($0,005 за ГБ в меньшей сети Volume) и от $0,01 до $0,055 за ГБ в месяц за хранение, от варианта без репликации до максимальной. Высокая репликация в основном влияет на задержку при промахе кеша.
Расчёт автора: хранение карты мира размером 139 ГБ с репликацией на большинство континентов (в 5 раз) обойдётся примерно в $5 в месяц. Загрузка карты Европы на ноутбуке с приближением до города передаёт около 5 МБ, что стоит $0,00005; повторные переходы и перезагрузки дешевле, так как карта кешируется на устройстве. При $0,05 за 1000 загрузок это может быть в 100 раз дешевле Mapbox. Автор оговаривается: трафик меняется, меньше у тех, кто сразу уходит, и возможно десятки мегабайт у активных пользователей; Mapbox же берёт фиксированную плату за визит.
Практические шаги. Файл лучше заливать в зону хранения с включённой S3-совместимостью: загрузка через HTTP API у автора оборвалась по тайм-ауту через 15 минут. Затем с помощью rclone настраивается подключение к Bunny и командой copyurl файл копируется напрямую из адреса сборки в хранилище (размер S3-фрагмента 256 МБ); при плохом соединении лучше делать это в tmux или с временного VPS. После создания pull zone (зоны раздачи) с зоной хранения в качестве источника автор советует: задать список разрешённых рефереров, чтобы чужие сайты не встраивали ваши тайлы; проверить, что включена опция «Optimize for large object delivery» (она позволяет кешировать Range-запросы); и защититься от массового скачивания всего файла, по его опыту, самый практичный способ это снижение скорости до 10 КБ/с после 10 МБ в одном запросе. Обычное использование до этого порога не доходит. Дополнительно можно ввести лимит запросов в секунду (учитывая, что и нормальная нагрузка иногда даёт большие значения) или месячный лимит трафика для зоны.
В конце, встраивание на сайт, например через MapLibre GL: нужно установить npm-пакет pmtiles и добавить в MapLibre протокол и стиль по официальной инструкции.
Ключевые факты
- PMTiles (часть экосистемы Protomaps), формат с тайлами карты в одном файле, доступном через HTTP Range-запросы; его можно положить в обычное хранилище.
- По оценке автора, хранение карты мира (139 ГБ) на Bunny.net с репликацией в 5 раз стоит около $5 в месяц; трафик, от $0,005 до $0,01 за ГБ в Европу и Северную Америку.
- Типичная загрузка карты Европы с приближением до города, около 5 МБ, то есть $0,00005; при $0,05 за 1000 загрузок это может быть в 100 раз дешевле Mapbox ($5 за 1000 загрузок после бесплатного лимита).
- Для загрузки файла автор советует S3-совместимую зону хранения и rclone; для защиты от массового скачивания, снижение скорости до 10 КБ/с после 10 МБ в одном запросе.
- На сайт карту можно встроить через MapLibre GL и npm-пакет pmtiles.
Почему это важно
Карты на сайт обычно подключают через коммерческие API с оплатой за каждую загрузку, и при внезапной популярности счёт может резко вырасти. Автор показывает альтернативу: один файл в хранилище и обычный CDN, где платишь за фактически переданный трафик и место. По его расчёту, при типичной нагрузке это может быть примерно в 100 раз дешевле Mapbox. Важно, что это именно оценка автора («could be»), а не измеренный результат.
Кому это важно
Разработчикам небольших и некоммерческих проектов, которым нужна карта на сайте или в приложении и которые боятся непредсказуемых счетов за API. Также тем, кому важна раздача из ЕС и отсутствие сбора персональных данных по умолчанию: автор отмечает это как свойства Bunny.net.
Как это применить
Порядок по тексту: скачать карту мира (ежедневная сборка) или вырезать нужную область или уровни масштаба консольной утилитой; создать в Bunny.net зону хранения с S3-совместимостью; настроить rclone и скопировать файл командой copyurl с размером фрагмента 256 МБ; создать pull zone с этой зоной хранения как источником; задать список разрешённых рефереров; убедиться, что включена опция «Optimize for large object delivery»; задать лимит скорости (10 КБ/с после 10 МБ в запросе) и при желании лимиты запросов или месячного трафика; подключить карту через MapLibre GL с пакетом pmtiles. Если CDN не кеширует Range-запросы к большим файлам (пример автора, Cloudflare), нужна периферийная функция, переводящая пути x/y/z в Range-запросы. Тарифы указаны по данным автора: $0,01 за ГБ трафика ($0,005 в сети Volume) и от $0,01 до $0,055 за ГБ в месяц за хранение.
Можно ли доверять
Это личный блог студента, а не измерение на боевом сайте: расчёты автора относятся к типичной загрузке (около 5 МБ), данных о задержках, доле попаданий в кеш и реальном трафике нет. Сравнение с Mapbox оговорено автором как «может быть в 100 раз дешевле», размер бесплатного лимита Mapbox не приведён. Ссылка на Bunny.net партнёрская, о чём автор прямо сообщает; сравнения с другими CDN в тексте нет. Арифметика внутри текста сходится: 5 МБ при $0,01 за ГБ, $0,00005, то есть $0,05 за 1000 загрузок.
Риски и подводные камни
Расходы зависят от реального трафика: у активных пользователей он может достигать десятков мегабайт на сессию, а Mapbox берёт фиксированную плату за визит. Есть риск массового скачивания всего файла, для этого автор предлагает лимит скорости после 10 МБ в одном запросе, а также возможные лимиты запросов в секунду (нормальная нагрузка тоже может давать большие значения) и месячный лимит трафика. Загрузка через HTTP API у автора оборвалась по тайм-ауту через 15 минут, поэтому нужна S3-совместимая зона и, при слабом соединении, tmux или временный VPS. На CDN без кеширования Range-запросов потребуется дополнительная периферийная функция.