api-example-apps

Example apps and starter

Small, focused demos for API exploration.

Each app is a standalone static page that shows one practical BTAA Geospatial API pattern, with a copyable template for new contributors.

Search + distance

Nearby Maps

Find map records around a latitude and longitude, rank them by client-side distance, and open the source or BTAA record.

Open app Map aggregate

Hexagons

Explore the API H3 aggregate layer on a Leaflet map, inspect record density, and open hexagon popups.

Open app Provider facets

Provider Bubbles

Map provider collection counts over campus locations, rank Geoportal holdings, and inspect resource-class facets.

Open app Keyword comparison

Search Fight

Compare two keyword searches by total records, year facets, and sample results from the live API.

Open app Metadata quality

Metadata Scorecard

Open one resource by ID, inspect its OGM metadata, and score field coverage from a CSV scoring matrix.

Open app Campus route

BTAA Road Trip

Travel east to west across BTAA campuses, then inspect live API map records in a pan-and-zoom display at each stop.

Open app Search + thumbnails

Map Memory

Choose a city, flip real historic map thumbnails, and find the matching pairs. Explore the library records behind your deck.

Open app Contributor starter

Example App Template

Copy a working search app with API status, error handling, result cards, and links ready to customize.

Open template

Facet pattern

Subject Picker

Planned demo for letting users start with a topic, then inspect the API filters behind the result set.

Planned

Project shape

One folder per app, one idea per app.

apps/nearby-maps/ apps/hexagons/ apps/provider-bubbles/ apps/search-fight/ apps/metadata-scorecard/ apps/btaa-road-trip/ apps/map-memory/ templates/example-app/