h1. Linked Places Format
%{color:red}Not up to date!%
h2. @context (required)
Contains the mappings for linked ontologies. We use the "Linked Places ":https://github.com/LinkedPasts/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"
h2. type (required)
The type of each output is "FeatureCollection", according to "GeoJSON-LD":http://geojson.org/geojson-ld/ , containing one or more Feature objects.
h2. feature[] (required)
Feature is a list, which can hold one or many feature objects. Each object can contain following elements:
h3. @id (required)
This is a unique and permanent URI pointing to the entity in the OpenAtlas instance.
"@id": "http://thanados.openatlas.eu/entity/50505"
h3. crmClass (required)
Show CIDOC CRM class code and name based on the "Erlangen CRM":http://erlangen-crm.org/documentation
"crmClass": "crm:E18_Physical_Thing"
h3. type (required)
The value for type is "feature" to state, that the object is a feature.
h3. 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"
}
h3. 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: [[form_field_dates|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"
}
}
]
}
h3. names[]
names is a list of [[form_field_alias|Aliases]].
"names":[
{
"alias":"Thunau Obere Holzwiese"
}
]
h3. types[]
Represents a list of one or more [[form_field_type|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":https://redmine.craws.net/projects/uni/wiki/Form_field_type#Value-types, 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"
}
]
h3. 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":https://tools.ietf.org/html/rfc7946#page-7.
*Geometries[]* is a list of none or more geometric objects. Each of these objects have the following keys:
* *Type* - Refers to the geometric types. OpenAtlas supports Point, Polygon and LineString
* *Title* - The given name of this geometric object
* *Description* - The given description of this geometric object
* *Coordinates[]* - Is a list of none or more lists with "positions":https://tools.ietf.org/html/rfc7946#section-3.1.1 of the object
"geometry":{
"geometries":[
{
"coordinates":[
21.53314304247,
41.528480700127
],
"title":"Ōrěhovь Dolь",
"type":"Point"
},
{
"coordinates":[
[
[
21.519985198975,
41.510119875951
],
[
21.547966003418,
41.509991329146
],
[
21.560153961182,
41.527471351458
],
[
21.546764373779,
41.546745312346
],
[
21.519470214844,
41.546231414598
],
[
21.506080627441,
41.528113909357
],
[
21.519985198975,
41.510119875951
]
]
],
"description":"A model of the village's boundaries.",
"title":"Ōrěhovь Dolь",
"type":"Polygon"
}
],
"type":"GeometryCollection"
}
h3. 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"
}
]
h3. 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 and concept|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"
}
]
h3. descriptions[]
Contains the [[form_field_description|description]] of the entity.
"description":[
{
"value":"In the area of Obere Holzwiese 215 inhumation burials were documented in different excavations[..]"
}
]
h3. depictions[]
Is a list of all linked depictions or files. *@id* links directly to the [[form_field_file|file]], *title* represents the given name and *license* contains the given license of the [[form_field_file|file]].
"depictions":[
{
"@id":"http://oa-dev.koschigel.de/api/0.1/entity/117992",
"license":"CC BY-SA 4.0",
"title":"oberleiserberg_map"
}
]
h1. 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"
}
]
}
]
}