Method: validateAddress

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

integer

Die Schemaüberarbeitung von PostalAddress. Bei allen Werten außer 0 wird von der API der Fehler INVALID_ARGUMENT zurückgegeben.

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/additional/Territory_information.html. Beispiel: "CH" für die Schweiz. Wenn der Regionscode nicht angegeben ist, wird er von der Adresse abgeleitet. Für eine optimale Leistung sollten Sie den Regionscode angeben, wenn Sie ihn kennen. Inkonsistente oder wiederholte Regionen können zu Leistungseinbußen führen. Wenn der addressLines beispielsweise bereits die Region enthält, geben Sie den Regionscode nicht noch einmal in dieses Feld ein. Unterstützte Regionen finden Sie in den FAQs.

string

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

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.

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

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.

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 "addressLines".

string

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

string

Erforderlich. 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 sind (z.B. „Austin, TX“), ist es wichtig, dass die Zeilenreihenfolge klar ist. Die Reihenfolge der Adresszeilen sollte der Adresse auf einem Briefumschlag für das Land bzw. die Region entsprechen.

Die geringste zulässige Struktur einer Adresse besteht aus allen Informationen, die in die addressLines aufgenommen werden. Wenn kein regionCode angegeben ist, wird die Region aus den Adresszeilen abgeleitet.

Wir empfehlen, eine Adresse zu erstellen, die nur addressLines enthält, und dann das Geocoding, um vollständig unstrukturierte Adressen zu verarbeiten. So müssen Sie nicht raten, welche Teile der Adresse Orte oder Verwaltungsgebiete umfassen.

string

Bitte lege dieses Feld nicht fest. Die Address Validation API verwendet sie derzeit nicht. Derzeit lehnt die API Anfragen mit diesem Feld nicht ab. Die Informationen werden jedoch verworfen und in der Antwort nicht zurückgegeben.

string

Bitte lege dieses Feld nicht fest. Die Address Validation API verwendet sie derzeit nicht. Derzeit lehnt die API Anfragen mit diesem Feld nicht ab. Die Informationen werden jedoch verworfen und in der Antwort nicht zurückgegeben.

{
  "verdict": {
    object (Verdict)
  },
  "address": {
    object (Address)
  },
  "geocode": {
    object (Geocode)
  },
  "metadata": {
    object (AddressMetadata)
  },
  "uspsData": {
    object (UspsData)
  }
}

object (Verdict)

Meldungen zum Urteil insgesamt

object (Address)

Informationen zur Adresse selbst, nicht zum Geocode

object (Geocode)

Informationen zum Ort und Ort, an den die Adresse geocodiert wurde.

object (AddressMetadata)

Sonstige für die Bereitstellung relevante Informationen. Es ist nicht garantiert, dass metadata bei jeder Adresse, die an die Address Validation API gesendet wird, vollständig ausgefüllt ist.

object (UspsData)

Zusätzliche Zustellungsflags von USPS. Nur in den Regionen US und PR angegeben.

{
  "inputGranularity": enum (Granularity),
  "validationGranularity": enum (Granularity),
  "geocodeGranularity": enum (Granularity),
  "addressComplete": boolean,
  "hasUnconfirmedComponents": boolean,
  "hasInferredComponents": boolean,
  "hasReplacedComponents": boolean
}

enum (Granularity)

Der Detaillierungsgrad der Eingabeadresse. Das ist das Ergebnis des Parsens der Eingabeadresse und liefert keine Validierungssignale. Informationen zu Validierungssignalen finden Sie unten im Abschnitt validationGranularity.

Wenn die Eingabeadresse beispielsweise eine bestimmte Wohnungsnummer enthält, ist inputGranularity hier SUB_PREMISE. Wenn wir die Wohnungsnummer in den Datenbanken nicht abgleichen können oder die Wohnungsnummer ungültig ist, beträgt die validationGranularity wahrscheinlich PREMISE oder niedriger.

enum (Granularity)

Der Detaillierungsgrad, mit dem die API die Adresse vollständig überprüfen kann. Beispiel: validationGranularity mit PREMISE gibt an, dass alle Adresskomponenten auf der Ebene PREMISE oder mehr grob validiert werden können.

