Package google.maps.addressvalidation.v1

Chỉ mục

AddressValidation

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

ProvideValidationFeedback

rpc ProvideValidationFeedback(ProvideValidationFeedbackRequest) returns (ProvideValidationFeedbackResponse)

Phản hồi về kết quả của trình tự các lần xác thực. Đây phải là cuộc 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 khi giao dịch hoàn tất. Bạn chỉ nên gửi email này một lần cho chuỗi ValidateAddress yêu cầu cần thiết để xác thực đầy đủ địa chỉ.
ValidateAddress

rpc ValidateAddress(ValidateAddressRequest) returns (ValidateAddressResponse)

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

Address (Địa chỉ)

Thông tin chi tiết về địa chỉ được xử lý sau. Xử lý hậu kỳ bao gồm sửa những 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 còn thiếu.

Trường
formatted_address

string

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

PostalAddress

Địa chỉ sau 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ỉ đã được định dạng và sửa, cùng với thông tin xác thực. Cột 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.
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 tìm thấy trong mục nhập 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 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.
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 này tương đương với việc lặp lại qua address_components để tìm loại 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.
unresolved_tokens[]

string

Bất kỳ mã thông báo nào trong dữ liệu đầu vào 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 đầu vào 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ì số đó 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.

Trường
component_name

ComponentName

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

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

ConfirmationLevel

Cho biết mức độ chắc chắn mà chúng tôi có đượ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 nằm trong dữ liệu đầu vào, nhưng chúng tôi đã suy luận thành phần này dựa trên vị trí của địa chỉ và cho rằng thành phần này nên được cung cấp để có một địa chỉ đầy đủ.
spell_corrected

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ừ biến thể chính tả này sang biến thể khác, chẳng hạn như khi thay đổi "centre" thành "center". Trang 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 "Amphitheaterre 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ã bưu chính sai được thay thế bằng mã đúng 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.
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 chính 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.

ConfirmationLevel

Các giá trị 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à phù hợp 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ể xác nhận được rằng nó tồn tại. Ví dụ: số nhà nằm trong một dãy số hợp lệ đã biết trên một con phố không xác định được 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ỉ.

AddressMetadata

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

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ì hệ thống sẽ cho biết rằng giá trị là không xác định.
po_box

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ì hệ thống sẽ cho biết rằng giá trị là không xác định.
residential

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ì hệ thống sẽ cho biết rằng giá trị là không xác định.

ComponentName

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

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

Mã địa lý

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

Trường
location

LatLng

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

Sử dụng mã địa điểm được ưu tiên hơn sử dụng địa chỉ, vĩ độ/kinh độ hoặc mã cộng. Sử dụng toạ độ khi định tuyến hoặc tính toán chỉ đường lái xe sẽ luôn gắn kết điểm với con đường gần với các toạ độ đó nhất. Đây có thể không phải là đường 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ã hoá địa lý ngược, chúng tôi không đảm bảo rằng địa chỉ được 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ã hoá địa lý, nhưng theo kích thước vật lý thay vì theo ý nghĩa ngữ nghĩa.
place_id

string

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

Để 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ý đến. Ví dụ: ['locality', 'political']. Bạn có thể xem danh sách đầy đủ các loại thuộc tính tại đây.

LanguageOptions

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ể bị hỗ trợ hạn chế. Đồng thời, các 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 khác trước giai đoạn phát hành rộng rãi. 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à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.

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

Trường
return_english_latin_address

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.

