Package google.maps.addressvalidation.v1

Index

AddressValidation

Der Dienst zum Validieren von Adressen.

ProvideValidationFeedback

rpc ProvideValidationFeedback(ProvideValidationFeedbackRequest) returns (ProvideValidationFeedbackResponse)

Feedback zum Ergebnis der Abfolge von Validierungsversuchen. Dies sollte der letzte Aufruf nach einer Reihe von Validierungsaufrufen für dieselbe Adresse sein. Er sollte nach Abschluss der Transaktion aufgerufen werden. Dies sollte nur einmal in der Abfolge von ValidateAddress-Anfragen gesendet werden, die zur vollständigen Validierung einer Adresse erforderlich sind.

ValidateAddress

rpc ValidateAddress(ValidateAddressRequest) returns (ValidateAddressResponse)

Validiert eine Adresse.

Adresse

Details zur nachbearbeiteten Adresse. Die Nachbearbeitung umfasst das Korrigieren falsch geschriebener Teile der Adresse, das Ersetzen falscher Teile und die Ableitung fehlender Teile.

Felder
formatted_address

string

Die nachbearbeitete Adresse, die gemäß den Formatierungsregeln der Region, in der sich die Adresse befindet, als einzeilige Adresse formatiert wird.

postal_address

PostalAddress

Die nachbearbeitete Adresse, dargestellt als Postanschrift.

address_components[]

AddressComponent

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

Die Adresskomponenten sind nicht auf eine bestimmte Weise angeordnet. Machen Sie keine Annahmen über die Reihenfolge der Adresskomponenten in der Liste.

missing_component_types[]

string

Die Komponenten, die in einer korrekt formatierten Postanschrift vorhanden sein sollten, aber in der Eingabe nicht gefunden wurden UND konnten nicht abgeleitet werden. Komponenten dieses Typs sind in formatted_address, postal_address und address_components nicht vorhanden. Ein Beispiel wäre ['street_number', 'route'] für eine Eingabe wie „Boulder, Colorado, 80301, USA“. Die Liste der möglichen Typen finden Sie hier.

unconfirmed_component_types[]

string

Die Komponententypen, die in der address_components vorhanden sind, aber nicht als korrekt bestätigt werden konnten. Dieses Feld wird zur Vereinfachung bereitgestellt: Sein Inhalt entspricht der Iteration über address_components, um die Typen aller Komponenten zu finden, bei denen confirmation_level nicht CONFIRMED oder das Flag inferred nicht auf true gesetzt ist. Die Liste der möglichen Typen finden Sie hier.

unresolved_tokens[]

string

Alle Tokens in der Eingabe, die nicht aufgelöst werden konnten. Dies kann eine Eingabe sein, die nicht als gültiger Teil einer Adresse erkannt wurde. In einer Eingabe wie „123235253253 Main St, San Francisco, CA, 94105“ können die nicht aufgelösten Tokens beispielsweise wie ["123235253253"] aussehen, da sie nicht wie eine gültige Hausnummer aussieht.

AddressComponent

Eine Adresskomponente, z. B. Straße, Stadt oder Bundesland

Felder
component_name

ComponentName

Der Name für diese Komponente.

component_type

string

Der Typ der Adresskomponente. Eine Liste möglicher 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, aber wir haben sie für den Adressstandort abgeleitet und glauben, dass sie für eine vollständige Adresse bereitgestellt werden sollte.

spell_corrected

bool

Weist auf eine Korrektur eines Rechtschreibfehlers im Komponentennamen hin. Die API meldet Änderungen von einer Rechtschreibvariante zu einer anderen nicht immer, z. B. wenn „Zentrum“ zu „Zentrum“ geändert wird. Außerdem werden häufig falsch geschriebene Wörter nicht immer erkannt, z. B. wenn „Amphitheater Pkwy“ in „Amphitheatre Pkwy“ geändert wird.

replaced

bool

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

unexpected

bool

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

ConfirmationLevel

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