Das Ergebnis der Überprüfung der Adresskomponenten findest du unter google.maps.addressvalidation.v1.Address.address_components.

enum (Granularity)

Informationen zum Detaillierungsgrad von geocode. Dies kann als die semantische Bedeutung von grobem und fein abgestimmtem Standort interpretiert werden.

Dies kann gelegentlich von den oben genannten validationGranularity abweichen. So kann beispielsweise in unserer Datenbank das Vorhandensein einer Wohnungsnummer erfasst werden, Sie haben jedoch keinen genauen Standort für diese Wohnung in einer großen Wohnanlage. In diesem Fall ist validationGranularity SUB_PREMISE, geocodeGranularity jedoch PREMISE.

boolean

Die Adresse wird als vollständig betrachtet, wenn es keine unaufgelösten Tokens oder keine unerwarteten oder fehlenden Adresskomponenten gibt. Weitere Informationen findest du in den Feldern missingComponentTypes, unresolvedTokens und unexpected.

boolean

Mindestens eine Adresskomponente kann nicht kategorisiert oder validiert werden. Weitere Informationen finden Sie unter google.maps.addressvalidation.v1.Address.address_components.

boolean

Mindestens eine Adresskomponente wurde abgeleitet (hinzugefügt), die nicht in der Eingabe enthalten war. Weitere Informationen finden Sie unter google.maps.addressvalidation.v1.Address.address_components.

boolean

Mindestens eine Adresskomponente wurde ersetzt. Weitere Informationen finden Sie unter google.maps.addressvalidation.v1.Address.address_components.

{
  "formattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "missingComponentTypes": [
    string
  ],
  "unconfirmedComponentTypes": [
    string
  ],
  "unresolvedTokens": [
    string
  ]
}

string

Die nach der Bearbeitungszeit verarbeitete Adresse, die als einzeilige Adresse gemäß den Formatierungsregeln für Regionen registriert ist, in denen sich die Adresse befindet.

object (PostalAddress)

Die nachträglich verarbeitete Adresse als Postanschrift.

object (AddressComponent)

Nicht sortierte Liste. Die einzelnen Adresskomponenten der formatierten und korrigierten Adresse zusammen mit Validierungsinformationen. Hier finden Sie Informationen zum Überprüfungsstatus der einzelnen Komponenten.

Adresskomponenten sind nicht in einer bestimmten Reihenfolge angeordnet. Nehmen Sie in der Liste keine Annahmen zur Reihenfolge der Adresskomponenten in der Liste an.

string

Die Komponentenkomponenten, die in einer korrekt formatierten Postanschrift vorhanden waren, aber nicht in der Eingabe gefunden wurden, konnten nicht abgeleitet werden. Komponenten dieses Typs sind in formattedAddress, postalAddress oder addressComponents nicht vorhanden. Ein Beispiel wäre ['street_number', 'route'] für eine Eingabe wie „Boulder, Colorado, 80301, USA“. Eine Liste der möglichen Typen finden Sie hier.

string

Die Arten der Komponenten, die in der addressComponents vorhanden sind, aber nicht als korrekt identifiziert werden konnten. Dieses Feld ist nur der Einfachheit halber vorgesehen. Der Inhalt entspricht dem Durchlaufen von addressComponents, um die Typen aller Komponenten zu finden, bei denen confirmationLevel nicht CONFIRMED ist oder das Flag inferred nicht auf true gesetzt ist. Eine Liste der möglichen Typen finden Sie hier.

string

Alle Tokens in der Eingabe, die nicht aufgelöst werden konnten. Das kann eine Eingabe sein, die nicht als gültiger Teil einer Adresse erkannt wurde. Beispielsweise kann bei einer Eingabe wie „123235253253 Main St, San Francisco, CA, 94105,“ der Status „Nicht aufgelöst“ nicht gültig sein, da dies keine gültige Hausnummer ist.

{
  "componentName": {
    object (ComponentName)
  },
  "componentType": string,
  "confirmationLevel": enum (ConfirmationLevel),
  "inferred": boolean,
  "spellCorrected": boolean,
  "replaced": boolean,
  "unexpected": boolean
}

object (ComponentName)

Der Name dieser Komponente.

string

