Method: validateAddress

{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}

integer

Bản sửa đổi giản đồ của PostalAddress. Bất kỳ giá trị nào khác 0 sẽ khiến API trả về lỗi INVALID_ARGUMENT.

string

Không bắt buộc. Mã vùng CLDR của quốc gia/khu vực trong địa chỉ. Hãy tham khảo https://cldr.unicode.org/ và https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html để biết thông tin chi tiết. Ví dụ: "CH" cho Thuỵ Sĩ. Nếu bạn không cung cấp mã vùng thì mã đó sẽ được suy ra từ địa chỉ đó. Để đạt được hiệu suất tốt nhất, bạn nên thêm mã vùng nếu biết. Việc có các khu vực không nhất quán hoặc lặp lại có thể dẫn đến hiệu suất kém. Ví dụ: nếu addressLines đã bao gồm khu vực đó, thì bạn không nên cung cấp lại mã khu vực trong trường này. Bạn có thể xem các khu vực được hỗ trợ trong phần Câu hỏi thường gặp.

string

Mã ngôn ngữ trong địa chỉ nhập được dành riêng để sử dụng sau này và sẽ bị bỏ qua hôm nay. API trả về địa chỉ bằng ngôn ngữ thích hợp cho vị trí của địa chỉ đó.

string

Không bắt buộc. Mã bưu chính của địa chỉ. Không phải quốc gia nào cũng sử dụng hoặc yêu cầu mã bưu chính phải xuất hiện, nhưng ở Hoa Kỳ, các quốc gia đó có thể kích hoạt quy trình xác thực bổ sung với các phần khác của địa chỉ (ví dụ: xác thực tiểu bang/mã bưu chính tại Hoa Kỳ).

string

Không bắt buộc. Mã phân loại bổ sung, theo quốc gia cụ thể. Thông tin này không được sử dụng ở hầu hết các khu vực. Khi giá trị được sử dụng, giá trị này phải là một chuỗi như "CEDEX", theo sau là một số (ví dụ: "CEDEX 7") hoặc chỉ là một số, đại diện cho "mã ngành" (Jamaica), "chỉ báo khu vực giao hàng" (Malawi) hoặc "chỉ báo bưu điện" (ví dụ: Côte d'Côte d' thận).

string

Không bắt buộc. Phân khu hành chính cao nhất được dùng cho địa chỉ bưu chính của một quốc gia hoặc khu vực. Ví dụ: bạn có thể nhập một tiểu bang, một tỉnh, một vùng hoặc một tỉnh. Cụ thể, đối với Tây Ban Nha, đây là tỉnh và không phải cộng đồng tự trị (ví dụ: "Barcelona" chứ không phải "Catalonia"). Nhiều quốc gia không sử dụng khu vực hành chính trong địa chỉ bưu điện. Ví dụ: ở Thuỵ Sĩ, bạn không nên điền giá trị này.

string

Không bắt buộc. Nói chung là phần thành phố/thị trấn của địa chỉ. Ví dụ: Thành phố ở Hoa Kỳ, xã CNTT, thị trấn có bưu điện của Vương quốc Anh. Trong các khu vực trên thế giới nơi các địa phương không được xác định rõ hoặc không phù hợp với cấu trúc này, hãy để trống địa phương và sử dụng addressLines.

string

Không bắt buộc. Quận/phường của địa chỉ. Ví dụ: đây có thể là vùng lân cận, thị xã, quận.

string

Bắt buộc. Dòng địa chỉ phi cấu trúc mô tả các cấp thấp hơn của một địa chỉ.

Vì các giá trị trong addressLines không có thông tin về kiểu và đôi khi có thể chứa nhiều giá trị trong một trường (ví dụ: "Austin, TX"), nên bạn cần phải đảm bảo thứ tự dòng rõ ràng. Thứ tự của dòng địa chỉ phải là "thứ tự phong bì" cho quốc gia/khu vực trong địa chỉ.

Cách trình bày cấu trúc tối thiểu được phép của một địa chỉ bao gồm tất cả thông tin được đặt trong addressLines. Nếu bạn không cung cấp regionCode, khu vực sẽ được suy ra từ các dòng địa chỉ.

