Trang này được dịch bởi Cloud Translation API.

Package google.maps.addressvalidation.v1

Chỉ mục

AddressValidation (giao diện)
Address (thông báo)
AddressComponent (thông báo)
AddressComponent.ConfirmationLevel (enum)
AddressMetadata (thông báo)
ComponentName (thông báo)
Geocode (thông báo)
PlusCode (thông báo)
ProvideValidationFeedbackRequest (thông báo)
ProvideValidationFeedbackRequest.ValidationConclusion (enum)
ProvideValidationFeedbackResponse (thông báo)
UspsAddress (thông báo)
UspsData (thông báo)
ValidateAddressRequest (thông báo)
ValidateAddressResponse (thông báo)
ValidationResult (thông báo)
Verdict (thông báo)
Verdict.Granularity (enum)

Xác thực địa chỉ

Dịch vụ xác thực địa chỉ.

Cung cấp phản hồi xác thực

Cung cấp phản hồi xác thực
`rpc ProvideValidationFeedback(ProvideValidationFeedbackRequest) returns (ProvideValidationFeedbackResponse)` Phản hồi về kết quả của trình tự xác thực. Đây phải là lệnh gọi cuối cùng được thực hiện sau một chuỗi các lệnh gọi xác thực cho cùng một địa chỉ và phải được gọi sau khi giao dịch kết thúc. Bạn chỉ nên gửi địa chỉ này một lần cho chuỗi yêu cầu `ValidateAddress` cần thiết để xác thực địa chỉ đầy đủ.

rpc ProvideValidationFeedback(ProvideValidationFeedbackRequest) returns (ProvideValidationFeedbackResponse)

Phản hồi về kết quả của trình tự xác thực. Đây phải là lệnh gọi cuối cùng được thực hiện sau một chuỗi các lệnh gọi xác thực cho cùng một địa chỉ và phải được gọi sau khi giao dịch kết thúc. Bạn chỉ nên gửi địa chỉ này một lần cho chuỗi yêu cầu ValidateAddress cần thiết để xác thực địa chỉ đầy đủ.

Xác thực địa chỉ

Xác thực địa chỉ
`rpc ValidateAddress(ValidateAddressRequest) returns (ValidateAddressResponse)` Xác thực địa chỉ.

rpc ValidateAddress(ValidateAddressRequest) returns (ValidateAddressResponse)

Xác thực địa chỉ.

Address (Địa chỉ)

Thông tin chi tiết về địa chỉ được phân tích cú pháp từ thông tin nhập vào.

