Xác nhận địa chỉ (ví dụ)

Tài liệu này mô tả một số tình huống thực tế mà trong đó, Address Validation API cung cấp tín hiệu phản hồi cho những địa chỉ cần có hành vi xác nhận từ hệ thống của bạn. Các ví dụ ở đây chỉ mang tính minh hoạ và chưa đầy đủ. Hãy xem phần Tổng quan về quy trình công việc trong bài viết Xây dựng logic xác thực để biết bối cảnh.

Ví dụ thường gặp: xác nhận

Ví dụ sau đây minh hoạ trường hợp các khu vực đô thị có tên đường giống nhau. Giả sử người dùng muốn nhập địa chỉ của Toà nhà Google D ở Kirkland, WA, Hoa Kỳ. Tuy nhiên, thay vì nhập thành phố là Kirkland, họ lại vô tình nhập Seattle.

Địa chỉ đã nhập Khu vực
Building D, 451 7th Avenue South, Seattle, WA 98033 Hoa Kỳ

Kết quả cho dữ liệu được thay thế

Ví dụ dưới đây nhấn mạnh các tín hiệu quan trọng từ kết quả.

{
  "inputGranularity": "SUB_PREMISE",
  "validationGranularity": "PREMISE_PROXIMITY",
  "geocodeGranularity": "PREMISE_PROXIMITY",
  "addressComplete": true,
  "hasUnconfirmedComponents": true
  "hasReplacedComponents": true
}

Mức độ chi tiết PREMISE_PROXIMITY cho biết mức độ gần đúng của một địa chỉ ở cấp toà nhà, nhưng không chi tiết bằng SUB_PREMISE, tức là mức độ chi tiết được cung cấp trong dữ liệu đầu vào. Phản hồi cũng chứa cả thành phần chưa xác nhận và thành phần đã thay thế, vì vậy, sự kết hợp này sẽ đưa phản hồi vào danh mục xác nhận.

Kết quả truy vấn các thành phần địa chỉ cho thấy những vấn đề sau:

