Confronto tra indirizzo e geocodifica

Il response di una chiamata API con convalida degli indirizzi contiene un address univoco e un geocode univoco. address rappresenta la migliore interpretazione dell'indirizzo nell'input da parte dell'API, mentre geocode rappresenta la migliore ipotesi dell'API nella posizione rappresentata da address.

Questa differenza è un po' delicata, per cui vale la pena illustrare un esempio.

Risorse richieste:

Il seguente corpo di richiesta a una chiamata API con convalida indirizzo si riferisce a una via e a un numero civico che non esistono.

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

Risposta

La chiamata all'API Address Validation restituisce la risposta mostrata di seguito. Ci sono diversi aspetti da considerare nella risposta:

• address contiene un componente del numero civico "123" e un componente della strada "Falso finto", entrambi contrassegnati come UNCONFIRMED_BUT_PLAUSIBLE. Ciò significa che l'API non è riuscita a confermare l'esistenza del numero civico e della via.

  Tuttavia, anche se questa strada e il numero non esistono nei nostri dati, l'API è riuscita a riconoscere che il significato semantico di questa parte dell'input era una strada e un numero civico e per questo motivo imposta inputGranularity su PREMISE, a indicare che l'indirizzo specificato è granulare per un edificio.

• Tieni presente che il campo geocodeGranularity è OTHER, a indicare che il codice geografico restituito si riferisce a un'area più ampia. Infatti, esaminando il campo placeTypes puoi vedere che il codice geografico è di tipo locality, cosa che si è verificata perché l'API non è stata in grado di individuare il numero civico o la via.

{
  "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"
}