Các trường
`formatted_address`	`string` Địa chỉ đã sửa, được định dạng là địa chỉ một dòng tuân theo quy tắc định dạng địa chỉ của khu vực có địa chỉ đó.
`postal_address`	`PostalAddress` Địa chỉ đã xác thực là địa chỉ gửi thư.
`address_components[]`	`AddressComponent` Danh sách không theo thứ tự. Các thành phần địa chỉ riêng lẻ của địa chỉ được định dạng và sửa, cùng với thông tin xác thực. Điều này cung cấp thông tin về trạng thái xác thực của các thành phần riêng lẻ. Các thành phần địa chỉ không được sắp xếp theo cách cụ thể. Đừng giả định về thứ tự của các thành phần địa chỉ trong danh sách.
`missing_component_types[]`	`string` Những loại thành phần dự kiến có trong địa chỉ gửi thư được định dạng chính xác nhưng không thể tìm thấy trong dữ liệu đầu vào VÀ không thể dự đoán được. Các thành phần thuộc loại này không có trong `formatted_address`, `postal_address` hoặc `address_components`. Ví dụ: `['street_number', 'route']` cho dữ liệu đầu vào như "Boulder, Colorado, 80301, Hoa Kỳ". Bạn có thể xem danh sách các loại có thể sử dụng tại đây.
`unconfirmed_component_types[]`	`string` Các loại thành phần có trong `address_components` 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 này tương đương với việc lặp lại thông qua `address_components` để tìm loại tất cả thành phần mà `confirmation_level` 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 có thể sử dụng tại đây.
`unresolved_tokens[]`	`string` Bất kỳ mã thông báo nào trong dữ liệu đầu vào không thể phân giải được. Đây có thể là dữ liệu đầu vào không được nhận dạng là một phần hợp lệ của địa chỉ (ví dụ: trong dữ liệu đầu vào như "123235253253 Main St, San Francisco, CA, 94105", các mã thông báo chưa được phân giải có thể trông giống như `["123235253253"]` vì đó có vẻ như không phải là một số hợp lệ.

Thành phần địa chỉ

Biểu thị một thành phần địa chỉ, chẳng hạn như đường phố, thành phố hoặc tiểu bang.

Các trường
`component_name`	`ComponentName` Tên cho thành phần này.
`component_type`	`string` Loại thành phần địa chỉ. Xem Bảng 2: Các loại bổ sung mà dịch vụ Địa điểm trả về để biết danh sách các loại có thể áp dụng.
`confirmation_level`	`ConfirmationLevel` Cho biết mức độ chắc chắn mà chúng tôi có để đảm bảo rằng thành phần này là chính xác.
`inferred`	`bool` Cho biết rằng thành phần không phải là một phần của thông tin đầu vào, nhưng chúng tôi dự đoán thành phần đó ở vị trí địa chỉ và tin rằng thành phần này nên được cung cấp cho một địa chỉ đầy đủ.
`spell_corrected`	`bool` Cho biết cách viết chính tả của tên thành phần bị sửa theo một cách nhỏ, ví dụ: bằng cách chuyển đổi hai ký tự xuất hiện theo thứ tự không chính xác. Điều này cho thấy một thay đổi thẩm mỹ.
`replaced`	`bool` 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ụ như một mã bưu chính sai được thay thế bằng một mã chính xác cho địa chỉ. Đây không phải là một thay đổi thẩm mỹ, thành phần đầu vào đã được thay đổi thành một thành phần khác.
`unexpected`	`bool` Cho biết thành phần địa chỉ không có khả năng xuất hiện trong địa chỉ bưu điện cho khu vực nhất định. Chúng tôi chỉ giữ lại dữ liệu này vì đó là một phần của dữ liệu đầu vào.

Cấp xác nhận

Các giá trị khác nhau cho các cấp xác nhận.

Enum
`CONFIRMATION_LEVEL_UNSPECIFIED`	Giá trị mặc định. Giá trị này không được sử dụng.
`CONFIRMED`	Chúng tôi có thể xác minh rằng thành phần này tồn tại và có ý nghĩa trong ngữ cảnh của phần còn lại của địa chỉ.
`UNCONFIRMED_BUT_PLAUSIBLE`	Không thể xác nhận thành phần này nhưng thành phần này hợp lý. Ví dụ: số nhà trong phạm vi số hợp lệ đã biết trên phố mà số nhà cụ thể không được biết.
`UNCONFIRMED_AND_SUSPICIOUS`	Thành phần này không được xác nhận và có thể không chính xác. Ví dụ: vùng lân cận không phù hợp với phần còn lại của địa chỉ.

Siêu dữ liệu địa chỉ

Siêu dữ liệu cho địa chỉ. Chúng tôi không đảm bảo rằng metadata sẽ được điền đầy đủ cho mọi địa chỉ được gửi đến API Xác thực địa chỉ.

Các trường

business

bool

Cho biết rằng đâ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ị không xác định.

po_box

bool

Cho biết đị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ị không xác định.

residential

bool

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

Tên thành phần

Trình bao bọc tên cho thành phần.

Các trường

Các trường
`text`	`string` Văn bản tên. Ví dụ: "5th Avenue" cho tên đường hoặc "1253" cho số nhà.
`language_code`	`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 liên kết với một ngôn ngữ, chẳng hạn như số nhà.

text

string

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

language_code

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 liên kết với một ngôn ngữ, chẳng hạn như số nhà.

Mã địa lý

Chứa thông tin về địa điểm chứa dữ liệu được mã hoá địa lý.

Các trường
`location`	`LatLng` Vị trí được mã hoá địa lý của đầu vào. Ưu tiên sử dụng mã địa điểm hơn là sử dụng địa chỉ, toạ độ 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 điểm được bám vào đường gần nhất với các toạ độ đó. Đây có thể 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 ở gần điểm truy cập vào cơ sở lưu trú. Ngoài ra, khi một vị trí được mã hóa địa lý ngược, không có gì đảm bảo rằng địa chỉ trả về sẽ khớp với địa chỉ gốc.
`plus_code`	`PlusCode` Plus code tương ứng với `location`.
`bounds`	`Viewport` Giới hạn của địa điểm được mã hóa địa lý.
`feature_size_meters`	`float` Kích thước của địa điểm được mã hóa địa lý, tính bằng mét. Đây là thước đo khác về độ nhám của vị trí được mã hóa địa lý, nhưng về kích thước thực tế chứ không phải về mặt ngữ nghĩa.
`place_id`	`string` PlaceID của địa điểm mà mục nhập này mã hoá địa lý. Để biết thêm thông tin về Mã địa điểm, hãy xem tại đây.
`place_types[]`	`string` (Các) loại địa điểm mà đầu vào đã mã hoá địa lý. Ví dụ: `['locality', 'political']`. Bạn có thể xem danh sách đầy đủ các loại tại đây.

Mã cộng

Plus code (http://plus.codes) là tham chiếu vị trí có hai định dạng: mã toàn cục xác định hình chữ nhật 14mx14m (1/8000 của độ) hoặc nhỏ hơn và mã phức hợp, thay thế tiền tố bằng vị trí tham chiếu.

Các trường

Các trường
`global_code`	`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).
`compound_code`	`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ầu và thay thế tiền tố bằng tên được định dạng của thực thể tham chiếu.

global_code

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).

compound_code

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ầu và thay thế tiền tố bằng tên được định dạng của thực thể tham chiếu.

Cung cấp Xác thực phản hồi yêu cầu

Yêu cầu gửi phản hồi xác thực.

Các trường

Các trường
`conclusion`	`ValidationConclusion` Bắt buộc. Kết quả của trình tự xác thực. Nếu bạn đặt trường này thành `VALIDATION_CONCLUSION_UNSPECIFIED`, hệ thống sẽ trả về lỗi `INVALID_ARGUMENT`.
`response_id`	`string` Bắt buộc. Mã của phản hồi mà phản hồi này được gửi tới. Đây phải là [response_id][google.maps.addressvalidateation.v1.AuthenticationAddressRequest.response_id] trong phản hồi đầu tiên trong một loạt lần xác thực địa chỉ.

conclusion

ValidationConclusion

Bắt buộc. Kết quả của trình tự xác thực.

Nếu bạn đặt trường này thành VALIDATION_CONCLUSION_UNSPECIFIED, hệ thống sẽ trả về lỗi INVALID_ARGUMENT.

response_id

string

Bắt buộc. Mã của phản hồi mà phản hồi này được gửi tới. Đây phải là [response_id][google.maps.addressvalidateation.v1.AuthenticationAddressRequest.response_id] trong phản hồi đầu tiên trong một loạt lần xác thực địa chỉ.

Kết luận xác thực

Kết quả cuối cùng có thể có của chuỗi yêu cầu xác thực địa chỉ cần thiết để xác thực địa chỉ.

Enum
`VALIDATION_CONCLUSION_UNSPECIFIED`	Giá trị này không được sử dụng. Nếu bạn đặt trường `ProvideValidationFeedbackRequest.conclusion` thành `VALIDATION_CONCLUSION_UNSPECIFIED`, hệ thống sẽ trả về lỗi `INVALID_ARGUMENT`.
`VALIDATED_VERSION_USED`	Phiên bản địa chỉ mà API Xác thực địa chỉ trả về đã được dùng cho giao dịch.
`USER_VERSION_USED`	Phiên bản địa chỉ do người dùng cung cấp được dùng cho giao dịch
`UNVALIDATED_VERSION_USED`	Phiên bản của địa chỉ đã được nhập sau lần xác thực gần nhất nhưng không được xác thực lại đã được sử dụng cho giao dịch.
`UNUSED`	Giao dịch đã bị bỏ qua và địa chỉ không được sử dụng.

Cung cấp phản hồi xác thực

Phản hồi cho phản hồi xác thực.

Phản hồi trống nếu phản hồi được gửi thành công.

Địa chỉ Usps

USPS đại diện cho một địa chỉ ở Hoa Kỳ.

Các trường
`first_address_line`	`string` Dòng địa chỉ đầu tiên.
`firm`	`string` Tên công ty.
`second_address_line`	`string` Dòng địa chỉ thứ hai.
`urbanization`	`string` Tên đô thị Puerto Rico.
`city_state_zip_address_line`	`string` Thành phố + tiểu bang + mã bưu chính.
`city`	`string` Tên thành phố.
`state`	`string` Mã trạng thái gồm 2 chữ cái.
`zip_code`	`string` Mã bưu chính, ví dụ: 10009.
`zip_code_extension`	`string` Mã bưu chính 4 chữ số, ví dụ: 5023.

Dataps

Dữ liệu của USPS cho địa chỉ. Chúng tôi không đảm bảo rằng uspsData sẽ được điền đầy đủ cho mỗi địa chỉ ở Hoa Kỳ hoặc PR được gửi đến API Xác thực địa chỉ. Bạn nên tích hợp các trường địa chỉ sao lưu trong phản hồi nếu sử dụng UspsData làm phần chính của phản hồi.

Các trường
`standardized_address`	`UspsAddress` Địa chỉ chuẩn hoá USPS.
`delivery_point_code`	`string` Mã điểm giao hàng gồm 2 chữ số
`delivery_point_check_digit`	`string` Số kiểm tra của điểm giao hàng. Mã số này được thêm vào cuối mã Delivery_point_barcode cho thư được quét cơ học. Kết hợp tất cả các chữ số của mã item_point_barcode,delivery_point_check_letter, mã bưu chính và ZIP+4 sẽ tạo ra một số chia hết cho 10.
`dpv_confirmation`	`string` Các giá trị có thể có để xác nhận DPV. Trả về một ký tự. `Y`: Địa chỉ đã được xác nhận là DPV cho số chính và bất kỳ số phụ nào. `N`: Không thể xác nhận thông tin về số chính và bất kỳ số phụ nào cho DPV để xác nhận. `S`: Địa chỉ do DPV xác nhận chỉ dành cho số điện thoại chính và thông tin số phụ đã có sẵn do không được xác nhận. `D`: Địa chỉ mà DPV đã xác nhận chỉ dành cho số điện thoại chính và thiếu thông tin số phụ.
`dpv_footnote`	`string` Các chú thích cuối trang từ xác thực điểm phân phối. 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`: Đã đối sánh với DPV (tất cả các thành phần) `CC`: Số phụ không khớp (có nhưng không hợp lệ) `N1`: Địa chỉ nhà cao tầng thiếu số phụ `M1`: Thiếu số điện thoại chính `M3`: Số chính không hợp lệ `P1`: Thiếu số hộp địa chỉ đầu vào RR hoặc HC `P3`: Địa chỉ nhập PO, RR hoặc Số hộp HC không hợp lệ `F1`: Địa chỉ nhập vào khớp với địa chỉ quân sự `G1`: Địa chỉ nhập vào khớp với địa chỉ giao hàng chung `U1`: Địa chỉ nhập khớp với mã ZIP duy nhất `PB`: Địa chỉ nhập vào khớp với bản ghi PBSA `RR`: Địa chỉ xác nhận DPV có thông tin PMB `R1`: Địa chỉ được xác nhận là DPV mà không có thông tin về PMB `R7`: Bản ghi R777 hoặc R779 của nhà mạng
`dpv_cmra`	`string` Cho biết địa chỉ có phải là CMRA (Cơ quan nhận thư thương mại) hay không – một doanh nghiệp tư nhân nhận thư cho khách hàng. Trả về một ký tự. `Y`: Địa chỉ là CMRA `N`: Địa chỉ này không phải là CMRA
`dpv_vacant`	`string` Địa điểm này có trống không? Trả về một ký tự. `Y`: Địa chỉ trống `N`: Địa chỉ không trống
`dpv_no_stat`	`string` Đây không phải là địa chỉ số liệu thống kê hay địa chỉ đang hoạt động? Không có địa chỉ trạng thái nào là địa chỉ không liên tục có người lưu trú hoặc địa chỉ mà USPS không phục vụ. Trả về một ký tự. `Y`: Địa chỉ không hoạt động `N`: Địa chỉ đang hoạt động
`carrier_route`	`string` Mã tuyến của nhà mạng. Mã bốn ký tự bao gồm một tiền 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ị giao hàng chung
`carrier_route_indicator`	`string` Chỉ báo sắp xếp cước phí của hãng vận chuyển.
`ews_no_match`	`bool` Địa chỉ giao hàng có thể khớp, nhưng tệp FOLDER chỉ ra rằng địa chỉ này sẽ sớm khớp chính xác.
`post_office_city`	`string` Bưu điện chính của thành phố.
`post_office_state`	`string` Tiểu bang chính của bưu điện.
`abbreviated_city`	`string` Thành phố viết tắt.
`fips_county_code`	`string` Mã hạt FIPS.
`county`	`string` Tên hạt.
`elot_number`	`string` Số Chuyến đi nâng cao (eLOT).
`elot_flag`	`string` eLOT Tăng/giảm cờ (A/D).
`lacs_link_return_code`	`string` Mã trả về LACSLink.
`lacs_link_indicator`	`string` Chỉ báo LACSLink.
`po_box_only_postal_code`	`bool` Chỉ mã bưu chính của PO Box.
`suitelink_footnote`	`string` Chú thích cuối trang phù hợp với thông tin đường phố hoặc toà nhà cao tầng. Nếu tìm thấy tên doanh nghiệp trùng khớp, hệ thống sẽ trả về số phụ. `A`: Đã cải thiện kết quả khớp bản ghi SuiteLink, địa chỉ doanh nghiệp. `00`: Không khớp, địa chỉ doanh nghiệp không được cải thiện.
`pmb_designator`	`string` Nhà chỉ định đơn vị PMB (Hộp thư riêng).
`pmb_number`	`string` Số PMB (Hộp thư riêng);
`address_record_type`	`string` Loại bản ghi địa chỉ khớp với địa chỉ nhập. `F`: FIRM. Đây là kết quả trùng khớp với Bản ghi công ty, đây là mức độ phù hợp nhất đối với một địa chỉ. `G`: PHÂN PHỐI CHUNG. Đây là một kết quả trùng khớp với bản ghi Phân phối chung. `H`: Xây dựng/căn hộ. Đây là kết quả trùng khớp với bản ghi của Toà nhà hoặc Căn hộ. `P`: HỘP CHÍNH THỨC ĐĂNG. Đây là kết quả phù hợp với Hộp thư bưu điện. `R`: HỢP ĐỒNG NGƯỢC ĐƯỜNG LIÊN KẾT hoặc HỢP ĐỒNG TẠO ĐƯỜNG LIÊN QUAN: Đây là kết quả trùng khớp với một Tuyến đường nông thôn hoặc hồ sơ Hợp đồng đường cao tốc, cả hai đều có phạm vi Số hộp được liên kết. `S`: GHI đường phố: Đây là kết quả trùng khớp với bản ghi Đường phố có chứa phạm vi số chính hợp lệ.
`default_address`	`bool` Chỉ báo cho biết một địa chỉ mặc định đã được tìm thấy, nhưng còn có địa chỉ cụ thể hơn.
`error_message`	`string` Thông báo lỗi khi truy xuất dữ liệu USPS. Quy trình này được điền sẵn khi quá trình xử lý USPS bị tạm ngưng do phát hiện 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 có lỗi này.
`cass_processed`	`bool` Chỉ báo cho biết yêu cầu đã được xử lý CASS.

