GeoJSON und JSON

Um eine Kartenvisualisierung in Polyteia zu verwenden, müssen Ihre Daten geografische Formen enthalten. Diese werden in einem Format namens GeoJSON beschrieben, einer geografischen Version von JSON.

Andere geografische Formdatentypen wie Shape-Dateien werden in zukünftigen Versionen folgen.

Was ist JSON

JSON (JavaScript Object Notation) ist ein gängiges Format zum Speichern und Austauschen von Daten zwischen Systemen. Es besteht aus Schlüssel-Wert-Paaren und kann Zahlen, Text, Listen und verschachtelte Strukturen enthalten.

Hier ist ein einfaches Beispiel:

[
  {
    "city": "Berlin",
    "population": 3769000,
    "isCapital": true,
    "longitude": 13.4050,
    "latitude": 52.5200
  },
  {
    "city": "Hamburg",
    "population": 1841000,
    "isCapital": false,
    "longitude": 9.9937,
    "latitude": 53.5511
  }
]

Dies ist ein einfaches JSON-Array mit strukturierten Daten zu Städten. Jedes Element im Array ist ein JSON-Objekt mit fünf Feldern:

• "city": der Name der Stadt (Text);

• "population": die Anzahl der Einwohner (Zahl);

• "isCapital": ob die Stadt eine Hauptstadt ist (true/false);

• "longitude" und "latitude": Längen- und Breitengrad der Stadt in separaten Eigenschaften (Zahl).

Wie die Tabelle nach dem Hochladen aussehen würde

city	population	isCapital	longitude	latitude
Berlin	3,769,000	true	13.4050	52.5200
Hamburg	1,841,000	false	9.9937	53.5511

Dies sind strukturierte Daten, die geografische Informationen enthalten - aber noch nicht in einem Format welches die Polyteia Plattform als Geometrie erkennen kann.

Um die Daten in einer Kartenvisualisierung zu verwenden, müssen die Koordinaten vor dem Hochladen in ein korrektes Geometrieformat konvertiert werden, wie einen Punkt mit einem Typ- und Koordinatenfeld.

Was ist GeoJSON

GeoJSON ist ein standardisiertes Format für geografische Formen wie Punkte, Linien und Polygone. Es baut auf regulärem JSON auf, fügt aber spezifische Regeln für die Beschreibung von Geometrie und Standort hinzu.

Ein gültiges GeoJSON-Objekt hat:

• einen Typ (z.B. Punkt, Polygon);

• ein Geometriefeld mit Form und Koordinaten;

• optionale Eigenschaften mit zusätzlichen Informationen.

Beispiel: Berliner Bezirke (Polygone)

[ 
  {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "geometry": {
          "type": "Polygon",
          "coordinates": [[[13.1, 52.5], [13.2, 52.5], [13.2, 52.6], [13.1, 52.6], [13.1, 52.5]]]
        },
        "properties": {
          "bezirk": "Berlin-Mitte",
          "id": "1101"
        }
      }
    ]
  }
]

Dies ist eine GeoJSON-Datei, die eine Polygonform (z.B. eine Bezirksgrenze) mit zusätzlichen Informationen beschreibt:

• Der Typ: "FeatureCollection" bedeutet, dass es sich um eine Liste geografischer Features handelt.

• Jedes Feature hat:

  • eine Geometrie mit der Form (ein Polygon aus Koordinatenpaaren);

  • Eigenschaften wie den Bezirksnamen (bezirk) und die ID.

Es ist das Standardformat zum Erstellen von Formen wie Städten oder Bezirken auf einer Karte.

Beispiel-Datei zum Download

Einfaches JSON mit Koordinaten verwenden

Nicht alle geografischen Daten müssen der vollständigen GeoJSON-Struktur folgen. Wenn Sie nur mit Punkten arbeiten - wie Schulen, Gewerben oder Hotels - können Sie ein einfacheres JSON-Format verwenden, solange es die folgenden Elemente enthält:

• einen Typ: Punkt;

• ein Koordinatenarray.

Diese Felder müssen in jedem Objekt verschachtelt sein und in jedem Datensatz im gleichen Feld erscheinen (z.B. Koordinaten oder location).

Beispiel

{
  "name": "Bright Nest Hotel",
  "coordinates": {
    "type": "Point",
    "coordinates": [13.4078, 52.5114]
  }
}

Diese Struktur funktioniert gut für punktbasierte Datensätze, auch wenn es kein vollständiges GeoJSON ist. Die Polyteia Plattform erkennt das "coordinates"-Feld automatisch und konvertiert es in eine Geometriespalte - genau wie bei GeoJSON.

Wenn Sie Formen wie Grenzen oder Bezirke benötigen, müssen Sie zu einem vollständigem GeoJSON wechseln.

Beispiel-Datei zum Download

JSON- oder GeoJSON-Datei hochladen

Um eine Kartenvisualisierung zu erstellen, muss Ihr Datensatz geografische Informationen enthalten - entweder als Polygone (z.B. Bezirksgrenzen) oder Punkte (z.B. Standortkoordinaten). Diese Daten müssen in einem der folgenden Formate hochgeladen werden:

Format	Beschreibung	Unterstützte Formen	Automatische Konvertierung in Geometrie?
.geojson	Standardformat für die Beschreibung von Kartenformen	Polygone, Punkte	Ja
.json	Muss GeoJSON-ähnlicher Struktur folgen (Typ + Koordinaten)	Meist Punkte	Ja, wenn korrekt formatiert

Um die Daten hochzuladen:

• Folgen Sie den Schritten in Datensatz erstellen, um Ihre .geojson- oder .json-Datei hochzuladen.

Nach dem Hochladen wird die Polyteia Plattform:

• ein gültiges GeoJSON erkennen und eine Geometriespalte erstellen;

• versuchen, punktbasierte JSON-Felder (z.B. location, Koordinaten) zu konvertieren, wenn die Struktur Typ und Koordinaten enthält.

Wenn keine Geometrie erkannt wird, wird die Spalte als Text oder verschachteltes Objekt behandelt. In diesem Fall müssen Sie sicherstellen, dass das Format in Ihrer hochgeladenen Datei angepasst ist, und dann versuchen, die Datei erneut hochzuladen.

Gut zu wissen

• Beim Hochladen einer .geojson-Datei erkennt die Polyteia Plattform das Format automatisch und konvertiert es in eine Geometriespalte.

• Beim Hochladen einer .json-Datei behandelt die Polyteia Plattform diese nur als geografisch, wenn sie ein Typ- und Koordinatenfeld in der korrekten GeoJSON-Struktur enthält.

• Wenn Ihre JSON-Datei verschachtelte Felder verwendet (wie Koordinaten), stellen Sie sicher, dass jedes Objekt konsistent formatiert ist.