datamodel.md

GeoJSON+ DataModel

Inhaltsverzeichnis

• Gazetteer GeoJSON
  • Gazetteer Ressource
  • Gazetteer Suche
• ChronOntology GeoJSON
• Names JSON
• Similarity JSON
  • Point Distance
  • String Distance

Gazetteer GeoJSON

Gazetteer Ressource

GeoJSON einer Gazetteer Ressource

Struktur

{
  "type": "Feature",
  "geometry": {},
  "properties": {
    "@id": "",
    "gazetteerid": "",
    "gazetteertype": "",
    "names": {}
  }
}

• type (DEFAULT) — [String] GeoJSON "Feature".
• geometry (DEFAULT) — [JSONObject] GeoJSON "geometry".
• properties (DEFAULT) — [JSONObject] GeoJSON "properties".
  • @id (DEFAULT) — [String] URI zur Gazetteer Ressource.
  • gazetteerid (DEFAULT) — [String] Gazetteer Ressource ID.
  • gazetteertype (DEFAULT) — [String] Gazetteer Typ: dai, getty, geonames, pleiades.
  • names (DEFAULT) — [JSONObject] siehe Names JSON.

Gazetteer Suche

GeoJSON einer Gazetteer Suche.

Struktur

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {},
      "properties": {
        "@id": "",
        "gazetteerid": "",
        "gazetteertype": "",
        "names": {},
        "similarity": {}
      }
    }
  ],
  "metadata": {
    "gazetteertype": "",
    "searchstring": "",
    "upperleftLon": "",
    "lowerleftLon": "",
    "lowerrightLat": "",
    "upperrightLon": "",
    "upperleftLat": "",
    "lowerleftLat": "",
    "lowerrightLon": "",
    "upperrightLat": ""
  }
}

• type (DEFAULT) — [String] GeoJSON "Feature".
• geometry (DEFAULT) — [JSONObject] GeoJSON "geometry".
• properties (DEFAULT) — [JSONObject] GeoJSON "properties".
  • @id (DEFAULT) — [String] URI zur Gazetteer Ressource.
  • gazetteerid (DEFAULT) — [String] Gazetteer Ressource ID.
  • gazetteertype (DEFAULT) — [String] Gazetteer Typ: dai, getty, geonames, pleiades.
  • names (DEFAULT) — [JSONObject] siehe Names JSON.
  • similarity (DEFAULT) — [JSONObject] siehe Similarity JSON.
• metadata (DEFAULT) — [JSONObject] Metadaten zur Suche.
  • gazetteertype (DEFAULT) — [String] Gazetteer Typ: dai, getty, geonames, pleiades.
  • searchstring (OPTIONAL) — [String] String für Suche.
  • upperleftLon, lowerleftLon, lowerrightLat, upperrightLon, upperleftLat, lowerleftLat, lowerrightLon, upperrightLat, (OPTIONAL) — [Double] BoundingBox Koordinaten.

ChronOntology GeoJSON

GeoJSON einer ChronOntology Ressource.

Struktur

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {},
      "properties": {
        "@id": "",
        "gazetteerid": "",
        "gazetteertype": "",
        "names": {},
        "gazetteerrelation": ""
      }
    }
  ],
  "metadata": {
    "@id": "",
    "periodid": "",
    "chronontology": {},
    "names": {},
    "when": [],
    "coverage": []
  }
}

• type (DEFAULT) — [String] GeoJSON "Feature".
• features (DEFAULT) — [JSONObject] GeoJSON "geometry".
  • type (DEFAULT) — [String] GeoJSON "Feature".
  • geometry (DEFAULT) — [JSONObject] GeoJSON "geometry".
  • properties (DEFAULT) — [JSONObject] GeoJSON "properties".
    • @id (DEFAULT) — [String] URI zur Gazetteer Ressource.
    • gazetteerid (DEFAULT) — [String] Gazetteer Ressource ID.
    • gazetteertype (DEFAULT) — [String] Gazetteer Typ: dai, getty, geonames, pleiades.
    • names (DEFAULT) — [JSONObject] siehe Names JSON.
    • gazetteerrelation (DEFAULT) — [String] ChronOntology Relation.
• metadata (DEFAULT) — [JSONObject] Metadaten.
  • @id (DEFAULT) — [String] URI zur ChronOntology Ressource.
  • periodid (DEFAULT) — [String] ChronOntology Ressource ID.
  • chronontology (DEFAULT) — [JSONObject] ChronOntology Object.
  • names (DEFAULT) — [JSONObject] ChronOntology Names Object.
  • when (DEFAULT) — [JSONArray] ChronOntology TimeSpan.
  • coverage (DEFAULT) — [JSONArray] Liste von Gazetteer Einträgen, welche die Periode abdecken.

Names JSON

JSONObject nach ChronOntology names object, erweitert um einen bevorzugten Namen, prefName.

{
  "prefName": {
    "name": "",
    "lang": ""
  },
  "language1": [],
  "language2": []
}

• prefName (DEFAULT) — [JSONObject] bevorzugter Name.
  • name (DEFAULT) — [String] Label des bevorzugten Namens.
  • lang (DEFAULT) — [String] Sprache des bevorzugten Namens.
• language (DEFAULT) — [JSONArray] Sprachvarianten.

Wenn die Sprache unbekannt ist, wird hierfür "unknown" verwendet.

Beispiel

{
  "prefName": {
    "name": "römisch",
    "lang": "de"
  },
  "de": ["Römisch", "römisch"],
  "en": ["greek", "Greek"]
}

Similarity JSON

Das Similarity JSON kann aus zwei verschiendenen Varianten bestehen. Beim Vergleich der Zeichenkette werden verschiedene Distanzen berechnet, bei einer Suche mit der Bounding Box die Distanz zum Zentrum der BBox.

Point Distance

{
	"distance": "",
	"bboxcenter": ["", ""],
	"point": ["", ""]
}

• distance (DEFAULT) — [Double] Errechnete Distanz in Kilometern zwischen bboxcenter und Point.
• bboxcenter (DEFAULT) — [JSONArray] lon, lat des Mittelpunkts der Bounding Box.
• point (DEFAULT) — [String] lon, lat eines Punktes in der Bounding Box.

Beispiel

{
	"distance": 1.36,
	"bboxcenter": [8.266449999999999, 49.993275999999994],
	"point": [8.2791, 49.98419]
}

String Distance

{
  "searchString": "",
  "gazetteerString": "",
  "levenshtein": "",
  "normalizedlevenshtein": "",
  "dameraulevenshtein": "",
  "jarowinkler": ""
}

• searchString (DEFAULT) — [String] String nach dem gesucht werden soll.
• gazetteerString (DEFAULT) — [String] Resultierender String aus dem Gazetteer Suchergebnis.
• levenshtein (DEFAULT) — [Double] Levenshtein Distanz.
• normalizedlevenshtein (DEFAULT) — [Double] Normalisierte Levenshtein Distanz.
• dameraulevenshtein (DEFAULT) — [Double] Damerau-Levenshtein Distanz.
• jarowinkler (DEFAULT) — [Double] Jaro-Winkler Distanz.

Beispiel

{
  "searchString": "Mainz",
  "gazetteerString": "Wiesbaden-Mainz-Kastel",
  "levenshtein": 17.0,
  "dameraulevenshtein": 17.0,
  "jarowinkler": 0.68,
  "normalizedlevenshtein": 0.77
}