Wir werden am 08.09.2026 ein Update der ID REST GD auf dem Schulsystem vornehmen. Den Status dazu können Sie hier einsehen: status.teleport.de

Die Livesysteme sind bei einem erfolgreichen Durchlauf auf dem Schulsystem einen Monat später, am 08.10.2026, dran. Den Status dazu können Sie hier einsehen: status.teleport.de

Achtung und Hinweis

Das Release enthält einige große Änderungen bei Parametern, Methoden und im Datenmodell. Daher ist die Testphase auf dem Schulsystem auf einem Monat verlängert. Sollte es Fragen, Feedback oder andere Anmerkungen geben, dann können Sie diese gerne an support@tsa.de schicken. Mit Hilfe von diesem Feedback können wir einschätzen, ob der Monat ausreichend ist oder noch verlängert wird.

Änderung zur Vorversion ID REST GD (Neue Version: 1.9.0)

• Wartung:

• Umfangreiches Audit und Aktualisierung von Drittkomponenten

• Breaking Changes:

• Aus ALLEN /GeographicalArea-Methoden wurden die geoCodingShapes (Koordinaten) entfernt. Diese sind jetzt in einer neuen, eigenen Methode (siehe Features) abrufbar.

• Neue Features:

• Neue Methode /GeographicalArea/{id}/geoCodings/, welche nur die geoCodingShapes für ein Gebiet zurückgibt.
• Neue Methode /verification/getByGeoCoding (Erklärung siehe unten)
• Neue Methode /verification/getByAddress (Erklärung siehe unten)
• Neuer Parameter „lastUpdated“ für alle Methoden zum inkrementellen Abrufen von Gebieten wurde hinzufügt. 

• Bugs behoben:

• Optimierung API-Key-Management nach Datenspiegelung von Live auf Schul
• Internal Server Error beim Abrufen von GeographicalArea wurde behoben
• getAreaClass liefert falsche Werte in areaClassClass
• PoliticalArea showAll gab Gebiete mal doppelt und mal gar nicht aus

Neue Kategorie “Verification”: Adress- und Geokoordinaten-Verifizierung

Mit der neuen Kategorie “Verification” stellt die ID REST GD zwei Methoden zur Verifizierung von Adressen und Geokoordinaten bereit:

• /verification/getByAddress
• /verification/getByGeoCoding

Die Methoden ermöglichen die Anbindung an den WFS des Geodatenzentrums und liefern auf Basis von Adressdaten oder Geokoordinaten die dazugehörigen verwaltungspolitischen und/oder geografischen Gebiete. 

Der Ablauf ist:

• Der API-Key der ID REST GD wird geprüft.
• Anhand des API-Keys wird das zugehörige Bundesland bzw. die ID ADM-Instanz ermittelt.
• Der konfigurierte WFS API-Key dieses Bundeslandes wird verwendet.
• Die Anfrage wird an den WFS weitergeleitet.
• Der WFS liefert ein oder mehrere Gebiete zurück.
• Die zurückgelieferten Gebiete werden, soweit möglich, gegen die Gebiete der ID GD gematcht.
• Die Ergebnisse werden im einheitlichen Datenmodell der ID REST GD zurückgegeben bzw. auf Grundlage des Datenmodells des WFS.
• Bei sortByDistance werden die Ergebnisse zusätzlich anhand der von der ID REST GD berechneten Entfernung zur angefragten Position sortiert.

Das vollständige Datenmodell (JSON) und die Parameter können Sie hier schon von unserem Snapshot einsehen: 1.9.0-SNAPSHOT

Bei Fragen wenden Sie sich bitte an support@teleport.de.