Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Lösungsleitfaden für die Adressbestätigung

Flussdiagramm mit einer allgemeinen Übersicht über die Testschritte.

Ziel

Address Validation bietet einen Mehrwert für eine Vielzahl von Anwendungsfällen. Es gibt jedoch wichtige Überlegungen, die über die reine Qualität der Testergebnisse hinausgehen und die Sie sich ansehen sollten. Beispiele: eine ganzheitliche Ansicht kompatibler Produkte in einem Nutzerablauf wie Place Autocomplete und Maps, regionale Verfügbarkeit sowie Vertrauen und Zuverlässigkeit für Unternehmen.

Wenn Sie die Address Validation API bewerten, sollten Sie die folgenden Richtlinien beachten.

Die Ziele dieses Tests sind:

Prüfen Sie, ob die Address Validation API für Ihren Anwendungsfall geeignet ist.
Prüfen Sie, ob die Address Validation API die Anforderungen Ihrer Lösung erfüllt, z. B.:
- Adressen von guter Qualität identifizieren
- Benachrichtigungen, um auf Eingaben von schlechter Qualität hinzuweisen.
- Korrekturen an Adressdaten vornehmen, einschließlich Ableitungen, Ersetzungen und Rechtschreibkorrekturen.
- Bereitstellung einer formatierten Adresse für den Versand.
- Warnung bei fehlenden oder falschen Daten zu Gebäudeteilen (nur USA)
Achten Sie darauf, dass Sie durch die Implementierung der API einen messbaren Nutzen erzielen.

Nach dem Test 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 repräsentativ für die Regionen sind, in denen Sie tätig sind. Wenn Sie also sowohl in den USA als auch im Vereinigten Königreich tätig sind, aber 70% Ihres Geschäfts im Vereinigten Königreich und 30% in den USA abgewickelt werden, sollte die Stichprobe diese Aufteilung widerspiegeln.

Verwenden Sie Adressen vom Erfassungspunkt. Wenn Sie beispielsweise die Adressvalidierung in Ihrem E-Commerce-Bezahlvorgang implementieren möchten, verwenden Sie die Adressen, die Ihre Kunden in das Formular eingegeben haben, bevor eine bestehende Verarbeitung stattgefunden hat, 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 diesen Abschnitt: Sie müssen wissen, wie Sie eine Anfrage zur Adressvalidierung senden.

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

Informationen zum Aufrufen der API finden Sie in der Dokumentation zur Address Validation API. In einem weiteren Artikel werden Best Practices für die Verwendung der Address Validation API zur Verarbeitung großer Adressmengen beschrieben.

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

Ergebnisse überprüfen

Voraussetzung für diesen Abschnitt: Sie müssen wissen, wie Sie die Validierungsantwort verarbeiten, insbesondere das Konzept von „Korrigieren“, „Bestätigen“ und „Akzeptieren“.

In diesem Abschnitt werden Ausgabeszenarien erläutert, die Sie analysieren können, um die Eignung der Lösung zu beurteilen.

Übersicht über die wichtigsten API-Felder, die in diesem Dokument behandelt werden

Antwortdaten	Was ist das?	Bewertung	Wie hilft es?
verdict.inputGranularity	Beschreibt die Eingabegenauigkeit der Adresse.	SUB_PREMISE PRÄMISSE PREMISE_PROXIMITY BLOCKIEREN ROUTE OTHER	Damit können Sie feststellen, ob für die eingegebene Adresse genügend Daten vorhanden sind, um potenziell gültig zu sein.
verdict.validationGranularity	Beschreibt die allgemeine Ausgabebestätigung der Adresse.	SUB_PREMISE PRÄMISSE PREMISE_PROXIMITY BLOCKIEREN ROUTE OTHER	Ermöglicht es Ihnen, die Gesamtqualität der Adressen 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 Bundesstaatscode fehlt.
verdict.hasReplacedComponents	Gibt an, ob die API eine Komponente ersetzt hat.	Richtig oder falsch	In einigen Szenarien 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, das warnt, wenn in der Adresse Komponenten fehlen.	Die Werte finden Sie in Tabelle 2.	Fehlende Komponenten einer unvollständigen Adresse hervorheben.

Gültige Adressen prüfen

Sortieren Sie die von der API zurückgegebenen Daten, um die Adressen zu ermitteln, die Ihr System als gültig akzeptieren würde. Wichtige Signale, auf die Sie bei der API achten sollten:

verdict.validationGranularity enthält PREMISE oder besser.
verdict.addressComplete liegt bei 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 werden. An dieser Stelle können Sie Folgendes festlegen:

Ist die Akzeptanzrate in Prozent akzeptabel?
Wenn Sie einen vorhandenen Workflow zur Address Validation 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 prüfen

In diesem Schritt können Sie einige der als ungültig markierten Adressdaten manuell prüfen und feststellen, ob die ungültige Adresse ohne die Address Validation API nachgelagerte Probleme verursachen könnte.

