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 dieses Objekt dem WGS84-Standard 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. Sie stellt kein Modell eines geografischen Standorts (Straßen, Städte, Berge) dar.

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

Hinweise zur Eingabe / Bearbeitung von Adressen: – Verwenden Sie ein für die Internationalisierung geeignetes Adress-Widget wie https://github.com/google/libaddressinput. Nutzern sollten außerhalb der Länder, in denen dieses Feld verwendet wird, keine UI-Elemente zur Eingabe oder Bearbeitung von Feldern angezeigt 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 kein Regionscode 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 Regionscode in diesem Feld nicht noch einmal an. 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 heute 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/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 Ziffer (z. B. "CEDEX 7"), oder nur eine Ziffer für den Sektorcode (Jamaika), den Zustellbereichsindikator (Malawi) oder den Postamtindikator (z. B. Elfenbeinküste).

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 dies 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. Für die Schweiz etwa sollte dieses Feld 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 Lokalitäten nicht hinreichend definiert sind oder nicht dieser Struktur entsprechen, diese Angabe leer und verwenden Sie stattdessen "address_Lines".

sublocality

string

Optional. Unterlokalität der Adresse. Dies 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 beinhalten 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 kein region_code angegeben ist, wird die Region aus den Adresszeilen abgeleitet.

Für die Verarbeitung vollständig unstrukturierter Adressen wird empfohlen, eine Adresse zu erstellen, die nur address_lines enthält und die dann über Geocoding verarbeitet werden sollen. So muss nicht erraten werden, welche Teile der Adresse Orte oder Verwaltungsgebiete sein sollen.

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. Sie wird derzeit nicht von der Address Validation API verwendet. Derzeit werden Anfragen mit diesem Feld in der API nicht abgelehnt. Die Informationen werden jedoch verworfen und nicht in der Antwort zurückgegeben.