Package google.maps.addressvalidation.v1

string

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

Lưu ý: định dạng của địa chỉ này có thể không khớp với định dạng của địa chỉ trong trường postal_address. Ví dụ: postal_address luôn biểu thị quốc gia dưới dạng region_code gồm 2 chữ cái, chẳng hạn như "US" hoặc "NZ". Ngược lại, trường này sử dụng tên quốc gia ở dạng dài hơn, chẳng hạn như "Hoa Kỳ" hoặc "New Zealand".

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ỉ đã được đị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ể. Đừ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.

string

Các 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 đầu vào như "Boulder, Colorado, 80301, USA". Bạn có thể xem danh sách các loại có thể sử dụng tại đây.

string

Các loại thành phần có trong address_components nhưng không xác nhận được 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 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à một phần hợp lệ của địa chỉ. Ví dụ: đối với giá trị nhập như "Parcel 0000123123 & 0000456456 Str # Guthrie Center IA 50115 US", các mã thông báo chưa được giải quyết có thể có dạng ["Parcel", "0000123123", "&", "0000456456"].

ComponentName

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

string

Loại của thành phần địa chỉ. Hãy xem Bảng 2: Các loại bổ sung do 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 rằng thành phần đó là chính xác.

bool

Cho biết thành phần này không phải là một phần của mục nhập, 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 biến thể khác, chẳng hạn như khi thay đổi "centre" thành "center". Công cụ này cũng không phải lúc nào cũng gắn cờ lỗi chính tả phổ biến, chẳng hạn như khi thay đổi "Amphitheater Pkwy" thành "Amphitheater 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ụ: mã bưu chính không chính xác được thay thế bằng mã bưu chính chính xác cho địa chỉ. Đâ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 một thành phần địa chỉ không được xuất hiện trong địa chỉ bưu chính của 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 không được đặt, hãy cho biết giá trị không xác định.

bool

Cho biết địa chỉ của hộp thư bưu điện. Nếu không được đặt, hãy cho biết giá trị không xác định.

bool

Cho biết đây là địa chỉ của một nơi cư trú. Nếu không được đặt, hãy cho biết giá trị không xác định.

string

Văn bản tên. Ví dụ: "5th Avenue" đối với tên đường hoặc "1253" đối với 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 dữ liệu đầu vào.

Bạn nên sử dụng mã địa điểm thay vì đị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 đường đi luôn dẫn đến việc điểm được chụp nhanh đến đường gần nhất với các toạ độ đó. Đây có thể không phải là con đường dẫn đến đí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ã hoá địa lý đảo ngược, không có gì đả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 chỉ số khác về độ thô của vị trí được mã hoá địa lý, nhưng ở kích thước thực tế thay 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à 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.

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ã hợp chất 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 được định dạng của một thực thể tham chiếu.

ValidationConclusion

Bắt buộc. Kết quả của trình tự các lần 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.

string

Bắt buộc. Mã của nội dung phản hồi mà ý kiến phản hồi này dành cho. Đây phải là [response_id][google.maps.addressvalidation.v1.ValidateAddressRequest.response_id] từ phản hồi đầu tiên trong một loạt các lần 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á ở 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

Phần mở rộng 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 được thêm vào cuối mã vạch điểm giao hàng cho thư được quét bằng máy. 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ẽ ra được một số chia hết cho 10.

string

Các giá trị có thể có cho 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ỉ chỉ được DPV xác nhận cho số chính và thiếu thông tin về số phụ.
• S: Địa chỉ chỉ được xác nhận là DPV cho số chính và thông tin về số phụ có 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ì địa chỉ đó chưa được gửi để xác nhận DPV.

string

Chú thích trong quá trình xác thực điểm giao hàng. Bạn có thể nối nhiều chú thích cuối cùng 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ố điện thoại phụ không khớp và không bắt buộc
• C1: Số điện thoại phụ không khớp nhưng bắt buộc phải có
• N1: Địa chỉ toà nhà cao tầng thiếu số phụ
• M1: Thiếu số chính
• M3: Số điện thoại 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: Số hộp thư bưu điện PO, RR hoặc 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ã 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 của DPV có thông tin PMB
• R1: Địa chỉ đã xác nhận của DPV không có thông tin PMB
• R7: Bản ghi Tuyến đường của hãng vận tải R777 hoặc R779
• IA: Đã xác định địa chỉ được thông báo
• TA: Số chính được so khớp bằng cách thả alpha ở cuối

string