ValidationAddressRequest

Yêu cầu xác thực địa chỉ.

Các trường

Các trường
`address`	`PostalAddress` Bắt buộc. Địa chỉ đang được xác thực. Bạn phải gửi các địa chỉ chưa được định dạng qua `address_lines`. Tổng độ dài của các trường trong dữ liệu nhập này không được vượt quá 280 ký tự. Bạn có thể tìm thấy các khu vực được hỗ trợ trong phần Câu hỏi thường gặp. Giá trị `language_code` trong địa chỉ nhập dành riêng cho việc sử dụng sau này và bị bỏ qua trong hôm nay. Kết quả xác thực địa chỉ sẽ được điền dựa trên ngôn ngữ ưa thích cho địa chỉ đã cung cấp, như được hệ thống xác định. API Xác thực địa chỉ bỏ qua các giá trị trong `recipients` và `organization`. Mọi giá trị trong các trường đó sẽ bị loại bỏ và không được trả về. Vui lòng không đặt.
`previous_response_id`	`string` Trường này phải để trống cho yêu cầu xác thực địa chỉ đầu tiên. Nếu cần thêm nhiều yêu cầu để xác thực đầy đủ một địa chỉ (ví dụ: nếu những thay đổi mà người dùng thực hiện sau khi xác thực lại lần đầu cần được xác thực lại), thì mỗi yêu cầu tiếp theo phải điền `response_id` này vào trường này bằng phản hồi đầu tiên trong trình tự xác thực.
`enable_usps_cass`	`bool` Bật chế độ tương thích với USPS CASS. Điều này chỉ ảnh hưởng đến trường `google.maps.addressvalidation.v1.ValidationResult.usps_data` của `google.maps.addressvalidation.v1.ValidationResult`. Lưu ý: đối với các yêu cầu hỗ trợ USPS CASS dành cho địa chỉ ở Puerto Rico, bạn phải cung cấp `google.type.PostalAddress.region_code` của `address` dưới dạng "PR" hoặc `google.type.PostalAddress.administrative_area` của `address` phải được cung cấp là "Puerto Rico" (không phân biệt chữ hoa chữ thường) hoặc "PR". Bạn nên sử dụng `address` thành phần hoặc chỉ định ít nhất 2 `google.type.PostalAddress.address_lines`, trong đó dòng đầu tiên chứa số nhà và tên, còn dòng thứ hai chứa thành phố, tiểu bang và mã bưu chính.