Enums
CONFIRMATION_LEVEL_UNSPECIFIED Standardwert Dieser Wert wird nicht verwendet.
CONFIRMED Wir konnten bestätigen, dass diese Komponente existiert und im Kontext der übrigen Adresse sinnvoll ist.
UNCONFIRMED_BUT_PLAUSIBLE Diese Komponente konnte nicht bestätigt werden, es ist jedoch möglich, dass sie vorhanden ist. Zum Beispiel eine Hausnummer innerhalb eines bekannten gültigen Nummernbereichs auf einer Straße, für die bestimmte Hausnummern nicht bekannt sind.
UNCONFIRMED_AND_SUSPICIOUS Diese Komponente wurde nicht bestätigt und ist wahrscheinlich falsch. Zum Beispiel ein Viertel, das nicht zum Rest der Adresse passt.

AddressMetadata

Die Metadaten für die Adresse. Das Feld metadata wird möglicherweise nicht für jede Adresse, die an die Address Validation API gesendet wird, vollständig ausgefüllt.

Felder
business

bool

Gibt an, dass dies die Adresse eines Unternehmens ist. Wenn nicht festgelegt, ist der Wert unbekannt.

po_box

bool

Gibt die Adresse eines Postfachs an. Wenn nicht festgelegt, ist der Wert unbekannt.

residential

bool

Gibt an, dass dies die Adresse eines Wohnsitzes ist. Wenn nicht festgelegt, ist der Wert unbekannt.

ComponentName

Ein Wrapper für den Namen der Komponente.

Felder
text

string

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

language_code

string

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

Geocodieren

Enthält Informationen über den Ort, für den die Eingabe geocodiert wurde.

Felder
location

LatLng

Der geocodierte Standort der Eingabe.

Orts-IDs sollten gegenüber Adressen, Breiten- und Längengradkoordinaten oder Plus Codes bevorzugt verwendet werden. Die Verwendung von Koordinaten bei der Routenplanung oder Berechnung von Wegbeschreibungen führt immer dazu, dass der Punkt an der Straße ausgerichtet wird, die diesen Koordinaten am nächsten ist. Dies darf keine Straße sein, die schnell oder sicher zum Ziel führt und sich nicht in der Nähe eines Zugangspunkts zum Objekt befindet. Außerdem gibt es bei einer umgekehrten Geocodierung eines Standorts keine Garantie, dass die zurückgegebene Adresse mit der ursprünglichen Adresse übereinstimmt.

plus_code

PlusCode

Der Plus Code für location.

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 Orts, jedoch nicht in semantisch, sondern in physikalischer Größe.

place_id

string

Die PlaceID des Orts, für den diese Eingabe geocodiert wird.

Weitere Informationen zu Orts-IDs

place_types[]

string

Die Art(en) des Ortes, für den die Eingabe das Geocoding vorgenommen hat. Beispiel: ['locality', 'political']. Die vollständige Liste der Typen findest du hier.

LanguageOptions

Vorabversion: Diese Funktion ist eine 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.

Hiermit kann die Address Validation API zusätzliche Informationen in die Antwort aufnehmen.

Felder
return_english_latin_address

bool

Vorschau: Geben Sie google.maps.addressvalidation.v1.Address auf Englisch zurück. Weitere Informationen findest du unter google.maps.addressvalidation.v1.ValidationResult.english_latin_address.

PlusCode

