Package google.maps.addressvalidation.v1

Chỉ mục

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

rpc ProvideValidationFeedback(ProvideValidationFeedbackRequest) returns (ProvideValidationFeedbackResponse)

Phản hồi về kết quả của chuỗi các lần 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à nên được gọi khi giao dịch kết thúc. Bạn chỉ nên gửi mã này một lần cho một chuỗi ValidateAddress yêu cầu cần thiết để xác thực địa chỉ đầy đủ.

Xác thực địa chỉ

rpc ValidateAddress(ValidateAddressRequest) returns (ValidateAddressResponse)

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

Address (Địa chỉ)

Chi tiết về địa chỉ sau khi xử lý. Xử lý hậu kỳ bao gồm sửa các phần sai chính tả của địa chỉ, thay thế các phần không chính xác và suy luận các phần bị thiếu.

Các trường
formatted_address

string

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

postal_address

PostalAddress

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

address_components[]

AddressComponent

Danh sách không theo thứ tự. 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. Thao tác 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 riêng lẻ.

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

missing_component_types[]

string

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 được tìm thấy trong dữ liệu đầu vào VÀ không thể suy ra đượ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 chẳng hạn như "Boulder, Colorado, 80301, USA". Bạn có thể tìm thấy 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ể được 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 address_components để tìm các loại thành phần trong đó confirmation_level không phải là CONFIRMED hoặc cờ inferred không được đặt thành true. Bạn có thể tìm thấy danh sách các loại có thể sử dụng tại đây.

unresolved_tokens[]

string

