Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Lösung für die Adressvalidierung auswählen

Flussdiagramm mit einer allgemeinen Übersicht über die Testschritte.

Ziel

Die Address Validation API bietet Mehrwert für eine Vielzahl von Anwendungsfällen. Neben der reinen Qualität der Testergebnisse gibt es weitere wichtige Aspekte, die Sie berücksichtigen sollten. Dazu gehören beispielsweise eine ganzheitliche Sicht auf kompatible Produkte in einem Nutzerfluss wie Place Autocomplete und Maps, die regionale Verfügbarkeit sowie das Vertrauen und die Zuverlässigkeit von Unternehmen.

Wenn Sie die Address Validation API bewerten möchten, empfehlen wir Ihnen, die folgenden Richtlinien im Rahmen Ihrer Tests zu verwenden.

Die Ziele dieses Tests sind:

Bestätigen, dass die Address Validation API für Ihren Anwendungsfall geeignet ist.
Prüfen, inwiefern die Address Validation API Ihre Lösungsanforderungen erfüllt, z. B.:
- Adressen mit guter Qualität identifizieren.
- Auf Adresseingaben mit schlechter Qualität hinweisen.
- Adressdaten korrigieren, einschließlich Schlussfolgerungen, Ersetzungen und Rechtschreibkorrekturen.
- Eine formatierte Adresse für den Versand bereitstellen.
- Auf fehlende oder falsche Daten zu Unteradressen hinweisen (nur USA).
Sicherstellen, dass Sie durch die Implementierung der API einen messbaren Nutzen erzielen.

Nachdem Sie den Test durchgeführt haben, können Sie die oben genannten Fragen beantworten und feststellen, ob die API für Ihr Unternehmen geeignet ist.

Daten vorbereiten

Der Test sollte mit einer Stichprobe Ihrer vorhandenen Adressdaten durchgeführt werden. Wählen Sie die Daten für den Test nicht manuell aus, sondern verwenden Sie Zufallsstichproben, die für die Regionen repräsentativ sind, in denen Sie tätig sind. Wenn Sie beispielsweise sowohl in den USA als auch im Vereinigten Königreich tätig sind, 70% Ihres Geschäfts aber im Vereinigten Königreich und 30% in den USA abgewickelt werden, sollte sich diese Aufteilung in der Stichprobe widerspiegeln.

Verwenden Sie Adressen aus dem Zeitpunkt der Erfassung. Wenn Sie beispielsweise die Address Validation in Ihrem E-Commerce-Checkout implementieren möchten, verwenden Sie die Adressen, die von Ihren Kunden im Formular eingegeben wurden, bevor eine Verarbeitung erfolgt ist, die durch die Implementierung der Address Validation API ersetzt werden kann.

Bereiten Sie für den Test eine Stichprobengröße von etwa 5.000 bis 10.000 Datensätzen vor.

API aufrufen

Voraussetzung für den Abschnitt: Sie wissen, wie Sie eine Anfrage zur Adressvalidierung senden.

Nachdem Sie die Daten vorbereitet haben, müssen Sie jeden Adressdatensatz mit der API abgleichen.

Eine Anleitung zum Aufrufen von the API finden Sie in der Dokumentation zur Address Validation API. Außerdem haben wir einen Artikel mit Best Practices für die Verwendung der Address Validation API zur Verarbeitung großer Mengen von Adressen.

Das Ergebnis dieses Schritts sollte eine Datenausgabe von der API für jeden Adressdatensatz sein. Anschließend können Sie die Ergebnisse analysieren, um die Eignung der API für Ihren Anwendungsfall zu ermitteln. Ob Sie dazu eine Tabellenkalkulation, eine Datenbank oder ein anderes Tool verwenden, bleibt Ihnen überlassen.

Ergebnisse überprüfen

Voraussetzung für den Abschnitt: Sie wissen, wie Sie mit der Validierungsantwort umgehen, und kennen insbesondere die Konzepte „Korrigieren“, „Bestätigen“ und „Akzeptieren“.

In diesem Abschnitt werden Ausgabeszenarien beschrieben, die Sie analysieren können, um die Eignung der Lösung zu bewerten.

Übersicht der wichtigsten API-Felder in diesem Dokument

