Linked Places Format

Not up to date!

@context (required)

Contains the mappings for linked ontologies. We use the Linked Places mappings found in http://linkedpasts.org/assets/linkedplaces-context-v1.jsonld

e.g. "@context": "https://raw.githubusercontent.com/LinkedPasts/linked-places/master/linkedplaces-context-v1.jsonld"

type (required)

The type of each output is "FeatureCollection", according to GeoJSON-LD , containing one or more Feature objects.

feature[] (required)

Feature is a list, which can hold one or many feature objects. Each object can contain following elements:

@id (required)

This is a unique and permanent URI pointing to the entity in the OpenAtlas instance.

"@id": "http://thanados.openatlas.eu/entity/50505" 

crmClass (required)

Show CIDOC CRM class code and name based on the Erlangen CRM

"crmClass": "crm:E18_Physical_Thing" 

type (required)

The value for type is "feature" to state, that the object is a feature.

properties{} (required)

The property element holds one key:value pair, because of the GeoJSON requirement. The key is title, which is the preferred name label of the entity. In the OA form it is called Form field name.

         "properties":{
            "title":"Gars Thunau Obere Holzwiese" 
         }

when{}

When is the temporally scope of the represented feature. OpenAtlas only supports dates in the YYYY-MM-DD format, so no periods or extensions for approximate and uncertain (for more details: Date).
Each "when" contains one timespans[] . A timespan can contain start{} and/or end{}. start{} or end{} hold timestamp values and the comments for the dates.

         "when":{
            "timespans":[
               {
                  "end":{
                     "earliest":"0950-01-01",
                     "latest":"0950-12-31" 
                  },
                  "start":{
                     "earliest":"0750-01-01",
                     "latest":"0750-12-31" 
                  }
               }
            ]
         }

names[]

names is a list of Aliases.

         "names":[
            {
               "alias":"Thunau Obere Holzwiese" 
            }
         ]

types[]

Represents a list of one or more types objects (nodes) for this feature. Identifier refers to the type entity of the type and label is the given name of the type. Hierarchy lists the super types in a string for the THANATOS front end. If the type is a value type, the unit and value is also shown.

         "types":[
            {
               "hierarchy":"Evidence > Archaeology",
               "identifier":"http://thanados.openatlas.eu/api/0.1/entity/5099",
               "label":"Excavation" 
            },
            {
               "hierarchy":"Dimensions",
               "identifier":"http://thanados.openatlas.eu/api/0.1/entity/26189",
               "label":"Length",
               "unit":"cm",
               "value":"200" 
            }
         ]

geometry{} (required)

A GeoJSON FeatureCollection must have one or more geometry elements to be valid. Therefore each entity, even if it has no geometric references has this entry:

         "geometry":{
            "geometries":[ ],
            "type":"GeometryCollection" 
         }

Type refers to geometric types according to RFC 7946 - The GeoJSON Format.

Geometries[] is a list of none or more geometric objects. Each of these objects have the following keys:

links[]

These are the links to other gazetteers. At the moment OpenAtlas support GeoNames, as described in Place.

         "links":[
            {
               "identifier":"http://www.geonames.org/2763660",
               "type":"closeMatch" 
            }
         ]

relations[]

Is a list of one or more entities, which are linked through the CRM to this feature. Label represents the name of the entity, relationTo contains the direct link to this entity and relationType shows the property code from the model with which the entities are linked.

"relations":[
            {
               "label":"Cenotaph_A",
               "relationTo":"http://oa-dev.koschigel.de/api/0.1/entity/57167",
               "relationType":"crm:P46_is_composed_of" 
            },
            {
               "label":"Excavation",
               "relationTo":"http://oa-dev.koschigel.de/api/0.1/entity/5099",
               "relationType":"crm:P2_has_type" 
            }
]

descriptions[]

Contains the description of the entity.

         "description":[
            {
               "value":"In the area of Obere Holzwiese 215 inhumation burials were documented in different excavations[..]" 
            }
         ]

depictions[]

Is a list of all linked depictions or files. @id links directly to the file, title represents the given name and license contains the given license of the file.

         "depictions":[
            {
               "@id":"http://oa-dev.koschigel.de/api/0.1/entity/117992",
               "license":"CC BY-SA 4.0",
               "title":"oberleiserberg_map" 
            }
         ]

Full Example