address

PostalAddress

Bắt buộc. Địa chỉ đang được xác thực. Bạn phải gửi các địa chỉ chưa được định dạng qua address_lines.

Tổng độ dài của các trường trong dữ liệu nhập này không được vượt quá 280 ký tự.

Bạn có thể tìm thấy các khu vực được hỗ trợ trong phần Câu hỏi thường gặp.

Giá trị language_code trong địa chỉ nhập dành riêng cho việc sử dụng sau này và bị bỏ qua trong hôm nay. Kết quả xác thực địa chỉ sẽ được điền dựa trên ngôn ngữ ưa thích cho địa chỉ đã cung cấp, như được hệ thống xác định.

API Xác thực địa chỉ bỏ qua các giá trị trong recipients và organization. Mọi giá trị trong các trường đó sẽ bị loại bỏ và không được trả về. Vui lòng không đặt.

previous_response_id

string

Trường này phải để trống cho yêu cầu xác thực địa chỉ đầu tiên. Nếu cần thêm nhiều yêu cầu để xác thực đầy đủ một địa chỉ (ví dụ: nếu những thay đổi mà người dùng thực hiện sau khi xác thực lại lần đầu cần được xác thực lại), thì mỗi yêu cầu tiếp theo phải điền response_id này vào trường này bằng phản hồi đầu tiên trong trình tự xác thực.

