Lớp AddressValidation
Lớp google.maps.addressValidation.AddressValidation
Lớp tĩnh để truy cập vào API AddressValidation.
Truy cập bằng cách gọi const {AddressValidation} = await google.maps.importLibrary("addressValidation")
.
Xem Thư viện trong Maps JavaScript API.
Phương thức tĩnh | |
---|---|
|
fetchAddressValidation(request) Tham số:
Giá trị trả về:
Promise<AddressValidation> Xác thực một địa chỉ. Hãy xem https://developers.google.com/maps/documentation/javascript/address-validation/validate-address. |
Thuộc tính | |
---|---|
|
Loại:
Address optional Thông tin về chính địa chỉ đó, chứ không phải mã địa lý. |
|
Loại:
Geocode optional Thông tin về vị trí và địa điểm mà địa chỉ được mã hoá địa lý. |
|
Loại:
AddressMetadata optional Thông tin khác liên quan đến khả năng gửi email. metadata không đảm bảo được điền đầy đủ cho mọi địa chỉ được gửi đến Address Validation API. |
|
Loại:
string optional 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. |
|
Loại:
USPSData optional Các cờ bổ sung về khả năng gửi được thư do USPS cung cấp. Chỉ được cung cấp ở khu vực US và PR . |
|
Loại:
Verdict optional Cờ kết quả tổng thể |
Phương thức | |
---|---|
|
toJSON() Tham số: Không có
Giá trị trả về:
Object Chuyển đổi lớp AddressValidation thành một đối tượng JSON có cùng các thuộc tính. |
Giao diện AddressValidationRequest
google.maps.addressValidation.AddressValidationRequest
giao diện
Giao diện yêu cầu cho
.AddressValidation.fetchAddressValidation
Thuộc tính | |
---|---|
|
Loại:
PostalAddressLiteral Địa chỉ đang được xác thực. Bạn nên gửi địa chỉ chưa được định dạng qua PostalAddress.addressLines . |
|
Loại:
string optional Bạn không được đặt trường này 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 trường này bằng từ phản hồi đầu tiên trong chuỗi xác thực. |
|
Loại:
boolean optional Bật chế độ tương thích CASS của USPS. Điều này chỉ ảnh hưởng đến trường của AddressValidation . Lưu ý: đối với các yêu cầu được bật CASS của USPS cho địa chỉ ở Puerto Rico, bạn phải cung cấp PostalAddress.regionCode của address là "PR" hoặc PostalAddress.administrativeArea của address là "Puerto Rico" (không phân biệt chữ hoa chữ thường) hoặc "PR". |
Lớp Địa chỉ
Lớp google.maps.addressValidation.Address
Thông tin chi tiết về địa chỉ đã được xử lý sau. Xử lý hậu kỳ bao gồm việc sửa các phần bị sai chính tả trong địa chỉ, thay thế các phần không chính xác và suy luận các phần bị thiếu.
Truy cập bằng cách gọi const {Address} = await google.maps.importLibrary("addressValidation")
.
Xem Thư viện trong Maps JavaScript API.
Thuộc tính | |
---|---|
|
Loại:
Array<AddressComponent> 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. Thông tin 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. |
|
Loại:
string optional Địa chỉ đã xử lý hậu kỳ, được định dạng dưới dạng địa chỉ một dòng theo các quy tắc định dạng địa chỉ của khu vực nơi địa chỉ đó nằm. |
|
Loại:
Array<string> Các loại thành phần dự kiến có trong một địa chỉ gửi thư có định dạng chính xác nhưng không có trong dữ liệu đầu vào VÀ không thể suy luận. 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 một dữ liệu đầu vào như "Boulder, Colorado, 80301, Hoa Kỳ". Bạn có thể xem danh sách các loại có thể có tại đây. |
|
Loại:
PostalAddress optional Địa chỉ đã xử lý sau được biểu thị dưới dạng địa chỉ bưu chính. |
|
Loại:
Array<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 thông qua address_components để tìm các loại của tất cả các thành phần mà không phải là hoặc cờ không được đặt thành true . Bạn có thể xem danh sách các loại có thể có tại đây. |
|
Loại:
Array<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à một 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", các mã thông báo chưa được phân giải có thể trông giống như ["123235253253"] vì mã thông báo đó không giống như một số nhà hợp lệ. |
Lớp AddressComponent
Lớp google.maps.addressValidation.AddressComponent
Đại diện cho một thành phần duy nhất của địa chỉ (ví dụ: tên đường, thành phố).
Truy cập bằng cách gọi const {AddressComponent} = await google.maps.importLibrary("addressValidation")
.
Xem Thư viện trong Maps JavaScript API.
Thuộc tính | |
---|---|
|
Loại:
string optional Văn bản tên thành phần. Ví dụ: "Đại lộ số 5" cho tên đường hoặc "1253" cho số nhà, |
|
Loại:
string optional Mã ngôn ngữ BCP-47. Thông tin 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à. |
|
Loại:
string optional Loại thành phần địa chỉ. Hãy xem Bảng 2: Các loại khác do dịch vụ Địa điểm trả về để biết danh sách các loại có thể có. |
|
Loại:
ConfirmationLevel optional Cho biết mức độ chắc chắn rằng thành phần này là chính xác. |
|
Loại:
boolean Nếu đúng, thành phần này không thuộc dữ liệu đầu vào, nhưng được suy luận cho vị trí địa chỉ. Bạn nên thêm thành phần này để có địa chỉ đầy đủ. |
|
Loại:
boolean 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ã bưu chính chính xác cho địa chỉ. Đây không phải là thay đổi về giao diện; thành phần đầu vào đã được thay đổi thành một thành phần khác. |
|
Loại:
boolean Cho biết nội dung chỉnh 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ể khác, chẳng hạn như "centre" thành "center". |
|
Loại:
boolean Nếu đúng, thành phần này không được xuất hiện trong địa chỉ bưu chính của khu vực đã cho. Nó chỉ được giữ lại vì là một phần của dữ liệu đầu vào. |
Lớp AddressMetadata
Lớp google.maps.addressValidation.AddressMetadata
Siêu dữ liệu của địa chỉ. AddressMetadata không đảm bảo được điền đầy đủ cho mọi địa chỉ được gửi đến Address Validation API.
Truy cập bằng cách gọi const {AddressMetadata} = await google.maps.importLibrary("addressValidation")
.
Xem Thư viện trong Maps JavaScript API.
Thuộc tính | |
---|---|
|
Loại:
boolean |
|
Loại:
boolean |
|
Loại:
boolean |
Hằng số ConfirmationLevel
Hằng số google.maps.addressValidation.ConfirmationLevel
Các giá trị có thể có khác nhau cho biết mức độ chắc chắn rằng thành phần là chính xác.
Truy cập bằng cách gọi const {ConfirmationLevel} = await google.maps.importLibrary("addressValidation")
.
Xem Thư viện trong Maps JavaScript API.
Hằng số | |
---|---|
|
|
|
|
|
Lớp Mã địa lý
Lớp google.maps.addressValidation.Geocode
Chứa thông tin về địa điểm mà dữ liệu đầu vào được mã hoá địa lý.
Truy cập bằng cách gọi const {Geocode} = await google.maps.importLibrary("addressValidation")
.
Xem Thư viện trong Maps JavaScript API.
Thuộc tính | |
---|---|
|
Loại:
LatLngBounds optional Ranh giới của địa điểm được mã hoá địa lý. |
|
Loại:
number optional 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 theo kích thước thực tế chứ không phải theo ý nghĩa ngữ nghĩa. |
|
Loại:
LatLngAltitude optional Vị trí được mã hoá địa lý của dữ liệu đầu vào. |
|
Loại:
string optional Mã địa điểm của địa điểm được mã hoá địa lý. Bạn nên sử dụng Place thay vì địa chỉ, toạ độ (vĩ độ/kinh độ) hoặc plus code. Việc sử dụng toạ độ để định tuyến hoặc tính toán chỉ đường lái xe sẽ luôn dẫn đến việc điểm được gắn vào con đường gần nhất với những toạ độ đó. Đây có thể không phải là con đường nhanh nhất hoặc an toàn nhất để dẫn đến điểm đến và có thể không gần một điểm tiếp cận đến cơ sở lưu trú. Ngoài ra, khi một vị trí được mã hoá địa lý 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. |
|
Loại:
Array<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 trong tài liệu về Geocoding API. |
|
Loại:
PlusCode optional Plus code tương ứng với location . |
Phương thức | |
---|---|
|
fetchPlace() Tham số: Không có
Giá trị trả về: Không có
Trả về một Place đại diện cho Geocode này. Để nhận thông tin chi tiết đầy đủ về địa điểm, bạn phải gọi đến place.fetchFields(). |
Hằng số độ chi tiết
Hằng số google.maps.addressValidation.Granularity
Các mức độ chi tiết mà một địa chỉ hoặc mã địa lý có thể có. Khi được dùng để cho biết mức độ chi tiết của một địa chỉ, các giá trị này cho biết mức độ chi tiết mà địa chỉ xác định điểm đến gửi thư. Ví dụ: một địa chỉ như "123 Main Street, Redwood City, CA, 94061" xác định một PREMISE
trong khi một địa chỉ như "Redwood City, CA, 94061" xác định một LOCALITY
. Tuy nhiên, nếu chúng tôi không tìm được mã địa lý cho "123 Main Street" ở Redwood City, thì mã địa lý được trả về có thể có độ chi tiết LOCALITY
mặc dù địa chỉ có độ chi tiết cao hơn.
Truy cập bằng cách gọi const {Granularity} = await google.maps.importLibrary("addressValidation")
.
Xem Thư viện trong Maps JavaScript API.
Hằng số | |
---|---|
|
Địa chỉ hoặc mã địa lý cho biết 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. |
|
Tất cả các mức độ chi tiết khác được gộp lại với nhau vì không thể phân phối. |
|
Kết quả ở cấp toà nhà. |
|
Mã địa lý ước chừng vị trí ở cấp độ toà nhà của địa chỉ. |
|
Mã địa lý hoặc địa chỉ có độ chi tiết đến từng tuyến đường, chẳng hạn như đường phố, đường hoặc đường cao tốc. |
|
Kết quả ở cấp dưới toà nhà, chẳng hạn như một căn hộ. |
Lớp USPSAddress
Lớp google.maps.addressValidation.USPSAddress
Thông tin về địa chỉ ở Hoa Kỳ theo USPS.
Truy cập bằng cách gọi const {USPSAddress} = await google.maps.importLibrary("addressValidation")
.
Xem Thư viện trong Maps JavaScript API.
Thuộc tính | |
---|---|
|
Loại:
string optional Tên thành phố. |
|
Loại:
string optional Dòng địa chỉ chứa thành phố, tiểu bang và mã bưu chính. |
|
Loại:
string optional Tên của công ty. |
|
Loại:
string optional Dòng đầu tiên của địa chỉ. |
|
Loại:
string optional Dòng thứ hai của địa chỉ. |
|
Loại:
string optional Mã tiểu bang gồm 2 chữ cái. |
|
Loại:
string optional Tên khu đô thị ở Puerto Rico. |
|
Loại:
string optional Mã bưu chính, ví dụ: "10009". |
|
Loại:
string optional Phần mở rộng mã bưu chính gồm 4 chữ số, ví dụ: "5023". |
Lớp USPSData
Lớp google.maps.addressValidation.USPSData
Dữ liệu của USPS cho địa chỉ. Không đảm bảo rằng USPSData sẽ được điền đầy đủ cho mọi địa chỉ ở Hoa Kỳ hoặc Puerto Rico được gửi đến Address Validation API. Bạn nên tích hợp các trường địa chỉ dự phòng trong phản hồi nếu sử dụng uspsData làm phần chính của phản hồi.
Truy cập bằng cách gọi const {USPSData} = await google.maps.importLibrary("addressValidation")
.
Xem Thư viện trong Maps JavaScript API.
Thuộc tính | |
---|---|
|
Loại:
string optional Thành phố viết tắt. |
|
Loại:
string optional Loại bản ghi địa chỉ khớp với địa chỉ đầu vào. |
|
Loại:
string optional Mã tuyến đường của hãng vận chuyển. Mã gồm 4 ký tự, trong đó có một tiền tố là chữ cái và một mã định danh tuyến đường gồm 3 chữ số. |
|
Loại:
string optional Chỉ báo sắp xếp theo tỷ lệ tuyến đường của hãng vận chuyển. |
|
Loại:
boolean Chỉ báo cho biết yêu cầu đã được xử lý bằng CASS. |
|
Loại:
string optional Tên hạt. |
|
Loại:
string optional 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 bằng máy. Tổng của tất cả các chữ số trong delivery_point_barcode, delivery_point_check_digit, mã bưu chính và ZIP+4 phải là một số chia hết cho 10. |
|
Loại:
string optional Mã điểm giao hàng gồm 2 chữ số. |
|
Loại:
string optional Cho biết địa chỉ có phải là CMRA (Commercial Mail Receiving Agency – Cơ quan nhận thư thương mại) hay không. Đây là một doanh nghiệp tư nhân nhận thư cho khách hàng. Trả về một ký tự đơn. |
|
Loại:
string optional Các giá trị có thể có cho thông tin xác nhận DPV. Trả về một ký tự duy nhất hoặc không trả về giá trị nào. |
|
Loại:
string optional 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. |
|
Loại:
string optional Cờ cho biết thư được gửi đến một hộp thư duy nhất tại một địa điểm. Trả về một ký tự đơn. |
|
Loại:
string optional Cho biết rằng có nhiều mã trả về DPV hợp lệ cho địa chỉ. Trả về một ký tự đơn. |
|
Loại:
string optional Chú thích trong quá trình xác thực điểm giao hàng. Bạn có thể ghép nhiều chú thích vào cùng một chuỗi. |
|
Loại:
string optional Cờ cho biết dịch vụ giao thư không hoạt động vào một số ngày trong tuần. Trả về một ký tự đơn. |
|
Loại:
number optional Số nguyên xác định những ngày không giao hàng. Bạn có thể truy vấn bằng cách sử dụ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 |
|
Loại:
string optional Cờ cho biết cửa có thể tiếp cận, nhưng gói hàng sẽ không được để lại do lo ngại về vấn đề bảo mật. Trả về một ký tự đơn. |
|
Loại:
string optional Cho biết địa chỉ đó là địa chỉ không có số nhà 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 có người ở liên tục hoặc những địa chỉ mà USPS không phục vụ. Trả về một ký tự đơn. |
|
Loại:
number optional Cho biết loại NoStat. Trả về mã lý do dưới dạng số nguyên. |
|
Loại:
string optional Cho biết địa chỉ đã khớp với bản ghi PBSA. Trả về một ký tự đơn. |
|
Loại:
string optional Cho biết thư không được gửi đến địa chỉ đường phố. Trả về một ký tự đơn. |
|
Loại:
string optional Cho biết địa chỉ có bị bỏ trống hay không. Trả về một ký tự đơn. |
|
Loại:
string optional Cờ eLOT tăng dần/giảm dần (A/D). |
|
Loại:
string optional Số Enhanced Line of Travel (eLOT). |
|
Loại:
string optional Thông báo lỗi khi truy xuất dữ liệu của USPS. Trường này được điền sẵn khi quá trình xử lý của USPS bị tạm ngưng do hệ thống phát hiện địa chỉ được tạo nhân tạo. |
|
Loại:
string optional Mã hạt FIPS. |
|
Loại:
boolean Chỉ báo cho biết hệ thống đã tìm thấy một địa chỉ mặc định, nhưng vẫn còn những địa chỉ cụ thể hơn. |
|
Loại:
boolean Địa chỉ giao hàng có thể so khớp, nhưng tệp EWS cho biết rằng tính năng so khớp chính xác sẽ sớm được cung cấp. |
|
Loại:
string optional Chỉ báo LACSLink. |
|
Loại:
string optional Mã trả về LACSLink. |
|
Loại:
string optional Mã nhận dạng đơn vị PMB (Hộp thư riêng). |
|
Loại:
string optional Số PMB (Hộp thư riêng). |
|
Loại:
boolean Mã bưu chính chỉ dành cho hộp thư bưu điện. |
|
Loại:
string optional Thành phố có bưu điện chính. |
|
Loại:
string optional Tiểu bang nơi có bưu điện chính. |
|
Loại:
USPSAddress optional Địa chỉ được tiêu chuẩn hoá của USPS. |
|
Loại:
string optional Chú thích từ việc so khớp một 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, số điện thoại phụ sẽ được trả về. |
Lớp Verdict
Lớp google.maps.addressValidation.Verdict
Biểu thị địa chỉ đã được xử lý hậu kỳ cho địa chỉ được cung cấp.
Truy cập bằng cách gọi const {Verdict} = await google.maps.importLibrary("addressValidation")
.
Xem Thư viện trong Maps JavaScript API.
Thuộc tính | |
---|---|
|
Loại:
boolean Đị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ỉ nào bị thiếu hoặc không mong muốn. Nếu chưa đặt, tức là giá trị là false . Hãy xem các trường , hoặc để biết thêm thông tin chi tiết. |
|
Loại:
Granularity optional 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 mức độ thô hoặc chi tiết của vị trí được mã hoá địa lý. |
|
Loại:
boolean Ít nhất một thành phần địa chỉ được suy luận (tức là được thêm) không có trong dữ liệu đầu vào, hãy xem AddressComponent để biết thông tin chi tiết. |
|
Loại:
boolean optional Ít nhất một thành phần địa chỉ đã được thay thế – hãy xem AddressComponent để biết chi tiết. |
|
Loại:
boolean 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 AddressComponent để biết thông tin chi tiết. |
|
Loại:
Granularity optional 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 validationGranularity . |
|
Loại:
Granularity optional Cấp độ chi tiết mà API có thể xác thực đầy đủ địa chỉ. Ví dụ: validationGranularity của PREMISE cho biết bạn có thể xác thực tất cả các thành phần địa chỉ ở cấp PREMISE và rộng hơn. |