Package google.type

Index

LatLng

Ein Objekt, das ein Paar aus Breiten- und Längengrad darstellt. Dies wird als Paar von Double-Werten zur Darstellung von Breiten- und Längengraden ausgedrückt. 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 Adresseingabe/-bearbeitung: Verwenden Sie ein zur Internationalisierung bereites Adress-Widget wie https://github.com/google/libaddressinput. Nutzer sollten außerhalb der Länder, in denen dieses Feld verwendet wird, keine UI-Elemente für die Eingabe oder Bearbeitung von Feldern sehen.

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

Felder
revision

int32

Die Schemaversion von PostalAddress. Jeder andere Wert als 0 führt dazu, dass die API den Fehler INVALID_ARGUMENT zurückgibt.

region_code

string

Optional. CLDR-Regionscode des Landes bzw. der Region der Adresse. 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. Wenn kein Regionscode angegeben ist, wird er aus der Adresse abgeleitet. Für eine optimale Leistung wird empfohlen, den Regionscode anzugeben, wenn Sie ihn kennen. Inkonsistente oder wiederholte Regionen können zu Leistungseinbußen führen. Wenn beispielsweise address_lines die Region bereits enthält, geben Sie den Regionscode nicht noch einmal in diesem Feld ein. Unterstützte Regionen finden Sie in den häufig gestellten Fragen.

language_code

string

Der Sprachcode in der Eingabeadresse ist für eine zukünftige Verwendung reserviert und wird heute ignoriert. Die API gibt die Adresse in der Sprache zurück, in der sie sich befindet.

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 enthalten und manchmal mehrere Werte in einem einzelnen Feld enthalten sind (z.B. „Austin, TX“), muss die Zeilenreihenfolge klar erkennbar sein. Die Reihenfolge der Adresszeilen sollte der Adresse auf einem Briefumschlag für das Land bzw. die Region entsprechen.

Die mindestens zulässige strukturelle Darstellung einer Adresse besteht aus allen Informationen, die im address_lines platziert werden. Wenn region_code nicht angegeben ist, wird die Region aus den Adresszeilen abgeleitet.

Für vollständig unstrukturierte Adressen wird empfohlen, eine Adresse zu erstellen, die nur address_lines enthält, und anschließend Geocoding. So muss nicht geraten werden, welche Teile der Adresse Orte oder Verwaltungsgebiete sind.

recipients[]

string

Bitte legen Sie dieses Feld nicht fest. Die Address Validation API wird derzeit nicht verwendet. Derzeit lehnt die API Anfragen mit diesem festgelegten Feld zwar nicht ab, die Informationen werden jedoch verworfen und in der Antwort nicht zurückgegeben.

organization

string

Bitte legen Sie dieses Feld nicht fest. Die Address Validation API wird derzeit nicht verwendet. Derzeit lehnt die API Anfragen mit diesem festgelegten Feld zwar nicht ab, die Informationen werden jedoch verworfen und in der Antwort nicht zurückgegeben.