enable_usps_cass

bool

Bật chế độ tương thích với USPS CASS. Điều này chỉ ảnh hưởng đến trường google.maps.addressvalidation.v1.ValidationResult.usps_data của google.maps.addressvalidation.v1.ValidationResult. Lưu ý: đối với các yêu cầu hỗ trợ USPS CASS dành cho địa chỉ ở Puerto Rico, bạn phải cung cấp google.type.PostalAddress.region_code của address dưới dạng "PR" hoặc google.type.PostalAddress.administrative_area của address phải được cung cấp là "Puerto Rico" (không phân biệt chữ hoa chữ thường) hoặc "PR".

Bạn nên sử dụng address thành phần hoặc chỉ định ít nhất 2 google.type.PostalAddress.address_lines, trong đó dòng đầu tiên chứa số nhà và tên, còn dòng thứ hai chứa thành phố, tiểu bang và mã bưu chính.

Xác thực địa chỉ phản hồi

Phản hồi cho một yêu cầu xác thực địa chỉ.

Các trường

Các trường
`result`	`ValidationResult` Kết quả xác thực địa chỉ.
`response_id`	`string` UUID xác định phản hồi này. Nếu cần xác thực lại địa chỉ, thì UUID này phải đi kèm với yêu cầu mới.

result

ValidationResult

