03 — For developers, researchers and institutions

Map API

Historical boundaries as data. Query the Phersu Atlas model for a collection of historical dates and render polities, capitals, cities and battles in your own maps, GIS tools and research pipelines.

Map API, Transparent style: historical polities draped over a physical background

Transparent style — historical polities at 60% opacity over a Natural Earth physical background.

One model, available through an API

Everything shown in Phersu Atlas, from the borders of around 8,000 polities across 5,500 years to their capitals, cities, battles, sieges and territorial changes, is derived from a single continuous historical model. The Map API makes that model available outside the atlas, allowing it to be integrated into web applications, GIS software, research workflows and digital publications.

What you get

  • Available dates — a collection of fixed dates, always 1 January: every century from 3400 BC to 1900 AD, then every year through the 20th and 21st centuries.
  • Geometries and tiles — polity boundaries and the historical coastline, ready to render in your own styles.
  • Objects — polities with their rulers and metadata, capitals, cities, battles and territorial changes.
  • Consistency — because every answer comes from the same model, maps of different dates can be compared without redrawing.

Who it is for

  • Developers building historical, educational or geopolitical applications.
  • Researchers who need reproducible historical boundaries for analysis and publication.
  • Institutions — museums, universities, publishers and cultural organisations integrating historical maps into their own platforms.

Access conditions, endpoints and examples are described in the documentation. For academic projects and institutional integrations, write to us.

Map styles

Four map styles, one URL each

Each style is a single URL. Three of them follow the historical dates of the model; the Physical style is date-independent.

Standard style: coloured historical polities on white land and blue ocean
StandardFull historical atlas: political boundaries, historical coastline, rivers, lakes and capitals on a clean white land / blue ocean base.
Transparent style: polities at 60% opacity over a physical map
TransparentHistorical polities at 60% opacity draped over a Natural Earth physical background — how geography shaped political history.
Coastline style: historical coastline, rivers and lakes only
CoastlineHistorical coastline, rivers and lakes only, no political data: a neutral geographic canvas for your own data layers.
Physical style: Natural Earth relief and bathymetry
PhysicalNatural Earth physical map only. Date-independent — today's terrain, rivers and ocean as a pure geographic basemap.