Package google.type

Index

Date

Stellt ein ganzes Kalenderdatum oder einen Teil davon dar, z. B. einen Geburtstag. Die Uhrzeit und die Zeitzone werden entweder an einer anderen Stelle angegeben oder sind nicht relevant. Das Datum bezieht sich auf den gregorianischen Kalender. Dies kann Folgendes darstellen:

  • Ein ganzes Datum mit Werten für Jahr, Monat und Tag, die nicht 0 sind
  • Einen Monat und einen Tag mit einem Jahr von 0 (z. B. einen Jahrestag)
  • Ein Jahr für sich allein, also mit einem Monat und einem Tag von 0
  • Ein Jahr und einen Monat mit einem Tag von 0 (z. B. ein Ablaufdatum der Kreditkarte)

Ähnliche Typen:

Felder
year

int32

Jahr des Datums. Der Wert muss zwischen 1 und 9999 liegen oder kann 0 sein, wenn ein Datum ohne Jahreszahl angegeben wird.
month

int32

Monat eines Jahres. Der Wert muss zwischen 1 und 12 liegen. Er kann auch 0 sein, wenn ein Jahr ohne Monat und Tag angegeben wird.
day

int32

Tag eines Monats. Der Wert muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein. Er kann auch 0 sein, wenn das Jahr bzw. der Monat angegeben wird, der Tag selbst jedoch nicht relevant ist.

DayOfWeek

Steht für einen Wochentag.

Enums
DAY_OF_WEEK_UNSPECIFIED Der Wochentag ist nicht angegeben.
MONDAY Montag
TUESDAY Dienstag
WEDNESDAY Mittwoch
THURSDAY Donnerstag
FRIDAY Freitag
SATURDAY Samstag
SUNDAY Sonntag

Intervall

Stellt ein Zeitintervall dar, das als Zeitstempelstart (einschließlich) und Zeitstempelende (ausschließlich) codiert ist.

Der Start muss kleiner oder gleich dem Ende sein. Wenn der Start dem Ende entspricht, ist das Intervall leer (die Zeit ist null). Wenn sowohl der Start als auch das Ende nicht angegeben sind, entspricht das Intervall einer beliebigen Zeit.

Felder
start_time

Timestamp

Optional. Eingeschlossener Start des Intervalls.

Wenn angegeben, muss ein Zeitstempel, der diesem Intervall entspricht, gleich dem Start sein oder darauf folgen.
end_time

Timestamp

Optional. Ausgeschlossenes Ende des Intervalls.

Wenn angegeben, muss ein Zeitstempel, der diesem Intervall entspricht, vor dem Ende liegen.

LatLng

Ein Objekt, das ein Paar aus Breiten- und Längengrad darstellt. Es wird als Paar aus Werten vom Typ „Double“ (Breiten- und Längengrad) ausgedrückt. Sofern nicht anders angegeben, muss es dem World Geodetic System 1984 (WGS 84) entsprechen. Die Werte müssen in normalisierten Bereichen 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.

Geld

Stellt einen Geldbetrag mit Währungstyp dar

Felder
currency_code

string

Der aus drei Buchstaben bestehende Währungscode gemäß ISO 4217.
units

int64

Die ganzen Einheiten des Betrags. Wenn currencyCode beispielsweise "USD" ist, entspricht 1 Einheit einem US-Dollar.
nanos

int32

Anzahl der Nanoeinheiten (10^-9) des Betrags. Der Wert muss im Bereich von -999.999.999 bis +999.999.999 liegen. Wenn units positiv ist, muss nanos positiv oder null sein. Wenn units null ist, kann nanos positiv, null oder negativ sein. Wenn units negativ ist, muss nanos negativ oder null sein. Beispiel: -1,75 $ wird als units=-1 und nanos=-750.000.000 dargestellt.

PostalAddress

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.

Felder
revision

int32

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.
region_code

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.
language_code

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"
postal_code

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).
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 „Liefergebietsindikator“ (Malawi) oder den „Postamtsindikator“ (Côte d'Ivoire) 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 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 address_lines.
sublocality

string

Optional. Unterlokalität der Adresse. Das kann beispielsweise ein Stadtteil, ein Bezirk oder ein Viertel sein.
address_lines[]

string

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

Da Werte in address_lines 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 region_code, wobei alle verbleibenden Informationen in der address_lines 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 region_code und address_lines 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.

TimeOfDay

Stellt eine Tageszeit dar. Das Datum und die Zeitzone sind entweder nicht relevant oder werden an anderer Stelle angegeben. Eine API kann Schaltsekunden zulassen. Vergleichbare Typen sind google.type.Date und google.protobuf.Timestamp.

Felder
hours

int32

Stunden im 24-Stunden-Format. Muss größer oder gleich 0 und in der Regel kleiner oder gleich 23 sein. Eine API kann den Wert "24:00:00" für Szenarien wie Geschäftsschlusszeit zulassen.
minutes

int32

Minuten einer Stunde. Muss größer oder gleich 0 und kleiner oder gleich 59 sein.
seconds

int32

Sekunden einer Minute. Muss größer oder gleich 0 und normalerweise kleiner oder gleich 59 sein. Eine API kann den Wert 60 zulassen, wenn sie Schaltsekunden zulässt.
nanos

int32

Sekundenbruchteile in Nanosekunden. Muss größer oder gleich 0 und kleiner oder gleich 999.999.999 sein.

TimeZone

Stellt eine Zeitzone aus der IANA-Zeitzonendatenbank dar.

Felder
id

string

Zeitzone aus der IANA-Zeitzonendatenbank. Beispiel: „America/New_York“
version

string

Optional. Versionsnummer aus der IANA-Zeitzonendatenbank. Beispiel: „2019a“