Thêm địa điểm phụ vào địa chỉ – ví dụ (chỉ ở Hoa Kỳ)
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tài liệu này mô tả một số trường hợp thực tế mà Address Validation API cung cấp các tín hiệu phản hồi đảm bảo hành vi thêm địa điểm phụ từ hệ thống của bạn. Các tín hiệu này chỉ dành cho địa chỉ ở Hoa Kỳ.
Hãy xem Ví dụ về quy trình làm việc trong phần Xây dựng logic xác thực để biết bối cảnh.
Ví dụ thường gặp: thêm cơ sở phụ
Tình huống này minh hoạ một địa chỉ mà hệ thống có thể nhắc khách hàng thêm số căn hộ vào địa chỉ.
Địa chỉ đã nhập
Khu vực
1450 Brickell Avenue, Miami, FL 33131-4065
Hoa Kỳ
Kết quả cho một địa chỉ thiếu thông tin về cơ sở phụ
Ví dụ sau đây đề cập đến trường hợp verdict cho biết các vấn đề về chất lượng địa chỉ cần được điều tra thêm. Ví dụ này cũng minh hoạ cách logic của bạn có thể chuyển từ kết quả sang các thành phần địa chỉ để có được thông tin đầy đủ hơn nhằm nâng cao logic hệ thống.
Thiếu các cơ sở phụ và các thành phần được suy luận và thay thế
Ví dụ này minh hoạ việc nhập một địa chỉ ở Hoa Kỳ nhưng thiếu thông tin về địa phương và mã bưu chính không chính xác.
Địa chỉ đã nhập
Khu vực
1450 Brickell Avenue, FL 33132-4065
Hoa Kỳ
Kết quả cho một cơ sở phụ bị thiếu và các thành phần được suy luận và thay thế
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-08-31 UTC."],[],[],null,["This document describes a number of real-world scenarios where the\nAddress Validation API provides response signals that warrant an *add subpremises*\nbehavior from your system. These signals are only available for US addresses.\nSee [Example workflows](/maps/documentation/address-validation/build-validation-logic#example-workflows) in\n**Build your validation logic** for context.\n| **Note:** The examples here are illustrative, but don't cover all scenarios.\n\nCommon example: add subpremises\n\nThis scenario illustrates an address in which your system might prompt a\ncustomer to add a unit number to the address.\n\n| Address entered | Region |\n|--------------------------------------------|--------|\n| 1450 Brickell Avenue, Miami, FL 33131-4065 | US |\n\nVerdict for an address missing a subpremises\n\nThe example below highlights the important signal. \n\n {\n \"inputGranularity\": \"PREMISE\",\n \"validationGranularity\": \"PREMISE\",\n \"geocodeGranularity\": \"PREMISE\",\n \"possibleNextAction\": \"CONFIRM_ADD_SUBPREMISES\"\n }\n\n| **Action:** For this address, you might prompt your user to add a unit number.\n\nEdge case example: add subpremises\n\nThe following example covers a situation in which the `verdict` indicates\naddress quality issues that warrant further investigation. This examples also\nillustrates how your logic can travel from the verdict to the address components\nto obtain a more complete picture in order to enhance your system logic.\n\nMissing subpremises and inferred and replaced components\n\nThis example illustrates entry of a US address with a missing locality and an\nincorrect postal code.\n\n| Address entered | Region |\n|-------------------------------------|--------|\n| 1450 Brickell Avenue, FL 33132-4065 | US |\n\nVerdict for a missing subpremises and inferred and replaced components \n\n {\n \"inputGranularity\": \"PREMISE\",\n \"validationGranularity\": \"PREMISE\",\n \"geocodeGranularity\": \"PREMISE\",\n \"hasInferredComponents\": true,\n \"hasReplacedComponents\": true,\n \"possibleNextAction\": \"CONFIRM_ADD_SUBPREMISES\"\n }\n\nFurther investigation of the address components reveals that the locality has\nbeen inferred, and the postal code has been replaced. \n\n {\n \"componentName\": {\n \"text\": \"33131\",\n }\n \"componentType\": \"postal_code\",\n \"confirmationLevel\": \"CONFIRMED\",\n \"replaced\": true\n },\n {\n \"componentName\": {\n \"text\": \"Miami\",\n \"languageCode\": \"en\"\n }\n \"componentType\": \"locality\",\n \"confirmationLevel\": \"CONFIRMED\",\n \"inferred\": true\n }\n\n| **Action:** For this address, you might prompt your user to add a unit number, or prompt them to review the entire address."]]