Package google.maps.addressvalidation.v1

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ỉ đó.

PostalAddress

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

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 formatted_address, postal_address hoặc address_components. 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 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 tương đương với việc lặp lại thông qua address_components để tìm kiểu của tất cả 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ể 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

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

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.

bool

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 đủ.

bool

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

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ụ: 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.

bool

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.

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ì tức là giá trị là không xác định.

bool

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.

bool

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.

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

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.

PlusCode

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

Viewport

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

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ề độ 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.

bool

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.

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.

ValidationConclusion

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

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

string

Bắt buộc. Mã của câu trả lời chứa ý kiến phản hồi này. Đây phải là [response_id][google.maps.address entities.v1.ValidateAddressRequest.response_id] từ phản hồi đầu tiên trong một loạt các lần thử xác thực địa chỉ.

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.

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. Cộng tất cả các chữ số của mã vạch delivery_point, delivery_point_check_digit, mã bưu chính và ZIP+4 sẽ thu được một 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ị dpv_confirmation, 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

int32

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.

int32

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.

bool

Đị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.

bool

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

bool

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.

bool

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

PostalAddress

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

Các trường trong dữ liệu đầu vào này không được dài 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ỉ đầu vào được dành riêng để sử dụng sau này và sẽ bị bỏ qua vào 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ỉ cụ thể do hệ thống xác định.

API xác thực địa chỉ sẽ 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 chúng.

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 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 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 response_id vào trường này từ phản hồi đầu tiên trong trình tự xác thực.

bool

Bật chế độ tương thích với USPS CASS. Việc 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 những 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 thành "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 có thành phần hoặc chỉ định ít nhất hai google.type.PostalAddress.address_lines, trong đó dòng đầu tiên chứa số và tên nhà, còn dòng thứ hai chứa thành phố, tiểu bang và mã bưu chính.

LanguageOptions

Không bắt buộc. 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.

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

string

Không bắt buộc. Một chuỗi xác định một phiên Tự động hoàn thành cho mục đích thanh toán. Phải là chuỗi base64 an toàn cho URL và tên tệp với độ dài tối đa 36 ký tự ASCII. Nếu không, lỗi INVALID_ARGUMENT sẽ được trả về.

Phiên hoạt động này bắt đầu khi người dùng tìm kiếm bằng tính năng Tự động hoàn thành và kết thúc khi họ chọn một địa điểm và thực hiện lệnh gọi đến phần Thông tin chi tiết về địa điểm hoặc Xác thực địa chỉ. Mỗi phiên hoạt động có thể có nhiều truy vấn Tự động hoàn thành, theo sau là một yêu cầu Thông tin chi tiết về địa điểm hoặc Xác thực địa chỉ. Thông tin đăng nhập dùng cho mỗi yêu cầu trong một phiên phải thuộc cùng một dự án Google Cloud Console. Sau khi phiên kết thúc, mã thông báo không còn hợp lệ; ứng dụng của bạn phải tạo mã thông báo mới cho mỗi phiên. Nếu thông số sessionToken bị bỏ qua hoặc nếu bạn sử dụng lại mã thông báo phiên, thì phiên sẽ được tính phí như thể không có mã thông báo phiên nào được cung cấp (mỗi yêu cầu sẽ được tính phí riêng).

Lưu ý: Bạn chỉ có thể sử dụng tính năng Xác thực địa chỉ trong các phiên có API Tự động hoàn thành (Mới), chứ không dùng được API Tự động hoàn thành. Hãy tham khảo https://developers.google.com/maps/documentation/places/web-service/session-pricing để biết thêm chi tiết.

ValidationResult

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

string

Mã nhận dạng duy nhất (UUID) xác định phản hồi này. Nếu cần xác thực lại địa chỉ, 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.

Verdict

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

Address

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

Geocode

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

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

UspsData

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

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 english_latin_address và google.maps.addressvalidation.v1.AddressComponent.confirmation_level trong english_latin_address.address_components không được điền sẵn.

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 validation_granularity bên dưới.

Ví dụ: nếu địa chỉ nhập chứa số căn hộ cụ thể, thì input_granularity ở đâ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ệ, validation_granularity có thể sẽ có giá trị là PREMISE hoặc thấp hơn.

Granularity

Mức độ chi tiết mà API có thể validate đầy đủ địa chỉ. Ví dụ: validation_granularity 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.

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

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ỉ 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 missing_component_types, unresolved_tokens hoặc unexpected để biết thêm thông tin.

bool

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.

bool

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

bool

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