Install

Works with Drupal: ^11.2

Using Composer to manage Drupal site dependencies

Alternative installation files

Download tar.gz 323.86 KB
MD5: fe016cf7c94f81938c7dd9823c675cb4
SHA-1: 7ebaeba235fa038f402a062ddbc442e9b5ed992f
SHA-256: a7d06cf21e5ecf84565c0dd8f11c737743eea2a3805a1549164d224a63fc15de
Download zip 434.61 KB
MD5: dd4e25f9d4930493db90f1eddfdd36f5
SHA-1: bf77ed38a5dbcf68d5e64e18c874b947cf2acca0
SHA-256: ccc9f46406726c086c9e3354bc775d62532c2634535a993e463df1ced09104c2

Release notes

First public release of Maper: every map at its best zoom, plus the surrounding area, drawn on the server from vector tiles the site holds.

What is in it

  • The core module: map types, map styles (light, dark, pearl), the Maper map block, the Maper locator field formatter, the Maper map Views style, place cards, "Open with" buttons, the zoom slider, and the JSON payload (schema 1) with its frame endpoint.
  • Maper: OpenFreeMap: fetches OpenMapTiles vector tiles once each, into private storage, behind a gate (contact required, budgets per job and per day, back-off, per-reader flood control).
  • Maper: Protomaps: reads a PMTiles extract in place; fetches nothing.
  • Maper: Nominatim (experimental): places nodes without coordinates. It ships switched off, with no instance set, and follows the public instance's usage policy.

Before you install

  • Drupal 11.2+, PHP 8.3 (64-bit) with zlib, a private file system path.
  • Vue 3.5.43 in /libraries/vue (composer require npm-asset/vue:3.5.43 via asset-packagist). Without it, the skin loads the same release from jsDelivr, checked against its hash, and the status report warns.
  • Fetching is off by default. Set a contact on the Settings tab before turning cached live fetch on.

Upgrading

Alphas carry no upgrade path. Uninstall maper and its submodules, update, and install again. Settings, map types and map styles are reset. Held tiles stay in private://maper/, so nothing is fetched twice.

Known gaps, planned before beta

  • The admin area is being regrouped into seven tabs, with tile deletion and a manual refetch of old tiles added to the Tile cache tab.
  • More clean-install, no-JavaScript and accessibility coverage, and phpstan level 6.
  • A held tile is kept until someone deletes it: tiles never expire by themselves, by design.

Credits

Map data © OpenStreetMap contributors (ODbL). Tiles from OpenFreeMap or Protomaps.

Created by: oneliner
Created on: 13 Oct 2026 at 00:33 UTC
Last updated: 13 Oct 2026 at 00:33 UTC
New features

Other releases