B2Base · 1.0.0-draft.1 · Projektentwurf
Postadressen, Druckzeilen und Standortangaben für unterschiedliche nationale Adresssysteme.
Austauschschema (JSON) · Schema für den Designer · Beispieldaten
Austauschschema: vollständige Strukturprüfung mit JSON Schema 2020-12. Designer-Fassung: gleiche Datenfelder mit reduzierten Strukturregeln zur Feldübernahme. Anleitung und Grenzen
| 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.
Alle Beispiele sind synthetisch. Sie werden mit dem mitgelieferten Schema geprüft; daraus folgt keine fachliche Echtheit oder externe Erreichbarkeit.
{
"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"
}
}
]
}
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.
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.
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://b2base.eu/schemas/1.0.0-draft.1/person/addressdetails.schema.json",
"title": "Internationale Adressen",
"$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": "Bekannte Adressen.",
"items": {
"$ref": "#/$defs/Address"
},
"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",
"minLength": 1,
"description": "Eine Adresszeile."
},
"minItems": 1
},
"language": {
"$ref": "#/$defs/LanguageTag"
},
"recipient": {
"type": "string",
"minLength": 1,
"description": "Optionale Empfängerbezeichnung."
},
"street": {
"type": "object",
"description": "Straßenname.",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Straßenname."
},
"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
}
},
"required": [
"name"
],
"additionalProperties": false
},
"number": {
"type": "object",
"description": "Hausnummer, auch alphanumerisch.",
"properties": {
"value": {
"type": "string",
"minLength": 1,
"description": "Hausnummer, auch alphanumerisch."
},
"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
}
},
"required": [
"value"
],
"additionalProperties": false
},
"unit": {
"type": "object",
"description": "Einheit oder Wohnung.",
"properties": {
"value": {
"type": "string",
"minLength": 1,
"description": "Einheit oder Wohnung."
},
"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
}
},
"required": [
"value"
],
"additionalProperties": false
},
"floor": {
"type": "object",
"description": "Etagenbezeichnung.",
"properties": {
"value": {
"type": "string",
"minLength": 1,
"description": "Etagenbezeichnung."
},
"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
}
},
"required": [
"value"
],
"additionalProperties": false
},
"postBox": {
"type": "object",
"description": "Postfach.",
"properties": {
"value": {
"type": "string",
"minLength": 1,
"description": "Postfach."
},
"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
}
},
"required": [
"value"
],
"additionalProperties": false
},
"blockOrPlotNumber": {
"type": "object",
"description": "Block- oder Parzellenbezeichnung.",
"properties": {
"value": {
"type": "string",
"minLength": 1,
"description": "Block- oder Parzellenbezeichnung."
},
"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
}
},
"required": [
"value"
],
"additionalProperties": false
},
"city": {
"type": "object",
"description": "Ort oder Zustellbezirk.",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Ort oder Zustellbezirk."
},
"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
}
},
"required": [
"name"
],
"additionalProperties": false
},
"state": {
"type": "object",
"description": "Region, Provinz oder Bundesstaat.",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Region, Provinz oder Bundesstaat."
},
"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
}
},
"required": [
"name"
],
"additionalProperties": false
},
"postalCode": {
"type": "object",
"description": "Postleitzahl als Text; keine globale fünfstellige Regel.",
"properties": {
"value": {
"type": "string",
"minLength": 1,
"description": "Postleitzahl als Text; keine globale fünfstellige Regel."
},
"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
}
},
"required": [
"value"
],
"additionalProperties": false
},
"wardNumber": {
"type": "object",
"description": "Verwaltungsbezirk.",
"properties": {
"value": {
"type": "string",
"minLength": 1,
"description": "Verwaltungsbezirk."
},
"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
}
},
"required": [
"value"
],
"additionalProperties": false
},
"country": {
"type": "object",
"description": "Zielland. Name und Code sind verschiedene Informationen.",
"properties": {
"code": {
"$ref": "#/$defs/CountryCode"
},
"name": {
"type": "string",
"minLength": 1,
"description": "Landesname in der angegebenen Sprache."
},
"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
}
},
"additionalProperties": false,
"anyOf": [
{
"required": [
"code"
]
},
{
"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": [
"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
}
},
"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"
}
}
]
}
]
}
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.