Địa chỉ so với mã địa lý

response của lệnh gọi API Xác thực địa chỉ chứa address duy nhất và geocode duy nhất. address thể hiện hiểu biết tốt nhất của API về địa chỉ trong dữ liệu đầu vào, còn geocode thể hiện dự đoán chính xác nhất của API tại vị trí mà address biểu thị.

Sự khác biệt này có phần khó phát hiện nên bạn nên lấy ví dụ để minh hoạ.

Yêu cầu

Nội dung yêu cầu sau đây cho lệnh gọi API Xác thực địa chỉ đề cập đến số nhà và số nhà không tồn tại.

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

Phản hồi

Lệnh gọi API Xác thực địa chỉ sẽ trả về phản hồi như minh hoạ bên dưới. Có một số điều cần lưu ý trong câu trả lời:

• address chứa thành phần số đường phố "123" và thành phần đường phố "Fake St" đều được đánh dấu là UNCONFIRMED_BUT_PLAUSIBLE. Điều này có nghĩa là API không thể xác nhận sự tồn tại của số nhà và số phố này.

  Tuy nhiên, mặc dù con phố này và số nhà không tồn tại trong dữ liệu của chúng tôi, nhưng API có thể nhận ra ý nghĩa ngữ nghĩa của phần đầu vào này là một số nhà và số nhà, vì vậy, API này sẽ đặt inputGranularity thành PREMISE, cho biết địa chỉ đã cho là chi tiết về một toà nhà.

• Xin lưu ý trường geocodeGranularity là OTHER, cho biết mã địa lý được trả về đề cập đến một khu vực lớn và trên thực tế, nhìn vào trường placeTypes, bạn có thể thấy rằng mã địa lý thuộc loại locality, điều này xảy ra vì API không thể xác định số nhà hoặc đường phố.

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