PostalAddress

• JSON-Darstellung

Stellt eine Postanschrift dar, z. B. für Postsendungen oder Zahlungsadressen. Mit einer Postanschrift kann ein Postdienst Sendungen an ein Gebäude, ein Postfach oder Ähnliches zustellen. Eine Postanschrift ist nicht dazu gedacht, geografische Standorte wie Straßen, Städte oder Berge zu modellieren.

In der Regel wird eine Adresse durch Nutzereingabe oder durch Importieren vorhandener Daten erstellt, je nach Art des Prozesses.

Hinweise zur Eingabe oder Bearbeitung von Adressen:

• Verwenden Sie ein Adress-Widget, das für die Internationalisierung geeignet ist, z. B. https://github.com/google/libaddressinput.
• Nutzern sollten keine UI-Elemente für die Eingabe oder Bearbeitung von Feldern außerhalb der Länder angezeigt werden, in denen dieses Feld verwendet wird.

Weitere Informationen zur Verwendung dieses Schemas finden Sie unter https://support.google.com/business/answer/6397478.

JSON-Darstellung
{ "revision": integer, "regionCode": string, "languageCode": string, "postalCode": string, "sortingCode": string, "administrativeArea": string, "locality": string, "sublocality": string, "addressLines": [ string ], "recipients": [ string ], "organization": string }

Felder
revision	integer Die Schemaversion von PostalAddress. Die Einstellung muss 0 lauten, was der aktuellen Überarbeitung entspricht. Alle neuen Überarbeitungen müssen abwärtskompatibel zu alten Überarbeitungen sein.
regionCode	string Erforderlich. CLDR-Regionscode des Landes bzw. der Region der Adresse. Er wird nie abgeleitet. Der Nutzer muss sicherstellen, dass der Wert richtig ist. Weitere Informationen finden Sie unter https://cldr.unicode.org/ und https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Beispiel: "CH" für die Schweiz.
languageCode	string Optional. BCP-47-Sprachencode des Inhalts dieser Adresse, falls bekannt. Dies ist oft die Sprache der UI des Eingabeformulars oder die Sprache, die mit einer der verwendeten Sprachen des Landes bzw. der Region mit der Adresse oder der entsprechenden Transliteration übereinstimmt. In bestimmten Ländern hat dies Auswirkungen auf die Formatierung. Es ist jedoch nicht entscheidend für die Richtigkeit der Daten und hat niemals Auswirkungen auf Validierungen oder andere nicht formatierungsbezogene Vorgänge. Wenn dieser Wert nicht bekannt ist, sollte er weggelassen werden. Das ist besser, als einen möglicherweise falschen Wert anzugeben. Beispiele: "zh-Hant", "ja", "ja-Latn", "en"
postalCode	string Optional. Postleitzahl der Adresse. Nicht in allen Ländern werden Postleitzahlen verwendet oder sind erforderlich. Wenn sie jedoch verwendet werden, können sie eine zusätzliche Validierung mit anderen Teilen der Adresse auslösen (z. B. Validierung des Bundesstaats oder der Postleitzahl in den USA).
sortingCode	string Optional. Zusätzlicher länderspezifischer Sortiercode. Dieser wird nur für wenige Regionen genutzt. Wenn er verwendet wird, ist der Wert entweder ein String wie „CEDEX“, optional gefolgt von einer Zahl (z. B. „CEDEX 7“), oder nur eine Zahl, die den „Sektorcode“ (Jamaika), den „Liefergebietsindikator“ (Malawi) oder den „Postamtsindikator“ (Côte d'Ivoire) darstellt.
administrativeArea	string Optional. Höchste administrative Untergliederung, die für Postadressen eines Landes oder einer Region verwendet wird. Dies kann beispielsweise ein Bundesland, eine Provinz, eine Oblast oder eine Präfektur sein. In Spanien ist dies die Provinz und nicht die autonome Gemeinschaft (z. B. „Barcelona“ und nicht „Katalonien“). In vielen Ländern werden in der Postadresse keine Verwaltungsgebiete verwendet. In der Schweiz sollte dieses Feld beispielsweise nicht ausgefüllt werden.
locality	string Optional. Bezieht sich im Allgemeinen auf den Ort der Adresse. Beispiele: Stadt in den USA, italienische Gemeinde, Post Town in Großbritannien. In Regionen, in denen Orte nicht klar definiert sind oder nicht gut in diese Struktur passen, lassen Sie locality leer und verwenden Sie addressLines.
sublocality	string Optional. Unterlokalität der Adresse. Das kann beispielsweise ein Stadtteil, ein Bezirk oder ein Viertel sein.
addressLines[]	string Unstrukturierte Adresszeilen, mit denen die unteren Ebenen einer Adresse beschrieben werden. Da Werte in addressLines keine Typinformationen enthalten und manchmal mehrere Werte in einem einzelnen Feld enthalten können (z. B. „Austin, TX“), ist es wichtig, dass die Zeilenreihenfolge klar ist. Die Reihenfolge der Adresszeilen sollte der „Umschlagreihenfolge“ für das Land oder die Region der Adresse entsprechen. An Orten, an denen dies variieren kann (z. B. Japan), wird address_language verwendet, um dies explizit anzugeben (z. B. „ja“ für die Reihenfolge von groß nach klein und „ja-Latn“ oder „en“ für die Reihenfolge von klein nach groß). So kann die spezifischste Zeile einer Adresse basierend auf der Sprache ausgewählt werden. Die minimal zulässige strukturelle Darstellung einer Adresse besteht aus einem regionCode, wobei alle verbleibenden Informationen in der addressLines platziert werden. Eine solche Adresse kann weitgehend angenähert ohne Geocodierung formatiert werden. Es wäre jedoch erst dann eine semantische Argumentation zu einer der Adresskomponenten möglich, wenn diese zumindest teilweise aufgelöst wird. Wenn Sie eine Adresse erstellen, die nur regionCode und addressLines enthält, und diese dann geocodieren, ist das die empfohlene Methode für vollständig unstrukturierte Adressen. Sie müssen dann nicht raten, welche Teile der Adresse Orte oder Verwaltungsgebiete sein sollen.
recipients[]	string Optional. Der Empfänger an der Adresse. Dieses Feld kann in bestimmten Fällen mehrere Zeilen lange Informationen enthalten. Beispielsweise kann es Informationen der Art "wohnhaft bei" enthalten.
organization	string Optional. Der Name der Organisation an der Adresse.