Mọi mã thông báo trong dữ liệu nhập mà 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à một phần hợp lệ của địa chỉ (ví dụ: trong dữ liệu nhập chẳng hạn như "123235253253 Main St, San Francisco, CA, 94105", mã thông báo chưa được phân giải có thể có dạng ["123235253253"] vì không phải là số đường hợp lệ.

AddressComponent

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

Các trường
component_name

ComponentName

Tên của 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 được dịch vụ Địa điểm trả về để biết danh sách các loại có thể có.

confirmation_level

ConfirmationLevel

Cho biết mức độ chắc chắn mà chúng tôi có rằng thành phần là chính xác.

inferred

bool

Cho biết rằng thành phần này không có trong dữ liệu nhập, nhưng chúng tôi suy luận thành phần đó cho vị trí của địa chỉ và cho rằng thành phần này nên được cung cấp cho một địa chỉ đầy đủ.

spell_corrected

bool

Chỉ ra lần 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 giữa các biến thể chính tả, chẳng hạn như khi thay đổi "centre" thành "center". Hệ thống cũng không phải lúc nào cũng gắn cờ các lỗi chính tả phổ biến, chẳng hạn như khi thay đổi "Amphitheater Pkwy" thành "Amphitheatre Pkwy".

replaced

bool

Cho biết tên của thành phần đã được thay thế bằng một thành phần hoàn toàn khác, ví dụ: một mã bưu chính sai được thay thế bằng một mã đúng với địa chỉ. Đây không phải là thay đổi về mặt 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ỉ dự kiến sẽ không xuất hiện trong địa chỉ bưu điện của khu vực đã cho. 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 có thể có 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à hợp lý 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 có thể chấp nhận được. Ví dụ: số nhà trong một dải số hợp lệ đã biết trên một con phố không xác định số nhà cụ thể.
UNCONFIRMED_AND_SUSPICIOUS Thành phần này chưa được xác nhận và có thể không chính xác. Ví dụ: một 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ỉ. metadata không đảm bảo 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 đâ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ì giá trị đó sẽ 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ì giá trị đó sẽ không xác định.

residential

bool

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

Tên thành phần

Một trình bao bọc cho tên của thành phần.

Các trường
text

string

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

language_code

string

Mã ngôn ngữ BCP-47. Thuộc tính 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ố đường phố.

Mã địa lý

Chứa thông tin về nơi mà dữ liệu đầu vào được mã hoá địa lý đến.

Các trường
location

LatLng

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

Bạn nên sử dụng mã địa điểm thay vì 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 được bám vào con đường gần nhất với các toạ độ đó. Đây có thể không phải là đường sẽ nhanh chóng hoặc an toàn dẫn đến điểm đế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ý đảo ngược, chúng tôi không thể đảm bảo rằng địa chỉ trả về sẽ khớp với địa chỉ ban đầu.

plus_code

PlusCode

Mã cộng tương ứng với location.

bounds

Viewport

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

feature_size_meters

float

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ề độ thô của vị trí được mã hóa địa lý, nhưng theo kích thước vật lý chứ không phải về ý nghĩa ngữ nghĩa.

place_id

string

Mã địa điểm của nơi nhập mã địa lý này.

Để 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à dữ liệu đầ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.

Tuỳ chọn ngôn ngữ

Bản xem trước: Tính năng này đang ở giai đoạn Xem trước (trước giai đoạn phát hành rộng rã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ể được hỗ trợ hạn chế. Đồng thời, 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 khác. Các Sản phẩm trước giai đoạn phát hành rộng rãi chịu sự điều chỉnh của Đ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ả về giai đoạn ra mắt.

Bật Address Validation API (API Xác thực địa chỉ) để đưa thêm thông tin vào phản hồi.

Các trường
return_english_latin_address

bool

Bản xem trước: Trả về một 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.

PlusCode

Mã cộng (http://plus.codes) là một giá trị tham chiếu vị trí có hai định dạng: mã chung xác định hình chữ nhật có kích thước 14mx14m (1/8000 độ) hoặc hình chữ nhật 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
global_code

string

Mã toàn cầu (đầy đủ) của Địa điểm, chẳng hạn như "9FWM33GV+HQ", biểu thị diện tích 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ã chung và thay thế tiền tố bằng tên đã định dạng của một thực thể tham chiếu.

Cung cấp ValidationFeedbackRequest

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

Các trường
conclusion

ValidationConclusion

Bắt buộc. Kết quả của chuỗi các lần thử xác thực.

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

response_id

string

Bắt buộc. Mã phản hồi của ý kiến phản hồi này. Đây sẽ là [Response_id][google.maps.addressvalidate.v1.ConfirmAddressRequest.response_id] trong phản hồi đầu tiên trong một loạt các 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 một đị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 thì hàm INVALID_ARGUMENT sẽ được trả về.
VALIDATED_VERSION_USED Phiên bản của địa chỉ mà API xác thực địa chỉ trả về đã được dùng cho giao dịch này.
USER_VERSION_USED Phiên bản của địa chỉ do người dùng cung cấp đã được sử dụng cho giao dịch
UNVALIDATED_VERSION_USED Một phiên bản của địa chỉ được nhập sau lần xác thực gần đây nhất nhưng chưa được xác thực lại đã được sử dụng cho giao dịch này.
UNUSED Giao dịch đã bị huỷ và địa chỉ không được sử dụng.

Cung cấp ValidationFeedbackResponse

Loại này không có trường.

Phản hồi cho ý kiến phản hồi về việc xác thực.

Phản hồi sẽ 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 khu vực đô thị của 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

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

Dữ liệu USB

Dữ liệu USPS của đị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 địa chỉ quan hệ công chúng đượ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 vào 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ỉ được 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. Số này được thêm vào cuối mã giao hàng_point_barcode cho thư được quét bằng máy. Cộng tất cả chữ số của mã vạch giao_hàng, chữ_số_giao_hàng, mã bưu chính và mã ZIP+4 cộng lại sẽ được một số chia hết cho 10.

dpv_confirmation

string

Các giá trị có thể dùng để xác nhận DPV. Trả về một ký tự đơn.

  • Y: Địa chỉ đã được xác nhận là DPV cho số chính và mọi số phụ.
  • N: DPV không xác nhận được thông tin về số chính và mọi thông tin phụ.
  • S: Địa chỉ đã được xác nhận là DPV chỉ dành cho số điện thoại chính và thông tin về số điện thoại phụ đã có nhưng chưa được xác nhận.
  • D: Địa chỉ đã được xác nhận là DPV chỉ dành cho số điện thoại chính và thiếu thông tin về số điện thoại phụ.
dpv_footnote

string

Chú thích cuối trang từ tính năng xác thực điểm phân phối. Có thể xâu nhiều chú thích cuối trang 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ả 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ố chính
  • M3: Số chính không hợp lệ
  • P1: Thiếu địa chỉ nhập RR hoặc số hộp HC
  • P3: Địa chỉ nhập PO, RR hoặc Số hộp HC không hợp lệ
  • F1: Địa chỉ nhập khớp với địa chỉ quân sự
  • 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ã bưu chính duy nhất
  • PB: Địa chỉ đầu vào khớp với bản ghi PBSA
  • RR: Địa chỉ đã xác nhận của DPV có thông tin PMB
  • R1: Địa chỉ đã xác nhận của DPV nhưng không có thông tin về PMB
  • R7: Bản ghi R777 hoặc R779 của Carrier Tuyến
dpv_cmra

string

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

  • Y: Địa chỉ này là CMRA
  • N: Địa chỉ không phải là CMRA
dpv_vacant

string

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

  • Y: Địa chỉ bị bỏ trống
  • N: Địa chỉ không bị trống
dpv_no_stat

string

Đây là địa chỉ không có số liệu thống kê hay địa chỉ đang hoạt động? Không có địa chỉ thống kê nào là những địa chỉ không được sử dụng 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ỉ này không hoạt động
  • N: Địa chỉ đang hoạt động
carrier_route

string

Mã tuyến của hãng vận chuyển. Mã 4 ký tự bao gồm tiền tố 1 chữ cái và 3 chữ số cho ký tự chỉ định tuyến đường.

Tiền tố:

  • C: Tuyến đường của hãng vận chuyển (hoặc tuyến đường 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: Khu vực hộp thư bưu điện
  • G: Đơn vị phân phối chung
carrier_route_indicator

string

Chỉ báo sắp xếp mức phí tuyến đường của hãng vận chuyển.

ews_no_match

bool

Địa chỉ gửi có thể khớp nhưng tệp EWS cho biết rằng sẽ sớm có địa chỉ khớp chính xác.

post_office_city

string

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

post_office_state

string

Tiểu bang của bưu điện chính.

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ố Tuyến du lịch nâng cao (eLOT).

elot_flag

string

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

po_box_only_postal_code

bool

Mã bưu chính chỉ Hộp thư bưu điện.

pmb_designator

string

Người 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à mức khớp với Hồ sơ công ty, đây là mức độ khớp tốt nhất hiện có cho một địa chỉ.
  • G: GIAO HÀNG CHUNG. Bản ghi này trùng khớp với bản ghi Gửi chung.
  • H: Toà nhà / căn hộ. Đây là bản ghi trùng khớp với bản ghi của một Toà nhà hoặc Căn hộ.
  • P: HỘP Bưu điện. Địa chỉ này trùng khớp với hộp thư bưu điện.
  • R: ĐƯỜNG ĐI NỀN TẢNG hoặc HỢP ĐỒNG ĐƯỜNG PHỐ: Đây là thông tin trùng khớp với tuyến đường nông thôn hoặc bản ghi Hợp đồng đường cao tốc, cả hai loại bản ghi này đều có thể liên kết với phạm vi Số hộp.
  • S: STREET RECORD: Đây là sự trùng khớp với bản ghi Street có chứa dải số chính hợp lệ.
default_address

bool

Chỉ báo cho biết đã tìm thấy địa chỉ mặc định, nhưng vẫ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. Thông tin này được điề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.

Bạn có thể không điền được các trường dữ liệu USPS 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
address

PostalAddress

Bắt buộc. Địa chỉ đang được xác thực. Bạn nên gửi đị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ể xem các khu vực được hỗ trợ tại đây.

Giá trị language_code trong địa chỉ nhập được dành riêng để sử dụng trong tương lai và sẽ bị bỏ qua trong hôm nay. Kết quả địa chỉ đã xác thực sẽ được điền dựa trên ngôn ngữ ưu tiên 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 recipientsorganization. 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 các thông số này.

previous_response_id

string

Trường này phải để trống đối với yêu cầu xác thực địa chỉ đầu tiên. Nếu cần nhiều yêu cầu hơn để xác thực đầy đủ một địa chỉ (ví dụ: nếu các thay đổi mà người dùng thực hiện sau lần xác thực ban đầu cần được xác thực lại), thì mỗi yêu cầu tiếp theo phải điền sẵn response_id vào trường này bằng response_id ngay từ 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 có hỗ trợ CASS của USPS cho địa chỉ ở Puerto Rico, bạn phải cung cấp google.type.PostalAddress.region_code của address là "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 dùng address được hợp 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ố và tên đường phố, còn dòng thứ hai chứa thành phố, tiểu bang và mã bưu chính.

language_options

LanguageOptions

Không bắt buộc. Bản xem trước: Tính năng này đang ở giai đoạn Xem trước (trước giai đoạn phát hành rộng rã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ể được hỗ trợ hạn chế. Đồng thời, 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 khác. Các Sản phẩm trước giai đoạn phát hành rộng rãi chịu sự điều chỉnh của Đ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ả về giai đoạn ra mắt.

Bật Address Validation API (API Xác thực địa chỉ) để đưa thêm thông tin vào phản hồi.

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

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

Các trường
result

ValidationResult

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

response_id

string

Mã nhận dạng duy nhất (UUID) xác định phản hồi này. Nếu địa chỉ cần được xác thực lại, thì mã nhận dạng duy nhất (UUID) này phải đi kèm với yêu cầu mới.

Kết quả xác thực

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

Các trường
verdict

Verdict

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

address

Address

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

geocode

Geocode

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

metadata

AddressMetadata

Thông tin khác liên quan đến khả năng gửi. metadata không đảm bảo 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ờ khả năng phân phối bổ sung do USPS cung cấp. Chỉ được cung cấp ở khu vực USPR.

english_latin_address

Address

Bản xem trước: Tính năng này đang ở giai đoạn Xem trước (trước giai đoạn phát hành rộng rã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ể được hỗ trợ hạn chế. Đồng thời, 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 khác. Các Sản phẩm trước giai đoạn phát hành rộng rãi chịu sự điều chỉnh của Đ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ả về giai đoạn ra mắt.

Địa chỉ được dịch sang tiếng Anh. Nếu một phần của địa chỉ không có bản dịch tiếng Anh, dịch vụ sẽ trả về phần đó bằng ngôn ngữ thay thế sử dụng chữ viết Latinh. Hãy xem tại đây để biết 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 hệ thống chữ viết 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ạn đã 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 english_latin_addressgoogle.maps.addressvalidation.v1.AddressComponent.confirmation_level trong english_latin_address.address_components không được điền sẵn.

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ỉ đầu vào và không cung cấp bất kỳ 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 validation_granularity dưới đây.

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 so khớp được 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 đầy đủ địa chỉ. Ví dụ: validation_granularity của PREMISE cho biết rằng hệ thống có thể xác thực tất cả thành phần địa chỉ ở cấp PREMISE trở lên.

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

geocode_granularity

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 về mức độ thô hoặc nhỏ của vị trí được mã hoá địa lý.

Đ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 của căn hộ trong một khu chung cư 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ỉ không mong muốn 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 hoặc 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 suy ra (được thêm vào) không có trong dữ liệu 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 mức độ chi tiết khác nhau của một địa chỉ hoặc một mã địa lý có thể có. Khi được dùng để cho biết mức độ chi tiết của một địa chỉ, các giá trị này cho biết mức độ chi tiết mà địa chỉ xác định một đích đến gửi thư. Ví dụ: một địa chỉ như "123 Main Street, Redwood City, CA, 94061" xác định PREMISE, còn địa chỉ 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ã địa lý cho "123 Main Street" tại Redwood City, 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 mức toà nhà, chẳng hạn như một căn hộ.
PREMISE Kết quả cấp toà nhà.
PREMISE_PROXIMITY Một mã địa lý gần đúng vị trí cấp toà nhà của địa chỉ.
BLOCK Địa chỉ hoặc mã địa lý biểu thị một khối. Chỉ được 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ỉ rất chi tiết để xác định tuyến đường, chẳng hạn như đường phố, đường hoặc đường cao tốc.
OTHER Tất cả chi tiết khác được nhóm lại với nhau vì không thể phân phối được.