Kết quả xác thực địa chỉ.

response_id

string

UUID xác định phản hồi này. Nếu cần xác thực lại địa chỉ, thì UUID này phải đi kèm với yêu cầu mới.

Xác thực kết quả

Kết quả xác thực địa chỉ.

Các trường
`verdict`	`Verdict` Cờ kết quả chung
`address`	`Address` Thông tin về chính địa chỉ đó thay vì mã hoá địa lý.
`geocode`	`Geocode` Thông tin về vị trí và địa điểm mà địa chỉ được mã hóa địa lý.
`metadata`	`AddressMetadata` Thông tin khác liên quan đến việc cung cấp nội dung. Chúng tôi không đảm bảo rằng `metadata` sẽ được điền đầy đủ cho mọi địa chỉ được gửi đến API Xác thực địa chỉ.
`usps_data`	`UspsData` Cờ về khả năng phân phối bổ sung do USPS cung cấp. Chỉ được cung cấp ở khu vực `US` và `PR`.

Kết quả

Thông tin tổng quan cấp cao về kết quả xác thực địa chỉ và mã địa lý.

Các trường
`input_granularity`	`Granularity` Mức độ chi tiết của địa chỉ đầu vào. Đây là kết quả của việc phân tích cú pháp địa chỉ nhập và không cung cấp bất kỳ tín hiệu xác thực nào. Đối với các tín hiệu xác thực, hãy tham khảo `validation_granularity` bên dưới. Ví dụ: nếu địa chỉ nhập bao gồm số căn hộ cụ thể thì `input_granularity` ở đây sẽ là `SUB_PREMISE`. Nếu chúng tôi không thể khớp số căn hộ trong cơ sở dữ liệu hoặc số căn hộ không hợp lệ, thì `validation_granularity` có thể sẽ là `PREMISE` hoặc thấp hơn.
`validation_granularity`	`Granularity` Mức độ chi tiết mà API có thể xác thực hoàn toàn địa chỉ. Ví dụ: `validation_granularity` của `PREMISE` cho biết mọi thành phần địa chỉ ở cấp `PREMISE` trở lên có thể được xác thực. Bạn có thể tìm thấy kết quả xác thực mỗi thành phần của địa chỉ trong `google.maps.addressvalidation.v1.Address.address_components`.
`geocode_granularity`	`Granularity` Thông tin về độ chi tiết của `geocode`. Điều này có thể được hiểu là ý nghĩa ngữ nghĩa của vị trí được mã hóa hoặc mức độ thô. Điều này đôi khi có thể khác với `validation_granularity` ở 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 cho căn hộ trong khu phức hợp căn hộ lớn. Trong trường hợp đó, `validation_granularity` sẽ là `SUB_PREMISE` nhưng `geocode_granularity` sẽ là `PREMISE`.
`address_complete`	`bool` Đị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ỉ lạ hoặc bị thiếu. Xem các trường `missing_component_types`, `unresolved_tokens` hoặc `unexpected` để biết thêm thông tin chi tiết.
`has_unconfirmed_components`	`bool` Không thể phân loại hay xác thực ít nhất một thành phần địa chỉ, hãy xem `google.maps.addressvalidation.v1.Address.address_components` để biết thông tin chi tiết.
`has_inferred_components`	`bool` Ít nhất một thành phần địa chỉ được dự đoán (đã thêm) không có trong mục nhập, hãy xem `google.maps.addressvalidation.v1.Address.address_components` để biết thông tin chi tiết.
`has_replaced_components`	`bool` Ít nhất một thành phần địa chỉ đã được thay thế, hãy xem `google.maps.addressvalidation.v1.Address.address_components` để biết thông tin chi tiết.

