Package google.maps.addressvalidation.v1

Index

Adressvalidierung

Der Dienst zum Überprüfen von Adressen.

Validierungsfeedback geben

rpc ProvideValidationFeedback(ProvideValidationFeedbackRequest) returns (ProvideValidationFeedbackResponse)

Feedback zum Ergebnis der Abfolge von Validierungsversuchen. Dies sollte der letzte Aufruf sein, der nach einer Reihe von Validierungsaufrufen für dieselbe Adresse erfolgt ist. Er sollte nach Abschluss der Transaktion aufgerufen werden. Es sollte nur einmal für die Sequenz 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 die Korrektur falsch geschriebener Teile der Adresse, das Ersetzen falscher Teile und die Ableitung fehlender Teile.

Felder
formatted_address

string

Die nachbearbeitete Adresse, die als einzeilige Adresse gemäß den Formatierungsregeln für Adressen der Region formatiert ist, in der sich die Adresse befindet.
postal_address

PostalAddress

Die nachbearbeitete Adresse, dargestellt als Postanschrift.
address_components[]

AddressComponent

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

Adresskomponenten sind nicht in einer bestimmten Reihenfolge angeordnet. Machen Sie keine Annahmen über die Reihenfolge der Adresskomponenten in der Liste.
missing_component_types[]

string