Tạo một địa chỉ chỉ chứa addressLines, và sau đó mã hoá địa lý là cách được khuyến nghị để xử lý các địa chỉ hoàn toàn không có cấu trúc (thay vì đoán phần nào của địa chỉ sẽ là thành phố hoặc khu vực hành chính).

string

Vui lòng tránh đặt trường này. API xác thực địa chỉ hiện không sử dụng API này. Mặc dù tại thời điểm này, API sẽ không từ chối các yêu cầu có nhóm trường này, nhưng thông tin sẽ bị loại bỏ và sẽ không được trả về trong phản hồi.

string

Vui lòng tránh đặt trường này. API xác thực địa chỉ hiện không sử dụng API này. Mặc dù tại thời điểm này, API sẽ không từ chối các yêu cầu có nhóm trường này, nhưng thông tin sẽ bị loại bỏ và sẽ không được trả về trong phản hồi.

{
  "returnEnglishLatinAddress": boolean
}

boolean

Xem trước: Trả về google.maps.addressvalidation.v1.Address bằng tiếng Anh. Hãy xem google.maps.addressvalidation.v1.ValidationResult.english_latin_address để biết chi tiết.

{
  "verdict": {
    object (Verdict)
  },
  "address": {
    object (Address)
  },
  "geocode": {
    object (Geocode)
  },
  "metadata": {
    object (AddressMetadata)
  },
  "uspsData": {
    object (UspsData)
  },
  "englishLatinAddress": {
    object (Address)
  }
}

object (Verdict)

Cờ cho kết quả tổng thể

object (Address)

Thông tin về chính địa chỉ đó chứ không phải mã địa lý.

object (Geocode)

Thông tin về vị trí và địa điểm mà địa chỉ được mã hoá địa lý.

object (AddressMetadata)

Thông tin khác liên quan đến việc giao hàng. metadata không được đảm bảo sẽ được điền đầy đủ dữ liệu cho mọi địa chỉ được gửi đến API xác thực địa chỉ.

object (UspsData)

Cờ giao hàng bổ sung do USPS cung cấp. Chỉ được cung cấp ở khu vực US và PR.

object (Address)

Bản xem trước: Tính năng này đang ở giai đoạn thử nghiệm (trước giai đoạn phát hành rộng rãi). Các sản phẩm và tính năng trước giai đoạn phát hành rộng rãi có thể được hỗ trợ hạn chế, đồng thời có thể những thay đổi đối với những sản phẩm và tính năng trước giai đoạn phát hành rộng rãi có thể không tương thích với những phiên bản trước giai đoạn phát hành rộng rãi. Sản phẩm trước giai đoạn phát hành rộng rãi phải tuân thủ Điều khoản dịch vụ dành riêng cho nền tảng Google Maps. Để biết thêm thông tin, hãy xem nội dung mô tả các giai đoạn ra mắt.

Địa chỉ này được dịch sang tiếng Anh.

Không thể sử dụng lại các địa chỉ đã dịch làm dữ liệu đầu vào của API. Dịch vụ này cung cấp các mã này để người dùng có thể sử dụng ngôn ngữ bản địa của họ để xác nhận hoặc từ chối xác thực địa chỉ được cung cấp ban đầu.

Nếu một phần của địa chỉ không có bản dịch tiếng Anh, thì dịch vụ sẽ trả về phần đó bằng ngôn ngữ thay thế sử dụng chữ viết Latinh. Xem tại đây để xem nội dung giải thích về cách ngôn ngữ thay thế được chọn. Nếu một phần của địa chỉ không có bất kỳ bản dịch hoặc bản chuyển tự nào trong ngôn ngữ sử dụng chữ Latinh, thì dịch vụ sẽ trả về phần đó bằng ngôn ngữ địa phương được liên kết với địa chỉ.

Bật đầu ra này bằng cách sử dụng cờ google.maps.addressvalidation.v1.LanguageOptions.return_english_latin_address.