Antwortdaten	Was ist das?	Wie auswerten	Wie hilft das?
verdict.inputGranularity	Beschreibt die Eingabegenauigkeit der Adresse.	SUB_PREMISE PREMISE PREMISE_PROXIMITY BLOCK ROUTE OTHER	Ermöglicht es Ihnen, festzustellen, ob die eingegebene Adresse genügend Daten enthält, um potenziell gültig zu sein.
verdict.validationGranularity	Beschreibt die allgemeine Validierung der Ausgabe der Adresse.	SUB_PREMISE PREMISE PREMISE_PROXIMITY BLOCK ROUTE OTHER	Ermöglicht es Ihnen, die allgemeine Adressqualität in der Ausgabe der API zu bestimmen.
verdict.hasInferredComponents	Gibt an, ob die API eine Komponente abgeleitet hat.	Richtig oder falsch	Die API kann fehlende Komponenten hinzufügen, wenn sie die Daten ableiten kann. Beispiel: ein fehlender Ländercode.
verdict.hasReplacedComponents	Gibt an, ob die API eine Komponente ersetzt hat.	Richtig oder falsch	In einigen Fällen kann die API falsche Komponenten durch die richtigen Daten ersetzen.
verdict.addressComplete	Gibt an, ob die Adresse vollständig ist.	Richtig oder falsch	Wenn die API feststellt, dass die Ausgabeadresse alle erforderlichen Komponenten enthält, ist dieser Wert „true“.
address.missingComponentTypes	Signal zur Warnung, wenn in der Adresse Komponenten fehlen.	Werte finden Sie in Tabelle 2.	Fehlende Komponenten aus einer unvollständigen Adresse hervorheben.

Gültige Adressen überprüfen

Sortieren Sie die von der API zurückgegebenen Daten, um die Adressen zu ermitteln, die von Ihrem System als gültig akzeptiert würden. Wichtige Signale der API sind:

verdict.validationGranularity enthält PREMISE oder einen besseren Wert.
verdict.addressComplete ist true.
Keine abgeleiteten oder ersetzten Komponenten.

Weitere Informationen finden Sie unter Adresse akzeptieren.

Das Ergebnis dieser Übung sollte eine Teilmenge der Adressdaten sein, die von Ihrem System als gültig akzeptiert würden. An diesem Punkt können Sie Folgendes feststellen:

Ist die Akzeptanzrate akzeptabel?
Wenn Sie einen vorhandenen Workflow zur Adressvalidierung verwenden, ist die Akzeptanzrate gleich oder besser?

Beispiel: Gültige Adresse

Eingegebene Adresse	Region
76 Buckingham Palace Road, London SW1W 9TQ	Vereinigtes Königreich

Einstufung

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true
}

Ungültige Adressen überprüfen

In diesem Schritt können Sie einige der als ungültig markierten Adressdaten manuell überprüfen und feststellen, ob diese ungültige Adresse ohne Verwendung der Address Validation API zu Problemen führen könnte.

Sortieren Sie die von der API zurückgegebenen Daten, um die Adressen zu ermitteln, die von Ihrem System als ungültig markiert würden. Wichtige Signale der API sind:

verdict.validationGranularity ist je nach Risikostufe auf OTHER oder ROUTE festgelegt.
verdict.addressComplete ist false.

Weitere Informationen finden Sie unter Adresse korrigieren.

Das Ergebnis dieser Übung sollte eine Teilmenge der Adressdaten sein, die von Ihrem System als ungültig markiert würden. An diesem Punkt können Sie feststellen, ob die Rate ungültiger Adressen akzeptabel ist.

Es ist wichtig zu beachten, dass das Markieren von Adressen als ungültig eine Kernfunktion der Address Validation API ist. Eine hohe Rate von als ungültig markierten Adressen spiegelt nicht unbedingt die Qualität der API wider. Die API informiert Sie darüber, dass mit der Adresse etwas nicht stimmt. So können Sie Fehler früher erkennen und Probleme vermeiden.

Beispiel: Ungültige Adresse

Eingegebene Adresse	Region
21 45 40th street	USA

Einstufung

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "OTHER",
  "geocodeGranularity": "OTHER",
  "hasUnconfirmedComponents": true
}

Fehlende oder nicht bestätigte Komponenten überprüfen

In dieser Phase können auch fehlende oder nicht bestätigte Komponenten überprüft werden. Dies ist Teil des Adressobjekts in der Rückgabe. Die beiden Felder sind missingComponentTypes und unconfirmedComponentTypes.

Mit diesen Feldern können Sie den Grund dafür ermitteln, dass eine Adresse von der API als ungültig markiert wurde. Außerdem können Sie die richtigen Informationen für die Adresse erfassen, damit sie gültig ist. Dazu geben Sie an der Stelle der Datenerfassung an, welche Felder falsch sind. So bietet die API Mehrwert, indem sie Ihnen spezifische Informationen zur Qualität Ihrer Daten liefert.

Beispiel: Fehlende und nicht bestätigte Komponente

Eingegebene Adresse	Region
Fake St, New York, NY 10011	USA

Einstufung

{
     "inputGranularity": "ROUTE",
     "validationGranularity": "OTHER",
     "geocodeGranularity": "OTHER",
     "hasUnconfirmedComponents": true
}

Fehlende und nicht bestätigte Komponenten

"missingComponentTypes": [
    "street_number"
],
"unconfirmedComponentTypes": [
    "route"
]

Adressen mit Korrekturen überprüfen

