Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen der Seite angezeigt.

--- schemes:person:addressdetails [2024/12/13 12:46] – [array notation] lars_gerulat
+++ schemes:person:addressdetails [2026/09/08 14:34] (aktuell) – B2Base-Schemaentwurf: internationale Datenmodelle, Beispiele und Erläuterungen 0.0.0.0
@@ Zeile 1: / Zeile 1: @@
-====== addressdetails ======
+====== Internationale Adressen ======
-===== description =====
-Das Schema für **[[schemes:person|person]]:addressdetails** unterstützt:
+<WRAP b2hero>
-  * Mehrere Adressen: Haupt- und Nebenwohnsitze sowie andere Typen (z. B. Arbeitsadresse).
+**B2Base · 1.0.0-draft.1 · Projektentwurf**
-  * Geolocation: Optionaler Standort mit Längen- und Breitengrad für Regionen ohne strukturierte Adressen.
-  * Vollständige Adressdetails: Straße, Stadt, Staat/Region, Postleitzahl und Land im ISO-Format.
+Postadressen, Druckzeilen und Standortangaben für unterschiedliche nationale Adresssysteme.
-===== examples =====
-==== json notation ====
+[[schemes:scheme|Bibliothek]] · [[schemes:person|Personen]] · [[schemes:principles|Internationale Grundregeln]]
-<code>
+</WRAP>
+===== Direkt verwenden =====
+[[b2schema>1.0.0-draft.1/person/addressdetails.schema.json|Austauschschema (JSON)]] · [[b2schema>1.0.0-draft.1/person/addressdetails.editor.schema.json|Schema für den Designer]] · [[b2schema>1.0.0-draft.1/person/addressdetails.examples.json|Beispieldaten]]
+**Austauschschema:** vollständige Strukturprüfung mit JSON Schema 2020-12. **Designer-Fassung:** gleiche Datenfelder mit reduzierten Strukturregeln zur Feldübernahme. [[:guidelines#im_workflowdesigner_verwenden|Anleitung und Grenzen]]
+===== Felder im Überblick =====
+^ Feld ^ Typ ^ Pflicht im Modul ^ Bedeutung ^
+| ''addresses'' | array | Ja | Bekannte Adressen. |
+| ''extensions'' | object | Nein | Vereinbarte Erweiterungen; Schlüssel als absolute URI des Herausgebers. Keine stillschweigende Änderung von Kernfeldern. |
+Pflichtangaben gelten für das jeweilige Objekt, wenn dieses Modul verwendet wird. Zusätzliche Alternativen und Statusregeln stehen im Austauschschema. Optionale Felder weglassen, wenn sie unbekannt oder nicht anwendbar sind; ein leeres Pflichtfeld ist kein gültiger Ersatz.
+===== International richtig einsetzen =====
+  * Straße, Stadt, Postleitzahl und Hausnummer sind optional. country bezeichnet das Zielland; code und name sind getrennt.
+  * Die geordneten addressLines bestimmen die Druckdarstellung, wenn sie angegeben sind. Strukturfelder dienen Suche und fachlicher Verarbeitung und müssen dazu passen.
+  * Koordinaten ersetzen keine Zustellbarkeitsprüfung. Zeilenreihenfolge und nationale Postregeln prüft das jeweilige Länderprofil.
+===== Gültige Beispiele =====
+Alle Beispiele sind synthetisch. Sie werden mit dem mitgelieferten Schema geprüft; daraus folgt keine fachliche Echtheit oder externe Erreichbarkeit.
+==== Beispiel 1 ====
+<file json example-1.json>
 {
   "addresses": [
     {
-      "type": "primary residence",
-      "street": {
-        "name": "Main Street",
-        "line_in_address": 1,
-        "position_in_address_line": 1
-      },
-      "number": {
-        "value": "123",
-        "line_in_address": 1,
-        "position_in_address_line": 2
-      },
-      "unit": {
-        "value": "Apt 5B",
-        "line_in_address": 1,
-        "position_in_address_line": 3
-      },
-      "floor": {
-        "value": "3",
-        "line_in_address": 1,
-        "position_in_address_line": 4
-      },
-      "city": {
-        "name": "Berlin",
-        "line_in_address": 2,
-        "position_in_address_line": 1
-      },
-      "state": {
-        "name": "Berlin",
-        "line_in_address": 2,
-        "position_in_address_line": 2
-      },
-      "postalCode": {
-        "value": "10115",
-        "line_in_address": 3,
-        "position_in_address_line": 1
-      },
       "country": {
-        "name": "Germany",
+        "code": "GB"
-        "line_in_address": 4,
-        "position_in_address_line": 1
       },
-      "geolocation": {
+      "addressLines": [
-        "latitude": 52.5200,
+        "Example House",
-        "longitude": 13.4050
+        "London SW1A 1AA"
+      ],
+      "postalCode": {
+        "value": "SW1A 1AA"
       }
-    },
+    }
+  ]
+}
+</file>
+==== Beispiel 2 ====
+<file json example-2.json>
+{
+  "addresses": [
     {
-      "type": "secondary residence",
+      "type": "delivery",
-      "street": {
-        "name": "Elm Street",
-        "line_in_address": 1,
-        "position_in_address_line": 1
-      },
-      "number": {
-        "value": "456",
-        "line_in_address": 1,
-        "position_in_address_line": 2
-      },
-      "city": {
-        "name": "Munich",
-        "line_in_address": 2,
-        "position_in_address_line": 1
-      },
-      "state": {
-        "name": "Bavaria",
-        "line_in_address": 2,
-        "position_in_address_line": 2
-      },
-      "postalCode": {
-        "value": "80331",
-        "line_in_address": 3,
-        "position_in_address_line": 1
-      },
       "country": {
-        "name": "Germany",
+        "code": "AE"
-        "line_in_address": 4,
-        "position_in_address_line": 1
       },
+      "addressLines": [
+        "صندوق بريد 12345",
+        "دبي"
+      ],
+      "language": "ar",
+      "postBox": {
+        "value": "12345"
+      }
     }
   ]
 }
-</code>
+</file>
-==== array notation ====
-<code>
-$person['addresses'][0]['type'] = "primary residence";
-$person['addresses'][0]['street']['name'] = "Main Street";
-$person['addresses'][0]['street']['line_in_address'] = 1;
-$person['addresses'][0]['street']['position_in_address_line'] = 1;
-$person['addresses'][0]['number']['value'] = "123";
-$person['addresses'][0]['number']['line_in_address'] = 1;
-$person['addresses'][0]['number']['position_in_address_line'] = 2;
-$person['addresses'][0]['unit']['value'] = "Apt 5B";
-$person['addresses'][0]['unit']['line_in_address'] = 1;
-$person['addresses'][0]['unit']['position_in_address_line'] = 3;
-$person['addresses'][0]['floor']['value'] = "3";
-$person['addresses'][0]['floor']['line_in_address'] = 1;
-$person['addresses'][0]['floor']['position_in_address_line'] = 4;
-$person['addresses'][0]['city']['name'] = "Berlin";
-$person['addresses'][0]['city']['line_in_address'] = 2;
-$person['addresses'][0]['city']['position_in_address_line'] = 1;
-$person['addresses'][0]['state']['name'] = "Berlin";
-$person['addresses'][0]['state']['line_in_address'] = 2;
-$person['addresses'][0]['state']['position_in_address_line'] = 2;
-$person['addresses'][0]['postalCode']['value'] = "10115";
-$person['addresses'][0]['postalCode']['line_in_address'] = 3;
-$person['addresses'][0]['postalCode']['position_in_address_line'] = 1;
-$person['addresses'][0]['country']['name'] = "Germany";
-$person['addresses'][0]['country']['line_in_address'] = 4;
-$person['addresses'][0]['country']['position_in_address_line'] = 1;
-$person['addresses'][0]['geolocation']['latitude'] = 52.5200;
-$person['addresses'][0]['geolocation']['longitude'] = 13.4050;
-$person['addresses'][1]['type'] = "secondary residence";
+===== Umstellung aus dem bisherigen Wiki =====
-$person['addresses'][1]['street']['name'] = "Elm Street";
-$person['addresses'][1]['street']['line_in_address'] = 1;
-$person['addresses'][1]['street']['position_in_address_line'] = 1;
-$person['addresses'][1]['number']['value'] = "456";
-$person['addresses'][1]['number']['line_in_address'] = 1;
-$person['addresses'][1]['number']['position_in_address_line'] = 2;
-$person['addresses'][1]['city']['name'] = "Munich";
-$person['addresses'][1]['city']['line_in_address'] = 2;
-$person['addresses'][1]['city']['position_in_address_line'] = 1;
-$person['addresses'][1]['state']['name'] = "Bavaria";
-$person['addresses'][1]['state']['line_in_address'] = 2;
-$person['addresses'][1]['state']['position_in_address_line'] = 2;
-$person['addresses'][1]['postalCode']['value'] = "80331";
-$person['addresses'][1]['postalCode']['line_in_address'] = 3;
-$person['addresses'][1]['postalCode']['position_in_address_line'] = 1;
-$person['addresses'][1]['country']['name'] = "Germany";
-$person['addresses'][1]['country']['line_in_address'] = 4;
-$person['addresses'][1]['country']['position_in_address_line'] = 1;
-</code>
-===== schema =====
+Die bisherigen verschachtelten Komponenten einschließlich line_in_address bleiben erhalten. Die generelle Pflicht für city und type entfällt. Neu sind addressLines, language und country.code; ein vorhandener country.name bleibt lesbar. Das ungültige alte JSON-Beispiel wurde ersetzt.
-<code>
+[[schemes:migration|Änderungsübersicht und Migrationsregeln]]
+===== Vollständiges Schema =====
+Die Datei ist eigenständig: verwendete Bausteine sind unter ''$defs'' eingebettet, Referenzen bleiben lokal. ''$id'' ist die kanonische Kennung. Die Downloads oben verwenden den aktuellen Server; eine Veröffentlichung unter der kanonischen Domain ist damit nicht behauptet.
+<file json addressdetails.schema.json>
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://b2base.eu/doku.php?id=schemes:person:addressdetails",
+  "$id": "https://b2base.eu/schemas/1.0.0-draft.1/person/addressdetails.schema.json",
-  "title": "b2base:schemes:person:addressdetails",
+  "title": "Internationale Adressen",
-  "description": "A schema for representing a person's addresses, including support for international and unique cases.",
+  "$comment": "B2Base 1.0.0-draft.1. Projektentwurf, kein durch ISO oder andere Normungsgremien verabschiedeter Standard.",
   "type": "object",
+  "description": "Eine oder mehrere Adressen.",
   "properties": {
     "addresses": {
       "type": "array",
-      "description": "A list of the person's addresses, including type and optional geolocation information.",
+      "description": "Bekannte Adressen.",
       "items": {
-        "type": "object",
+        "$ref": "#/$defs/Address"
-        "properties": {
+      },
-          "type": {
+      "minItems": 1
+    },
+    "extensions": {
+      "type": "object",
+      "description": "Vereinbarte Erweiterungen; Schlüssel als absolute URI des Herausgebers. Keine stillschweigende Änderung von Kernfeldern.",
+      "properties": {},
+      "additionalProperties": true,
+      "propertyNames": {
+        "format": "uri"
+      }
+    }
+  },
+  "required": [
+    "addresses"
+  ],
+  "additionalProperties": false,
+  "$defs": {
+    "Address": {
+      "type": "object",
+      "description": "Internationale Post- oder Standortadresse. Weder Straße, Hausnummer, Stadt noch Postleitzahl sind weltweit obligatorisch.",
+      "properties": {
+        "type": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Verwendungszweck, etwa home, work oder delivery."
+        },
+        "addressLines": {
+          "type": "array",
+          "description": "Geordnete Druckzeilen in der Originalschrift; bei Angabe maßgeblich für die Darstellung.",
+          "items": {
             "type": "string",
-            "description": "The type of address, e.g., primary residence, secondary residence, work, post box, or military address.",
+            "minLength": 1,
-            "example": "primary residence"
+            "description": "Eine Adresszeile."
           },
-          "street": {
+          "minItems": 1
-            "type": "object",
+        },
-            "description": "Detailed information about the street.",
+        "language": {
-            "properties": {
+          "$ref": "#/$defs/LanguageTag"
-              "name": {
+        },
-                "type": "string",
+        "recipient": {
-                "description": "The name of the street.",
+          "type": "string",
-                "example": "Main Street"
+          "minLength": 1,
-              },
+          "description": "Optionale Empfängerbezeichnung."
-              "line_in_address": {
+        },
-                "type": "integer",
+        "street": {
-                "description": "Defines which line in the address this street appears on when formatted.",
+          "type": "object",
-                "example": 1
+          "description": "Straßenname.",
-              },
+          "properties": {
-              "position_in_address_line": {
+            "name": {
-                "type": "integer",
+              "type": "string",
-                "description": "Defines the position of the street name within its address line.",
+              "minLength": 1,
-                "example": 1
+              "description": "Straßenname."
-              }
             },
-            "required": ["name"]
+            "line_in_address": {
+              "type": "integer",
+              "description": "Optionale Druckzeile, beginnend bei 1; aus dem bisherigen Modell beibehalten.",
+              "minimum": 1
+            },
+            "position_in_address_line": {
+              "type": "integer",
+              "description": "Optionale Position in der Druckzeile, beginnend bei 1.",
+              "minimum": 1
+            }
           },
-          "number": {
+          "required": [
-            "type": "object",
+            "name"
-            "description": "Detailed information about the house or building number.",
+          ],
-            "properties": {
+          "additionalProperties": false
-              "value": {
+        },
-                "type": "string",
+        "number": {
-                "description": "The house or building number.",
+          "type": "object",
-                "example": "123"
+          "description": "Hausnummer, auch alphanumerisch.",
-              },
+          "properties": {
-              "line_in_address": {
+            "value": {
-                "type": "integer",
+              "type": "string",
-                "description": "Defines which line in the address this number appears on when formatted.",
+              "minLength": 1,
-                "example": 1
+              "description": "Hausnummer, auch alphanumerisch."
-              },
-              "position_in_address_line": {
-                "type": "integer",
-                "description": "Defines the position of the number within its address line.",
-                "example": 2
-              }
             },
-            "required": ["value"]
+            "line_in_address": {
+              "type": "integer",
+              "description": "Optionale Druckzeile, beginnend bei 1; aus dem bisherigen Modell beibehalten.",
+              "minimum": 1
+            },
+            "position_in_address_line": {
+              "type": "integer",
+              "description": "Optionale Position in der Druckzeile, beginnend bei 1.",
+              "minimum": 1
+            }
           },
-          "unit": {
+          "required": [
-            "type": "object",
+            "value"
-            "description": "Detailed information about the unit, apartment, or room number.",
+          ],
-            "properties": {
+          "additionalProperties": false
-              "value": {
+        },
-                "type": "string",
+        "unit": {
-                "description": "The unit, apartment, or room number.",
+          "type": "object",
-                "example": "Apt 5B"
+          "description": "Einheit oder Wohnung.",
-              },
+          "properties": {
-              "line_in_address": {
+            "value": {
-                "type": "integer",
+              "type": "string",
-                "description": "Defines which line in the address this unit appears on when formatted.",
+              "minLength": 1,
-                "example": 1
+              "description": "Einheit oder Wohnung."
-              },
-              "position_in_address_line": {
-                "type": "integer",
-                "description": "Defines the position of the unit within its address line.",
-                "example": 3
-              }
             },
-            "required": ["value"]
+            "line_in_address": {
+              "type": "integer",
+              "description": "Optionale Druckzeile, beginnend bei 1; aus dem bisherigen Modell beibehalten.",
+              "minimum": 1
+            },
+            "position_in_address_line": {
+              "type": "integer",
+              "description": "Optionale Position in der Druckzeile, beginnend bei 1.",
+              "minimum": 1
+            }
           },
-          "floor": {
+          "required": [
-            "type": "object",
+            "value"
-            "description": "Detailed information about the floor.",
+          ],
-            "properties": {
+          "additionalProperties": false
-              "value": {
+        },
-                "type": "string",
+        "floor": {
-                "description": "The floor number.",
+          "type": "object",
-                "example": "3"
+          "description": "Etagenbezeichnung.",
-              },
+          "properties": {
-              "line_in_address": {
+            "value": {
-                "type": "integer",
+              "type": "string",
-                "description": "Defines which line in the address this floor appears on when formatted.",
+              "minLength": 1,
-                "example": 1
+              "description": "Etagenbezeichnung."
-              },
-              "position_in_address_line": {
-                "type": "integer",
-                "description": "Defines the position of the floor within its address line.",
-                "example": 4
-              }
             },
-            "required": ["value"]
+            "line_in_address": {
+              "type": "integer",
+              "description": "Optionale Druckzeile, beginnend bei 1; aus dem bisherigen Modell beibehalten.",
+              "minimum": 1
+            },
+            "position_in_address_line": {
+              "type": "integer",
+              "description": "Optionale Position in der Druckzeile, beginnend bei 1.",
+              "minimum": 1
+            }
           },
-          "postBox": {
+          "required": [
-            "type": "object",
+            "value"
-            "description": "Detailed information about the post box.",
+          ],
-            "properties": {
+          "additionalProperties": false
-              "value": {
+        },
-                "type": "string",
+        "postBox": {
-                "description": "The post box number.",
+          "type": "object",
-                "example": "PO Box 1234"
+          "description": "Postfach.",
-              },
+          "properties": {
-              "line_in_address": {
+            "value": {
-                "type": "integer",
+              "type": "string",
-                "description": "Defines which line in the address this post box appears on when formatted.",
+              "minLength": 1,
-                "example": 2
+              "description": "Postfach."
-              },
-              "position_in_address_line": {
-                "type": "integer",
-                "description": "Defines the position of the post box within its address line.",
-                "example": 1
-              }
             },
-            "required": ["value"]
+            "line_in_address": {
+              "type": "integer",
+              "description": "Optionale Druckzeile, beginnend bei 1; aus dem bisherigen Modell beibehalten.",
+              "minimum": 1
+            },
+            "position_in_address_line": {
+              "type": "integer",
+              "description": "Optionale Position in der Druckzeile, beginnend bei 1.",
+              "minimum": 1
+            }
           },
-          "blockOrPlotNumber": {
+          "required": [
-            "type": "object",
+            "value"
-            "description": "Detailed information about the block or plot number.",
+          ],
-            "properties": {
+          "additionalProperties": false
-              "value": {
+        },
-                "type": "string",
+        "blockOrPlotNumber": {
-                "description": "The block or plot number.",
+          "type": "object",
-                "example": "Block 15, Plot 23"
+          "description": "Block- oder Parzellenbezeichnung.",
-              },
+          "properties": {
-              "line_in_address": {
+            "value": {
-                "type": "integer",
+              "type": "string",
-                "description": "Defines which line in the address this block or plot number appears on when formatted.",
+              "minLength": 1,
-                "example": 2
+              "description": "Block- oder Parzellenbezeichnung."
-              },
-              "position_in_address_line": {
-                "type": "integer",
-                "description": "Defines the position of the block or plot number within its address line.",
-                "example": 2
-              }
             },
-            "required": ["value"]
+            "line_in_address": {
+              "type": "integer",
+              "description": "Optionale Druckzeile, beginnend bei 1; aus dem bisherigen Modell beibehalten.",
+              "minimum": 1
+            },
+            "position_in_address_line": {
+              "type": "integer",
+              "description": "Optionale Position in der Druckzeile, beginnend bei 1.",
+              "minimum": 1
+            }
           },
-          "city": {
+          "required": [
-            "type": "object",
+            "value"
-            "description": "Detailed information about the city or town.",
+          ],
-            "properties": {
+          "additionalProperties": false
-              "name": {
+        },
-                "type": "string",
+        "city": {
-                "description": "The name of the city or town.",
+          "type": "object",
-                "example": "Berlin"
+          "description": "Ort oder Zustellbezirk.",
-              },
+          "properties": {
-              "line_in_address": {
+            "name": {
-                "type": "integer",
+              "type": "string",
-                "description": "Defines which line in the address this city appears on when formatted.",
+              "minLength": 1,
-                "example": 3
+              "description": "Ort oder Zustellbezirk."
-              },
-              "position_in_address_line": {
-                "type": "integer",
-                "description": "Defines the position of the city within its address line.",
-                "example": 1
-              }
             },
-            "required": ["name"]
+            "line_in_address": {
+              "type": "integer",
+              "description": "Optionale Druckzeile, beginnend bei 1; aus dem bisherigen Modell beibehalten.",
+              "minimum": 1
+            },
+            "position_in_address_line": {
+              "type": "integer",
+              "description": "Optionale Position in der Druckzeile, beginnend bei 1.",
+              "minimum": 1
+            }
           },
-          "state": {
+          "required": [
-            "type": "object",
+            "name"
-            "description": "Detailed information about the state, province, or region.",
+          ],
-            "properties": {
+          "additionalProperties": false
-              "name": {
+        },
-                "type": "string",
+        "state": {
-                "description": "The name of the state, province, or region.",
+          "type": "object",
-                "example": "Berlin"
+          "description": "Region, Provinz oder Bundesstaat.",
-              },
+          "properties": {
-              "line_in_address": {
+            "name": {
-                "type": "integer",
+              "type": "string",
-                "description": "Defines which line in the address this state appears on when formatted.",
+              "minLength": 1,
-                "example": 3
+              "description": "Region, Provinz oder Bundesstaat."
-              },
-              "position_in_address_line": {
-                "type": "integer",
-                "description": "Defines the position of the state within its address line.",
-                "example": 2
-              }
             },
-            "required": ["name"]
+            "line_in_address": {
+              "type": "integer",
+              "description": "Optionale Druckzeile, beginnend bei 1; aus dem bisherigen Modell beibehalten.",
+              "minimum": 1
+            },
+            "position_in_address_line": {
+              "type": "integer",
+              "description": "Optionale Position in der Druckzeile, beginnend bei 1.",
+              "minimum": 1
+            }
           },
-          "postalCode": {
+          "required": [
-            "type": "object",
+            "name"
-            "description": "Detailed information about the postal or ZIP code.",
+          ],
-            "properties": {
+          "additionalProperties": false
-              "value": {
+        },
-                "type": "string",
+        "postalCode": {
-                "description": "The postal or ZIP code.",
+          "type": "object",
-                "example": "10115"
+          "description": "Postleitzahl als Text; keine globale fünfstellige Regel.",
-              },
+          "properties": {
-              "line_in_address": {
+            "value": {
-                "type": "integer",
+              "type": "string",
-                "description": "Defines which line in the address this postal code appears on when formatted.",
+              "minLength": 1,
-                "example": 4
+              "description": "Postleitzahl als Text; keine globale fünfstellige Regel."
-              },
-              "position_in_address_line": {
-                "type": "integer",
-                "description": "Defines the position of the postal code within its address line.",
-                "example": 1
-              }
             },
-            "required": ["value"]
+            "line_in_address": {
+              "type": "integer",
+              "description": "Optionale Druckzeile, beginnend bei 1; aus dem bisherigen Modell beibehalten.",
+              "minimum": 1
+            },
+            "position_in_address_line": {
+              "type": "integer",
+              "description": "Optionale Position in der Druckzeile, beginnend bei 1.",
+              "minimum": 1
+            }
           },
-          "wardNumber": {
+          "required": [
-            "type": "object",
+            "value"
-            "description": "Detailed information about the ward number.",
+          ],
-            "properties": {
+          "additionalProperties": false
-              "value": {
+        },
-                "type": "string",
+        "wardNumber": {
-                "description": "The ward number.",
+          "type": "object",
-                "example": "Ward 12"
+          "description": "Verwaltungsbezirk.",
-              },
+          "properties": {
-              "line_in_address": {
+            "value": {
-                "type": "integer",
+              "type": "string",
-                "description": "Defines which line in the address this ward number appears on when formatted.",
+              "minLength": 1,
-                "example": 5
+              "description": "Verwaltungsbezirk."
-              },
-              "position_in_address_line": {
-                "type": "integer",
-                "description": "Defines the position of the ward number within its address line.",
-                "example": 1
-              }
             },
-            "required": ["value"]
+            "line_in_address": {
+              "type": "integer",
+              "description": "Optionale Druckzeile, beginnend bei 1; aus dem bisherigen Modell beibehalten.",
+              "minimum": 1
+            },
+            "position_in_address_line": {
+              "type": "integer",
+              "description": "Optionale Position in der Druckzeile, beginnend bei 1.",
+              "minimum": 1
+            }
           },
-          "country": {
+          "required": [
-            "type": "object",
+            "value"
-            "description": "Detailed information about the country.",
+          ],
-            "properties": {
+          "additionalProperties": false
-              "name": {
+        },
-                "type": "string",
+        "country": {
-                "description": "The name of the country.",
+          "type": "object",
-                "example": "Germany"
+          "description": "Zielland. Name und Code sind verschiedene Informationen.",
-              },
+          "properties": {
-              "line_in_address": {
+            "code": {
-                "type": "integer",
+              "$ref": "#/$defs/CountryCode"
-                "description": "Defines which line in the address this country appears on when formatted.",
+            },
-                "example": 5
+            "name": {
-              },
+              "type": "string",
-              "position_in_address_line": {
+              "minLength": 1,
-                "type": "integer",
+              "description": "Landesname in der angegebenen Sprache."
-                "description": "Defines the position of the country within its address line.",
+            },
-                "example": 1
+            "line_in_address": {
-              }
+              "type": "integer",
+              "description": "Optionale Druckzeile, beginnend bei 1; aus dem bisherigen Modell beibehalten.",
+              "minimum": 1
             },
-            "required": ["name"]
+            "position_in_address_line": {
+              "type": "integer",
+              "description": "Optionale Position in der Druckzeile, beginnend bei 1.",
+              "minimum": 1
+            }
           },
-          "militaryAddress": {
+          "additionalProperties": false,
-            "type": "boolean",
+          "anyOf": [
-            "description": "Indicates if this is a military address.",
+            {
-            "example": false
+              "required": [
-          },
+                "code"
-          "geolocation": {
+              ]
-            "type": "object",
-            "description": "Geolocation coordinates for areas without structured addresses.",
-            "properties": {
-              "latitude": {
-                "type": "number",
-                "description": "The latitude of the location.",
-                "example": 52.5200
-              },
-              "longitude": {
-                "type": "number",
-                "description": "The longitude of the location.",
-                "example": 13.4050
-              }
             },
-            "required": ["latitude", "longitude"]
+            {
+              "required": [
+                "name"
+              ]
+            }
+          ]
+        },
+        "militaryAddress": {
+          "type": "boolean",
+          "description": "Kennzeichnet eine militärische Adresse, falls bekannt."
+        },
+        "geolocation": {
+          "$ref": "#/$defs/Geolocation"
+        },
+        "extensions": {
+          "type": "object",
+          "description": "Vereinbarte Erweiterungen; Schlüssel als absolute URI des Herausgebers. Keine stillschweigende Änderung von Kernfeldern.",
+          "properties": {},
+          "additionalProperties": true,
+          "propertyNames": {
+            "format": "uri"
           }
+        }
+      },
+      "required": [
+        "country"
+      ],
+      "additionalProperties": false,
+      "anyOf": [
+        {
+          "required": [
+            "addressLines"
+          ]
         },
-        "required": ["type", "city", "country"]
+        {
-      }
+          "required": [
+            "street"
+          ]
+        },
+        {
+          "required": [
+            "postBox"
+          ]
+        },
+        {
+          "required": [
+            "city"
+          ]
+        },
+        {
+          "required": [
+            "geolocation"
+          ]
+        },
+        {
+          "required": [
+            "blockOrPlotNumber"
+          ]
+        }
+      ]
+    },
+    "LanguageTag": {
+      "type": "string",
+      "minLength": 1,
+      "description": "BCP-47-Sprachtag, etwa de, zh-Hant-TW, sr-Latn oder x-internal. Das Muster prüft nur die Grundform, nicht Registrierung oder alle BCP-47-Regeln.",
+      "pattern": "^[A-Za-z]{1,8}(-[A-Za-z0-9]{1,8})*$"
+    },
+    "CountryCode": {
+      "type": "string",
+      "minLength": 1,
+      "description": "ISO 3166-1 Alpha-2, Großbuchstaben. Das Muster prüft nur die Schreibweise; zugewiesenen Code und Gültigkeitszeitpunkt gesondert prüfen.",
+      "pattern": "^[A-Z]{2}$"
+    },
+    "Geolocation": {
+      "type": "object",
+      "description": "WGS-84-Koordinaten in Dezimalgrad. Benannte Felder vermeiden eine vertauschte Achsenreihenfolge.",
+      "properties": {
+        "latitude": {
+          "type": "number",
+          "description": "Breitengrad.",
+          "minimum": -90,
+          "maximum": 90
+        },
+        "longitude": {
+          "type": "number",
+          "description": "Längengrad.",
+          "minimum": -180,
+          "maximum": 180
+        },
+        "accuracyMeters": {
+          "type": "number",
+          "description": "Geschätzter horizontaler Unsicherheitsradius in Metern.",
+          "minimum": 0
+        }
+      },
+      "required": [
+        "latitude",
+        "longitude"
+      ],
+      "additionalProperties": false
     }
   },
-  "required": ["addresses"]
+  "examples": [
+    {
+      "addresses": [
+        {
+          "country": {
+            "code": "GB"
+          },
+          "addressLines": [
+            "Example House",
+            "London SW1A 1AA"
+          ],
+          "postalCode": {
+            "value": "SW1A 1AA"
+          }
+        }
+      ]
+    },
+    {
+      "addresses": [
+        {
+          "type": "delivery",
+          "country": {
+            "code": "AE"
+          },
+          "addressLines": [
+            "صندوق بريد 12345",
+            "دبي"
+          ],
+          "language": "ar",
+          "postBox": {
+            "value": "12345"
+          }
+        }
+      ]
+    }
+  ]
 }
-</code>
+</file>
+===== Quellen und Abgrenzung =====
+  * [[https://www.w3.org/International/questions/qa-address-formats|W3C: Address formats around the world]]
+  * [[https://www.iso.org/iso-3166-country-codes.html|ISO: ISO 3166-Ländercodes]]
+Quellen geprüft am 8. September 2026. Die B2Base-Felder und ihre Kombination sind ein eigener Entwurf. Code-Register, nationale Regeln, Echtheit, Zeitfolgen und Referenzziele benötigen die im jeweiligen Verfahren vereinbarten Zusatzprüfungen.
+[[schemes:scheme|Zur Bibliothek]] · [[:guidelines|Integration]] · [[:faq|Häufige Fragen]]