Der Typ der Adresskomponente. Eine Liste der möglichen Typen finden Sie unter Tabelle 2: Zusätzliche vom Places-Dienst zurückgegebene Typen.

enum (ConfirmationLevel)

Gibt an, wie sicher es ist, dass die Komponente korrekt ist

boolean

Gibt an, dass die Komponente nicht Teil der Eingabe war, wir sie aber für den Standort der Adresse abgeleitet haben und glauben, dass sie für eine vollständige Adresse angegeben werden sollte.

boolean

Gibt an, dass der Name der Komponente geringfügig korrigiert wurde, z. B. indem zwei Zeichen in der falschen Reihenfolge geändert wurden. Dies weist auf eine kosmetische Änderung hin.

boolean

Gibt an, dass der Name der Komponente durch eine völlig neue ersetzt wurde, z. B. eine falsche Postleitzahl durch eine korrekte Adresse für die Adresse. Dies ist keine kosmetische Änderung, die Eingabekomponente wurde in eine andere geändert.

boolean

Gibt eine Adresskomponente an, die voraussichtlich nicht in einer Postanschrift für die angegebene Region vorhanden ist. Wir haben es nur aufbewahrt, weil es Teil der Eingabe war.

{
  "text": string,
  "languageCode": string
}

string

Name Beispiel: „5th Avenue“ für einen Straßennamen oder „1253“ für eine Hausnummer.

string

Der BCP-47-Sprachcode. Diese Option ist nicht verfügbar, wenn der Komponentenname nicht mit einer Sprache verknüpft ist, z. B. eine Hausnummer.

{
  "location": {
    object (LatLng)
  },
  "plusCode": {
    object (PlusCode)
  },
  "bounds": {
    object (Viewport)
  },
  "featureSizeMeters": number,
  "placeId": string,
  "placeTypes": [
    string
  ]
}

object (LatLng)

Der geocodierte Standort der Eingabe.

Die Verwendung von Orts-IDs wird gegenüber Adressen, Breiten- und Längengradkoordinaten oder Plus Codes bevorzugt. Wenn Sie bei der Routenplanung oder beim Berechnen von Routen die Koordinaten verwenden, wird der Punkt immer auf die nächstgelegene Straße ausgerichtet. Dies ist möglicherweise keine Straße, die schnell oder sicher zum Ziel führt und sich nicht in der Nähe eines Zugangspunkts zum Hotel befindet. Wenn Sie für einen Standort das umgekehrte Geocoding verwenden, ist nicht garantiert, dass die zurückgegebene Adresse mit dem Original übereinstimmt.

object (PlusCode)

Der Pluscode für location.

object (Viewport)

Die Grenzen des geocodierten Ortes.

number

Die Größe des geocodierten Ortes in Metern. Dies ist ein weiteres Maß für die Grobheit des geocodierten Standorts, jedoch in der physischen Größe und nicht in der semantischen Bedeutung.

string

Die PlaceID des Orts, an dem diese Eingabe geocodiert wird

Weitere Informationen zu Orts-IDs

string

Die Ortstypen, an die die Eingabe geocodiert werden soll. Beispiel: ['locality', 'political']. Eine vollständige Liste der Typen finden Sie hier.

{
  "latitude": number,
  "longitude": number
}

number

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

number

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

{
  "globalCode": string,
  "compoundCode": string
}

string

Globaler (vollständiger) Code des Ortes, z. B. „9FWM33GV+HQ“, was eine Fläche von 1/8000 x 1/8000 Grad darstellt (~14 x 14 Meter)

string

Zusammengesetzter Code des Ortes, z. B. "33GV+HQ, Ramberg, Norwegen", mit dem Suffix des globalen Codes und Ersetzen des Präfixes durch einen formatierten Namen einer Referenzentität.

{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}

object (LatLng)

Erforderlich. Der niedrige Punkt des Darstellungsbereichs.

object (LatLng)

Erforderlich. Der Höhepunkt des Darstellungsbereichs.

{
  "business": boolean,
  "poBox": boolean,
  "residential": boolean
}

boolean

Gibt an, dass dies die Adresse eines Unternehmens ist. Wenn die Richtlinie nicht konfiguriert ist, bedeutet das, dass der Wert unbekannt ist.