Độ chi tiết

Các chi tiết khác nhau mà địa chỉ hoặc mã địa lý có thể có. Khi dùng để chỉ báo mức độ chi tiết cho một địa chỉ, các giá trị này cho biết mức độ chi tiết mà địa chỉ nhận dạng đích đến gửi thư. Ví dụ: địa chỉ như "123 Main Street, Redwood City, CA, 94061" xác định PREMISE trong khi một cái gì đó như "Redwood City, CA, 94061" xác định LOCALITY. Tuy nhiên, nếu chúng tôi không thể tìm thấy một mã địa lý cho "123 Main Street" ở Thành phố Redwood, mã địa lý được trả về có thể có độ chi tiết LOCALITY mặc dù địa chỉ chi tiết hơn.

Enum
`GRANULARITY_UNSPECIFIED`	Giá trị mặc định. Giá trị này không được sử dụng.
`SUB_PREMISE`	Kết quả dưới cấp toà nhà, chẳng hạn như căn hộ.
`PREMISE`	Kết quả cấp toà nhà.
`PREMISE_PROXIMITY`	Một mã địa lý phải rất gần với vị trí của địa chỉ ở cấp toà nhà. Chỉ dùng cho mã địa lý và không dùng cho địa chỉ.
`BLOCK`	Địa chỉ hoặc mã địa lý biểu thị một khối. Chỉ được sử dụng ở những khu vực có địa chỉ cấp khối, chẳng hạn như Nhật Bản.
`ROUTE`	Mã địa lý hoặc địa chỉ chi tiết để định tuyến, chẳng hạn như đường phố, đường phố hoặc đường cao tốc.
`OTHER`	Tất cả các chi tiết khác được nhóm lại với nhau vì không thể phân phối cùng lúc.