Digital Atlas of the Roman Empire
All content on the Digital Atlas of the Roman Empire (DARE) is published under the Creative Commons Attribution-ShareAlike 3.0 (CC BY-SA 3.0) license. Data may be shared, adapted or used under the condition that a reference with link to http://imperium.ahlfeldt.se, or to the relevant page on DARE as the source, is provided. If you alter, transform, or build upon this work, you may distribute the resulting work only under the same or similar license to this one.
The API returns information about ancient places in GeoJSON format.
The base URL of the API is
http://imperium.ahlfeldt.se/api/geojson.php
The bbox and point methods return information about places including geometry, name, ancient name(s), country and feature type. The place-by-id method returns extended information about the place.
The GeoJSON API interface has Cross-origin Resource Sharing (CORS) enabled. Alternatively the API will return JSONP when a 'callback' parameter has been supplied.
| Parameters | Description |
| Places by Bounding Box Returns: coordinates, id, name, country, ancient name, type and precision | |
?bbox=‹bbox› | bounding box, expressed as lower left corner (lon1, lat1) and upper right corner (lon2, lat2), decimal degrees. Default -15,20,70,60 (entire area). Example: area around Rome, Italy ?bbox=10.44,40.78,14.53,42.98 |
&callback=‹callback› | Required for JSONP |
&zoom=‹zoomlevel› | Zoom level. More places are displayed on the map as the zoom level increases. At zoom 10, all placetypes are rendered. At zoom 6 (default) only cities and legionary fortresses are rendered, e.g. ?zoom=6 |
&typeid=‹typeid› | Optional Numerical placetype id: city (11), town (12), zoom is ignored, e.g. Roman villa (14), ?typeid=14. see the for a complete list of placetype identifiers. |
&layer=‹layer› | Optional Selection of places based on a collection of external identifiers, zoom is ignored, e.g. the Peutinger map, ?layer=TPPlace. Available layers are described |
&cc=‹countrycode› | Optional Modern country (ISO 3166), e.g. France ?cc=FR. |
&mss=‹string› | Optional UTF-8 encoded search string of modern placename, for instance, ?mss=court return all places containing the lemma court. Zoom parameter is ignored |
&ass=‹string› | Optional UTF-8 encoded search string of ancient placename, for instance, ?ass=briga return all places containing the Celtic lemma briga. Zoom parameter is ignored |
| Nearest place(s) by Point | |
?point=‹lon,lat› | Returns one or more places around the longitude/latitude point, ordered by distance from that point. |
&callback=‹callback› | Required for JSONP |
&count=‹count› | Optional Number of places to return. Default is one. |
&radius=‹radius› | Optional The radius of the area to search. Default is 0.2 degrees (both latitude and longitude) |
... | Other parameters, used by the bbox method described above, can also be used by the point method, i.e. zoom, typeid, layer, etc. |
| Single place by identifier | |
?id=‹id› | Return extended information about a place by DARE identifier, e.g. Rome ?id=1438 |
?pleiades=‹pleiadesid› | Alternate Single place by Pleiades identifier, id is ignored, e.g. Rome ?pleiades=423025 |
Important Note: A maximum of 500 places are returned using the bounding box method. Questions? Contact information below.
Printer friendly page/print.php
© Johan Åhlfeldt 2013