{
  "componentName": {
    "text": "451",
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
}
...
{
  "componentName": {
    "text": "98104",
  },
  "componentType": "postal_code",
  "confirmationLevel": "CONFIRMED",
  "replaced": true
}
...
{
  "componentName": {
    "text": "Building D",
    "language_code": "en"
  },
  "componentType": "subpremise",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
}
.......

    "unconfirmedComponentTypes": [
      "street_number",
      "subpremise"
    ]

Trong trường hợp này, Address Validation API đã tìm thấy một địa chỉ gần đúng với địa chỉ được cung cấp ở Seattle và thay thế mã ZIP (một thành phần cấp cao hơn) để phân giải thành địa chỉ Seattle. Đây có thể là một giá trị thay thế hợp lệ, nhưng cùng với việc các thành phần chưa được xác nhận, bạn nên đảm bảo rằng người dùng có ý định nhập địa chỉ ở Seattle chứ không phải địa chỉ khác, chẳng hạn như Kirkland.

Ví dụ về trường hợp đặc biệt: xác nhận

Các ví dụ sau đây minh hoạ các loại trường hợp hiếm gặp:

Các suy luận nhỏ ĐÃ ĐƯỢC xác nhận

Khi kết hợp với dữ liệu đã xác nhận ở cấp độ chi tiết hơn, API vẫn có thể đưa ra suy luận chính xác nếu dữ liệu đầu vào chỉ thiếu một thành phần thuộc các loại sau:

  • Thành phố
  • Tiểu bang
  • Postal code
  • Quốc gia

Ví dụ: khách hàng cung cấp địa chỉ đường phố hợp lệ cho một nhà hàng McDonald's ở Springfield, Massachusetts, nhưng quên nhập thành phố và cung cấp mã ZIP không có phần mở rộng gồm 4 chữ số.

Địa chỉ đã nhập Khu vực
1402 Allen St, MA 01118 Hoa Kỳ

Kết luận về thành phố bị thiếu

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

Trong những trường hợp Address Validation API suy luận các thành phần cấp cao hơn để tạo ra một địa chỉ có thể giao hàng, bạn có thể tin tưởng hơn rằng dữ liệu từ hệ thống là chính xác. Điều này là do các thành phần được suy luận đại diện cho một khu vực địa lý rộng lớn sẽ dễ dàng được so khớp với các thành phần địa chỉ đã xác nhận có thông tin chi tiết hơn. Ngay cả ở những quốc gia có tên thành phố trùng lặp, chẳng hạn như Springfield ở Hoa Kỳ, thì các thành phần khác kết hợp với tên thành phố đó có thể tạo ra một địa chỉ duy nhất.

Sử dụng ví dụ ở trên, quá trình quét trên tất cả các thành phần địa chỉ cho thấy mọi thành phần đều được xác nhận, tức là thành phần đó khớp với dữ liệu do Address Validation API lưu trữ và dịch vụ cũng suy luận ra hai thành phần cấp cao hơn.

{
  "componentName": {
    "text": "Springfield",
    "languageCode": "en"
  },
  "componentType": "locality",
  "confirmationLevel": "CONFIRMED",
  "inferred": true
},
{
  "componentName": {
    "text": "1806"
  },
  "componentType": "postal_code_suffix",
  "confirmationLevel": "CONFIRMED",
  "inferred": true
}

Thành phần địa chỉ không mong muốn CHƯA được xác nhận

Trường hợp này minh hoạ tầm quan trọng của việc kiểm tra khi các thành phần chưa được xác nhận. Nếu một thành phần địa chỉ không như mong đợi, thì Address Validation API sẽ xoá thành phần đó khỏi kết quả. Trong những trường hợp này, bạn có thể chấp nhận địa chỉ hoặc xác nhận lại địa chỉ với khách hàng, tuỳ thuộc vào mức độ rủi ro và mức độ tin cậy của bạn.

Ví dụ: một địa chỉ có thể thuộc một khu vực mà khách hàng thường nhập thông tin vô hại bị cơ quan bưu chính bỏ qua, trong trường hợp đó, bạn sẽ chấp nhận địa chỉ đó. Tuy nhiên, trong một số trường hợp, thành phần chưa được xác nhận có thể không phải là thành phần mà khách hàng muốn.

Địa chỉ đã nhập Khu vực
1 Rue Grenache, la caritat 2, 34630 Saint-Thibéry Pháp

Chưa xác nhận được kết quả cho thành phần địa chỉ không mong muốn

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

Ngoài kết quả có các thành phần chưa được xác nhận, Address Validation API còn trả về địa chỉ được định dạng như sau:

"formattedAddress": "1 Rue Grenache, 34630 Saint-Thibéry, France",

Quá trình quét các thành phần chưa được xác nhận cho thấy API đã xoá la caritat 2 khỏi địa chỉ được trả về:

{
  "componentName": {
    "text": "la caritat 2",
    "languageCode": "fr"
  },
  "componentType": "sublocality_level_1",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
  "unexpected": true
}

Thành phần địa chỉ không mong muốn ĐÃ được xác nhận

Ví dụ này minh hoạ việc thêm một hạt ở Vương quốc Anh vào địa chỉ được cung cấp, đây là một phương pháp phổ biến. Tuy nhiên, đây không phải là yêu cầu của cơ quan bưu chính Vương quốc Anh và về cơ bản là bị bỏ qua. Hãy xem postoffice.co.uk và Cách ghi địa chỉ thư ở Vương quốc Anh và thư quốc tế.

Do đó, khi khách hàng cung cấp hạt trong địa chỉ ở Vương quốc Anh, dịch vụ sẽ đánh giá đây là thông tin đầu vào không mong muốn.

Địa chỉ đã nhập Khu vực
33 Dunalley St, Cheltenham, Gloucestershire, GL50 4AP Vương quốc Anh

Kết luận về thành phần địa chỉ không mong muốn ĐÃ được xác nhận

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

Tại đây, address_complete được đánh giá là false và kết quả phân tích thành phần địa chỉ cho thấy một cờ không mong muốn.

{
  "componentName": {
    "text": "Gloucestershire",
    "languageCode": "en"
  },
  "componentType": "administrative_area_level_2",
  "confirmationLevel": "CONFIRMED",
  "unexpected": true
}

Mặc dù Gloucestershire là hạt chính xác cho địa chỉ đã nhập, nhưng bản thân địa chỉ đó có định dạng không đúng. Hãy nhớ rằng Address Validation API cũng đánh giá thông tin để định dạng đúng cách.