OpenIndexMaps Compatibility Spike

[srappel]

GeoDiscovery is mostly OpenIndexMap-compatible at the record and viewer level, but not fully compatible with OpenIndexMaps v1 feature popups/downloads.

What Works

• The app uses GeoBlacklight ~> 4.5, which defines https://openindexmaps.org as the index map reference key. See Gemfile.
• Item viewer preference includes index maps, so records with that reference should render as index maps.
• The Allmaps tabbed viewer preserves GeoBlacklight's index map viewer and legend.
• config/settings.yml includes index map styling and controls.
• Harvest/classification code detects OpenIndexMaps and normalizes records toward Maps / Index maps.

Main Gap

GeoBlacklight 4.5's popup template displays older fields like:

• websiteUrl
• downloadUrl
• iiifUrl
• recordIdentifier
• recId
• label
• note

It does not display several OpenIndexMaps v1 fields that UWM records use, including:

• digHold
• physHold
• datePub
• dateSurvey
• publisher
• scale

This means the map should render, but sheet-level access information may be hidden or incomplete in the popup/download panel.

Metadata Risk

Some UWM fixtures with OpenIndexMap references still identify as:

• gbl_resourceClass_sm: ["Datasets"]
• gbl_resourceType_sm: ["Polygon data"]

The normalizer should fix harvested records, but static fixtures and currently indexed data may need reindexing or metadata cleanup.

Evidence

• Gemfile includes gem "geoblacklight", "~> 4.5".
• GeoBlacklight constants map index_map to https://openindexmaps.org.
• GeoBlacklight item viewer preference includes index_map.
• config/settings.yml includes LEAFLET.LAYERS.INDEX and LEAFLET.VIEWERS.INDEXMAP.
• lib/opendataharvest/src/opendataharvest/normalize.py detects OpenIndexMaps references and adjusts class/type.
• lib/opendataharvest/src/opendataharvest/classify.py classifies OpenIndexMaps records as Maps / Index maps.
• UWM fixture records such as test/fixtures/files/uwm_documents/c413_2bA100000_BL_Aardvark.json reference https://openindexmaps.org.
• Live UWM OpenIndexMap files use v1-style properties such as available, digHold, datePub, and recId.

Recommended Next Step

Add a local override for GeoBlacklight's index_map_info.hbs and index_map_download.hbs templates to display v1 digHold and physHold, then add one system test using an existing UWM index map fixture.

Sources

• GeoBlacklight Index Maps docs: https://geoblacklight.org/docs/index_maps/
• OpenIndexMaps overview: https://openindexmaps.org/
• OpenIndexMaps 1.0.0 specification: https://openindexmaps.org/specification/1.0.0.html
• UWM OpenIndexMap example: https://github.com/OpenIndexMaps/edu.uwm/blob/main/413_2bA100000.geojson