omeka / omeka/plugin-Geolocation

Fix broken basemaps and add Carto/Stadia API key support

Open
#81 0 comments 0 reactions 1 assignee View on GitHub

@jimsafley is already working on this.

Since Sep 3, 2026.

Dominant language
JavaScript
Stars
12
Forks
22
PR merge metrics
No merged PRs in 30d

Description

Half the basemaps we offer don't work:

  • All six Carto styles are watermarked without an API key, including Voyager, our default.
  • The six Stamen styles return 401 on any real domain.
  • Esri DeLorme is retired (404).

Because Voyager is the default, most existing sites are showing a watermarked map and probably don't know it. Fixing this means those sites will visibly change to OpenStreetMap, their setting is preserved, so adding a Carto key restores it.

The Stamen problem is easy to miss: those styles moved to Stadia hosting, and Stadia now requires an API key or a registered domain for anything but localhost. They render normally on localhost, so a developer testing locally sees nothing wrong.

Closes #76. Takes over part of #80.

What needs doing:

  • Change the default basemap to OpenStreetMap.
  • Remove Esri DeLorme and migrate sites using it.
  • Update leaflet-providers to v4.0.0, which adds Carto's API key support.
  • Add Carto and Stadia API key fields, alongside the existing Mapbox one.
  • Tell admins in the config form when their basemap needs a key, and substitute the default where we can do that safely.
  • Add a contrast suggestion to the Base Map setting (from #80).

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.