Package google.maps.addressvalidation.v1

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

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ỉ đã xử lý sau được biểu thị dưới dạng địa chỉ bưu chính.

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. Trạng thái 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 giả định 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ẽ có 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 thể suy luận được. 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.

Lưu ý: bạn có thể thấy một loại thành phần bị thiếu khi cho rằng mình đã cung cấp thành phần bị thiếu. Ví dụ: điều này có thể xảy ra khi địa chỉ đầu vào chứa tên toà nhà nhưng không có số nhà. Trong địa chỉ "渋谷区渋谷３丁目　Shibuya Stream", tên toà nhà "Shibuya Stream" có loại thành phần premise, nhưng thiếu số toà nhà, vì vậy missing_component_types sẽ chứa premise.

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 này tương đương với việc lặp lại qua address_components để tìm các loại của tất cả cá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.

string

Mọi mã thông báo trong dữ liệu đầu vào không thể phân giải. Đâ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 dữ liệu đầu vào như "Parcel 0000123123 & 0000456456 Str # Guthrie Center IA 50115 US", các mã thông báo chưa phân giải có thể có dạng ["Parcel", "0000123123", "&", "0000456456"].

ComponentName

Tên của thành phần này.

string

Loại 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 dữ liệu đầu vào, nhưng chúng tôi đã suy luận thành phần này cho vị trí địa chỉ và cho rằng bạn nên cung cấp thành phần này để có địa chỉ đầy đủ.

bool

Cho biết nội dung 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 "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ụ: 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 về mặt hình thức, mà là 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 giá trị 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" (Đường số 5) đối với tên đường hoặc "1253" đối với số nhà.

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

Ranh giới 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à thông tin đầu vào này mã hoá địa lý.

Để biết thêm thông tin về Mã địa điểm, hãy 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

Bản 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 một khu vực có kích thướ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á của 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 tiêu 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. Việc cộng tất cả chữ số của delivery_point_barcode, delivery_point_check_digit, mã bưu chính và ZIP+4 lại với nhau sẽ trả về một số có thể 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 xác nhận được thông tin số điện thoại chính và bất kỳ số điện thoại phụ nào qua DPV.
• D: Địa chỉ chỉ được DPV xác nhận cho số điện thoại chính và thiếu thông tin về số điện thoại phụ.
• S: Địa chỉ chỉ được DPV xác nhận cho số chính, còn thông tin về số phụ có nhưng chưa được xác nhận.
• Y: Địa chỉ đã được DPV xác nhận cho 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 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ả 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ố điện thoại chính
• M3: Số điện thoại chính không hợp lệ
• P1: Thiếu số hộp thư bưu điện, 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ỉ đầu vào khớp với một mã bưu chính duy nhất
• PB: Địa chỉ nhập khớp với bản ghi PBSA
• RR: Địa chỉ đã được DPV xác nhận có thông tin PMB
• R1: Địa chỉ do DPV xác nhận 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 được Địa chỉ đã 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 (Cơ quan tiếp 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ỉ 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ó số liệu thống kê hay địa chỉ đang hoạt động? Địa chỉ không có số liệu thống kê là những địa chỉ không liên tục có người ở hoặc địa chỉ mà USPS không cung cấp dịch 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ỉ nhận thư nội bộ) – Địa chỉ không nhận thư trực tiếp từ USPS mà được gửi đến một địa chỉ nhận thư để phục vụ đị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ố 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 đội và các loại khác) – Mã bưu chính + 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ự.

• Y: Thư không được giao đến địa chỉ đường.
• 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 mỗi ngày trong tuần. Trả về một ký tự.

