Klasse plz

Adressdatenbank: Postleitzahlen, Orte und Straßen

Diese Klasse eignet sich für Autovervollständigung und Plausibilitätsprüfung in Adressformularen – insbesondere für die Sparten Hausrat (HR) und Wohngebäude (WG), bei denen die Anschrift des Risikoorts benötigt wird.

Alle Beispiele setzen die Hilfsfunktion curlSend() und den Aufbau aus den Grundlagen voraus.

MethodeZweck
fetchListPLZ, Orte und Straßen gezielt abfragen
getListCitiesListe aller Orte

fetchList – PLZ, Orte und Straßen

Die Methode arbeitet stufenweise: Sie grenzen mit jedem zusätzlichen Parameter weiter ein und bestimmen über columns, welche Felder zurückkommen.

ParameterBedeutung
plz Abfrage der möglichen PLZ über ein Fragment (z.B. 093) oder der Ortsliste bei vollständiger PLZ
ort Abfrage der Straßen – in Verbindung mit der PLZ
strasse Eingrenzung der Straßennamen durch Anfangsbuchstaben
columns Array mit den gewünschten Rückgabefeldern: plz, ort, strasse
limit Begrenzt die Ausgabe
Request – PLZ-Fragment auflösen
$UpdateParams = array (
    "dataUser" => array (
        'user' => 'IHREVERMITTLERNUMMER',
        'pass' => '********',
    ),
    "content"  => array (
        'plz' => array (
            'fetchList' => array (
                array (
                    'plz'     => '0106',
                    'limit'   => '5',
                    'columns' => array ( 'plz', 'ort' ),
                ),
            ),
        ),
    ),
);
Response
array (
  'response' =>
  array (
    'plz' =>
    array (
      'fetchList' =>
      array (
        0 =>
        array (
          0 => array ( 'plz' => '01067', 'ort' => 'Dresden' ),
          1 => array ( 'plz' => '01069', 'ort' => 'Dresden' ),
        ),
      ),
    ),
  ),
)
Request – Straßen zu PLZ und Ort
'fetchList' => array (
    array (
        'plz'     => '01067',
        'ort'     => 'Dresden',
        'strasse' => 'Bahn',              // Anfangsbuchstaben zur Eingrenzung
        'columns' => array ( 'strasse' ),
        'limit'   => '20',
    ),
),
Typischer Ablauf in einem Formular
1. Nutzer tippt PLZ → plz als Fragment senden, Ortsliste anzeigen.
2. Ort steht fest → plz + ort senden, Straßenliste laden.
3. Bei sehr großen Orten zusätzlich strasse als Anfangsbuchstaben mitgeben und limit setzen.

getListCities – Alle Orte

Liefert die Liste aller Orte. Es müssen keine Parameter übergeben werden.

Request
$UpdateParams = array (
    "dataUser" => array (
        'user' => 'IHREVERMITTLERNUMMER',
        'pass' => '********',
    ),
    "content"  => array (
        'plz' => array (
            'getListCities' => array( "" ),
        ),
    ),
);
Response (gekürzt)
array (
  'response' =>
  array (
    'plz' =>
    array (
      'getListCities' =>
      array (
        0 =>
        array (
          0 => array ( 'ort' => 'Dresden' ),
          1 => array ( 'ort' => 'Hamburg' ),
          // ...
        ),
      ),
    ),
  ),
)
⚠ Große Antwort
Diese Methode liefert die komplette Ortsliste Deutschlands. Rufen Sie sie nicht bei jedem Formularaufruf auf, sondern cachen Sie das Ergebnis. Für Autovervollständigung ist fetchList mit limit die bessere Wahl.
✉ Feedback
Fehler oder Unstimmigkeit in dieser Doku entdeckt? Schreiben Sie uns: ts@mr-money.de