Plus Code (http://plus.codes) ist eine Standortreferenz in zwei Formaten: Globaler Code, der ein Rechteck mit einer Größe von 14 MXN14 m (1/8.000 Grad eines Grads) oder kleiner definiert, und Kompoundcode, bei dem das Präfix durch eine Referenzposition ersetzt wird.

Felder
global_code

string

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

compound_code

string

Zusammengesetzter Code eines Orts, z. B. „33GV+HQ, Ramberg, Norway“, der das Suffix des globalen Codes enthält und das Präfix durch den formatierten Namen einer Referenzentität ersetzt

ProvideValidationFeedbackRequest

Die Anfrage zum Senden von Validierungsfeedback.

Felder
conclusion

ValidationConclusion

Erforderlich. Das Ergebnis der Abfolge von Validierungsversuchen.

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

response_id

string

Erforderlich. Die ID der Antwort, auf die sich dieses Feedback bezieht. Dies sollte die [response_id][google.maps.addressvalidation.v1.ValidateAddressRequest.response_id] aus der ersten Antwort in einer Reihe von Versuchen der Adressüberprüfung sein.

ValidationConclusion

Die möglichen endgültigen Ergebnisse der Abfolge von Anfragen zur Adressüberprüfung, die zum Validieren 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 der Fehler INVALID_ARGUMENT zurückgegeben.
VALIDATED_VERSION_USED Die von der Address Validation API zurückgegebene Version der Adresse wurde für die Transaktion verwendet.
USER_VERSION_USED Die vom Nutzer angegebene Version der Adresse wurde für die Transaktion verwendet
UNVALIDATED_VERSION_USED Für die Transaktion wurde eine Version der Adresse verwendet, die nach dem letzten Überprüfungsversuch eingegeben, aber nicht noch einmal validiert wurde.
UNUSED Die Transaktion wurde abgebrochen und die Adresse nicht verwendet.

ProvideValidationFeedbackResponse

Dieser Typ hat keine Felder.

Die Antwort auf das Feedback zur Validierung.

Wenn das Feedback erfolgreich gesendet wurde, ist die Antwort leer.

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

Puerto-ricanischer Urbanisierungsname.

city_state_zip_address_line

string

Stadt + Bundesland + Postleitzahl.

city

string

Stadt

state

string

2-stelliger Bundesstaatcode.

zip_code

string

Postleitzahl, z.B. 10009.

zip_code_extension

string

4-stellige Postleitzahlerweiterung, z.B. 5023.

UspsData

Die USPS-Daten für die Adresse. Es wird nicht garantiert, dass uspsData für jede US- oder PR-Adresse, die an die Address Validation API gesendet wird, vollständig ausgefüllt wird. Es wird empfohlen, die Backup-Adressfelder in die Antwort zu integrieren, wenn du uspsData als primären Teil der Antwort verwendest.

Felder
standardized_address

UspsAddress

Standardisierte USPS-Adresse.

delivery_point_code

string

2-stelliger Code der Lieferstelle

delivery_point_check_digit

string

Die Prüfziffer für den Lieferort. Bei mechanisch gescannten E-Mails wird diese Nummer am Ende des „delivery_point_barcode“ eingefügt. Die Addition aller Ziffern aus „delivery_point_barcode“, „delivery_point_check_ sicher“, „Postleitzahl“ und „Postleitzahl“ ergibt eine Zahl, die durch 10 teilbar ist.

dpv_confirmation

string

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

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

string

Die Fußnoten aus der Validierung der Lieferpunkte. Mehrere Fußnoten können in derselben Zeichenfolge aneinandergereiht werden.

  • AA: Eingabeadresse, die mit der ZIP+4-Datei übereinstimmt
  • A1: Eingabeadresse stimmte nicht mit der ZIP+4-Datei überein
  • BB: An DPV angepasst (alle Komponenten)
  • CC: Sekundäre Nummer stimmt nicht überein und ist nicht erforderlich
  • C1: Sekundäre Nummer nicht zugeordnet, aber erforderlich
  • N1: Hochhausadresse ohne Zweitnummer
  • M1: primäre Nummer fehlt
  • M3: primäre Nummer ungültig
  • P1: Bestellnummer, RR- oder HC-Feldnummer fehlt
  • P3: PO-, RR- oder HC-Box-Nummer der Eingabeadresse ungültig
  • F1: Eingabeadresse stimmt mit einer Militäradresse überein
  • G1: Die eingegebene Adresse stimmt mit einer allgemeinen Lieferadresse überein
  • U1: Die eingegebene Adresse stimmt mit einer eindeutigen Postleitzahl überein
  • PB: Eingabeadresse stimmt mit dem PBSA-Eintrag überein
  • RR: vom Datenschutzrahmen bestätigte Adresse mit Angaben zum PMB
  • R1: vom Datenschutzrahmen bestätigte Adresse ohne Angaben zum PMB
  • R7: Carrier Route R777- oder R779-Eintrag
  • IA: Informierte Adresse identifiziert
  • TA: primäre Zahl für Übereinstimmung durch Entfernen eines nachgestellten Alpha-Werts
dpv_cmra

string

Gibt an, ob die Adresse eine CMRA (Commercial Mail Receiving Agency) ist – ein privates Unternehmen, das Post für Kunden erhält. Gibt ein einzelnes Zeichen zurück.

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

string

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

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

string

Ist dies eine Adresse ohne Statistik oder eine aktive Adresse? Keine Statistik-Adressen sind Adressen, die nicht ständig belegt sind oder die nicht von USPS bedient 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 Typ NoStat an. Gibt einen Ursachencode als int zurück.

  • 1: IDA (Internal Drop Address) – Adressen, die Post nicht direkt vom USPS erhalten, sondern an eine Adresse zugestellt werden, die sie bedient.
  • 2: CDS – Adressen, die noch nicht zustellbar sind. Zum Beispiel eine neue Untergruppe, in der viele und primäre Nummern bestimmt wurden, aber noch keine Struktur für die Belegung vorhanden ist.
  • 3: Kollision – Adressen, die keine DPV-Bestätigung durchführen.
  • 4: CMZ (College, Military und andere Typen) – ZIP und 4 Einträge, die USPS in die Daten eingebunden hat.
  • 5: Normal – Gibt an, dass Adressen nicht zugestellt werden können und nicht als mögliche Zustellungen gezählt werden.
  • 6: sekundär erforderlich: Für die Adresse sind sekundäre Informationen erforderlich.
dpv_drop

string

Das Flag gibt an, dass die E-Mail an einen einzelnen Empfänger eines Standorts zugestellt wird. Gibt ein einzelnes Zeichen zurück.

  • Y: Die Post wird an einen einzelnen Empfänger eines Standorts zugestellt.
  • N: Die E-Mail wird nicht an einen einzelnen Empfänger einer Website zugestellt.
dpv_throwback

string

Gibt an, dass E-Mails nicht an die Adresse zugestellt werden. 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 E-Mail nicht an jedem Wochentag zugestellt wird. Gibt ein einzelnes Zeichen zurück.

  • Y: Die E-Mail wird nicht an jedem Wochentag zugestellt.
  • N: Kein Hinweis, dass die E-Mail nicht an jedem Wochentag erfolgt.
dpv_non_delivery_days_values

int32

Ganzzahl, die die Tage der Nicht-Auslieferung angibt. Er kann mit Bit-Flags abgefragt werden: 0x40 – Sonntag ist ein Tag der Nichtlieferung 0x20 – Montag ist ein Tag der Nichtlieferung 0x10 – Dienstag ist ein Tag der Nichtlieferung 0x08 – Mittwoch ist ein Tag der Nichtlieferung 0x04 – Donnerstag ist ein Tag der Nichtlieferung 0x02 – Freitag ist ein Tag der Nichtlieferung 0x01

dpv_no_secure_location

string

Flagge zeigt an, dass die Tür zugänglich ist, aber das Paket wird aus Sicherheitsgründen nicht abgelegt. Gibt ein einzelnes Zeichen zurück.

  • Y: Das Paket wird aus Sicherheitsgründen nicht hinterlassen.
  • N: Kein Hinweis, dass das Paket aufgrund von Sicherheitsbedenken nicht hinterlassen 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 konnte nicht mit dem PBSA-Eintrag abgeglichen werden.
dpv_door_not_accessible

string

Flagge zeigt Adressen an, bei denen USPS nicht an die Tür klopfen kann, um Post zuzustellen. Gibt ein einzelnes Zeichen zurück.

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

string

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

  • Y: DPV für primäre und alle sekundären Nummern wurde bestätigt.
  • N: Die Angaben zur primären und sekundären Nummer konnten nicht per DPV bestätigt werden.
  • S: Die Adresse wurde nur für die primäre Nummer per DPV bestätigt und die Informationen zur sekundären Nummer waren durch nicht bestätigt oder es wurde bei einer primären Nummer ein nur nachgestellter Alphatest für eine primäre Nummer entfernt, um eine DPV-Übereinstimmung zu machen und sekundäre Informationen erforderlich zu machen.
  • D: Die DPV wurde nur für die primäre Nummer bestätigt und die sekundäre Nummer fehlt.
  • R: Die Adresse wurde bestätigt, ist aber der Phantomroute R777 und R779 zugewiesen. Keine Zustellung per USPS angegeben.
carrier_route

string

Der Routencode des Transportunternehmens. Ein vierstelliger Code, der aus einem Präfix aus einem Buchstaben und einem dreistelligen Routenbezeichner besteht.

Präfixe:

  • C: Route des Transportunternehmens (oder Stadtroute)
  • R: Landstraße
  • H: Autobahnvertragsroute
  • B: Postfachbereich
  • G: allgemeine Bereitstellungseinheit
carrier_route_indicator

string

Sortieranzeige für Versandpreise für Transportunternehmen.

ews_no_match

bool

Die Lieferadresse kann abgeglichen werden, aber aus der EWS-Datei geht hervor, dass in Kürze eine genaue Übereinstimmung verfügbar sein wird.

post_office_city

string

Stadt der Hauptpostfiliale.

post_office_state

string

Hauptpostfiliale.

abbreviated_city

string

Gekürzte Stadt.

fips_county_code

string

FIPS-Bezirkscode.

county

string

Landkreis

elot_number

string

eLOT-Nummer (Enhanced Line of Travel)

elot_flag

string

Aufsteigendes/absteigendes eLOT-Flag (A/D).

po_box_only_postal_code

bool

Postleitzahl (nur Postfach).

pmb_designator

string

PMB-Einheit (Private Mail Box)

pmb_number

string

PMB-Nummer (Private Mail Box):

address_record_type

string

Typ des Adresseintrags, der mit der Eingabeadresse übereinstimmt.

  • F: FIRM. Dies ist eine Übereinstimmung mit einem Firmeneintrag, der die genaueste verfügbare Übereinstimmung für eine Adresse darstellt.
  • G: ALLGEMEINE LIEFERUNG. Dies entspricht einem Datensatz für die allgemeine Zustellung.
  • H: AUFBAU / WOHNUNG. Dies stimmt mit einem Gebäude- oder Apartment-Eintrag überein.
  • P: POSTLEITFADEN. Dies entspricht einem Postfach.
  • R: LÄNDER ROUTE oder HIGHWAY CONTRACT: Dies ist eine Übereinstimmung mit einem Datensatz für eine Landstraße oder einen Fernstraßenvertrag, für den beide Bereiche mit Box-Nummern verknüpft sein können.
  • S: STREET RECORD: Übereinstimmung mit einem Straßendatensatz mit einem gültigen primären Zahlenbereich.
default_address

bool

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

error_message

string

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

Wenn dieser Fehler auftritt, werden die USPS-Datenfelder möglicherweise nicht ausgefüllt.

cass_processed

bool

Zeigt an, dass die Anfrage CASS verarbeitet wurde.

ValidateAddressRequest

Die Anfrage zur Validierung einer Adresse.

Felder
address

PostalAddress

Erforderlich. Die zu bestätigende Adresse. Nicht formatierte Adressen müssen über address_lines gesendet werden.

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

Unterstützte Regionen finden Sie hier.

Der Wert language_code in der Eingabeadresse ist für zukünftige Verwendungen reserviert und wird heute ignoriert. Das validierte Ergebnis für die Adresse wird anhand der vom System ermittelten bevorzugten Sprache für die jeweilige 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. Legen Sie sie nicht fest.

previous_response_id

string

Dieses Feld muss bei der ersten Anfrage zur Adressüberprüfung leer sein. Wenn mehrere Anfragen erforderlich sind, um eine einzelne Adresse vollständig zu validieren, z. B. wenn die Änderungen, die der Nutzer nach der ersten Überprüfung vornimmt, noch einmal validiert werden müssen, muss in jeder Folgeanfrage dieses Feld mit dem response_id von 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 Anfragen mit USPS CASS für Adressen in Puerto Rico müssen google.type.PostalAddress.region_code von address als „PR“ oder google.type.PostalAddress.administrative_area von address als „Puerto Rico“ (Groß-/Kleinschreibung nicht berücksichtigt) oder „PR“ angegeben werden.

Es empfiehlt sich, eine address mit Komponenten zu verwenden oder mindestens zwei google.type.PostalAddress.address_lines anzugeben, wobei die erste Zeile die Hausnummer und den Namen und die zweite Zeile die Stadt, das Bundesland und die Postleitzahl enthält.

language_options

LanguageOptions

Optional. Vorabversion: Diese Funktion ist eine 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.

Hiermit kann die Address Validation API zusätzliche Informationen in die Antwort aufnehmen.

session_token

string

Optional. Ein String, der eine Autocomplete-Sitzung zu Abrechnungszwecken identifiziert. Muss ein URL- und Dateiname-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 Place Details oder Address Validation erfolgt. Jede Sitzung kann mehrere Autocomplete-Abfragen enthalten, gefolgt von einer Place Details- oder Address Validation-Anfrage. Die für die einzelnen Anfragen innerhalb einer Sitzung verwendeten Anmeldedaten müssen zum selben Google Cloud Console-Projekt gehören. Sobald eine Sitzung beendet ist, ist das Token nicht mehr gültig. Ihre App muss für jede Sitzung ein neues Token generieren. Wenn der Parameter sessionToken weggelassen wird oder Sie ein Sitzungstoken wiederverwenden, wird die Sitzung so abgerechnet, als wäre kein Sitzungstoken angegeben worden. Jede Anfrage wird separat abgerechnet.

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

ValidateAddressResponse

Die Antwort auf eine Anfrage zur Adressüberprüfung.

Felder
result

ValidationResult

Das Ergebnis der Adressvalidierung.

response_id

string

Die UUID, die diese Antwort identifiziert. Muss die Adresse noch einmal validiert werden, muss diese UUID der neuen Anfrage beigefügt werden.

ValidationResult

Das Ergebnis der Adressüberprüfung.

Felder
verdict

Verdict

Flags für das Gesamtergebnis

address

Address

Informationen zur Adresse selbst, im Gegensatz zum Geocode.

geocode

Geocode

Informationen über den Standort und den Ort, für den die Adresse das Geocoding durchgeführt hat.

metadata

AddressMetadata

Weitere Informationen, die für die Lieferbarkeit relevant sind. Das Feld metadata wird möglicherweise nicht für jede Adresse, die an die Address Validation API gesendet wird, vollständig ausgefüllt.

usps_data

UspsData

Flags für zusätzliche Zustellbarkeit wurden von USPS bereitgestellt. Nur in den Regionen US und PR angegeben.

english_latin_address

Address

Vorabversion: Diese Funktion ist eine 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 wird ins Englische übersetzt.

Übersetzte Adressen können nicht als API-Eingabe wiederverwendet werden. Der Dienst stellt sie zur Verfügung, damit Nutzer die Bestätigung der ursprünglich angegebenen Adresse in ihrer Muttersprache bestätigen oder ablehnen können.

Wenn es für einen Teil der Adresse keine englische Übersetzung gibt, gibt der Dienst diesen Teil in einer alternativen Sprache mit lateinischer Schrift zurück. Weitere Informationen dazu, wie die alternative Sprache ausgewählt wird, finden Sie hier. Wenn für einen Teil der Adresse keine Übersetzungen oder Transkriptionen in einer Sprache mit lateinischer Schrift verfügbar sind, gibt der Dienst diesen Teil in der mit der Adresse verknüpften lokalen Sprache zurück.

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

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

Ergebnis

Allgemeine Übersicht über das Ergebnis und die Geocodierung der Adresse

Felder
input_granularity

Granularity

Der Detaillierungsgrad der input-Adresse. Dies ist das Ergebnis des Parsens der Eingabeadresse. Es werden keine Validierungssignale ausgegeben. Informationen zu Validierungssignalen finden Sie unter validation_granularity unten.

Wenn die eingegebene Adresse beispielsweise eine bestimmte Wohnungsnummer enthält, lautet input_granularity hier SUB_PREMISE. Wenn wir die Wohnungsnummer in den Datenbanken nicht abgleichen können oder die Wohnungsnummer ungültig ist, ist validation_granularity wahrscheinlich PREMISE oder niedriger.

validation_granularity

Granularity

Der Detaillierungsgrad, mit dem die API die Adresse vollständig validate kann. Ein validation_granularity-Wert von PREMISE gibt beispielsweise an, dass alle Adresskomponenten auf PREMISE-Ebene oder einer höheren Ebene validiert werden können.

Das Validierungsergebnis für die einzelnen Adresskomponenten finden Sie in google.maps.addressvalidation.v1.Address.address_components.

geocode_granularity

Granularity

Informationen zum Detaillierungsgrad von geocode. Dies kann als die semantische Bedeutung dessen verstanden werden, wie grob oder fein der geocodierte Standort ist.

Diese kann gelegentlich vom obigen validation_granularity abweichen. So kann es z. B. vorkommen, dass unsere Datenbank die Existenz einer Wohnungsnummer erfasst, aber keinen genauen Standort für die Wohnung innerhalb eines großen Wohnkomplexes aufweist. In diesem Fall ist validation_granularity SUB_PREMISE, geocode_granularity aber PREMISE.

address_complete

bool

Die Adresse gilt als vollständig, wenn es keine nicht aufgelösten Tokens oder keine unerwarteten oder fehlenden Adresskomponenten gibt. Wenn kein Wert festgelegt ist, wird der Wert auf false gesetzt. Weitere Informationen findest du 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 Adresskomponente 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.

Detaillierungsgrad

Die verschiedenen Detaillierungsgrad, die eine Adresse oder ein Geocode haben kann. Wenn diese Werte zur Angabe des Detaillierungsgrads für eine Adresse verwendet werden, geben diese Werte den Detaillierungsgrad an, mit dem die Adresse eine Postanschrift identifiziert. Beispielsweise identifiziert eine Adresse wie „123 Main Street, Redwood City, CA, 94061“ ein PREMISE, während etwas wie „Redwood City, CA, 94061“ ein LOCALITY identifiziert. Wenn wir jedoch keinen Geocode für die „Hauptstraße 123“ in Redwood City finden, kann der zurückgegebene Geocode den Detaillierungsgrad LOCALITY haben, obwohl die Adresse detaillierter ist.

Enums
GRANULARITY_UNSPECIFIED Standardwert Dieser Wert wird nicht verwendet.
SUB_PREMISE Ergebnis unterhalb der Gebäudeebene, z. B. eine Wohnung.
PREMISE Ergebnis auf Gebäudeebene.
PREMISE_PROXIMITY Ein Geocode, der den Standort der Adresse auf Gebäudeebene nähert.
BLOCK Die Adresse bzw. der Geocode steht für einen Block. Wird nur in Regionen mit Adressierung auf Blockebene verwendet, z. B. Japan.
ROUTE Der Geocode oder die Adresse ist detailliert für die Route, z. B. eine Straße, eine Straße oder eine Autobahn.
OTHER Alle anderen Detaillierungen, die zu einer Gruppe zusammengefasst werden, da sie nicht lieferbar sind.