Package google.maps.addressvalidation.v1

Index

AddressValidation

Der Dienst zur Validierung von Adressen.

ProvideValidationFeedback

rpc ProvideValidationFeedback(ProvideValidationFeedbackRequest) returns (ProvideValidationFeedbackResponse)

Feedback zum Ergebnis der Validierungsversuche. Dies sollte der letzte Aufruf nach einer Reihe von Validierungsaufrufen für dieselbe Adresse sein und sollte aufgerufen werden, sobald die Transaktion abgeschlossen ist. Dieser Wert sollte nur einmal für die Abfolge von ValidateAddress Anfragen gesendet werden, die zur vollständigen Bestätigung einer Adresse erforderlich sind.
ValidateAddress

rpc ValidateAddress(ValidateAddressRequest) returns (ValidateAddressResponse)

Validiert eine Adresse.

Adresse

Details zur nachbehandelten Adresse. Die Nachbearbeitung umfasst das Korrigieren falsch geschriebener Teile der Adresse, das Ersetzen falscher Teile und das Erschließen fehlender Teile.

Felder
formatted_address

string

Die nachbehandelte Adresse, formatiert als eine Zeile gemäß den Adressformatierungsregeln der Region, in der sich die Adresse befindet.

Hinweis: Das Format dieser Adresse stimmt möglicherweise nicht mit dem Format der Adresse im Feld postal_address überein. Beispiel: Der postal_address steht immer für das Land als zweistelliger region_code, z. B. „DE“ oder „NZ“. In diesem Feld wird dagegen eine längere Form des Landesnamens verwendet, z. B. „USA“ oder „Neuseeland“.
postal_address

PostalAddress

Die nachbehandelte Adresse als Postadresse.
address_components[]

AddressComponent

Unsortierte Liste. Die einzelnen Adresskomponenten der formatierten und korrigierten Adresse sowie Validierungsinformationen. Hier finden Sie Informationen zum Validierungsstatus der einzelnen Komponenten.

Die Adresskomponenten sind nicht in einer bestimmten Reihenfolge angeordnet. Gehen Sie nicht davon aus, dass die Adresskomponenten in der Liste in einer bestimmten Reihenfolge angeordnet sind.
missing_component_types[]

string

Die Arten von Komponenten, die in einer korrekt formatierten Postanschrift vorhanden sein sollten, aber nicht in der Eingabe gefunden wurden ODER nicht abgeleitet werden konnten. 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.

Hinweis: Möglicherweise wird ein fehlender Komponententyp angezeigt, obwohl Sie der Meinung sind, dass Sie die fehlende Komponente bereits angegeben haben. Das kann beispielsweise passieren, wenn die eingegebene Adresse den Namen des Gebäudes, aber nicht die Hausnummer enthält. In der Adresse „渋谷区渋谷３丁目　Shibuya Stream“ hat der Gebäudename „Shibuya Stream“ den Komponententyp premise, aber die Gebäudenummer fehlt. Daher enthält missing_component_types premise.
unconfirmed_component_types[]

string

Die Typen der Komponenten, die in der address_components vorhanden sind, deren Richtigkeit jedoch nicht bestätigt werden konnte. Dieses Feld dient der Bequemlichkeit: Sein Inhalt entspricht einer Iteration durch die address_components, um die Typen aller Komponenten zu finden, bei denen confirmation_level nicht CONFIRMED ist oder das inferred-Flag nicht auf true gesetzt ist. Eine Liste der möglichen Typen finden Sie hier.
unresolved_tokens[]

string

Alle Tokens in der Eingabe, die nicht aufgelöst werden konnten. Möglicherweise wurde eine Eingabe nicht als gültiger Teil einer Adresse erkannt. Bei einer Eingabe wie „Parcel 0000123123 & 0000456456 Str # Guthrie Center IA 50115 US“ sehen die nicht aufgelösten Tokens beispielsweise so aus: ["Parcel", "0000123123", "&", "0000456456"].

AddressComponent

Stellt eine Adresskomponente dar, z. B. eine Straße, eine Stadt oder ein Bundesland.

Felder
component_name

ComponentName

Der Name dieser Komponente.
component_type

string

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

ConfirmationLevel

Gibt an, wie sicher wir sind, dass die Komponente korrekt ist.
inferred

bool

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

bool

Gibt eine Korrektur einer Rechtschreibfehler im Komponentennamen an. Die API meldet nicht immer Änderungen von einer Schreibvariante zu einer anderen, z. B. wenn „Zentrum“ in „Zentrum“ geändert wird. Außerdem werden nicht immer häufige Rechtschreibfehler gemeldet, z. B. wenn „Amphitheater Pkwy“ in „Amphitheatre Pkwy“ geändert wird.
replaced

bool

Gibt an, dass der Name der Komponente durch einen völlig anderen ersetzt wurde, z. B. eine falsche Postleitzahl durch eine, die für die Adresse korrekt ist. Das ist keine kosmetische Änderung, sondern die Eingabekomponente wurde durch eine andere ersetzt.
unexpected