PlusCode

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

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 tỷ lệ 1/8000 x 1/8000 độ khu vực (~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.

ProvideValidationFeedbackRequest

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

Trường
conclusion

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, hàm sẽ trả về lỗi INVALID_ARGUMENT.
response_id

string

Bắt buộc. Mã của phản hồi nhận được phản hồi này. Đây phải là [response_id][google.maps.addressvalidate.v1.ValidateAddressRequest.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ỉ.

ValidationConclusion

Kết quả cuối cùng có thể xảy ra của chuỗi yêu cầu xác thực địa chỉ mà bạn cần để 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ệ thống sẽ trả về lỗi INVALID_ARGUMENT.
VALIDATED_VERSION_USED Phiên bản của địa chỉ mà API xác thực địa chỉ trả về đã được sử dụng cho giao dịch.
USER_VERSION_USED Phiên bản đị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 dùng cho giao dịch này.
UNUSED Giao dịch đã bị huỷ bỏ và địa chỉ không được sử dụng.

ProvideValidationFeedbackResponse

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 bạn gửi ý kiến phản hồi thành công.

UspsAddress

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

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ị hoá của Puerto Rico.
city_state_zip_address_line

string

Thành phố + tiểu bang + mã bưu điện.
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

Phần mở rộng của mã bưu chính gồm 4 chữ số, ví dụ: 5023.

UspsData

Dữ liệu USPS cho địa chỉ. Google không đảm bảo rằng uspsData sẽ được điền đầy đủ dữ liệu cho mọi địa chỉ ở Hoa Kỳ hoặc PR được gửi tới 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.

Trường
standardized_address

UspsAddress

Địa chỉ được chuẩn hoá theo 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 delivery_point_barcode đối với thư được quét cơ học. Cộng tất cả các chữ số của delivery_point_barcode, delivery_point_check_digit, mã bưu chính và ZIP+4 cùng nhau 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 hoặc không trả về giá trị nào.

  • N: Không xác nhận được thông tin về số chính và mọi thông tin về số phụ.
  • D: Địa chỉ đã được DPV xác nhận chỉ 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 DPV chỉ xác nhận cho số điện thoại chính, và thông tin về số điện thoại phụ đã xuất hiện nhưng chưa được xác nhận.
  • Y: Địa chỉ đã được xác nhận là DPV cho các số chính và các số phụ.
  • Trống: Nếu phản hồi không chứa giá trị dpv_confirmation, tức là địa chỉ chưa được gửi để xác nhận DPV.
dpv_footnote

string

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: Đã 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ỉ 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 PO, 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 độ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ã bưu chính duy nhất
  • PB: Địa chỉ nhập khớp với bản ghi PBSA
  • RR: Địa chỉ đã xác nhận của DPV với thông tin của PMB
  • R1: Địa chỉ đã xác nhận của DPV mà không có thông tin của PMB
  • R7: Bản ghi R777 hoặc R779 của nhà mạng
  • IA: Đã xác định được địa chỉ đã nhận thông tin
  • TA: Số chính được khớp bằng cách bỏ dấu alpha ở cuối
dpv_cmra

string

Cho biết địa chỉ đó có phải là CMRA (Công ty 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ự đơn.

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

string

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

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

string

Đây là địa chỉ không có dữ 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ó người sử dụng liên tục hoặc các đị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
dpv_no_stat_reason_code

int32

Cho biết loại NoStat. Trả về mã lý do dưới dạng int.

  • 1: IDA (Địa chỉ thả xuống nội bộ) – Những địa chỉ không nhận thư trực tiếp từ USPS nhưng được gửi đến một địa chỉ thả dịch vụ các địa chỉ đó.
  • 2: CDS – Những địa chỉ chưa gửi được. Ví dụ: một phân mục mới có các lô và số chính đã được xác định, nhưng chưa có cấu trúc nào để xác định số người lưu trú.
  • 3: Va chạm – Địa chỉ không thực sự xác nhận DPV.
  • 4: CMZ (Trường đại học, quân đội và các loại hình khác) – ZIP + 4 hồ sơ mà USPS đã tích hợp vào dữ liệu.
  • 5: Thông thường – Cho biết các địa chỉ không nhận được dịch vụ giao hàng và các địa chỉ này không được tính là nơi giao hàng.
  • 6: Bắt buộc phụ – Địa chỉ yêu cầu thông tin phụ.
dpv_drop

string

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

  • Y: Thư được gửi đến một người nhận tại trang web.
  • N: Thư không được gửi đến một người nhận tại trang web.
dpv_throwback

string

Cho biết rằng 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ố.
dpv_non_delivery_days

string

Cờ cho biết việc gửi thư không được thực hiện mỗi 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 mỗi ngày trong tuần.
  • N: Không có dấu hiệu cho thấy việc gửi thư không được thực hiện mỗi ngày trong tuần.
dpv_non_delivery_days_values

int32

Số nguyên xác định ngày không phân phối. Có thể phân phối 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 0x01 – Thứ Bảy là ngày không giao hàng 0x01
dpv_no_secure_location

string

Cờ cho biết có thể vào cửa nhưng gói hàng sẽ không được để lại do vấn đề bảo mật. Trả về một ký tự đơn.

  • Y: Gói sẽ không còn lại do vấn đề bảo mật.
  • N: Không có chỉ báo rằng gói sẽ không còn lại do vấn đề bảo mật.
dpv_pbsa

string

Cho biết địa chỉ này 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.
dpv_door_not_accessible

string

Cờ cho biết những địa chỉ mà USPS không thể gõ cửa để gửi 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.
dpv_enhanced_delivery_code

string

Cho biết có nhiều mã trả lại DPV hợp lệ cho địa chỉ này. Trả về một ký tự đơn.

  • Y: Địa chỉ đã được xác nhận là DPV cho các số chính và các số phụ.
  • N: Không xác nhận được thông tin về số chính và mọi thông tin về số phụ.
  • S: Địa chỉ được xác nhận bằng DPV chỉ với số điện thoại chính và thông tin về số phụ xuất hiện khi chưa được xác nhận hoặc một ký tự alpha duy nhất trong số điện thoại chính đã bị loại bỏ để so khớp DPV và cần có thông tin phụ.
  • D: Địa chỉ đã được DPV xác nhận chỉ cho số điện thoại chính và thiếu thông tin về số điện thoại phụ.
  • R: Đã xác nhận địa chỉ nhưng chưa chỉ định địa chỉ cho tuyến ảo R777 và R779 và chưa cung cấp phân phối USPS.
carrier_route

string

Mã tuyến của nhà mạng. Mã bốn ký tự bao gồm một tiền tố một chữ cái và một tên 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 đườ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 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 tốc độ tuyến đường của nhà mạng.
ews_no_match

bool

Địa chỉ giao hàng có thể khớp nhưng tệp EWS cho biết rằng một kết quả khớp chính xác sẽ sớm có sẵn.
post_office_city

string

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

string

Tiểu bang bưu điện chính.
abbreviated_city

string

Thành phố được 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ỉ dành cho Hộp thư bưu điện.
pmb_designator

string

Người chỉ định đơn vị PMB (Hộp thư riêng tư).
pmb_number

string

số PMB (Hộp thư riêng tư);
address_record_type

string

Loại bản ghi địa chỉ khớp với địa chỉ được nhập.

  • F: FIRM. Đây là kết quả khớp với Bản ghi công ty, là mức độ so khớp tốt nhất có sẵn cho một địa chỉ.
  • G: GIAO HÀNG TỔNG HỢP. Thông tin này trùng khớp với một hồ sơ Phân phối chung.
  • H: XÂY DỰNG / CĂN HỘ. Thông tin này trùng khớp với một bản ghi về Toà nhà hoặc Căn hộ.
  • P: HỘP ĐĂNG KHUYẾN KHÍCH. Đây là kết quả phù hợp với Hộp thư bưu điện.
  • R: HỢP ĐỒNG ĐƯỜNG RỘNG hoặc HỢP ĐỒNG ĐỊA PHƯƠNG: Đây là kết quả trùng khớp với tuyến đường nông thôn hoặc hồ sơ Hợp đồng đường cao tốc, cả hai bản ghi này đều có thể có phạm vi Số hộp tương ứng.
  • S: ĐƯỜNG RECORD: Đây là kết quả trùng khớp với một bản ghi đường phố 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 có cá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 sẵn khi việc 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 xuất hiện lỗi này.
cass_processed

bool

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

ValidateAddressRequest

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

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 mục 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 cho mục đích sử dụng sau này và sẽ bị bỏ qua ngay hôm nay. Kết quả xác thực địa chỉ sẽ được điền dựa trên ngôn ngữ ưu tiên cho địa chỉ đã cho, do 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 đó đều sẽ bị loại bỏ và không được trả về. Vui lòng không đặt chúng.
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 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 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ó bật CASS của USPS cho các đị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 cung cấp 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 dùng address được thành phần hoá 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 đường, 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ể bị hỗ trợ hạn chế. Đồng thời, các 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 khác trước giai đoạn phát hành rộng rãi. 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à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.

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

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à chuỗi base64 an toàn cho URL và tên tệp, có độ dài tối đa là 36 ký tự ASCII. Nếu không, hệ thống sẽ trả về lỗi INVALID_ qu.

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 một cuộc gọi đến Chi tiết địa điểm hoặc Xác thực đị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 Thông tin chi tiết về địa điểm hoặc Yêu cầu xác thực địa chỉ. Thông tin đăng nhập được dùng cho từng 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 này không còn hợp lệ nữa. Ứng dụng phải tạo một mã thông báo mới cho mỗi phiên. Nếu tham 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 hoạt động 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ể 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 tham khảo tại https://developers.google.com/maps/documentation/places/web-service/session-pricing để biết thêm chi tiết.

ValidateAddressResponse

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

Trường
result

ValidationResult

Kết quả của việc 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 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.

ValidationResult

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

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ý đến.
metadata

AddressMetadata

Thông tin khác liên quan đến khả năng phân phối. Google không đảm bảo rằng metadata sẽ được điền đầy đủ dữ liệu cho mọi địa chỉ được gửi đến API xác thực địa chỉ.
usps_data

UspsData

Cờ khả năng giao bổ sung do USPS cung cấp. Chỉ được cung cấp ở khu vực US và PR.
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ể bị hỗ trợ hạn chế. Đồng thời, các 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 khác trước giai đoạn phát hành rộng rãi. 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à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ụ này cung cấp những thông tin đó để người dùng có thể sử dụng ngôn ngữ bản địa của mình để xác nhận hoặc từ chối xác thực địa chỉ đã 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, dịch vụ sẽ trả về phần đó bằng ngôn ngữ thay thế có sử dụng chữ viết Latinh. Vui lòng xem tại đây để biết nội dung giải thích về cách hệ thống lựa chọn ngôn ngữ thay thế. 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 bằng ngôn ngữ sử dụng chữ viết Latinh, 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 kết quả 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à các trường google.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ý.

Trường
input_granularity

Granularity

Độ 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. Để 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 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ể sẽ là PREMISE hoặc thấp hơn.
validation_granularity

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 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ề độ chi tiết của geocode. Điều này có thể được hiểu là ý nghĩa ngữ nghĩa cho biết vị trí được mã hoá địa lý kém hay nhỏ.

Đ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 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ỉ nào không mong muốn hoặc bị thiếu. Nếu không được đặt, hãy cho biết giá trị là false. Xem các trường missing_component_types, unresolved_tokens hoặc unexpected để biết thêm thông tin.
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) không có trong dữ liệu nhập, hãy xem google.maps.addressvalidation.v1.Address.address_components để biết 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

Chi tiết khác nhau mà một địa chỉ hoặc một mã địa lý có thể có. Khi dùng để biểu thị mức độ chi tiết của một địa chỉ, các giá trị này sẽ thể hiện mức độ chi tiết của địa chỉ xác định một điểm đến gửi thư. Ví dụ: Địa chỉ như "123 Main Street, Redwood City, CA, 94061" xác định PREMISE, trong khi đị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" ở 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ả có cấp độ toà nhà thấp hơn, 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ý ước chừ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 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 đối với tuyến đường, chẳng hạn như đường, đường 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ì chúng không thể phân phối được.