boolean

Gibt die Adresse eines Postfachs an. Wenn die Richtlinie nicht konfiguriert ist, bedeutet das, dass der Wert unbekannt ist.

boolean

Gibt an, dass dies die Adresse eines Wohnsitzes ist. Wenn die Richtlinie nicht konfiguriert ist, bedeutet das, dass der Wert unbekannt ist.

{
  "standardizedAddress": {
    object (UspsAddress)
  },
  "deliveryPointCode": string,
  "deliveryPointCheckDigit": string,
  "dpvConfirmation": string,
  "dpvFootnote": string,
  "dpvCmra": string,
  "dpvVacant": string,
  "dpvNoStat": string,
  "carrierRoute": string,
  "carrierRouteIndicator": string,
  "ewsNoMatch": boolean,
  "postOfficeCity": string,
  "postOfficeState": string,
  "abbreviatedCity": string,
  "fipsCountyCode": string,
  "county": string,
  "elotNumber": string,
  "elotFlag": string,
  "lacsLinkReturnCode": string,
  "lacsLinkIndicator": string,
  "poBoxOnlyPostalCode": boolean,
  "suitelinkFootnote": string,
  "pmbDesignator": string,
  "pmbNumber": string,
  "addressRecordType": string,
  "defaultAddress": boolean,
  "errorMessage": string,
  "cassProcessed": boolean
}

object (UspsAddress)

USPS-standardisierte Adresse.

string

2-stelliger Lieferpunktcode

string

Die Prüfziffer des Lieferpunkts. Diese Nummer wird am Ende des delivery_point_barcode für mechanisch gescannte E-Mails hinzugefügt. Wenn alle Zahlen aus „delivery_point_barcode“, „deliveryPointCheckDigit“, „zip“ und „Zip+4“ addiert werden, muss die Zahl durch 10 geteilt werden.

string

Mögliche Werte für die DPV-Bestätigung. Gibt ein einzelnes Zeichen zurück.

• Y: Die Adresse wurde für die primäre und sekundäre Nummern bereits bestätigt.
• N: Primäre und sekundäre Informationen konnten nicht von der DPV bestätigt werden.
• S: Die Adresse wurde nur für die primäre Nummer bestätigt, die sekundäre Nummer war aber nicht vorhanden.
• D: Die Adresse wurde nur für die primäre Nummer bestätigt, die Informationen zur sekundären Nummer fehlten.

string

Die Fußnoten aus der Validierung des Lieferpunkts. Mehrere Fußnoten können in einem String miteinander verbunden sein.

• AA: Eingabeadresse, die mit der ZIP-Datei + 4 übereinstimmt
• A1: Die eingegebene Adresse wurde nicht mit der ZIP-Datei 4 abgeglichen
• BB: an DPV angepasst (alle Komponenten)
• CC: Keine sekundäre Telefonnummer (entspricht, aber ungültig)
• N1: In einer Hochhaus-Adresse fehlt die sekundäre Nummer
• M1: Primäre Nummer fehlt
• M3: Primäre Nummer ungültig
• P1: Fehlende RR- oder HC-Feldnummer der Eingabe
• P3: Postfach-, RR- oder HC-Feldnummer ist ungültig
• F1: Eingabeadresse entspricht einer Militäradresse
• G1: Eingabeadresse, die mit einer allgemeinen Lieferadresse übereinstimmt
• U1: Eingabeadresse entspricht einer eindeutigen Postleitzahl
• PB: Eingabeadresse entspricht PBSA-Eintrag
• RR: DPV-bestätigte Adresse mit PMB-Informationen
• R1: DPV-bestätigte Adresse ohne PMB-Informationen
• R7: Carrier Route R777- oder R779-Eintrag

string

Gibt an, ob die Adresse eine CMRA (Commercial Mail Received Agency) ist, also ein privates Unternehmen, das E-Mails für Kunden empfängt. Gibt ein einzelnes Zeichen zurück.

• Y: Die Adresse ist ein CMRA
• N: Die Adresse ist kein CMRA

string

Ist dieser Ort leer? Gibt ein einzelnes Zeichen zurück.

• Y: Die Adresse ist leer
• N: Die Adresse ist nicht leer