{
   "@context":"https://raw.githubusercontent.com/LinkedPasts/linked-places/master/linkedplaces-context-v1.1.jsonld",
   "type":"FeatureCollection",
   "features":[
      {
         "@id":"http://127.0.0.1:5000/entity/50505",
         "type":"Feature",
         "crmClass":"crm:E18 Physical Thing",
         "systemClass":"place",
         "properties":{
            "title":"Thunau Obere Holzwiese" 
         },
         "description":[
            {
               "value":"In the area of Obere Holzwiese 215 inhumation burials were documented in different excavations. The cemetery ranges from the (later) 8th c. to the (early) 10th c.\r\n##German\r\n215 Bestattungen wurden im Bereich der Oberen Holzwiese dokumentiert; im NW-Areal wird eine Holzkirche vermutet, die wohl bereits in der ersten Hälfte des 9. Jahrhunderts vorhanden war." 
            }
         ],
         "when":{
            "timespans":[
               {
                  "start":{
                     "earliest":"0750-01-01",
                     "latest":"0750-12-31" 
                  },
                  "end":{
                     "earliest":"0950-01-01",
                     "latest":"0950-12-31" 
                  }
               }
            ]
         },
         "types":[
            {
               "identifier":"http://127.0.0.1:5000/api/0.2/entity/22378",
               "label":"Inhumation Cemetery",
               "description":null,
               "hierarchy":"Place > Burial Site > Cemetery",
               "value":null,
               "unit":null
            },
            {
               "identifier":"http://127.0.0.1:5000/api/0.2/entity/5099",
               "label":"Excavation",
               "description":null,
               "hierarchy":"Evidence > Archaeology",
               "value":null,
               "unit":null
            }
         ],
         "relations":[
            {
               "label":"Cenotaph_A",
               "relationTo":"http://127.0.0.1:5000/api/0.2/entity/57167",
               "relationType":"crm:P46 is composed of",
               "relationSystemClass":"feature",
               "relationDescription":null,
               "type":null,
               "when":{
                  "timespans":[
                     {
                        "start":{
                           "earliest":"0750-01-01",
                           "latest":"0750-01-01" 
                        },
                        "end":{
                           "earliest":"0950-12-31",
                           "latest":"0950-12-31" 
                        }
                     }
                  ]
               }
            },
            {
               "label":"Excavation",
               "relationTo":"http://127.0.0.1:5000/api/0.2/entity/5099",
               "relationType":"crm:P2 has type",
               "relationSystemClass":"type",
               "relationDescription":null,
               "type":null,
               "when":{
                  "timespans":[
                     {
                        "start":{
                           "earliest":"None",
                           "latest":"None" 
                        },
                        "end":{
                           "earliest":"None",
                           "latest":"None" 
                        }
                     }
                  ]
               }
            },
            {
               "label":"Inhumation Cemetery",
               "relationTo":"http://127.0.0.1:5000/api/0.2/entity/22378",
               "relationType":"crm:P2 has type",
               "relationSystemClass":"type",
               "relationDescription":null,
               "type":null,
               "when":{
                  "timespans":[
                     {
                        "start":{
                           "earliest":"None",
                           "latest":"None" 
                        },
                        "end":{
                           "earliest":"None",
                           "latest":"None" 
                        }
                     }
                  ]
               }
            },
            {
               "label":"Location of Thunau Obere Holzwiese",
               "relationTo":"http://127.0.0.1:5000/api/0.2/entity/50510",
               "relationType":"crm:P53 has former or current location",
               "relationSystemClass":"object_location",
               "relationDescription":null,
               "type":null,
               "when":{
                  "timespans":[
                     {
                        "start":{
                           "earliest":"None",
                           "latest":"None" 
                        },
                        "end":{
                           "earliest":"None",
                           "latest":"None" 
                        }
                     }
                  ]
               }
            },
            {
               "label":"Obere Holzwiese",
               "relationTo":"http://127.0.0.1:5000/api/0.2/entity/179483",
               "relationType":"crm:P1 is identified by",
               "relationSystemClass":"appellation",
               "relationDescription":null,
               "type":null,
               "when":{
                  "timespans":[
                     {
                        "start":{
                           "earliest":"None",
                           "latest":"None" 
                        },
                        "end":{
                           "earliest":"None",
                           "latest":"None" 
                        }
                     }
                  ]
               }
            },
            {
               "label":"GeoNames",
               "relationTo":"http://127.0.0.1:5000/api/0.2/entity/155980",
               "relationType":"crm:P67i is referred to by",
               "relationSystemClass":"reference_system",
               "relationDescription":"2763660",
               "type":"closeMatch",
               "when":{
                  "timespans":[
                     {
                        "start":{
                           "earliest":"None",
                           "latest":"None" 
                        },
                        "end":{
                           "earliest":"None",
                           "latest":"None" 
                        }
                     }
                  ]
               }
            },
            {
               "label":"http://austriaca.at/8066-1inhalt?frames=yes",
               "relationTo":"http://127.0.0.1:5000/api/0.2/entity/116288",
               "relationType":"crm:P67i is referred to by",
               "relationSystemClass":"external_reference",
               "relationDescription":"Website EPub",
               "type":null,
               "when":{
                  "timespans":[
                     {
                        "start":{
                           "earliest":"None",
                           "latest":"None" 
                        },
                        "end":{
                           "earliest":"None",
                           "latest":"None" 
                        }
                     }
                  ]
               }
            },
            {
               "label":"https://doi.org/10.2307/j.ctv8xnfjn",
               "relationTo":"http://127.0.0.1:5000/api/0.2/entity/116289",
               "relationType":"crm:P67i is referred to by",
               "relationSystemClass":"external_reference",
               "relationDescription":"Nowotny 2018 EPub",
               "type":null,
               "when":{
                  "timespans":[
                     {
                        "start":{
                           "earliest":"None",
                           "latest":"None" 
                        },
                        "end":{
                           "earliest":"None",
                           "latest":"None" 
                        }
                     }
                  ]
               }
            },
            {
               "label":"thunau_modified",
               "relationTo":"http://127.0.0.1:5000/api/0.2/entity/112760",
               "relationType":"crm:P67i is referred to by",
               "relationSystemClass":"file",
               "relationDescription":null,
               "type":null,
               "when":{
                  "timespans":[
                     {
                        "start":{
                           "earliest":"None",
                           "latest":"None" 
                        },
                        "end":{
                           "earliest":"None",
                           "latest":"None" 
                        }
                     }
                  ]
               }
            }
         ],
         "names":[
            {
               "alias":"Obere Holzwiese" 
            }
         ],
         "links":[
            {
               "type":"closeMatch",
               "identifier":"https://www.geonames.org/2763660",
               "referenceSystem":"GeoNames" 
            }
         ],
         "geometry":{
            "type":"Point",
            "coordinates":[
               15.6432715260176,
               48.5867361212989
            ],
            "title":"",
            "description":"" 
         },
         "depictions":[
            {
               "@id":"http://127.0.0.1:5000/api/0.2/entity/112760",
               "title":"thunau_modified",
               "license":"Bildzitat",
               "url":"N/A" 
            }
         ]
      }
   ]
}