Lưu ý: trường google.maps.addressvalidation.v1.Address.unconfirmed_component_types trong các trường englishLatinAddress và google.maps.addressvalidation.v1.AddressComponent.confirmation_level trong englishLatinAddress.address_components không được điền sẵn.

{
  "inputGranularity": enum (Granularity),
  "validationGranularity": enum (Granularity),
  "geocodeGranularity": enum (Granularity),
  "addressComplete": boolean,
  "hasUnconfirmedComponents": boolean,
  "hasInferredComponents": boolean,
  "hasReplacedComponents": boolean
}

enum (Granularity)

Độ chi tiết của địa chỉ đầu vào. Đây là kết quả của quá trình phân tích cú pháp địa chỉ đầu vào và không đưa ra tín hiệu xác thực nào. Để biết các tín hiệu xác thực, hãy tham khảo validationGranularity bên dưới.

Ví dụ: nếu địa chỉ nhập chứa số căn hộ cụ thể, thì inputGranularity ở đây sẽ là SUB_PREMISE. Nếu chúng tôi không thể so khớp số căn hộ trong cơ sở dữ liệu hoặc số căn hộ không hợp lệ, validationGranularity có thể sẽ có giá trị là PREMISE hoặc thấp hơn.

enum (Granularity)

Mức độ chi tiết mà API có thể validate đầy đủ địa chỉ. Ví dụ: validationGranularity của PREMISE cho biết có thể xác thực được tất cả các thành phần địa chỉ ở cấp PREMISE trở lên.

Có thể tìm thấy kết quả xác thực thành phần theo từng địa chỉ trong google.maps.addressvalidation.v1.Address.address_components.

enum (Granularity)

Thông tin về mức độ chi tiết của geocode. Điều này có thể được hiểu là ý nghĩa ngữ nghĩa của mức độ tương đối hoặc chi tiết của vị trí được mã hoá địa lý.

Điều này đôi khi có thể khác với validationGranularity ở trên. Ví dụ: cơ sở dữ liệu của chúng tôi có thể ghi lại sự tồn tại của số căn hộ nhưng không có vị trí chính xác của căn hộ trong một khu phức hợp căn hộ lớn. Trong trường hợp đó, validationGranularity sẽ là SUB_PREMISE nhưng geocodeGranularity sẽ là PREMISE.

boolean

Địa chỉ được coi là hoàn chỉnh nếu không có mã thông báo chưa được giải quyết, không có thành phần địa chỉ bị thiếu hoặc không mong muốn nào. Nếu bạn không đặt chính sách này, hãy cho biết giá trị là false. Hãy xem các trường missingComponentTypes, unresolvedTokens hoặc unexpected để biết thêm thông tin.

boolean

Có ít nhất một thành phần địa chỉ không thể phân loại hoặc xác thực được, hãy xem google.maps.addressvalidation.v1.Address.address_components để biết chi tiết.

boolean

Ít nhất một thành phần địa chỉ đã được suy luận (thêm) không có trong dữ liệu đầu vào, hãy xem google.maps.addressvalidation.v1.Address.address_components để biết chi tiết.

boolean

Ít nhất một thành phần địa chỉ đã được thay thế, vui lòng xem google.maps.addressvalidation.v1.Address.address_components để biết thông tin chi tiết.

{
  "formattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "missingComponentTypes": [
    string
  ],
  "unconfirmedComponentTypes": [
    string
  ],
  "unresolvedTokens": [
    string
  ]
}

string

Địa chỉ sau xử lý, có định dạng là địa chỉ một dòng tuân theo các quy tắc định dạng địa chỉ của khu vực đặt địa chỉ đó.

object (PostalAddress)

Địa chỉ sau xử lý được thể hiện dưới dạng địa chỉ bưu điện.

object (AddressComponent)

Danh sách không theo thứ tự. Các thành phần địa chỉ riêng lẻ của địa chỉ đã định dạng và đã sửa, cùng với thông tin xác thực. Dữ liệu này cung cấp thông tin về trạng thái xác thực của từng thành phần.

