Adresse und Geocoding

Die response eines Address Validation API-Aufrufs enthält einen eindeutigen address und einen eindeutigen geocode. address stellt die beste Darstellung der API in der Eingabe dar und geocode stellt die bestmögliche Einschätzung der API an dem Standort dar, der durch address dargestellt wird.

Dieser Unterschied ist etwas subtil, daher sollte er anhand eines Beispiels illustriert werden.

Anfragen

Der folgende Anfragetext an einen Address Validation API-Aufruf bezieht sich auf eine nicht vorhandene Straße und Hausnummer.

{
  "address": {
    "regionCode": "US",
    "administrativeArea": "California",
    "locality": "Mountain View",
    "addressLines": ["123 Fake St"]
  }
}

Antwort

Der Aufruf zur Address Validation API gibt die unten gezeigte Antwort zurück. Die Antwort enthält mehrere Hinweise:

• address enthält die Hausnummer „123“ und die Straßenkomponente „Fake St“. Sie ist beide als UNCONFIRMED_BUT_PLAUSIBLE gekennzeichnet. Das bedeutet, dass die API die Existenz dieser Straße und Hausnummer nicht bestätigen konnte.

  Obwohl diese Straße und die Hausnummer in unseren Daten nicht vorhanden sind, konnte die API erkennen, dass die semantische Bedeutung dieses Teils der Eingabe eine Straße und eine Hausnummer war. Daher setzt sie die inputGranularity auf PREMISE, was bedeutet, dass die angegebene Adresse genau auf ein Gebäude bezieht.

• Das Feld geocodeGranularity ist OTHER. Das bedeutet, dass die zurückgegebene Geocodierung auf einen großen Bereich verweist. Wenn Sie sich tatsächlich das Feld placeTypes ansehen, erkennen Sie, dass die Geocodierung vom Typ locality ist. Das liegt daran, dass die API nicht die Hausnummer oder Straße finden konnte.

{
  "result": {
    "verdict": {
      "inputGranularity": "PREMISE",
      "validationGranularity": "OTHER",
      "geocodeGranularity": "OTHER",
      "hasUnconfirmedComponents": true
    },
    "address": {
      "formattedAddress": "123 Fake St, Mountain View, CA, USA",
      "postalAddress": {
        "regionCode": "US",
        "languageCode": "en",
        "administrativeArea": "CA",
        "locality": "Mountain View",
        "addressLines": [
          "123 Fake St"
        ]
      },
      "addressComponents": [
        {
          "componentName": {
            "text": "123",
            "languageCode": "en"
          },
          "componentType": "street_number",
          "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
        },
        {
          "componentName": {
            "text": "Fake St",
            "languageCode": "en"
          },
          "componentType": "route",
          "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
        },
        {
          "componentName": {
            "text": "Mountain View",
            "languageCode": "en"
          },
          "componentType": "locality",
          "confirmationLevel": "CONFIRMED"
        },
        {
          "componentName": {
            "text": "CA",
            "languageCode": "en"
          },
          "componentType": "administrative_area_level_1",
          "confirmationLevel": "CONFIRMED"
        },
        {
          "componentName": {
            "text": "USA",
            "languageCode": "en"
          },
          "componentType": "country",
          "confirmationLevel": "CONFIRMED"
        }
      ],
      "missingComponentTypes": [
        "postal_code"
      ],
      "unconfirmedComponentTypes": [
        "street_number",
        "route"
      ]
    },
    "geocode": {
      "location": {
        "latitude": 37.3860517,
        "longitude": -122.0838511
      },
      "plusCode": {
        "globalCode": "849V9WP8+CF"
      },
      "bounds": {
        "low": {
          "latitude": 37.3567832,
          "longitude": -122.1178619
        },
        "high": {
          "latitude": 37.469887,
          "longitude": -122.0446721
        }
      },
      "featureSizeMeters": 9943.329,
      "placeId": "ChIJiQHsW0m3j4ARm69rRkrUF3w",
      "placeTypes": [
        "locality",
        "political"
      ]
    },
    "uspsData": {
      "standardizedAddress": {
        "firstAddressLine": "123 FAKE ST",
        "cityStateZipAddressLine": "MOUNTAIN VIEW",
        "city": "MOUNTAIN VIEW",
        "state": "CA"
      },
      "dpvFootnote": "A1",
      "dpvCmra": "N",
      "postOfficeCity": "MOUNTAIN VIEW",
      "postOfficeState": "CA"
    }
  },
  "responseId": "20cfe06a-9d39-4da6-80e0-eef852e9ea8d"
}