Sortieren Sie die von der API zurückgegebenen Daten, um die Adressen zu ermitteln, die Ihr System als ungültig markieren würde. Wichtige Signale, auf die Sie bei der API achten sollten:

verdict.validationGranularity ist je nach Risikostufe auf OTHER oder ROUTE festgelegt.
verdict.addressComplete liegt bei 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 werden. An dieser Stelle können Sie festlegen, ob der Prozentsatz ungültiger Daten akzeptabel ist.

Das Markieren von Adressen als ungültig ist eine Kernfunktion der Address Validation API. Eine hohe Rate von als ungültig markierten Adressen ist nicht unbedingt ein Zeichen für eine schlechte API. Die API informiert Sie darüber, dass etwas mit der Adresse nicht stimmt. So können Sie Fehler früher erkennen, bevor sie später Probleme verursachen, und Ihren Workflow effizienter gestalten.

Beispiel: Ungültige Adresse

Eingegebene Adresse	Region
21 45 40th street	USA

Einstufung

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

Fehlende oder unbestätigte Komponenten prüfen

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

Anhand dieser Felder können Sie herausfinden, warum 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 wird, indem Sie die fehlerhaften Felder an die Stelle der Datenerhebung zurückgeben. So bietet die API einen Mehrwert, indem sie Ihnen spezifische Informationen zur Qualität Ihrer Daten liefert.

Beispiel: Fehlende und unbestätigte Komponente

Eingegebene Adresse	Region
Musterstraße, 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, indem sie eine potenziell ungültige Adresseingabe entgegennimmt und gültige Adressdaten ausgibt. Dies ist eine Möglichkeit, wie die API einen Mehrwert bietet. Es ist wichtig, dies im Rahmen des Tests zu erfassen.

Wichtige Signale, auf die Sie achten sollten:

inferred, replaced oder spellCorrected auf true für eine der addressComponents festgelegt.
verdict.hasInferredComponents oder verdict.hasReplacedComponents auf true festgelegt.

Weitere Informationen finden Sie unter Adresse bestätigen.

Die Ausgabe 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 die Reibung in Ihrem nachgelagerten Workflow verringern würden.

Beispiel: Adresse mit einer Korrektur

Eingegebene Adresse	Region
76 Buckingham 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 Gebäudeteilen überprüfen

Die Address Validation API kann bei US-Adressen feststellen, ob eine Untereinheit fehlt oder falsch ist.

Wichtige Signale, auf die Sie achten sollten:

Im Address-Objekt:
- unconfirmedComponentTypes enthält subpremise
- missingComponentTypes enthält subpremise
Im UspsData-Objekt:
- dpvConfirmation ist D (Gebäudeuntereinheit fehlt)
- dpvConfirmation ist S (Untergebäude unbestätigt)

Weitere Informationen finden Sie unter Adressen in den USA verarbeiten.

Dieser Test zeigt, ob es in Ihren Daten ein Problem mit fehlenden oder falschen Untergebäuden wie Wohnungsnummern gibt. Dies kann zu nachgelagerten Problemen führen, insbesondere bei Anwendungsfällen für die Auslieferung. Die Address Validation API kann Ihrem Workflow Mehrwert verleihen, indem sie solche Probleme frühzeitig erkennt, sodass Sie Schritte zur Erfassung korrigierter Daten implementieren können.

Beispiel: Fehlende Unteradresse

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

Fehlende Komponente

"missingComponentTypes": [
    "subpremise"
]

DPV-Bestätigung der USPS-Daten

"dpvConfirmation": "D"

[Nur USA] USPS standardizedAddress prüfen

Die Address Validation API gibt für US-Adressen auch die standardisierte USPS-Adresse zurück. Das ist besonders wichtig, wenn Sie USPS-formatierte Adressen auf Ihren Versandlabels benötigen.

Sie können UspsAddress prüfen, um diese Daten aufzurufen und festzustellen, ob sie einen Mehrwert für Ihren Workflow bieten.

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

Testen Sie die Address Validation API noch heute, um genaue Adressdaten zu erhalten, die Nutzerfreundlichkeit zu verbessern und Ihre Geschäftsabläufe zu optimieren. Nachdem Sie die oben beschriebenen Testszenarien durchlaufen haben, können Sie entscheiden, ob die Address Validation API für Ihren Workflow nützlich ist.

Empfohlene weitere Informationen:

Beitragende

Henrik Valve | DevX Engineer

Lösungsleitfaden für die Adressbestätigung 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 prüfen

Beispiel: Gültige Adresse

Ungültige Adressen prüfen

Beispiel: Ungültige Adresse

Fehlende oder unbestätigte Komponenten prüfen

Beispiel: Fehlende und unbestätigte Komponente

Adressen mit Korrekturen überprüfen

Beispiel: Adresse mit einer Korrektur

[Nur USA] Adresse mit fehlenden oder falschen Daten zu Gebäudeteilen überprüfen

Beispiel: Fehlende Unteradresse

[Nur USA] USPS standardizedAddress prüfen

Beispiel: USPS-standardisierte Adresse

Fazit

Beitragende

Lösungsleitfaden für die Adressbestätigung