• Y: Hoạt động gửi thư không được thực hiện vào 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. Bạn có thể truy vấn thông tin này 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 – Thứ Bảy là ngày không giao hàng

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 giữ lại do lo ngại về bảo mật.
• N: Không có dấu hiệu nào cho thấy gói sẽ không được giữ lại do lo ngại về 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ỉ đã được so 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ể mở cửa.
• N: Không có dấu hiệu cho thấy không thể mở 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 xác nhận được thông tin số điện thoại chính và bất kỳ số điện thoại phụ nào qua 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ố đ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 được chỉ định cho tuyến đường ảo R777 và R779 và không cung cấp dịch vụ giao hàng qua 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 theo mức giá của hãng vận chuyển.

bool

Địa chỉ giao hàng có thể so khớp, nhưng tệp EWS cho biết rằng địa chỉ giao hàng chính xác sẽ sớm 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ả về LACSLink.

string

Chỉ báo LACSLink.

bool

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

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ìm thấy tên doanh nghiệp trùng khớp, hệ thống sẽ trả về số phụ.

• A: So khớp bản ghi SuiteLink, địa chỉ doanh nghiệp được cải thiện.
• 00: Không có kết quả trùng khớp, địa chỉ doanh nghiệp không được cải thiện.

string

Chỉ định đơn vị PMB (Private Mail Box – Hộp thư riêng).

string

Số PMB (Private Mail Box – Thùng thư riêng);

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: GIAO HÀNG CHUNG. Đây là kết quả trùng khớp với một bản ghi Phân phối chung.
• H: TOÀ NHÀ / CHUNG CƯ. Đây là kết quả trùng khớp với bản ghi Toà nhà hoặc Căn hộ.
• P: HỘP BƯU ĐIỆN. Đây là kết quả trùng khớp với một Hộp thư bưu điện.
• R: TUYẾN NÔNG THÔNG hoặc HỢP ĐỒNG ĐƯỜNG QUỐC LỘ: Đây là kết quả trùng khớp với bản ghi về Tuyến nông thôn hoặc Hợp đồng đường quốc lộ, cả hai đều có thể có các dải ô Số hộp liên kết.
• S: STREET RECORD (BẢN GHI ĐƯỜNG): Đây là kết quả khớp với một bản ghi Đườ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. Trường này được điền khi USPS tạm ngưng xử lý do phát hiện địa chỉ được tạo một cách 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. Bạn nên gửi địa chỉ chưa định dạng 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.

Address Validation API 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 yêu cầu để xác thực đầy đủ một địa chỉ (ví dụ: nếu cần xác thực lại những thay đổi mà người dùng thực hiện sau lần xác thực ban đầu), thì mỗi yêu cầu tiếp theo phải điền response_id từ phản hồi đầu tiên trong trình tự xác thực vào trường này.

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 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 chưa phát hành công khai 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 chưa phát hành công khai có thể không tương thích với các phiên bản chưa phát hành công khai khác. Sản phẩm/dịch vụ ở giai đoạn trước khi phát hành rộng rãi tuân theo Điều khoản dành riêng cho 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 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 bạn bỏ qua thông số sessionToken hoặc sử dụng lại mã thông báo phiên, thì phiên sẽ bị 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 đượ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 phải 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 thông tin 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 địa chỉ cần được xác thực lại, thì 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 khả năng phân phối. 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 chưa phát hành công khai 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 chưa phát hành công khai có thể không tương thích với các phiên bản chưa phát hành công khai khác. Sản phẩm/dịch vụ ở giai đoạn trước khi phát hành rộng rãi tuân theo Điều khoản dành riêng cho 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.

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

Bạn không thể sử dụng lại địa chỉ đã dịch làm dữ liệu đầu vào 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. Hãy xem tại đây để biết nội dung giải thích về cách chọn ngôn ngữ thay thế. 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. Đố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ỉ đầu vào bao gồm một 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 tất cả các 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 cho từng thành phần địa chỉ trong google.maps.addressvalidation.v1.Address.address_components.

Granularity

Thông tin về độ 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 nhận sự tồn tại của một 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à đầy đủ nếu không có mã thông báo chưa được phân giải, không có thành phần địa chỉ bất ngờ hoặc bị thiếu. 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.