Package google.type

Index

LatLng

Ein Objekt, das ein Paar aus Breiten- und Längengrad darstellt. Es wird als Paar von Double-Werten ausgedrückt, die für den Breitengrad und den Längengrad stehen. Sofern nicht anders angegeben, muss es dem World Geodetic System 1984 (WGS 84) entsprechen. Die Werte müssen innerhalb normalisierter Bereiche liegen.

Felder
latitude

double

Der Breitengrad in Grad. Er muss im Bereich [-90,0, +90,0] liegen.

longitude

double

Der Längengrad in Grad. Er muss im Bereich [-180,0, +180,0] liegen.

PostalAddress

Stellt eine Postadresse dar, z. B. für Postzustellungs- oder Zahlungsadressen. Mit einer Postadresse kann ein Postdienst Artikel an eine Einrichtung, ein Postfach oder eine andere Adresse liefern. Eine Postanschrift ist nicht dazu gedacht, geografische Standorte wie Straßen, Städte oder Berge zu modellieren.

Normalerweise wird eine Adresse je nach Prozesstyp durch eine Nutzereingabe oder den Import vorhandener Daten erstellt.

Tipps zur Eingabe oder Bearbeitung von Adressen:

  • Verwenden Sie ein internationalisierungsfähiges Address Widget wie https://github.com/google/libaddressinput.
  • Nutzer sollten nur UI-Elemente für die Eingabe oder Bearbeitung von Feldern sehen, die in ihrem Land verwendet werden.

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

Felder
revision

int32

Die Schemaversion der PostalAddress. Bei einem anderen Wert als 0 gibt die API den Fehler INVALID_ARGUMENT zurück.

region_code

string

Optional. CLDR-Regionscode des Landes bzw. der Region der Adresse. Ausführliche 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. Wenn der Regionscode nicht angegeben ist, wird er aus der Adresse abgeleitet. Für eine optimale Leistung wird empfohlen, die Regionscodes anzugeben, sofern bekannt. Inkonsistente oder wiederholte Regionen können zu einer schlechten Leistung führen. Wenn die address_lines beispielsweise bereits die Region enthält, geben Sie die Regionscodes nicht noch einmal in dieses Feld ein. Eine Liste der unterstützten Regionen finden Sie in den häufig gestellten Fragen.

language_code

string

Der Sprachcode in der Eingabeadresse ist für zukünftige Verwendungen reserviert und wird derzeit ignoriert. Die API gibt die Adresse in der Sprache zurück, die für den Standort der Adresse geeignet ist.

postal_code

string

Optional. Postleitzahl der Adresse. Postleitzahlen werden nicht in allen Ländern verwendet oder benötigt. Dort, wo sie verwendet werden, können sie weitere Validierungsvorgänge für andere Adressteile nach sich ziehen, z. B. die Validierung von Bundesstaat oder Postleitzahl in den USA.

sorting_code

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 „Lieferbereichscode“ (Malawi) oder den „Postamtscode“ (Elfenbeinküste) darstellt.

administrative_area

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 das beispielsweise die Provinz und nicht das autonome Gebiet, also z. B. „Barcelona“ und nicht „Katalonien“. In vielen Ländern werden in der Postadresse keine Verwaltungsgebiete verwendet. In der Schweiz sollte dieses Feld beispielsweise leer gelassen werden.

locality

string

Optional. Bezieht sich in der Regel auf die Stadt-/Ortsangabe der Adresse. Beispiele: Stadt in den USA, italienische Gemeinde, Post Town in Großbritannien. Lassen Sie in Regionen der Welt, in denen Postorte nicht hinreichend definiert sind oder nicht dieser Struktur entsprechen, locality leer und verwenden Sie stattdessen address_lines.

sublocality

string

Optional. Unterlokalität der Adresse. Ortsteile können beispielsweise Stadtviertel, Stadtteile und Bezirke sein.

address_lines[]

string

Erforderlich. Unstrukturierte Adresszeilen, mit denen die unteren Ebenen einer Adresse beschrieben werden.

Da die Werte in „address_lines“ keine Typinformationen enthalten und manchmal mehrere Werte in einem einzigen Feld enthalten sind, z.B. „Austin, TX“, muss die Zeilenreihenfolge deutlich erkennbar sein. Die Reihenfolge der Adresszeilen sollte der Adresse auf einem Briefumschlag für das Land bzw. die Region entsprechen.

Die Mindestangabe für eine zulässige strukturierte Darstellung einer Adresse besteht aus allen Informationen in address_lines. Wenn region_code nicht angegeben ist, wird die Region aus den Adresszeilen abgeleitet.

Es empfiehlt sich, für vollständig unstrukturierte Adressen eine Adresse mit nur address_lines zu erstellen und danach eine Geocodierung dafür durchzuführen. So muss nicht geraten werden, welche Teile der Adresse Orte oder Verwaltungsgebiete darstellen.

recipients[]

string

Legen Sie dieses Feld nicht fest. Die Address Validation API verwendet sie derzeit nicht. Derzeit werden Anfragen mit diesem Feld in der API nicht abgelehnt. Die Informationen werden jedoch verworfen und nicht in der Antwort zurückgegeben.

organization

string

Legen Sie dieses Feld nicht fest. Die Address Validation API verwendet sie derzeit nicht. Derzeit werden Anfragen mit diesem Feld in der API nicht abgelehnt. Die Informationen werden jedoch verworfen und nicht in der Antwort zurückgegeben.