Die Address Validation API kann Korrekturen an Eingabedaten vornehmen und aus einer potenziell ungültigen Adresseingabe gültige Adressdaten ausgeben. Das ist ein Beispiel dafür, wie die API Mehrwert bietet. Dies sollte im Rahmen des Tests erfasst werden.

Wichtige Signale sind:

inferred, replaced oder spellCorrected ist für eine der addressComponents auf true gesetzt.
verdict.hasInferredComponentsoder verdict.hasReplacedComponents ist auf true gesetzt.

Weitere Informationen finden Sie unter Adresse bestätigen.

Das Ergebnis dieser Übung sollte eine Teilmenge der Adressdaten sein, die von der API korrigiert wurden.

Ein Teil dieser Daten kann manuell überprüft werden, um festzustellen, ob die API Korrekturen an Ihren Daten vornimmt, die Reibungsverluste in Ihrem nachgelagerten Workflow reduzieren.

Beispiel: Adresse mit Korrektur

Eingegebene Adresse	Region
76 Bruckingm Palace Road, London SW1W 9TQ	Vereinigtes Königreich

Route addressComponent

{
    "componentName": {
        "text": "Buckingham Palace Road",
        "languageCode": "en"
    },
    "componentType": "route",
    "confirmationLevel": "CONFIRMED",
    "spellCorrected": true
}

[Nur USA] Adresse mit fehlenden oder falschen Daten zu Unteradressen überprüfen

Die Address Validation API kann für US-Adressen feststellen, ob eine Unteradresse fehlt oder falsch ist.

Wichtige Signale sind:

Im Adressobjekt:
- unconfirmedComponentTypes enthält subpremise
- missingComponentTypes enthält subpremise
Im UspsData-Objekt:
- dpvConfirmation ist D (Unteradresse fehlt)
- dpvConfirmation ist S (Unteradresse nicht bestätigt)

Weitere Informationen finden Sie unter Adressen in den USA verarbeiten.

Dieser Test zeigt, ob es in Ihren Daten Probleme mit fehlenden oder falschen Unteradressen wie Wohnungsnummern gibt. Dies kann zu Problemen führen, insbesondere bei Lieferanwendungsfällen. Die Address Validation API kann Ihren Workflow verbessern, indem sie diese Probleme früher erkennt. So können Sie Schritte implementieren, um korrigierte Daten zu erfassen.

Beispiel: Fehlende Unteradresse

Eingegebene Adresse	Region
111 8th Avenue, Manhattan, NY 10011	USA

Fehlende Komponente

"missingComponentTypes": [
    "subpremise"
]

USPS-Daten – DPV-Bestätigung

"dpvConfirmation": "D"

[Nur USA] USPS-standardisierte Adresse überprüfen

Die Address Validation API gibt auch die USPS-standardisierte Adresse für US-Adressen zurück. Das ist besonders wichtig, wenn auf Ihren Versandetiketten Adressen im USPS-Format gedruckt werden müssen.

Sie können UspsAddress überprüfen, um diese Daten aufzurufen und festzustellen, ob sie Ihren Workflow um Wert erweitern.

Beispiel: USPS-standardisierte Adresse

"standardizedAddress": {
    "firstAddressLine": "111 8TH AVE FL 11",
    "cityStateZipAddressLine": "NEW YORK NY 10011-5201",
    "city": "NEW YORK",
    "state": "NY",
    "zipCode": "10011",
    "zipCodeExtension": "5201"
}

Fazit

Jetzt testen: Beginnen Sie noch heute mit dem Testen der Address Validation API, um genaue Adressdaten zu erhalten, das Kundenerlebnis zu verbessern und Ihre Geschäftsprozesse zu optimieren. Nachdem Sie die oben beschriebenen Testszenarien durchlaufen haben, haben Sie die Informationen, die Sie benötigen, um zu entscheiden, ob die Address Validation API Ihren Workflow verbessert.

Empfohlene Artikel:

Beitragende

Henrik Valve | DevX Engineer

Lösung für die Adressvalidierung auswählen Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Ziel

Daten vorbereiten

API aufrufen

Ergebnisse überprüfen

Gültige Adressen überprüfen

Beispiel: Gültige Adresse

Ungültige Adressen überprüfen

Beispiel: Ungültige Adresse

Fehlende oder nicht bestätigte Komponenten überprüfen

Beispiel: Fehlende und nicht bestätigte Komponente

Adressen mit Korrekturen überprüfen

Beispiel: Adresse mit Korrektur

[Nur USA] Adresse mit fehlenden oder falschen Daten zu Unteradressen überprüfen

Beispiel: Fehlende Unteradresse

[Nur USA] USPS-standardisierte Adresse überprüfen

Beispiel: USPS-standardisierte Adresse

Fazit

Beitragende

Lösung für die Adressvalidierung auswählen