Index
AddressValidation
(Benutzeroberfläche)Address
(Meldung)AddressComponent
(Meldung)AddressComponent.ConfirmationLevel
(Aufzählung)AddressMetadata
(Meldung)ComponentName
(Meldung)Geocode
(Meldung)PlusCode
(Meldung)ProvideValidationFeedbackRequest
(Meldung)ProvideValidationFeedbackRequest.ValidationConclusion
(Aufzählung)ProvideValidationFeedbackResponse
(Meldung)UspsAddress
(Meldung)UspsData
(Meldung)ValidateAddressRequest
(Meldung)ValidateAddressResponse
(Meldung)ValidationResult
(Meldung)Verdict
(Meldung)Verdict.Granularity
(Aufzählung)
Adressvalidierung
Der Dienst zur Validierung von Adressen.
Feedback zur Überprüfung |
---|
Feedback zum Ergebnis der Sequenz der Überprüfungsversuche. Dies sollte der letzte Aufruf nach einer Reihe von Validierungsaufrufen für dieselbe Adresse sein und nach Abschluss der Transaktion aufgerufen werden. Das sollte nur einmal gesendet werden. Das ist erforderlich, wenn |
Adresse bestätigen |
---|
Validiert eine Adresse. |
Adresse
Details zur Nachverarbeitung der Adresse. Die Nachbearbeitung umfasst die Korrektur falsch geschriebener Teile der Adresse, den Austausch falscher Teile und die Ableitung fehlender Teile.
Felder | |
---|---|
formatted_address |
Die nach der Bearbeitungszeit verarbeitete Adresse, die als einzeilige Adresse gemäß den Formatierungsregeln für Regionen registriert ist, in denen sich die Adresse befindet. |
postal_address |
Die nachträglich verarbeitete Adresse als Postanschrift. |
address_components[] |
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. |
missing_component_types[] |
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 |
unconfirmed_component_types[] |
Die Arten der Komponenten, die in der |
unresolved_tokens[] |
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. |
Adresskomponente
Eine Adresskomponente wie eine Straße, eine Stadt oder ein Bundesland
Felder | |
---|---|
component_name |
Der Name dieser Komponente. |
component_type |
Der Typ der Adresskomponente. Eine Liste der möglichen Typen finden Sie unter Tabelle 2: Zusätzliche vom Places-Dienst zurückgegebene Typen. |
confirmation_level |
Gibt an, wie sicher es ist, dass die Komponente korrekt ist |
inferred |
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. |
spell_corrected |
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. |
replaced |
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. |
unexpected |
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. |
Bestätigungsstufe
Verschiedene mögliche Werte für Bestätigungsstufen
Enums | |
---|---|
CONFIRMATION_LEVEL_UNSPECIFIED |
Standardwert Dieser Wert wird nicht verwendet. |
CONFIRMED |
Wir konnten feststellen, ob diese Komponente vorhanden ist und im Kontext der restlichen Adresse sinnvoll sind. |
UNCONFIRMED_BUT_PLAUSIBLE |
Diese Komponente konnte nicht bestätigt werden, ist aber verfügbar. Dies kann beispielsweise eine Hausnummer innerhalb eines bekannten gültigen Nummernbereichs auf einer Straße sein, an der keine Hausnummern bekannt sind. |
UNCONFIRMED_AND_SUSPICIOUS |
Diese Komponente wurde nicht bestätigt und ist wahrscheinlich falsch. Das kann beispielsweise ein Stadtteil sein, der nicht zum Rest der Adresse passt. |
Adressmetadaten
Die Metadaten der Adresse. Es ist nicht garantiert, dass metadata
bei jeder Adresse, die an die Address Validation API gesendet wird, vollständig ausgefüllt ist.
Felder | |
---|---|
business |
Gibt an, dass dies die Adresse eines Unternehmens ist. Wenn die Richtlinie nicht konfiguriert ist, bedeutet das, dass der Wert unbekannt ist. |
po_box |
Gibt die Adresse eines Postfachs an. Wenn die Richtlinie nicht konfiguriert ist, bedeutet das, dass der Wert unbekannt ist. |
residential |
Gibt an, dass dies die Adresse eines Wohnsitzes ist. Wenn die Richtlinie nicht konfiguriert ist, bedeutet das, dass der Wert unbekannt ist. |
Komponentenname
Ein Wrapper für den Namen der Komponente.
Felder | |
---|---|
text |
Name Beispiel: „5th Avenue“ für einen Straßennamen oder „1253“ für eine Hausnummer. |
language_code |
Der BCP-47-Sprachcode. Diese Option ist nicht verfügbar, wenn der Komponentenname nicht mit einer Sprache verknüpft ist, z. B. eine Hausnummer. |
Geocodieren
Enthält Informationen zu dem Ort, an den die Eingabe geocodiert wurde
Felder | |
---|---|
location |
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. |
plus_code |
Der Pluscode für |
bounds |
Die Grenzen des geocodierten Ortes. |
feature_size_meters |
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. |
place_id |
Die PlaceID des Orts, an dem diese Eingabe geocodiert wird |
place_types[] |
Die Ortstypen, an die die Eingabe geocodiert werden soll. Beispiel: |
PlusCode
Plus Code (http://plus.codes) ist eine Standortreferenz mit zwei Formaten: globaler Code, der einen 14 MX 14 m (1/8.000. Grad) oder ein kleineres Rechteck definiert, und zusammengesetzter Code, wobei das Präfix durch einen Referenzort ersetzt wird.
Felder | |
---|---|
global_code |
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) |
compound_code |
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. |
Anfragevalidierungsanfrage
Die Anfrage zum Senden von Validierungsfeedback.
Felder | |
---|---|
conclusion |
Erforderlich. Das Ergebnis der Abfolge der Überprüfungsversuche. Wenn das Feld auf |
response_id |
Erforderlich. Die ID der Antwort, für die dieses Feedback vorgesehen ist. Dies sollte die [response_id][google.maps.addressValidation.v1.ValidateAddressRequest.response_id] aus der ersten Antwort in einer Reihe von Versuchen der Adressvalidierung sein. |
Überprüfung
Die möglichen Endergebnisse der Abfolge von Anfragen zur Adressbestätigung, die zum Bestätigen 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 Version der von der Address Validation API zurückgegebenen Adresse wurde für die Transaktion verwendet. |
USER_VERSION_USED |
Die Version der vom Nutzer angegebenen Adresse wurde für die Transaktion verwendet |
UNVALIDATED_VERSION_USED |
Für die Transaktion wurde eine Version der Adresse verwendet, die nach dem letzten Bestätigungsversuch eingegeben, aber nicht noch einmal validiert wurde. |
UNUSED |
Die Transaktion wurde abgebrochen. Die Adresse wurde nicht verwendet. |
ValidierungsfeedbackAntworten
Die Antwort für Validierungsfeedback.
Die Antwort ist leer, wenn das Feedback erfolgreich gesendet wurde.
Usps-Adresse
USPS-Repräsentation einer US-Adresse.
Felder | |
---|---|
first_address_line |
Erste Adresszeile. |
firm |
Firmenname. |
second_address_line |
Zweite Adresszeile. |
urbanization |
Puerto-ricanischer Urbanisierungsname. |
city_state_zip_address_line |
Stadt + Bundesland + Postleitzahl. |
city |
Stadt |
state |
2-stelliger Bundesstaatcode |
zip_code |
Postleitzahl, z.B. 10009. |
zip_code_extension |
4-stellige Postleitzahlerweiterung, z.B. 5023. |
USB-Daten
Die USPS-Daten für die Adresse. Es ist nicht garantiert, dass uspsData
bei jeder US- oder PR-Adresse, die an die Address Validation API gesendet wird, vollständig ausgefüllt ist. Wir empfehlen Ihnen, die Felder der Sicherungsadresse in die Antwort einzubinden, wenn Sie „uspsData“ als primären Teil der Antwort verwenden.
Felder | |
---|---|
standardized_address |
USPS-standardisierte Adresse. |
delivery_point_code |
2-stelliger Lieferpunktcode |
delivery_point_check_digit |
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 der Auslieferungsbarcode-, Liefer-, Scheck- und Postleitzahl zusammengerechnet werden, muss die Zahl durch 10 geteilt werden. |
dpv_confirmation |
Mögliche Werte für die DPV-Bestätigung. Gibt ein einzelnes Zeichen zurück.
|
dpv_footnote |
Die Fußnoten aus der Validierung des Lieferpunkts. Mehrere Fußnoten können in einem String miteinander verbunden sein.
|
dpv_cmra |
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.
|
dpv_vacant |
Ist dieser Ort leer? Gibt ein einzelnes Zeichen zurück.
|
dpv_no_stat |
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.
|
carrier_route |
Der Routencode des Transportunternehmens. Ein Code aus vier Zeichen, der aus einem einstelligen Präfix und einer dreistelligen Routenbezeichnung besteht. Präfixe:
|
carrier_route_indicator |
Anzeige zur Sortierung der vom Transportunternehmen berechneten Preise. |
ews_no_match |
Die Lieferadresse kann abgeglichen werden, die EWS-Datei gibt jedoch an, dass eine genaue Übereinstimmung bald verfügbar sein wird. |
post_office_city |
Stadt in der Hauptpoststelle. |
post_office_state |
Hauptpostamt |
abbreviated_city |
Abgekürzte Stadt. |
fips_county_code |
FIPS County-Code. |
county |
Name des Landkreises. |
elot_number |
eLOT-Nummer (Extended Line of Travel) |
elot_flag |
eLOT Aufsteigende/absteigende Flagge (A/D). |
lacs_link_return_code |
LACSLink-Rückgabecode. |
lacs_link_indicator |
LACSLink-Indikator. |
po_box_only_postal_code |
Nur Postfach. |
suitelink_footnote |
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.
|
pmb_designator |
PMB (Private Postfach) Gerätekennzeichnung. |
pmb_number |
PMB-Nummer (Private Mail Box) |
address_record_type |
Typ des Adresseintrags, der mit der Eingabeadresse übereinstimmt.
|
default_address |
Zeigt an, dass eine Standardadresse gefunden wurde, aber spezifischere Adressen vorhanden sind. |
error_message |
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. |
cass_processed |
Zeigt an, dass die Anfrage verarbeitet wurde. |
Anfrage bestätigen
Die Anfrage zur Validierung einer Adresse.
Felder | |
---|---|
address |
Erforderlich. Die zu validierende Adresse. Nicht formatierte Adressen müssen über Die Gesamtlänge der Felder in dieser Eingabe darf 280 Zeichen nicht überschreiten. Der Die Address Validation API ignoriert die Werte in |
previous_response_id |
Dieses Feld muss für die erste Anfrage zur Adressbestätigung leer sein. Wenn mehr Anfragen erforderlich sind, um eine einzelne Adresse vollständig zu validieren (z. B. wenn die Änderungen des Nutzers nach der ersten Validierung noch einmal überprüft werden müssen), muss in jeder nachfolgenden Anfrage das Feld |
enable_usps_cass |
Aktiviert den Modus „PSS CASS“. Dies wirkt sich nur auf das Feld Es wird empfohlen, ein komponentenbasiertes |
ValidatorAddressResponse
Die Antwort auf eine Anfrage zur Adressbestätigung.
Felder | |
---|---|
result |
Das Ergebnis der Validierung der Adresse. |
response_id |
Die UUID, die diese Antwort identifiziert. Eine erneute Validierung der Adresse muss durch die UUID begleitet werden. |
ValidationResult
Das Ergebnis der Validierung einer Adresse.
Felder | |
---|---|
verdict |
Meldungen zum Urteil insgesamt |
address |
Informationen zur Adresse selbst, nicht zum Geocode |
geocode |
Informationen zum Ort und Ort, an den die Adresse geocodiert wurde. |
metadata |
Sonstige für die Bereitstellung relevante Informationen. Es ist nicht garantiert, dass |
usps_data |
Zusätzliche Zustellungsflags von USPS. Nur in den Regionen |
Ergebnis
Eine allgemeine Übersicht über das Ergebnis der Adressenbestätigung und die Geocodierung.
Felder | |
---|---|
input_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 Wenn die Eingabeadresse beispielsweise eine bestimmte Wohnungsnummer enthält, ist |
validation_granularity |
Der Detaillierungsgrad, mit dem die API die Adresse vollständig überprüfen kann. Beispiel: Das Ergebnis der Überprüfung der Adresskomponenten findest du unter |
geocode_granularity |
Informationen zum Detaillierungsgrad von Dies kann gelegentlich von den oben genannten |
address_complete |
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 |
has_unconfirmed_components |
Mindestens eine Adresskomponente kann nicht kategorisiert oder validiert werden. Weitere Informationen finden Sie unter |
has_inferred_components |
Mindestens eine Adresskomponente wurde abgeleitet (hinzugefügt), die nicht in der Eingabe enthalten war. Weitere Informationen finden Sie unter |
has_replaced_components |
Mindestens eine Adresskomponente wurde ersetzt. Weitere Informationen finden Sie unter |
Detaillierungsgrad
Die verschiedenen Detaillierungsgrade, die eine Adresse oder ein Geocode haben kann. Wenn Sie den Detaillierungsgrad für eine Adresse angeben, geben diese Werte an, wie detailliert die Adresse ist. So erkennt beispielsweise eine Adresse wie „Hauptstraße 123, 12347 Berlin“ eine PREMISE
, während eine Adresse wie „Redwood City, Kalifornien, 94061“ eine LOCALITY
identifiziert. Wenn wir jedoch keine Geocoding-Anfrage für „Hauptstraße 123“ in Redwood City finden können, ist diese möglicherweise über den Detaillierungsgrad LOCALITY
möglich, obwohl die Adresse detaillierter ist.
Enums | |
---|---|
GRANULARITY_UNSPECIFIED |
Standardwert Dieser Wert wird nicht verwendet. |
SUB_PREMISE |
Ergebnisse unter dem Gebäude, z. B. eine Wohnung |
PREMISE |
Ergebnis auf Gebäudeebene. |
PREMISE_PROXIMITY |
Ein Geocode, der den ungefähren Standort auf Gebäudeebene der Adresse angibt. |
BLOCK |
Die Adresse oder der Geocode gibt einen Block an. Wird nur in Regionen mit Adressierung auf Blockebene verwendet, z. B. Japan. |
ROUTE |
Der Geocode oder die Adresse ist eine Route, z. B. eine Straße, eine Straße oder eine Autobahn. |
OTHER |
Alle anderen Detaillierungsgrade, die in Buckets zusammengefasst werden, da sie nicht zustellbar sind. |