bool

Gibt eine Adresskomponente an, die in einer Postanschrift für die angegebene Region nicht vorhanden sein sollte. Wir haben sie nur beibehalten, weil sie Teil der Eingabe war.

ConfirmationLevel

Die verschiedenen möglichen Werte für Bestätigungsstufen.

Enums
CONFIRMATION_LEVEL_UNSPECIFIED Standardwert Dieser Wert wird nicht verwendet.
CONFIRMED Wir konnten bestätigen, dass diese Komponente vorhanden ist und im Kontext der restlichen Adresse Sinn ergibt.
UNCONFIRMED_BUT_PLAUSIBLE Diese Komponente konnte nicht bestätigt werden, es ist aber wahrscheinlich, dass sie vorhanden ist. Beispiel: Eine Hausnummer innerhalb eines bekannten gültigen Zahlenbereichs in einer Straße, in der bestimmte Hausnummern nicht bekannt sind.
UNCONFIRMED_AND_SUSPICIOUS Diese Komponente wurde nicht bestätigt und ist wahrscheinlich falsch. Beispielsweise ein Stadtteil, der nicht zum Rest der Adresse passt.

AddressMetadata

Die Metadaten für die nachbehandelte Adresse. Es kann nicht garantiert werden, dass metadata für jede an die Address Validation API gesendete Adresse vollständig ausgefüllt ist.

Felder
business

bool

Gibt an, dass es sich um die Adresse eines Unternehmens handelt. Wenn dieser Parameter nicht festgelegt ist, ist der Wert unbekannt.
po_box

bool

Gibt an, dass es sich um die Adresse eines Postfachs handelt. Wenn dieser Parameter nicht festgelegt ist, ist der Wert unbekannt.
residential

bool

Gibt an, dass es sich um die Adresse eines Privathauses handelt. Wenn dieser Parameter nicht festgelegt ist, ist der Wert unbekannt.

ComponentName

Ein Wrapper für den Namen der Komponente.

Felder
text

string

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

string

Der BCP-47-Sprachcode. Dieser Wert ist nicht vorhanden, wenn der Komponentenname nicht mit einer Sprache verknüpft ist, z. B. bei einer Hausnummer.

Geocode

Enthält Informationen zum Ort, zu dem die Eingabe geocodiert wurde.

Felder
location

LatLng

Der geocodierte Standort der Eingabe.

Die Verwendung von Orts-IDs wird gegenüber der Verwendung von Adressen, Breiten- und Längengraden oder Plus Codes empfohlen. Wenn Sie beim Berechnen von Routen oder Wegbeschreibungen Koordinaten verwenden, wird der Punkt immer an der Straße angedockt, die diesen Koordinaten am nächsten ist. Diese Straße führt möglicherweise nicht schnell oder sicher zum Ziel und befindet sich möglicherweise nicht in der Nähe eines Zugangs zum Grundstück. Außerdem gibt es keine Garantie dafür, dass die zurückgegebene Adresse mit der ursprünglichen Adresse übereinstimmt, wenn ein Standort umgekehrt geocodiert wird.
plus_code

PlusCode

Der Plus Code, der der location entspricht.
bounds

Viewport

Die Grenzen des geocodierten Orts.
feature_size_meters

float

Die Größe des geocodierten Orts in Metern. Dies ist ein weiteres Maß für die Grobheit des geocodierten Standorts, jedoch in Bezug auf die physische Größe und nicht auf die semantische Bedeutung.
place_id

string

Die PlaceID des Orts, zu dem diese Eingabe geocodiert wird.

Weitere Informationen zu Orts-IDs
place_types[]

string

Die Art des Orts, zu dem die Eingabe geocodiert wurde. Beispiel: ['locality', 'political']. Eine vollständige Liste der Typen finden Sie hier.

LanguageOptions

Vorabversion: Diese Funktion befindet sich in der Vorabversion (pre-GA). Pre-GA-Produkte und ‑Funktionen werden eventuell nur eingeschränkt unterstützt. Außerdem sind Änderungen an diesen Produkten und Funktionen möglicherweise nicht mit anderen pre-GA-Versionen kompatibel. Pre-GA-Angebote sind durch die dienstspezifischen Nutzungsbedingungen für die Google Maps Platform abgedeckt. Weitere Informationen finden Sie unter Beschreibungen der Startphase.

Ermöglicht es der Address Validation API, zusätzliche Informationen in die Antwort aufzunehmen.

Felder
return_english_latin_address

bool

Vorschau: Gibt einen google.maps.addressvalidation.v1.Address auf Englisch zurück. Weitere Informationen finden Sie unter google.maps.addressvalidation.v1.ValidationResult.english_latin_address.

PlusCode