Cho biết địa chỉ có phải là CMRA (Đại lý 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ự.

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

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

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

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

• 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ỉ gửi thư phục vụ các địa chỉ đó.
• 2: CDS – Địa chỉ chưa thể giao hàng. Ví dụ: một tiểu khu mới đã xác định được lô đất và số nhà chính nhưng chưa có cấu trúc nào cho việc sử dụng.
• 3: Xung đột – Địa chỉ không thực sự được DPV xác nhận.
• 4: CMZ (Cao đẳng, quân sự và các loại hình khác) – Mã ZIP + 4 bản ghi mà USPS đã đưa vào dữ liệu.
• 5: Thông thường – Cho biết những địa chỉ không nhận được hàng và không được tính là địa chỉ có thể giao hàng.
• 6: Bắt buộc phải có thông tin phụ – Địa chỉ cần có thông tin phụ.

string

Cờ cho biết thư được gửi đến một hộp thư duy nhất tại một trang web. Trả về một ký tự.

• Y: Thư được phân phối đến một hộp thư duy nhất tại một trang web.
• N: Thư không được phân phối đến một hộp thư duy nhất 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 giao đến địa chỉ đường phố.
• N: Thư được giao đến địa chỉ đường phố.

string

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

• 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ó dấu hiệu nào cho thấy việc phân phối thư không được thực hiện hằng ngày trong tuần.

int32

Số nguyên xác định những 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 hàng 0x08 – Thứ Tư là ngày không giao hàng 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

string

Cờ cho biết có thể mở cửa, nhưng gói hàng sẽ không được để lại do lo ngại về an ninh. Trả về một ký tự.

• 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ỉ đã được so khớp với bản ghi PBSA. Trả về một ký tự.

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

• Y: Không thể vào cửa.
• N: Không có dấu hiệu cho thấy không thể tiếp cận cửa.

string

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

• Y: Địa chỉ đã được DPV xác nhận cho 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 bằng DPV chỉ cho số chính và thông tin số phụ có nhưng chưa được xác nhận, hoặc một chữ cái ở cuối số chính đã bị loại bỏ để so khớp DPV và cần có thông tin phụ.
• D: Địa chỉ chỉ được DPV xác nhận cho số chính và thiếu thông tin về số phụ.
• R: Địa chỉ đã được xác nhận nhưng chỉ định cho tuyến ảo R777 và R779, đồng thời không cung cấp dịch vụ giao hàng USPS.

string

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

Tiền tố:

• C: Tuyến của hãng vận tải (hoặc tuyến trong thành phố)
• R: Tuyến đường nông thôn
• H: Tuyến đường theo hợp đồng đường cao tốc
• B: Phần 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ó 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 theo FIPS.

string

Tên hạt.

string

Số đường bay nâng cao (eLOT).

string

Cờ tăng dần/giảm dần eLOT (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 khi so khớp bản ghi đường phố hoặc toà nhà cao tầng với thông tin về 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 không đượ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ỉ đầu vào.

• F: FIRM. Đây là kết quả trùng khớp với một Bản ghi doanh nghiệp. Đây là mức độ trùng khớp cao nhất có thể đối với một địa chỉ.
• G: PHÂN PHỐI CHUNG. Đây là kết quả trùng khớp với một bản ghi Phân phối chung.
• H: TÒA NHÀ / CĂN HỘ. Đây là dữ liệu trùng khớp với một hồ sơ về Toà nhà hoặc Căn hộ.
• P: HỘP BƯU ĐIỆN. Đây là kết quả 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à trường hợp 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: STREET RECORD (BẢN DỮ LIỆU ĐƯỜNG): Đây là kết quả khớp với một bản dữ liệu Đường chứa 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ó các địa chỉ cụ thể hơn.

string

Thông báo lỗi khi 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 khi xảy ra lỗi này.

bool

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

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.

Tổng độ dài của các trường trong dữ liệu đầu vào 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ỉ đầu vào được dành riêng cho các mục đích sử dụng trong tương lai và bị bỏ qua hiện tại. 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ỉ đã cho, theo xác định của hệ thống.

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 các giá trị này.

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. Đ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ó bật USPS CASS 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 dưới dạng "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 tạo 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ố nhà và tên đường, còn dòng thứ hai chứa thành phố, tiểu bang và mã zip.

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ế và các thay đổi đối vớ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ể không tương thích với các 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 tuân theo Điều khoản cụ thể về dịch vụ của 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.

Cho phép 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 phiên Tự động hoàn thành cho mục đích thanh toán. Phải là một URL và tên tệp an toàn ở định dạng base64, có độ dài tối đa 36 ký tự ASCII. Nếu không, hệ thống sẽ trả về lỗi INVALID_ARGUMENT.

Phiên bắt đầu khi người dùng thực hiện một truy vấn 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 Chi tiết địa điểm hoặc Xác minh địa chỉ. Mỗi phiên có thể có nhiều truy vấn Tự động hoàn thành, theo sau là một yêu cầu Chi tiết địa điểm hoặc Xác thực địa chỉ. Thông tin xác thực dùng cho mỗi yêu cầu trong một phiên phải thuộc cùng một dự án trên Google Cloud Console. Sau khi một phiên kết thúc, mã thông báo sẽ không còn hợp lệ nữa; ứng dụng của bạn phải tạo một 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 xem 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

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ờ 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. Không đảm bảo metadata được điền đầy đủ cho mọi địa chỉ được gửi đến API Xác thực địa chỉ.

UspsData

Các cờ bổ sung về khả năng phân phối do USPS cung cấp. Chỉ được cung cấp trong vùng US và PR.

Address

Bản dùng thử: Tính năng này đang ở giai đoạn Bản dùng thử (trước khi phát hành công khai). 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ế và các thay đổi đối vớ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ể không tương thích với các 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 tuân theo Điều khoản cụ thể về dịch vụ của 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ỉ được dịch sang tiếng Anh.

Không thể sử dụng lại các địa chỉ đã dịch dưới dạng dữ liệu đầu vào của API. Dịch vụ cung cấp các thông báo này để người dùng có thể sử dụng tiếng mẹ đẻ 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 một 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ản dịch hoặc bản phiên âm bằng ngôn ngữ sử dụng chữ cái Latinh, thì dịch vụ sẽ trả về phần đó bằng ngôn ngữ địa phương 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 english_latin_address và trường google.maps.addressvalidation.v1.AddressComponent.confirmation_level trong english_latin_address.address_components không được điền sẵn.

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 đưa ra 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 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ệ, thì validation_granularity có thể là PREMISE trở xuống.

Granularity

Cấp độ chi tiết mà API có thể xác thực đầ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.

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

Granularity

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

Đôi khi, giá trị này 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 không được đặt, 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 chi tiết.

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.

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 thông tin chi tiết.

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.