Neue Ortssuche im BKG
Die Suche der Verwaltungsleistungen im PVOG basiert auf einer Ortssuche. Bisher war das Gemeindeverzeichnis GV 100 von Destatis die Grundlage für die Ermittlung des Amtlichen Regionalschlüssels (ARS) nach Ortsnamen und/oder PLZ. Dadurch war keine straßengenaue Suche möglich. Wenn ein ARS-Gebiet mehrere Postleitzahlen enthält, konnten regionale Zuordnungen von Städten und Gemeinden nicht korrekt im PVOG abgebildet und aktuell gehalten werden.
Für genauere Suchinformationen wurde jetzt der Service des Bundesamtes für Kartographie und Geodäsie eingebunden. Wird nun in der Ortssuche eine genaue Beschreibung des Wohnortes angegeben, erhält der Nutzer eine detaillierte Auswahl. Es werden auch Ortsteile bei der Suche berücksichtigt.
Reicht der ausgewählte Ort für die eindeutige Bestimmung des Amtlichen Regionalschlüssels nicht aus, hilft eine Straßensuche weiter.
Mit der Bestätigung der Ortsauswahl wird der Wohnort in eine eindeutige ARS Information umgewandelt, was besonders bei der Zuordnung von Leistungen, Organisationseinheiten, Zuständigkeiten und Spezialisierungen wichtig ist.
Beispiele für die Nutzung der BKG APIs
Mit der PVOG-Version 8.15 werden vier Endpunkte zur Nutzung freigegeben (/docs/api/suchdienst-api):
v3/locations
- Liefert anhand des Wertes der Suchanfrage Orte aus dem BKG zurück.
- Es muss mindestens einer der Parameter ort oder plz gefüllt sein.
- Beispiel: https://public.demo.pvog.cloud-bdc.dataport.de/suchdienst/api/v3/locations?q=20144
v3/locations/suggestions
- Liefert Vorschläge zur Autovervollständigung für den Suchbegriff zurück (Präfixsuche).
- Beispiel: https://public.demo.pvog.cloud-bdc.dataport.de/suchdienst/api/v3/locations/suggestions?q=07745
v3/locations/details
- Liefert anhand des Wertes der Suchanfrage Orte aus dem BKG zurück.
- Es muss mindestens einer der Parameter ort oder plz gefüllt sein.
- Beispiel: https://public.demo.pvog.cloud-bdc.dataport.de/suchdienst/api/v3/locations/details?plz=20144
v3/locations/ars
- Liefert anhand des Wertes der Suchanfrage Orte aus dem BKG zurück.
- Beispiel: https://public.demo.pvog.cloud-bdc.dataport.de/suchdienst/api/v3/locations/ars?ars=033555107033