Ein Plus Code (http://plus.codes) ist ein Standortbezug mit zwei Formaten: ein globaler Code, der ein Rechteck von 14 × 14 m (1/8.000stel eines Grades) oder kleiner definiert, und ein zusammengesetzter Code, bei dem das Präfix durch einen Referenzstandort ersetzt wird.

Felder
global_code

string

Der globale (vollständige) Code des Orts, z. B. „9FWM33GV+HQ“, der einen Bereich von 1/8.000 × 1/8.000 Grad (ca. 14 × 14 Meter) darstellt.
compound_code

string

Der zusammengesetzte Code des Orts, z. B. „33GV+HQ, Ramberg, Norwegen“, mit dem Suffix des globalen Codes und dem Präfix einer formatierten Referenzentität.

ProvideValidationFeedbackRequest

Die Anfrage zum Senden von Validierungsfeedback.

Felder
conclusion

ValidationConclusion

Erforderlich. Das Ergebnis der Validierungsversuche.

Wenn dieses Feld auf VALIDATION_CONCLUSION_UNSPECIFIED gesetzt ist, wird der Fehler INVALID_ARGUMENT zurückgegeben.
response_id

string

Erforderlich. Die ID der Antwort, für die dieses Feedback gilt. Dies sollte die [response_id][google.maps.addressvalidation.v1.ValidateAddressRequest.response_id] aus der ersten Antwort in einer Reihe von Versuchen zur Adressvalidierung sein.

ValidationConclusion

Die möglichen Endergebnisse der Abfolge von Adressbestätigungsanfragen, die zur Validierung einer Adresse erforderlich sind.

Enums
VALIDATION_CONCLUSION_UNSPECIFIED Dieser Wert wird nicht verwendet. Wenn das Feld ProvideValidationFeedbackRequest.conclusion auf VALIDATION_CONCLUSION_UNSPECIFIED gesetzt ist, wird ein INVALID_ARGUMENT-Fehler zurückgegeben.
VALIDATED_VERSION_USED Für die Transaktion wurde die von der Address Validation API zurückgegebene Version der Adresse verwendet.
USER_VERSION_USED Die vom Nutzer angegebene Adresse wurde für die Transaktion verwendet.
UNVALIDATED_VERSION_USED Für die Transaktion wurde eine Version der Adresse verwendet, die nach dem letzten Validierungsversuch eingegeben, aber nicht noch einmal validiert wurde.
UNUSED Die Transaktion wurde abgebrochen und die Adresse wurde nicht verwendet.

ProvideValidationFeedbackResponse

Dieser Typ hat keine Felder.

Die Antwort auf das Validierungsfeedback.

Die Antwort ist leer, wenn das Feedback erfolgreich gesendet wurde.

UspsAddress

USPS-Darstellung einer US-Adresse.

Felder
first_address_line

string

Erste Adresszeile.
firm

string

Name des Unternehmens.
second_address_line

string

Zweite Adresszeile.
urbanization

string

Name der Urbanisierung in Puerto Rico.
city_state_zip_address_line

string

Stadt + Bundesland + Postleitzahl
city

string

Stadt
state

string

Zweistelliger Bundeslandcode.
zip_code

string

Postleitzahl, z.B. 10009.
zip_code_extension

string

Vierstellige Postleitzahlerweiterung, z.B. 5023.

UspsData

Die USPS-Daten für die Adresse. Es kann nicht garantiert werden, dass uspsData für jede an die Address Validation API gesendete Adresse in den USA oder in Puerto Rico vollständig ausgefüllt ist. Wir empfehlen, die Felder für die Ersatzadresse in die Antwort einzubinden, wenn Sie „uspsData“ als Hauptteil der Antwort verwenden.

Felder
standardized_address

UspsAddress

USPS-Standardadresse.
delivery_point_code

string

Zweistelliger Code des Lieferorts
delivery_point_check_digit

string

Die Prüfziffer des Lieferorts. Diese Nummer wird am Ende des delivery_point_barcode für mechanisch gescannte Post hinzugefügt. Die Summe aller Ziffern von delivery_point_barcode, delivery_point_check_digit, postal_code und ZIP+4 muss eine durch 10 teilbare Zahl ergeben.
dpv_confirmation

string

Die möglichen Werte für die DPV-Bestätigung. Gibt ein einzelnes Zeichen oder keinen Wert zurück.

  • N: Die Informationen zur primären und allen sekundären Nummern konnten nicht durch DPV bestätigt werden.
  • D: Die Adresse wurde nur für die primäre Nummer per DPV bestätigt und die Informationen zur sekundären Nummer fehlten.
  • S: Die Adresse wurde nur für die primäre Nummer per DPV bestätigt. Die Informationen zur sekundären Nummer waren vorhanden, aber nicht bestätigt.
  • Y: Die Adresse wurde für die primäre und alle sekundären Nummern per DPV bestätigt.
  • Leer: Wenn die Antwort keinen dpv_confirmation-Wert enthält, wurde die Adresse nicht zur DPV-Bestätigung gesendet.
dpv_footnote

string

Die Fußnoten aus der Validierung des Lieferorts. Mehrere Fußnoten können in einem String aneinandergereiht werden.

  • AA: Eingabeadresse, die mit der ZIP+4-Datei übereinstimmt
  • A1: Die Eingabeadresse wurde nicht mit der ZIP+4-Datei abgeglichen.
  • BB: Mit DPV abgeglichen (alle Komponenten)
  • CC: Sekundäre Nummer stimmt nicht überein und ist nicht erforderlich
  • C1: Sekundäre Nummer stimmt nicht überein, ist aber erforderlich
  • N1: Für Adresse eines Hochhauses fehlt die sekundäre Nummer
  • M1: Primäre Nummer fehlt
  • M3: Die primäre Nummer ist ungültig.
  • P1: Die Postfachnummer der Eingabeadresse (PO Box, RR oder HC) fehlt
  • P3: Die Postfachnummer der Eingabeadresse (PO, RR oder HC) ist ungültig.
  • F1: Die eingegebene Adresse stimmt mit einer Militäradresse überein.
  • G1: Eingabeadresse, die mit einer allgemeinen Zustelladresse übereinstimmt
  • U1: Die eingegebene Adresse stimmt mit einer eindeutigen Postleitzahl überein.
  • PB: Eingabeadresse, die mit dem PBSA-Eintrag übereinstimmt
  • RR: Von DPV bestätigte Adresse mit PMB-Informationen
  • R1: Von DPV bestätigte Adresse ohne PMB-Informationen
  • R7: Eintrag „Carrier Route“ R777 oder R779
  • IA: Die benachrichtigte Adresse wurde ermittelt.
  • TA: Primäre Nummer, die durch Weglassen eines nachfolgenden Alphazeichens übereinstimmt
dpv_cmra

string

Gibt an, ob es sich bei der Adresse um eine CMRA (Commercial Mail Receiving Agency) handelt, also um ein privates Unternehmen, das Post für Kunden empfängt. Gibt ein einzelnes Zeichen zurück.

  • Y: Die Adresse ist eine CMRA.
  • N: Die Adresse ist keine CMRA.
dpv_vacant

string

Ist dieser Platz frei? Gibt ein einzelnes Zeichen zurück.

  • Y: Die Adresse ist nicht bewohnt
  • N: Die Adresse ist nicht frei.
dpv_no_stat

string

Ist dies eine Adresse ohne Status oder eine aktive Adresse? Zu den nicht besetzten Adressen gehören Adressen, die nicht durchgehend besetzt sind, oder Adressen, die nicht vom USPS beliefert werden. Gibt ein einzelnes Zeichen zurück.

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

int32

Gibt den NoStat-Typ an. Gibt einen Grundcode als int zurück.

  • 1: IDA (Internal Drop Address): Adressen, an die keine Post direkt vom USPS zugestellt wird, sondern an eine Abholadresse, die für sie zuständig ist.
  • 2: CDS: Adressen, an die noch keine Zustellung möglich ist. Beispiel: Eine neue Parzelle, für die Parzellen und Hauptnummern bestimmt wurden, aber noch kein Gebäude für die Belegung vorhanden ist.
  • 3: Kollision: Adressen, die nicht durch DPV bestätigt werden.
  • 4: CMZ (College, Military and Other Types): ZIP-plus-4-Einträge, die von USPS in die Daten aufgenommen wurden.
  • 5: Normal: Gibt Adressen an, an die keine Zustellung erfolgt. Diese Adressen werden nicht als mögliche Zustellungen gezählt.
  • 6: Sekundär erforderlich: Für die Adresse sind sekundäre Informationen erforderlich.
dpv_drop

string

Das Flag gibt an, dass die Post an einem Standort an einem einzigen Abholort zugestellt wird. Gibt ein einzelnes Zeichen zurück.

  • Y: Die Post wird an einem Standort an einem einzigen Abholort zugestellt.
  • N: Die Post wird nicht an einem einzigen Ort zugestellt.
dpv_throwback

string

Gibt an, dass die Post nicht an die angegebene Adresse zugestellt wird. Gibt ein einzelnes Zeichen zurück.

  • Y: Die Post wird nicht an die Adresse zugestellt.
  • N: Die Post wird an die Adresse zugestellt.
dpv_non_delivery_days

string

Das Flag gibt an, dass die Zustellung nicht an jedem Wochentag erfolgt. Gibt ein einzelnes Zeichen zurück.

  • Y: Die Zustellung der Post erfolgt nicht an jedem Wochentag.
  • N: Es wird nicht angegeben, dass die Zustellung nicht an jedem Wochentag erfolgt.
dpv_non_delivery_days_values

int32

Ganzzahl, die Tage mit Nichtauslieferung angibt. Sie kann mithilfe von Bitflags abgefragt werden: 0x40 – Sonntag ist kein Liefertag 0x20 – Montag ist kein Liefertag 0x10 – Dienstag ist kein Liefertag 0x08 – Mittwoch ist kein Liefertag 0x04 – Donnerstag ist kein Liefertag 0x02 – Freitag ist kein Liefertag 0x01 – Samstag ist kein Liefertag
dpv_no_secure_location

string

Das Flag gibt an, dass die Tür zugänglich ist, das Paket aber aus Sicherheitsgründen nicht hinterlassen wird. Gibt ein einzelnes Zeichen zurück.

  • Y: Das Paket wird aus Sicherheitsgründen nicht hinterlassen.
  • N: Es gibt keine Hinweise darauf, dass das Paket aus Sicherheitsgründen nicht zugestellt wird.
dpv_pbsa

string

Gibt an, dass die Adresse mit dem PBSA-Eintrag abgeglichen wurde. Gibt ein einzelnes Zeichen zurück.

  • Y: Die Adresse wurde mit dem PBSA-Eintrag abgeglichen.
  • N: Die Adresse wurde nicht mit dem PBSA-Eintrag abgeglichen.
dpv_door_not_accessible

string

Gibt Adressen an, an denen die USPS nicht an der Tür klingeln kann, um Post zuzustellen. Gibt ein einzelnes Zeichen zurück.

  • Y: Die Tür ist nicht zugänglich.
  • N: Es gibt keine Hinweise darauf, dass die Tür nicht barrierefrei ist.
dpv_enhanced_delivery_code

string

Gibt an, dass für die Adresse mehr als ein DPV-Rückgabecode gültig ist. Gibt ein einzelnes Zeichen zurück.

  • Y: Die Adresse wurde für die primäre und alle sekundären Nummern per DPV bestätigt.
  • N: Die Informationen zur primären und allen sekundären Nummern konnten nicht durch DPV bestätigt werden.
  • S: Die Adresse wurde nur für die primäre Nummer per DPV bestätigt. Die Informationen zur sekundären Nummer waren vorhanden, aber nicht bestätigt. Oder ein einzelnes nachfolgendes Alphazeichen bei einer primären Nummer wurde entfernt, um eine DPV-Übereinstimmung zu ermöglichen, und sekundäre Informationen sind erforderlich.
  • D: Die Adresse wurde nur für die primäre Nummer per DPV bestätigt und die Informationen zur sekundären Nummer fehlten.
  • R: Die Adresse wurde bestätigt, aber dem Phantom-Weg R777 und R779 zugewiesen. Die Zustellung durch USPS ist nicht möglich.
carrier_route

string

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

Präfixe:

  • C: Betreiberroute (oder Stadtbuslinie)
  • R: Ländliche Route
  • H: Autobahn-Vertragsroute
  • B: Abschnitt für Postfach
  • G: Allgemeine Übermittlungseinheit
carrier_route_indicator

string

Sortierindikator für den Preis des Transportunternehmens.
ews_no_match

bool

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

string

Ort der Hauptpost.
post_office_state

string

Bundesland des Hauptpostamts.
abbreviated_city

string

Abgekürzte Stadt.
fips_county_code

string

FIPS-County-Code.
county

string

Name des Landkreises.
elot_number

string

Die Nummer der erweiterten Flugbahn (Enhanced Line of Travel, eLOT).
elot_flag

string

eLOT-Flag für aufsteigend/absteigend (A/D).
po_box_only_postal_code

bool

Nur Postleitzahl für Postfach.
pmb_designator

string

PMB (Private Mail Box)-Einheitsbezeichner.
pmb_number

string

PMB-Nummer (Private Mail Box)
address_record_type

string

Der Typ des Adresseintrags, der mit der Eingabeadresse übereinstimmt.

  • F: FIRM. Dies ist eine Übereinstimmung mit einem Unternehmenseintrag, der die höchste Übereinstimmungsebene für eine Adresse ist.
  • G: ALLGEMEINE LIEFERUNG. Dieser Datensatz stimmt mit einem Allgemeinadressdatensatz überein.
  • H: GEBÄUDE / WOHNUNG. Es gibt eine Übereinstimmung mit einem Gebäude- oder Wohnungseintrag.
  • P: POSTFACH. Diese Adresse entspricht einer Postfachadresse.
  • R: LÄNDLICHE STRASSE oder STRASSENBAUVERTRAG: Dies ist eine Übereinstimmung mit einem Eintrag für eine ländliche Straße oder einen Straßenbauvertrag. Beide können Bereiche mit Postleitzahlen haben.
  • S: STRASSENEINTRAG: Dies ist eine Übereinstimmung mit einem Straßeneintrag mit einem gültigen Primärnummernbereich.
default_address

bool

Ein Indikator dafür, dass eine Standardadresse gefunden wurde, es aber spezifischere Adressen gibt.
error_message

string

Fehlermeldung beim Abrufen von USPS-Daten Dieses Feld wird ausgefüllt, wenn die USPS-Verarbeitung aufgrund der Erkennung von künstlich erstellten Adressen ausgesetzt wird.

Die USPS-Datenfelder sind bei diesem Fehler möglicherweise nicht ausgefüllt.
cass_processed

bool

Gibt an, dass die Anfrage mit CASS verarbeitet wurde.

ValidateAddressRequest

Die Anfrage zur Validierung einer Adresse.

Felder
address

PostalAddress

Erforderlich. Die Adresse, die bestätigt werden soll. Unformatierte Adressen sollten über address_lines eingereicht werden.

Die Gesamtlänge der Felder in dieser Eingabe darf 280 Zeichen nicht überschreiten.

Eine Liste der unterstützten Regionen finden Sie hier.

Der language_code-Wert in der Eingabeadresse ist für zukünftige Verwendungen reserviert und wird derzeit ignoriert. Das Ergebnis der bestätigten Adresse wird basierend auf der vom System ermittelten bevorzugten Sprache für die angegebene Adresse ausgefüllt.

Die Address Validation API ignoriert die Werte in recipients und organization. Alle Werte in diesen Feldern werden verworfen und nicht zurückgegeben. Bitte legen Sie diese nicht fest.
previous_response_id

string

Dieses Feld muss für die erste Anfrage zur Adressbestätigung leer sein. Wenn für die vollständige Validierung einer einzelnen Adresse weitere Anfragen erforderlich sind (z. B. wenn die vom Nutzer nach der Erstvalidierung vorgenommenen Änderungen noch einmal validiert werden müssen), muss dieses Feld in jeder Folgeanfrage mit der response_id aus der allerersten Antwort in der Validierungssequenz ausgefüllt werden.
enable_usps_cass

bool

Aktiviert den USPS CASS-kompatiblen Modus. Dies betrifft nur das Feld google.maps.addressvalidation.v1.ValidationResult.usps_data von google.maps.addressvalidation.v1.ValidationResult. Hinweis: Bei USPS CASS-fähigen Anfragen für Adressen in Puerto Rico muss die google.type.PostalAddress.region_code der address als „PR“ oder die google.type.PostalAddress.administrative_area der address als „Puerto Rico“ (ohne Berücksichtigung der Groß- und Kleinschreibung) oder „PR“ angegeben werden.

Wir empfehlen, eine komponentenbasierte address zu verwenden. Alternativ können Sie mindestens zwei google.type.PostalAddress.address_lines angeben, wobei die erste Zeile die Hausnummer und den Straßennamen und die zweite Zeile die Stadt, den Bundesstaat und die Postleitzahl enthält.
language_options

LanguageOptions

Optional. Vorabversion: Diese Funktion befindet sich in der Vorabversion (pre-GA). Pre-GA-Produkte und ‑Funktionen werden eventuell nur eingeschränkt unterstützt. Außerdem sind Änderungen an diesen Produkten und Funktionen möglicherweise nicht mit anderen pre-GA-Versionen kompatibel. Pre-GA-Angebote sind durch die dienstspezifischen Nutzungsbedingungen für die Google Maps Platform abgedeckt. Weitere Informationen finden Sie unter Beschreibungen der Startphase.

Ermöglicht es der Address Validation API, zusätzliche Informationen in die Antwort aufzunehmen.
session_token

string

Optional. Ein String, der eine Autocomplete-Sitzung zu Abrechnungszwecken identifiziert. Muss ein für URLs und Dateinamen sicherer Base64-String mit maximal 36 ASCII-Zeichen sein. Andernfalls wird der Fehler INVALID_ARGUMENT zurückgegeben.

Die Sitzung beginnt, wenn der Nutzer eine Autocomplete-Abfrage stellt, und endet, wenn er einen Ort auswählt und ein Aufruf von „Places Details“ oder „Address Validation“ erfolgt. Jede Sitzung kann mehrere Autocomplete-Abfragen und eine „Places Details“- oder „Adress Validation“-Anfrage umfassen. Die Anmeldedaten, die für jede Anfrage innerhalb einer Sitzung verwendet werden, müssen zu demselben Google Cloud Console-Projekt gehören. Sobald eine Sitzung beendet wird, ist das Token nicht mehr gültig. Ihre App muss für jede Sitzung ein neues Token generieren. Wenn Sie den sessionToken-Parameter weglassen oder ein Sitzungstoken wiederverwenden, wird die Sitzung so in Rechnung gestellt, als wäre kein Sitzungstoken bereitgestellt worden. Jede Anfrage wird separat abgerechnet.

Hinweis: Die Address Validation API kann nur in Sitzungen mit der Autocomplete (New) API, nicht mit der Autocomplete API verwendet werden. Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/session-pricing.

ValidateAddressResponse

Die Antwort auf eine Anfrage zur Adressbestätigung.

Felder
result

ValidationResult

Das Ergebnis der Adressbestätigung.
response_id

string

Die UUID, die diese Antwort identifiziert. Wenn die Adresse noch einmal bestätigt werden muss, muss diese UUID der neuen Anfrage beigefügt werden.

ValidationResult

Das Ergebnis der Validierung einer Adresse.

Felder
verdict

Verdict

Flags für das Gesamturteil
address

Address

Informationen zur Adresse selbst, im Gegensatz zum Geocode.
geocode

Geocode

Informationen zum Standort und Ort, zu dem die Adresse geocodiert wurde.
metadata

AddressMetadata

Sonstige für die Zustellbarkeit relevante Informationen. Es kann nicht garantiert werden, dass metadata für jede an die Address Validation API gesendete Adresse vollständig ausgefüllt ist.
usps_data

UspsData

Zusätzliche Flags zur Zustellbarkeit, die von USPS bereitgestellt werden. Nur in den Regionen US und PR verfügbar.
english_latin_address

Address

Vorabversion: Diese Funktion befindet sich in der Vorabversion (pre-GA). Pre-GA-Produkte und ‑Funktionen werden eventuell nur eingeschränkt unterstützt. Außerdem sind Änderungen an diesen Produkten und Funktionen möglicherweise nicht mit anderen pre-GA-Versionen kompatibel. Pre-GA-Angebote sind durch die dienstspezifischen Nutzungsbedingungen für die Google Maps Platform abgedeckt. Weitere Informationen finden Sie unter Beschreibungen der Startphase.

Die Adresse in englischer Sprache.

Übersetzte Adressen können nicht wiederverwendet werden. Der Dienst stellt sie zur Verfügung, damit der Nutzer die Validierung der ursprünglich angegebenen Adresse in seiner Muttersprache bestätigen oder ablehnen kann.

Wenn für einen Teil der Adresse keine englische Übersetzung vorhanden ist, gibt der Dienst diesen Teil in einer anderen Sprache zurück, die ein lateinisches Schriftsystem verwendet. Hier finden Sie eine Erklärung dazu, wie die alternative Sprache ausgewählt wird. Wenn für einen Teil der Adresse keine Übersetzungen oder Transliterationen in einer Sprache mit lateinischem Alphabet verfügbar sind, gibt der Dienst diesen Teil in der mit der Adresse verknüpften Landessprache zurück.

Aktivieren Sie diese Ausgabe mit dem Flag google.maps.addressvalidation.v1.LanguageOptions.return_english_latin_address.

Hinweis: Die Felder google.maps.addressvalidation.v1.Address.unconfirmed_component_types in english_latin_address und google.maps.addressvalidation.v1.AddressComponent.confirmation_level in english_latin_address.address_components sind nicht ausgefüllt.

Urteil

Grober Überblick über das Ergebnis der Adressbestätigung und den Geocode.

Felder
input_granularity

Granularity

Die Detaillierung der Eingabeadresse. Dies ist das Ergebnis des Parsens der Eingabeadresse und gibt keine Validierungssignale. Informationen zu Validierungssignalen finden Sie unten unter validation_granularity.

Wenn die Eingabeadresse beispielsweise eine bestimmte Wohnungsnummer enthält, ist input_granularity hier SUB_PREMISE. Wenn der Dienst zur Adressbestätigung die Wohnungsnummer in den Datenbanken nicht finden kann oder die Wohnungsnummer ungültig ist, ist die validation_granularity wahrscheinlich PREMISE oder gröber.
validation_granularity

Granularity

Die Detailebene der nachbehandelten Adresse, die die API vollständig validieren kann. Ein validation_granularity von PREMISE bedeutet beispielsweise, dass alle Adresskomponenten auf der Ebene von PREMISE oder gröber validiert werden können.

Die Ergebnisse der Validierung der einzelnen Adresskomponenten finden Sie unter google.maps.addressvalidation.v1.Address.address_components.
geocode_granularity

Granularity

Informationen zum Detaillierungsgrad der geocode. Dies kann als semantische Bedeutung dafür verstanden werden, wie grob oder genau der geocodierte Standort ist.

Dieser kann gelegentlich von validation_granularity oben abweichen. In unserer Datenbank ist beispielsweise die Existenz einer Wohnungsnummer erfasst, aber es ist nicht genau bekannt, wo sich die Wohnung in einem großen Wohnkomplex befindet. In diesem Fall ist die validation_granularity SUB_PREMISE, die geocode_granularity aber PREMISE.
address_complete

bool

Die nachbehandelte Adresse gilt als vollständig, wenn keine nicht aufgelösten Tokens, keine unerwarteten oder fehlenden Adresskomponenten vorhanden sind. Wenn dieser Parameter nicht festgelegt ist, entspricht der Wert false. Weitere Informationen finden Sie in den Feldern missing_component_types, unresolved_tokens oder unexpected.
has_unconfirmed_components

bool

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

bool

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

bool

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

PossibleNextAction

Vorabversion: Diese Funktion befindet sich in der Vorabversion (pre-GA). Pre-GA-Produkte und ‑Funktionen werden eventuell nur eingeschränkt unterstützt. Außerdem sind Änderungen an diesen Produkten und Funktionen möglicherweise nicht mit anderen pre-GA-Versionen kompatibel. Pre-GA-Angebote sind durch die dienstspezifischen Nutzungsbedingungen für die Google Maps Platform abgedeckt. Weitere Informationen finden Sie unter Beschreibungen der Startphase.

Bietet eine aussagekräftige Zusammenfassung der API-Antwort, die bei der Entscheidung über eine mögliche nachfolgende Aktion helfen soll. Dieses Feld wird aus anderen Feldern in der API-Antwort abgeleitet und ist keine Garantie für die Richtigkeit der Adresse oder die Zustellbarkeit. Weitere Informationen finden Sie unter Validierungslogik erstellen.
has_spell_corrected_components

bool

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

Detaillierungsgrad

Die verschiedenen Detailebenen, die eine Adresse oder ein Geocode haben kann. Wenn diese Werte verwendet werden, um die Detailgenauigkeit einer Adresse anzugeben, geben sie an, mit welcher Detailgenauigkeit die Adresse ein Ziel für die Zustellung von E-Mails angibt. Eine Adresse wie „123 Main Street, Redwood City, CA, 94061“ bezeichnet beispielsweise eine PREMISE, während „Redwood City, CA, 94061“ eine LOCALITY bezeichnet. Wenn wir jedoch keinen Geocode für „123 Main Street“ in Redwood City finden, kann der zurückgegebene Geocode eine LOCALITY-Genauigkeit haben, auch wenn die Adresse detaillierter ist.

Enums
GRANULARITY_UNSPECIFIED Standardwert Dieser Wert wird nicht verwendet.
SUB_PREMISE Ergebnis unterhalb der Gebäudeebene, z. B. ein Apartment.
PREMISE Ergebnis auf Gebäudeebene.
PREMISE_PROXIMITY Ein Geocode, der den Standort der Adresse auf Gebäudeebene annähernd angibt.
BLOCK Die Adresse oder der Geocode gibt einen Block an. Wird nur in Regionen mit Blockadressierung verwendet, z. B. in Japan.
ROUTE Der Geocode oder die Adresse ist auf eine Route wie eine Straße, eine Landstraße oder eine Autobahn ausgerichtet.
OTHER Alle anderen Detailebenen, die zusammengefasst werden, da sie nicht ausgeliefert werden können.

PossibleNextAction

Vorabversion: Diese Funktion befindet sich in der Vorabversion (pre-GA). Pre-GA-Produkte und ‑Funktionen werden eventuell nur eingeschränkt unterstützt. Außerdem sind Änderungen an diesen Produkten und Funktionen möglicherweise nicht mit anderen pre-GA-Versionen kompatibel. Pre-GA-Angebote sind durch die dienstspezifischen Nutzungsbedingungen für die Google Maps Platform abgedeckt. Weitere Informationen finden Sie unter Beschreibungen der Startphase.

Mögliche nächste Aktionen, die auf Grundlage der API-Antwort ausgeführt werden können.

Enums
POSSIBLE_NEXT_ACTION_UNSPECIFIED Standardwert Dieser Wert wird nicht verwendet.
FIX Ein oder mehrere Felder der API-Antwort weisen auf ein potenzielles Problem mit der nachbehandelten Adresse hin, z. B. verdict.validation_granularity = OTHER. Wenn Sie den Kunden bitten, die Adresse zu bearbeiten, kann dies die Qualität der Adresse verbessern.
CONFIRM_ADD_SUBPREMISES Die API-Antwort gibt an, dass für die nachbehandelte Adresse möglicherweise keine untergeordneten Räumlichkeiten vorhanden sind. Wenn Sie den Kunden bitten, die Adresse zu überprüfen und eine Wohnungsnummer hinzuzufügen, kann das die Qualität der Adresse verbessern. Die nachbehandelte Adresse kann auch andere kleinere Probleme aufweisen. Hinweis: Dieser Enum-Wert kann nur für US-Adressen zurückgegeben werden.
CONFIRM In einem oder mehreren Feldern der API-Antwort werden potenzielle kleinere Probleme mit der nachbehandelten Adresse angezeigt, z. B. dass die Adresskomponente postal_code replaced war. Wenn Sie Ihren Kunden bitten, die Adresse zu überprüfen, kann das die Qualität der Adresse verbessern.
ACCEPT Die API-Antwort enthält keine Signale, die einen der anderen Werte für „PossibleNextAction“ rechtfertigen. Sie können die nachbehandelte Adresse verwenden, ohne den Kunden noch einmal um Bestätigung zu bitten. Es kann jedoch nicht garantiert werden, dass die Adresse gültig ist, und sie kann noch Korrekturen enthalten. Es liegt in Ihrer Verantwortung, je nach Ihrer eigenen Risikobewertung zu entscheiden, ob und wie Sie Ihren Kunden darauf hinweisen.