Die Komponententypen, die in einer korrekt formatierten Postanschrift vorhanden sein sollten, die aber nicht in der Eingabe gefunden wurden UND die nicht abgeleitet werden konnten. Komponenten dieses Typs sind in formatted_address, postal_address oder address_components nicht vorhanden. Beispiel: ['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 Typen der Komponenten, die in address_components vorhanden sind, deren Richtigkeit aber nicht bestätigt werden konnte. Dieses Feld wird zur Vereinfachung bereitgestellt: Sein Inhalt entspricht der Iteration über address_components, um die Typen aller Komponenten zu finden, bei denen das 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

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. Beispiel: In einer Eingabe wie „123235253253 Main St, San Francisco, CA, 94105“ sehen die nicht aufgelösten Tokens möglicherweise wie ["123235253253"] aus, da dies keine gültige Hausnummer ist.

Adresskomponente

Stellt eine Adresskomponente dar, z. B. eine Straße, eine Stadt oder ein 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 unter 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 haben sie jedoch als Adressstandort abgeleitet und glauben, dass sie für eine vollständige Adresse bereitgestellt werden sollte.
spell_corrected

bool

Gibt eine Korrektur eines Rechtschreibfehlers im Komponentennamen an. Die API meldet Änderungen von einer Schreibvariante an eine andere nicht immer, z. B. wenn „centre“ in „center“ geändert wird. Auch häufig verwendete abweichende Schreibweisen, zum Beispiel die Änderung von "Amphitheater Pkwy" in "Amphitheatre Pkwy", werden nicht immer erkannt.
replaced

bool

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

bool

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

Bestätigungsebene

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

Enums
CONFIRMATION_LEVEL_UNSPECIFIED Standardwert Dieser Wert wird nicht verwendet.
CONFIRMED Wir konnten überprüfen, ob diese Komponente existiert und im Zusammenhang mit dem Rest der Adresse sinnvoll ist.
UNCONFIRMED_BUT_PLAUSIBLE Diese Komponente konnte nicht bestätigt werden, es ist jedoch plausibel, dass sie existiert. Dies kann beispielsweise eine Hausnummer innerhalb eines gültigen Nummernbereichs für eine Straße sein, in der die spezifischen Hausnummern nicht bekannt sind.
UNCONFIRMED_AND_SUSPICIOUS Diese Komponente wurde nicht bestätigt und ist wahrscheinlich falsch. Beispiel: ein Stadtteil, der nicht zur übrigen Adresse passt.

Adressmetadaten

Die Metadaten für die Adresse. Das Feld metadata ist nicht zwangsläufig 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 kein Wert festgelegt ist, ist der Wert unbekannt.
po_box

bool

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

bool

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

Komponentenname

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 keiner Sprache zugeordnet ist, z. B. mit einer Hausnummer.

Geocodieren

Enthält Informationen über den Ort, an dem die Eingabe geocodiert wurde.

Felder
location

LatLng

Der geocodierte Ort 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 Routen 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 Zugriffspunkts zum Objekt befindet. Außerdem gibt es bei der umgekehrten Geocodierung eines Standorts keine Garantie, dass die zurückgegebene Adresse mit dem Original übereinstimmt.
plus_code

PlusCode

Der Plus Code, der location entspricht.
bounds

Viewport

Die Grenzen des geocodierten Ortes.
feature_size_meters

float

Die Größe des geocodierten Orts in Metern. Dies ist ein weiteres Maß für die Grobheit des geocodierten Standorts, allerdings nicht hinsichtlich der semantischen Bedeutung, sondern anhand der physischen Größe.
place_id

string

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

Weitere Informationen zu Orts-IDs
place_types[]

string

Der Typ(en) des Ortes, für den die Eingabe geocodiert wurde. Beispiel: ['locality', 'political']. Die vollständige Liste der Typen finden Sie hier.

Sprachoptionen

Vorschau: Diese Funktion ist eine Vorabversion (pre-GA). Pre-GA-Produkte und ‐Funktionen werden möglicherweise 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 der Address Validation API, zusätzliche Informationen in die Antwort aufzunehmen.

Felder
return_english_latin_address

bool

Vorschau: Ein google.maps.addressvalidation.v1.Address auf Englisch zurückgeben. 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: mit globalem Code, mit dem ein Rechteck mit einer Größe von 14 x 14 m (1/8.000. eines Grades) oder kleiner definiert wird, und zusammengesetztem 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 eine Fläche von 1/8.000 × 1/8.000 Grad (~14 × 14 Meter) darstellt.
compound_code

string

Der zusammengesetzte 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 Reihe 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 zur Adressüberprüfung sein.

ValidierungFazit

Die möglichen endgültigen Ergebnisse der Abfolge von Anfragen zur Adressüberprüfung, 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 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 überprüft wurde.
UNUSED Die Transaktion wurde abgebrochen und die Adresse nicht verwendet.

ProvideValidationFeedbackResponse

Dieser Typ hat keine Felder.

Die Antwort auf das Validierungsfeedback.

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

USPS-Adresse

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

Vierstellige Postleitzahlerweiterung, z.B. 5023.

USPS-Daten

Die USPS-Daten für die Adresse. Das Feld uspsData ist nicht zwangsläufig für jede US- oder PR-Adresse, die an die Address Validation API gesendet wird, vollständig ausgefüllt. Es wird empfohlen, die Backup-Adressfelder in die Antwort zu integrieren, wenn Sie uspsData als primären Teil der Antwort verwenden.

Felder
standardized_address

UspsAddress

Standardisierte USPS-Adresse.
delivery_point_code

string

2-stelliger Code der Lieferstelle
delivery_point_check_digit

string

Die Prüfziffer der Lieferstelle. Diese Nummer wird bei mechanisch gescannten E-Mails am Ende des delivery_point_barcode eingefügt. Wenn du alle Ziffern von „delivery_point_barcode“, „delivery_point_check_Ziffer“, „Postleitzahl“ und „Postleitzahl+4“ addierst, erhältst du eine durch 10 teilbare Zahl.
dpv_confirmation

string

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

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

string

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

  • AA: Die eingegebene Adresse stimmt mit der ZIP+4-Datei überein.
  • A1: Die eingegebene Adresse stimmte nicht mit der ZIP+4-Datei überein
  • BB: an DPV angepasst (alle Komponenten)
  • CC: Zweitnummer nicht zugeordnet (vorhanden, aber ungültig)
  • N1: Hochhausadresse hat keine Zweitnummer
  • M1: Primäre Nummer fehlt
  • M3: Primäre Nummer ungültig
  • P1: Nummer des RR- oder Hilfefelds für die Eingabeadresse fehlt
  • P3: Bestellnummer für die eingegebene Adresse, die Bestellnummer oder die Nummer der Hilfebox ist ungültig
  • F1: Eingabeadresse stimmt mit einer Militäradresse überein
  • G1: Eingabeadresse stimmt mit einer allgemeinen Lieferadresse überein
  • U1: Die eingegebene Adresse stimmt mit einer eindeutigen Postleitzahl überein
  • PB: Eingabeadresse stimmt mit PBSA-Eintrag überein
  • RR: Vom öffentlichen Verkehrsunternehmen bestätigte Adresse mit Informationen zum PMB
  • R1: Vom öffentlichen Verkehrsunternehmen bestätigte Adresse ohne PMB-Informationen
  • R7: Carrier Route R777- oder R779-Eintrag
dpv_cmra

string

Gibt an, ob es sich bei der Adresse um eine CMRA (Commercial Mail Recipient Agency) handelt, d. h. ein privates Unternehmen, das E-Mails für Kunden erhält. Gibt ein einzelnes Zeichen zurück.

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

string

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

  • Y: Die Adresse ist leer.
  • N: Die Adresse ist ungültig
dpv_no_stat

string

Handelt es sich um eine Adresse vom Typ „Keine Statistik“ oder eine aktive Adresse? Keine Statistikadressen sind solche, die nicht ständig belegt sind, oder Adressen, die vom USPS nicht bedient werden. Gibt ein einzelnes Zeichen zurück.

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

string

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

Präfixe:

  • C: Route des Transportunternehmens (oder Stadtstraße)
  • R: Landstraße
  • H: Fernstraßenvertragsroute
  • B: Postfach
  • G: Allgemeine Auslieferungseinheit
carrier_route_indicator

string

Sortieranzeige für Routenkosten des Transportunternehmens.
ews_no_match

bool

Die Lieferadresse kann abgeglichen werden, laut EWS-Datei wird aber demnächst eine genaue Übereinstimmung verfügbar sein.
post_office_city

string

Stadt der Hauptpoststelle
post_office_state

string

Hauptstaat der Postfiliale.
abbreviated_city

string

Stadt (abgekürzt)
fips_county_code

string

FIPS County-Code.
county

string

Name des Landkreises.
elot_number

string

eLOT-Nummer (Enhanced Line of Travel)
elot_flag

string

Aufsteigende/absteigende eLOT-Markierung (A/D).
po_box_only_postal_code

bool

Postleitzahl nur für Postfach
pmb_designator

string

PMB-Einheitenbezeichner (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 ist eine Übereinstimmung mit einem allgemeinen Lieferdatensatz.
  • H: GEBRAUCH / WERBEApartment. Dies ist eine Übereinstimmung mit einem Gebäude- oder Apartmentdatensatz.
  • P: POST OFFICE BOX. Dies entspricht einem Postfach.
  • R: ROUTEN- oder HIGHWAY-VERTRAG: Dies ist eine Übereinstimmung mit einer Landstraße oder einem Fernstraßenvertrag, die beide über verknüpfte Box-Nummernbereiche verfügen können.
  • S: STREET RECORD: Dies ist eine Übereinstimmung mit einem Street View-Datensatz, der einen gültigen primären Zahlenbereich enthält.
default_address

bool

Zeigt an, dass eine Standardadresse gefunden wurde, es aber genauere Adressen gibt.
error_message

string

Fehlermeldung für den USPS-Datenabruf. Dieses Feld wird ausgefüllt, wenn die USPS-Verarbeitung aufgrund der Erkennung künstlich erstellter Adressen ausgesetzt wurde.

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

bool

Zeigt an, dass die Anfrage über CASS verarbeitet wurde.

ValidateAddressRequest

Die Anfrage zum Validieren einer Adresse.

Felder
address

PostalAddress

Erforderlich. Die zu überprüfende Adresse. Nicht formatierte Adressen müssen über address_lines gesendet werden.

Die Felder in dieser Eingabe dürfen insgesamt maximal 280 Zeichen lang sein.

Unterstützte Regionen

Der Wert language_code in der Eingabeadresse ist für zukünftige Verwendungen reserviert und wird heute ignoriert. Das validierte Adressergebnis wird anhand 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 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, neu validiert werden müssen, muss dieses Feld in jeder Folgeanfrage mit dem response_id aus der ersten Antwort in der Validierungssequenz gefü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 ein google.type.PostalAddress.region_code von address als „PR“ oder ein google.type.PostalAddress.administrative_area von address als „Puerto Rico“ (Groß-/Kleinschreibung wird nicht berücksichtigt) oder „PR“ angegeben werden.

Wir empfehlen, 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. Vorschau: Diese Funktion ist eine Vorabversion (pre-GA). Pre-GA-Produkte und ‐Funktionen werden möglicherweise 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 der Address Validation API, zusätzliche Informationen in die Antwort aufzunehmen.

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. Wenn die Adresse noch einmal überprüft werden muss, muss diese UUID der neuen Anfrage beigefügt werden.

ValidationResult

Das Ergebnis der Überprüfung einer Adresse.

Felder
verdict

Verdict

Meldungen zu Gesamtergebnissen
address

Address

Informationen über die Adresse selbst im Gegensatz zur Geocodierung.
geocode

Geocode

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

AddressMetadata

Sonstige Informationen, die für die Zustellbarkeit relevant sind. Das Feld metadata ist nicht zwangsläufig für jede Adresse, die an die Address Validation API gesendet wird, vollständig ausgefüllt.
usps_data

UspsData

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

Address

Vorschau: Diese Funktion ist eine Vorabversion (pre-GA). Pre-GA-Produkte und ‐Funktionen werden möglicherweise 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. 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 zur Auswahl der alternativen Sprache 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.

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

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 der Adressüberprüfung und den Geocode.

Felder
input_granularity

Granularity

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

Wenn die Eingabeadresse beispielsweise eine bestimmte Wohnungsnummer enthält, lautet die 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, bei dem die API die Adresse vollständig validieren kann. Ein validation_granularity mit dem Wert PREMISE gibt beispielsweise an, dass alle Adresskomponenten auf der Ebene PREMISE 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 der grob oder fein der geocodierten Position verstanden werden.

Diese kann gelegentlich von den validation_granularity oben abweichen. Es kann beispielsweise sein, dass unsere Datenbank die Existenz einer Wohnungsnummer speichert, aber keinen genauen Standort für die Wohnung in einem großen Apartmentkomplex enthält. In diesem Fall ist validation_granularity SUB_PREMISE, geocode_granularity aber PREMISE.
address_complete

bool

Die Adresse gilt als vollständig, wenn keine nicht aufgelösten Tokens oder keine unerwarteten oder fehlenden Adresskomponenten vorhanden sind. 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

Es wurde mindestens eine Adresskomponente 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 Detaillierungen, die eine Adresse oder ein Geocode haben kann. Wenn diese Werte zur Angabe des Detaillierungsgrads für eine Adresse verwendet werden, geben diese Werte an, wie fein die Adresse ein Versandziel identifiziert. Eine Adresse wie „123 Main Street, Redwood City, CA, 94061“ identifiziert beispielsweise ein PREMISE, während eine Adresse wie „Redwood City, CA, 94061“ ein LOCALITY identifiziert. Wenn wir jedoch keinen Geocode für „Hauptstraße 123“ in Redwood City finden können, hat die zurückgegebene Geocodierung möglicherweise den Detaillierungsgrad LOCALITY, obwohl die Adresse differenzierter 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 ungefähren Standort der Adresse auf Gebäudeebene 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 detailliert für die Route, z. B. eine Straße, Straße oder Autobahn.
OTHER Alle anderen Detaillierungsgrade, die zusammengefasst werden, da sie nicht lieferbar sind.