Các thành phần địa chỉ không được sắp xếp theo một cách cụ thể. Không giả định về thứ tự của các thành phần địa chỉ trong danh sách.

string

Những loại thành phần dự kiến sẽ xuất hiện trong địa chỉ gửi thư được định dạng chính xác nhưng không tìm thấy trong dữ liệu đầu vào VÀ không suy luận được. Các thành phần thuộc loại này không có trong formattedAddress, postalAddress hoặc addressComponents. Ví dụ: ['street_number', 'route'] cho dữ liệu nhập như "Boulder, Colorado, 80301, USA". Bạn có thể xem danh sách các loại tài sản có thể sử dụng tại đây.

string

Loại thành phần có trong addressComponents nhưng không thể xác nhận là chính xác. Trường này được cung cấp để thuận tiện: nội dung của trường tương đương với việc lặp lại thông qua addressComponents để tìm kiểu của tất cả thành phần trong đó confirmationLevel không phải là CONFIRMED hoặc cờ inferred không được đặt thành true. Bạn có thể xem danh sách các loại tài sản có thể sử dụng tại đây.

string

Mọi mã thông báo trong dữ liệu nhập không phân giải được. Đây có thể là dữ liệu đầu vào không được nhận dạng là phần hợp lệ của một địa chỉ (ví dụ: trong giá trị nhập như "123235253253 Main St, San Francisco, CA, 94105", mã thông báo chưa được giải quyết có thể có dạng ["123235253253"] vì mã đó trông không hợp lệ.

{
  "componentName": {
    object (ComponentName)
  },
  "componentType": string,
  "confirmationLevel": enum (ConfirmationLevel),
  "inferred": boolean,
  "spellCorrected": boolean,
  "replaced": boolean,
  "unexpected": boolean
}

object (ComponentName)

Tên cho thành phần này.

string

Loại của thành phần địa chỉ. Xem Bảng 2: Các loại bổ sung được dịch vụ Địa điểm trả về để biết danh sách các loại có thể có.

enum (ConfirmationLevel)

Cho biết mức độ chắc chắn của chúng tôi về việc thành phần này là chính xác.

boolean

Cho biết rằng thành phần này không phải là một phần của thông tin đầu vào, nhưng chúng tôi đã suy luận cho vị trí địa chỉ và cho rằng thành phần này nên được cung cấp cho một địa chỉ đầy đủ.

boolean

Cho biết đã sửa lỗi chính tả trong tên thành phần. API không phải lúc nào cũng gắn cờ các thay đổi từ một biến thể chính tả sang một biến thể chính tả khác, chẳng hạn như khi thay đổi "center" (trung tâm) thành "center". Ngoài ra, không phải lúc nào tính năng này cũng gắn cờ các lỗi chính tả phổ biến, chẳng hạn như khi thay đổi "AmphitThermal Pkwy" thành "Amphitheatre Pkwy".

boolean

Cho biết tên của thành phần đã được thay thế bằng một tên hoàn toàn khác, ví dụ: thay thế mã bưu chính không chính xác bằng một mã địa chỉ chính xác. Đây không phải là thay đổi mang tính thẩm mỹ, thành phần đầu vào đã được thay đổi thành một thành phần khác.

boolean

Cho biết thành phần địa chỉ dự kiến sẽ không xuất hiện trong một địa chỉ bưu chính cho khu vực nhất định. Chúng tôi chỉ giữ lại đoạn mã này vì nó là một phần của dữ liệu đầu vào.

{
  "text": string,
  "languageCode": string
}

string

Văn bản tên. Ví dụ: "5th Avenue" cho tên đường hoặc "1253" cho số nhà.

string

Mã ngôn ngữ BCP-47. Điều này sẽ không xuất hiện nếu tên thành phần không được liên kết với một ngôn ngữ, chẳng hạn như số nhà.

{
  "location": {
    object (LatLng)
  },
  "plusCode": {
    object (PlusCode)
  },
  "bounds": {
    object (Viewport)
  },
  "featureSizeMeters": number,
  "placeId": string,
  "placeTypes": [
    string
  ]
}

object (LatLng)

Vị trí được mã hoá địa lý của đầu vào.

Bạn nên sử dụng mã địa điểm so với việc sử dụng địa chỉ, vĩ độ/kinh độ hoặc mã cộng. Việc sử dụng toạ độ khi định tuyến hoặc tính toán chỉ đường lái xe sẽ luôn dẫn đến việc điểm bị gắn với con đường gần các toạ độ đó nhất. Đây không phải là đường sẽ dẫn tới điểm đến một cách nhanh chóng hoặc an toàn và có thể không nằm gần điểm truy cập vào cơ sở lưu trú. Ngoài ra, khi một vị trí được mã hoá địa lý đảo ngược, chúng tôi không thể đảm bảo rằng địa chỉ được trả về sẽ khớp với địa chỉ ban đầu.

object (PlusCode)

Plus code tương ứng với location.

object (Viewport)

Giới hạn của địa điểm được mã hoá địa lý.

number

Kích thước của địa điểm được mã hoá địa lý, tính bằng mét. Đây là một phép đo khác về độ tương đối của vị trí được mã hoá địa lý, nhưng về kích thước vật lý chứ không phải là về nghĩa ngữ nghĩa.

string

Mã địa điểm của địa điểm mà đầu vào này mã hoá địa lý đến.

Để biết thêm thông tin về Mã địa điểm, vui lòng xem tại đây.

string

(Các) Loại địa điểm mà đầu vào được mã hoá địa lý. Ví dụ: ['locality', 'political']. Bạn có thể xem danh sách đầy đủ các loại tại đây.

{
  "latitude": number,
  "longitude": number
}

number

Vĩ độ tính bằng độ. Giá trị này phải nằm trong khoảng [-90.0, +90.0].

number

Kinh độ tính bằng độ. Giá trị này phải nằm trong khoảng [-180.0, +180.0].

{
  "globalCode": string,
  "compoundCode": string
}

string

Mã toàn cầu (đầy đủ) của địa điểm, chẳng hạn như "9FWM33GV+HQ", đại diện cho khu vực 1/8000 x 1/8000 độ (~ 14 x 14 mét).

string

Mã phức hợp của địa điểm, chẳng hạn như "33GV+HQ, Ramberg, Na Uy", chứa hậu tố của mã toàn cục và thay thế tiền tố bằng tên đã được định dạng của thực thể tham chiếu.

{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}

object (LatLng)

Bắt buộc. Điểm thấp của khung nhìn.

object (LatLng)

Bắt buộc. Điểm cao của khung nhìn.

{
  "business": boolean,
  "poBox": boolean,
  "residential": boolean
}

boolean

Cho biết đây là địa chỉ của một doanh nghiệp. Nếu bạn không đặt chính sách này thì tức là giá trị là không xác định.

boolean

Cho biết rằng địa chỉ của hộp thư bưu điện. Nếu bạn không đặt chính sách này thì tức là giá trị là không xác định.

boolean

Cho biết rằng đây là địa chỉ của một nơi cư trú. Nếu bạn không đặt chính sách này thì tức là giá trị là không xác định.

{
  "standardizedAddress": {
    object (UspsAddress)
  },
  "deliveryPointCode": string,
  "deliveryPointCheckDigit": string,
  "dpvConfirmation": string,
  "dpvFootnote": string,
  "dpvCmra": string,
  "dpvVacant": string,
  "dpvNoStat": string,
  "dpvNoStatReasonCode": integer,
  "dpvDrop": string,
  "dpvThrowback": string,
  "dpvNonDeliveryDays": string,
  "dpvNonDeliveryDaysValues": integer,
  "dpvNoSecureLocation": string,
  "dpvPbsa": string,
  "dpvDoorNotAccessible": string,
  "dpvEnhancedDeliveryCode": string,
  "carrierRoute": string,
  "carrierRouteIndicator": string,
  "ewsNoMatch": boolean,
  "postOfficeCity": string,
  "postOfficeState": string,
  "abbreviatedCity": string,
  "fipsCountyCode": string,
  "county": string,
  "elotNumber": string,
  "elotFlag": string,
  "lacsLinkReturnCode": string,
  "lacsLinkIndicator": string,
  "poBoxOnlyPostalCode": boolean,
  "suitelinkFootnote": string,
  "pmbDesignator": string,
  "pmbNumber": string,
  "addressRecordType": string,
  "defaultAddress": boolean,
  "errorMessage": string,
  "cassProcessed": boolean
}

object (UspsAddress)

Địa chỉ được chuẩn hoá của USPS.

string

Mã điểm giao hàng gồm 2 chữ số

string

Số kiểm tra điểm giao hàng. Số này sẽ được thêm vào cuối delivery_point_barcode đối với thư được quét bằng phương pháp cơ học. Thêm tất cả các chữ số của delivery_point_barcode, deliveryPointCheckDigit, mã bưu chính và ZIP+4 lại với nhau sẽ được số chia hết cho 10.

string

Các giá trị có thể sử dụng để xác nhận DPV. Trả về một ký tự hoặc không trả về giá trị nào.

• N: Không thể xác nhận thông tin về số chính và mọi thông tin phụ về DPV.
• D: Địa chỉ đã được xác nhận DPV cho số điện thoại chính và thiếu thông tin về số điện thoại phụ.
• S: Địa chỉ đã được xác nhận DPV cho số điện thoại chính và thông tin về số phụ đã xuất hiện nhưng chưa được xác nhận.
• Y: Địa chỉ đã được xác nhận DPV cho các số chính và mọi số phụ.
• Trống: Nếu phản hồi không chứa giá trị dpvConfirmation, thì tức là địa chỉ đó chưa được gửi để xác nhận DPV.

string

Chú thích cuối trang từ quy trình xác thực điểm giao hàng. Nhiều chú thích cuối trang có thể được xâu chuỗi với nhau trong cùng một chuỗi.

• AA: Địa chỉ nhập khớp với tệp ZIP+4
• A1: Địa chỉ nhập không khớp với tệp ZIP+4
• BB: Đã khớp với DPV (tất cả thành phần)
• CC: Số phụ không khớp và không bắt buộc
• C1: Số phụ không khớp nhưng bắt buộc
• N1: Địa chỉ cao tầng thiếu số phụ
• M1: Thiếu số chính
• M3: Số chính không hợp lệ
• P1: Thiếu số hộp PO, RR hoặc HC của địa chỉ nhập
• P3: Địa chỉ nhập PO, RR hoặc HC Số hộp không hợp lệ
• F1: Địa chỉ nhập khớp với địa chỉ quân đội
• G1: Địa chỉ nhập khớp với địa chỉ giao hàng chung
• U1: Địa chỉ nhập khớp với một mã ZIP duy nhất
• PB: Địa chỉ đầu vào khớp với bản ghi PBSA
• RR: Địa chỉ đã xác nhận DPV với thông tin PMB
• R1: Địa chỉ đã được xác nhận DPV nhưng không có thông tin về PMB
• R7: Bản ghi R777 hoặc R779 của hãng hàng không
• IA: Đã xác định địa chỉ được thông báo
• TA: Số chính được so khớp bằng cách bỏ alpha ở cuối

string

Cho biết địa chỉ có phải là CMRA (Công ty nhận thư thương mại) không--một doanh nghiệp tư nhân nhận thư cho khách hàng. Trả về một ký tự đơn.

• Y: Địa chỉ là một CMRA
• N: Địa chỉ không phải là CMRA

string

Địa điểm này có còn trống không? Trả về một ký tự đơn.

• Y: Địa chỉ còn trống
• N: Địa chỉ còn trống

string

Đây là địa chỉ không có trạng thái hay địa chỉ đang hoạt động? Không có địa chỉ trong số liệu thống kê là những địa chỉ không có người ở liên tục hoặc là địa chỉ mà USPS không phục vụ. Trả về một ký tự đơn.

• Y: Địa chỉ không hoạt động
• N: Địa chỉ đang hoạt động

integer

Cho biết loại NoStat. Trả về mã lý do dưới dạng số nguyên.

• 1: IDA (Địa chỉ gửi thư nội bộ) – Các địa chỉ không nhận thư trực tiếp từ USPS nhưng được gửi đến địa chỉ thả thư phục vụ các địa chỉ đó.
• 2: CDS – Các địa chỉ chưa thể giao được. Ví dụ: một phân mục mới đã xác định số lô và số chính nhưng chưa có cấu trúc nào về số người lưu trú.
• 3: Va chạm – Các địa chỉ không thực sự xác nhận DPV.
• 4: CMZ (Cao đẳng, quân sự và các loại hình khác) – Mã ZIP + 4 hồ sơ mà USPS đã đưa vào dữ liệu.
• 5: Thường xuyên – Cho biết các địa chỉ không nhận được thư và các địa chỉ này không được tính là nơi giao hàng có thể thực hiện.
• 6: Bắt buộc phải có thông tin phụ – Địa chỉ này phải có thông tin phụ.

string

Cờ cho biết thư được gửi đến một nơi có thể nhận tại một trang web. Trả về một ký tự đơn.

• Y: Thư được gửi đến một nơi có thể nhận tại một trang web.
• N: Thư không được gửi tới một nơi có thể nhận tại một trang web.

string

Cho biết thư không được gửi đến địa chỉ đường phố. Trả về một ký tự đơn.

• Y: Thư không được gửi đến địa chỉ đường phố.
• N: Thư được gửi đến địa chỉ đường phố.

string

Cờ cho biết việc gửi thư không được thực hiện tất cả các ngày trong tuần. Trả về một ký tự đơn.

• Y: Việc gửi thư không được thực hiện tất cả các ngày trong tuần.
• N: Không có chỉ báo rằng việc gửi thư không được thực hiện tất cả các ngày trong tuần.

integer

Số nguyên xác định số ngày không phân phối. Có thể điều tra bằng cờ bit: 0x40 – Chủ Nhật là ngày không giao hàng 0x20 – Thứ Hai là ngày không giao hàng 0x10 – Thứ Ba là ngày không giao 0x08 – Thứ Tư là ngày không giao 0x04 – Thứ Năm là ngày không giao hàng 0x02 – Thứ Sáu là ngày không giao hàng 0x01 – Thứ Bảy là ngày không giao hàng

string

Cờ cho biết có thể vào cửa, nhưng gói hàng sẽ không bị để lại do vấn đề bảo mật. Trả về một ký tự đơn.

• Y: Gói sẽ không được để lại do lo ngại về bảo mật.
• N: Không có chỉ báo rằng gói sẽ không được để lại do vấn đề bảo mật.

string

Cho biết địa chỉ khớp với bản ghi PBSA. Trả về một ký tự đơn.

• Y: Địa chỉ khớp với bản ghi PBSA.
• N: Địa chỉ không khớp với bản ghi PBSA.

string

Cờ cho biết những địa chỉ mà USPS không thể gõ cửa để giao thư. Trả về một ký tự đơn.

• Y: Không thể vào cửa.
• N: Không có chỉ báo là không thể vào cửa.

string

Cho biết địa chỉ có nhiều mã trả về DPV hợp lệ. Trả về một ký tự đơn.

• Y: Địa chỉ đã được xác nhận DPV cho các số chính và mọi số phụ.
• N: Không thể xác nhận thông tin về số chính và mọi thông tin phụ về DPV.
• S: Địa chỉ được xác nhận DPV chỉ cho số chính và thông tin về số phụ đã xuất hiện nhưng không được xác nhận hoặc một alpha cuối của số chính đã bị loại bỏ để khiến DPV trùng khớp và cần có thông tin phụ.
• D: Địa chỉ đã được xác nhận DPV cho số điện thoại chính và thiếu thông tin về số điện thoại phụ.
• R: Địa chỉ đã được xác nhận nhưng chỉ định cho tuyến ảo R777 và R779 cũng như không cung cấp dịch vụ giao hàng USPS.

string

Mã tuyến của nhà mạng. Mã bốn ký tự bao gồm một tiền tố là một chữ cái và một mã chỉ định tuyến đường gồm ba chữ số.

Tiền tố:

• C: Tuyến đường của hãng vận chuyển (hoặc tuyến thành phố)
• R: Tuyến đường nông thôn
• H: Tuyến đường hợp đồng trên đường cao tốc
• B: Mục hộp thư bưu điện
• G: Đơn vị phân phối chung

string

Chỉ báo sắp xếp tốc độ lộ trình của hãng vận chuyển.

boolean

Địa chỉ giao hàng có thể khớp, nhưng tệp EWS cho thấy sẽ sớm có kết quả khớp chính xác.

string

Thành phố của bưu điện chính.

string

Trạng thái của bưu điện chính.

string

Thành phố viết tắt.

string

Mã hạt FIPS.

string

Tên hạt.

string

Số tuyến du lịch nâng cao (eLOT).

string

eLOT Cờ tăng dần/giảm dần (A/D).

string

Mã trả lại LACSLink.

string

Chỉ báo LACSLink.

boolean

Mã bưu chính chỉ dành cho hộp thư bưu điện.

string

Chú thích chân trang từ việc so khớp một con phố hoặc hồ sơ nhà cao tầng với thông tin căn hộ. Nếu tên doanh nghiệp trùng khớp, số phụ sẽ được trả về.

• A: Bản ghi SuiteLink trùng khớp, địa chỉ doanh nghiệp đã được cải thiện.
• 00: Không khớp, địa chỉ doanh nghiệp chưa được cải thiện.

string

Người chỉ định đơn vị PMB (Hộp thư cá nhân).

string

số PMB (Hộp thư cá nhân);

string

Loại bản ghi địa chỉ khớp với địa chỉ đã nhập.

• F: TÌNH HUỐNG. Đây là kết quả trùng khớp với Bản ghi của công ty, đây là mức độ trùng khớp cao nhất hiện có cho một địa chỉ.
• G: PHÂN PHỐI CHUNG. Dữ liệu này khớp với một Hồ sơ phân phối chung.
• H: TÒA NHÀ / CĂN HỘ. Dữ liệu này trùng khớp với một bản ghi về Toà nhà hoặc Căn hộ.
• P: HỘP SAU KHI ĐĂNG TẢI. Mã này khớp với Hộp thư bưu điện.
• R: HỢP ĐỒNG NỀN TẢNG hoặc KHU VỰC CẤP ĐƯỜNG: Đây là hợp đồng trùng khớp với Hồ sơ Tuyến đường nông thôn hoặc hồ sơ Hợp đồng Đường cao tốc, cả hai hồ sơ này có thể có phạm vi Số hộp tương ứng.
• S: BẢN GHI PHỐ: Đây là kết quả trùng khớp với một bản ghi đường phố có chứa một dải số chính hợp lệ.

boolean

Chỉ báo cho biết đã tìm thấy địa chỉ mặc định nhưng có địa chỉ cụ thể hơn.

string

Thông báo lỗi về việc truy xuất dữ liệu USPS. Thông tin này được điền sẵn khi quá trình xử lý USPS bị tạm ngưng do phát hiện thấy các địa chỉ được tạo giả tạo.

Các trường dữ liệu USPS có thể không được điền sẵn khi xuất hiện lỗi này.

boolean

Chỉ báo cho biết yêu cầu đã được xử lý CASS.

{
  "firstAddressLine": string,
  "firm": string,
  "secondAddressLine": string,
  "urbanization": string,
  "cityStateZipAddressLine": string,
  "city": string,
  "state": string,
  "zipCode": string,
  "zipCodeExtension": string
}

string

Dòng địa chỉ đầu tiên.

string

Tên công ty.

string

Dòng địa chỉ thứ hai.

string

Tên đô thị hoá tại Puerto Rico.

string

Thành phố + tiểu bang + mã bưu chính.

string

Tên thành phố.

string

Mã tiểu bang gồm 2 chữ cái.

string

Mã bưu chính, ví dụ: 10009.

string

Mã bưu chính gồm 4 chữ số, ví dụ: 5023.