string

Ist das eine Adresse ohne Statistik oder eine aktive Adresse? Statistikadressen sind solche, die nicht kontinuierlich besetzt sind oder an denen der USPS nicht bedient wird. Gibt ein einzelnes Zeichen zurück.

• Y: Die Adresse ist nicht aktiv
• N: Die Adresse ist aktiv

string

Der Routencode des Transportunternehmens. Ein Code aus vier Zeichen, der aus einem einstelligen Präfix und einer dreistelligen Routenbezeichnung besteht.

Präfixe:

• C: Fluggesellschaft (oder Stadtroute)
• R: Landstraße
• H: Autobahn-Vertragsroute
• B: Abschnitt „Postfach“
• G: Allgemeine Auslieferungseinheit

string

Anzeige zur Sortierung der vom Transportunternehmen berechneten Preise.

boolean

Die Lieferadresse kann abgeglichen werden, die EWS-Datei gibt jedoch an, dass eine genaue Übereinstimmung bald verfügbar sein wird.

string

Stadt in der Hauptpoststelle.

string

Hauptpostamt

string

Abgekürzte Stadt.

string

FIPS County-Code.

string

Name des Landkreises.

string

eLOT-Nummer (Extended Line of Travel)

string

eLOT Aufsteigende/absteigende Flagge (A/D).

string

LACSLink-Rückgabecode.

string

LACSLink-Indikator.

boolean

Nur Postfach.

string

Fußnoten vom Abgleich einer Straße oder eines Hochhauses mit Informationen zur Suite. Wenn eine Übereinstimmung mit dem Namen des Unternehmens gefunden wird, wird die sekundäre Nummer zurückgegeben.

• A: Übereinstimmung von SuiteLink-Eintrag und Geschäftsadresse verbessert.
• 00: Keine Übereinstimmung. Die Adresse des Unternehmens wird nicht verbessert.

string

PMB (Private Postfach) Gerätekennzeichnung.

string

PMB-Nummer (Private Mail Box)

string

Typ des Adresseintrags, der mit der Eingabeadresse übereinstimmt.

• F: FIRM Dies ist eine Übereinstimmung mit einem festen Datensatz, der besten verfügbaren Übereinstimmungsstufe für eine Adresse.
• G: ALLGEMEINE LIEFERUNG. Dies ist eine Übereinstimmung mit einem General Delivery-Datensatz.
• H: BAUER / EINHEIT. Dies ist eine Übereinstimmung mit einem Gebäude- oder Wohnungseintrag.
• P: POST POSTEINGANG. Dies ist eine Übereinstimmung mit einer Briefkasten.
• R: RURAL ROUTE oder HIGHWAY CONTRACT: Dies ist eine Übereinstimmung mit einer ländlichen Route oder einem Highway-Vertrag, die beide Nummernbereiche für Box-Nummern haben können.
• S: STREET RECORD – Übereinstimmung mit einem Street Record-Eintrag mit einem gültigen primären Nummernbereich.

boolean

Zeigt an, dass eine Standardadresse gefunden wurde, aber spezifischere Adressen vorhanden sind.

string

Fehlermeldung für den Abruf von USPS-Daten. Wird automatisch ausgefüllt, wenn die USPS-Verarbeitung aufgrund der Erkennung künstlich erstellter Adressen ausgesetzt wird.

Die USPS-Datenfelder werden möglicherweise nicht ausgefüllt, wenn dieser Fehler vorhanden ist.

boolean

Zeigt an, dass die Anfrage verarbeitet wurde.

{
  "firstAddressLine": string,
  "firm": string,
  "secondAddressLine": string,
  "urbanization": string,
  "cityStateZipAddressLine": string,
  "city": string,
  "state": string,
  "zipCode": string,
  "zipCodeExtension": string
}

string

Erste Adresszeile.

string

Firmenname.

string

Zweite Adresszeile.

string

Puerto-ricanischer Urbanisierungsname.

string

Stadt + Bundesland + Postleitzahl.

string

Stadt

string

2-stelliger Bundesstaatcode

string

Postleitzahl, z.B. 10009.

string

4-stellige Postleitzahlerweiterung, z.B. 5023.