Pleiades Places API

Chunks of read-only data we use in various applications are available in JSON via HTTP. We're supporting Cross-Origin Resource Sharing but not JSONP.

Status

A count of places, locations, and names.

http://api.pleiades.stoa.org/status

Access Example

$ curl -v http://api.pleiades.stoa.org/status
> GET /api/status HTTP/1.1
> Host: pleiades.stoa.org
> Accept: */*
> 
< HTTP/1.1 200 OK
< Date: Fri, 27 Jan 2012 20:55:02 GMT
< Content-Type: application/json
< Cache-Control: max-age=900
< Access-Control-Allow-Origin: *
<
{"num_places": 34090, "num_locations": 35220, "num_names": 26644}

Data Items

num_places
The current number of published places (int)
num_locations
The current number of published locations (int)
num_names
The current number of published names (int)

Place

Data about a single ancient place represented as a GeoJSON feature collection.

URI template: http://pleiades.stoa.org/places/{pid}/json

Access Example

$ curl -v http://pleiades.stoa.org/places/423025/json | python -m json.tool
> GET /places/423025/json HTTP/1.1
> Host: pleiades.stoa.org
> Accept: */*
>
< HTTP/1.1 200 OK
< Date: Wed, 14 Mar 2012 18:40:17 GMT
< Content-Type: application/json
< Access-Control-Allow-Origin: *
< 
{
    "bbox": [
        12.486136999999999, 
        41.8917, 
        12.4862, 
        41.891775000000003
    ], 
    "connectsWith": [
        "423080"
    ], 
    "description": "The capital of the Roman Republic and Empire", 
    "features": [
        {
            "geometry": {
                "bbox": [
                    12.4862, 
                    41.8917, 
                    12.4862, 
                    41.8917
                ], 
                "coordinates": [
                    12.4862, 
                    41.8917
                ], 
                "type": "Point"
            }, 
            "id": "temple-of-vesta", 
            "properties": {
                "description": "", 
                "link": "http://pleiades.stoa.org/places/423025/temple-of-vesta", 
                "title": "Temple of Vesta"
            }, 
            "type": "Feature"
        }, 
        {
            "geometry": {
                "bbox": [
                    12.486136999999999, 
                    41.891775000000003, 
                    12.486136999999999, 
                    41.891775000000003
                ], 
                "coordinates": [
                    12.486136999999999, 
                    41.891775000000003
                ], 
                "type": "Point"
            }, 
            "id": "darmc-location-30635", 
            "properties": {
                "description": "", 
                "link": "http://pleiades.stoa.org/places/423025/darmc-location-30635", 
                "title": "DARMC location 30635"
            }, 
            "type": "Feature"
        }
    ], 
    "id": "423025", 
    "names": [
        "Roma", 
        "Rome"
    ], 
    "recent_changes": [
        {
            "modified": "2012-02-15T04:56:45Z", 
            "principal": "admin"
        }
    ], 
    "reprPoint": [
        12.486136999999999, 
        41.891775000000003
    ], 
    "title": "Roma", 
    "type": "FeatureCollection"
}

Data Items

id
The pid of this place (string)
connectsWith
The pid of every geographically connected place (list)
recent_changes
The timestamp and principal of the one or two most recent changes to this place's data (list)
features
Locations associated with this place, as in GeoJSON (list)
description
Brief description suitable for UI element label (string)
title
Not necessarily an ancient name (string)
reprPoint
A representative longitude (float), latitude (float) point (list)
bbox
Longitude and latitude bounds, [bottom, left, top, right] (list)
names
English transliterations of appellations for the place (list)