服務物件 (預覽)
清理、驗證和增強聯絡人資料。 我們的工具會根據數百個權威資料來源驗證和交叉驗證聯絡人的姓名、位置、電話、電子郵件地址和裝置。
此連接器適用於以下產品和區域:
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域, 但下列區域除外: - Azure Government 區域 - Azure 中國區域 - 美國國防部 (DoD) |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| Power Automate(自動化服務) | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 連絡人 | |
|---|---|
| 名稱 | 服務物件支援 |
| URL | https://www.serviceobjects.com/ |
| support@serviceobjects.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | 服務對象 |
| 網站 | https://www.serviceobjects.com/ |
| 隱私策略 | https://www.serviceobjects.com/privacy |
| 類別 | 銷售和客戶關係管理;資料 |
先決條件
試駕我們的實時服務,隨心所欲。 首先選擇產品並註冊免費 API 密鑰。 包括 500 筆測試交易和我們專門的 24/7 客戶支持。
產品頁面: https://www.serviceobjects.com/products
如何取得認證
讓我們的資料品質顧問協助您選擇適合您業務需求的服務。
請致電:1-800-694-6269
聯絡我們 - https://www.serviceobjects.com/contact-us
開始使用連接器
若要開始使用,請先註冊授權金鑰。 之後,您可以利用服務物件聯結器即時驗證您的資料。 選擇資料來源,從「動作」功能表中選取相關服務,將輸入對應至連接器,並利用輸出做出更好的業務決策。
正在建立連線
連接器支援下列驗證類型:
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用:所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| API 金鑰 | securestring | 此 API 的 API 金鑰 | 對 |
| 環境 | 字串 | 要使用的 API 環境;生產或試用 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
|
DOTS IP 位址驗證 - Get |
傳回指定 IP 位址的地理位置、Proxy、主機名稱和美國區域資訊。 |
|
DOTS 國際鉛驗證 - Validate |
DOTS Lead Validation International (LVI) 評估國際潛在客戶數據,並將數據質量分為通過/失敗/審查類別。 透過評估聯絡人的資訊質量,線上行銷人員可以更有效地剔除詐欺聯絡人。在線欺詐者更有可能提供不准確的聯繫信息,因為地址和電話號碼很容易被追踪。 與其他對單個變量執行簡單數據檢查的驗證服務不同,服務對象潛在客戶驗證解決方案能夠交叉驗證聯繫人的姓名、地址、電話號碼、電子郵件和 IP 地址是否彼此匹配並與消費者相關。 |
|
DOTS 國際電話交換 - Get |
我們的國際電話交換服務可驗證電話號碼並格式化國際直撥電話,同時傳回線路類型、國家/地區代碼和地理編碼資訊。 |
|
DOTS 地址 Geocode International - Place |
PlaceSearch 操作會傳回指定國際地址的緯度和經度,以及其他地址和位置資訊。 它會嘗試在屬性層級對地址進行地理編碼,這通常是某些屬性的屋頂座標,然後級聯到下一個最佳可用解析度,例如街道、社區、郵遞區號、地點等。 對於街道、城市和郵遞區號等非地址地點,座標會傳回通常與該位置相關聯的座標點或區域的質心。 |
|
DOTS 地址地理編碼國際 - Reverse |
ReverseSearch 作業會傳回一組指定座標的地址或地點資訊,以及其他地址和位置資訊。 它會嘗試反轉地理編碼座標,並在屬性層級傳回國際位址,這通常是某些屬性的內部部署層級解析,然後級聯至下一個最佳可用解析,例如街道、社區、郵遞區號、地點等。 對於服務傳回的街道、城市和郵遞區號等非地址地點,回應內文中的座標輸出將代表通常與該區域的位置或質心相關聯的座標點。 |
|
DOTS 地址驗證國際 - Get |
我們的即時國際地址驗證 API 服務可驗證並更正全球郵寄地址,以滿足每個國家/地區、郵寄地址格式和文化特質的獨特要求。 隨著特定國家/地區郵政當局的不斷更新,我們的數據始終 up-to時,地址真實準確。 |
|
美國 DOTS 地址驗證 3 - Get |
傳回已剖析和驗證的地址元素,包括遞送點驗證 (DPV)、住宅遞送指標 (RDI) 和套件資料。 GetBestMatches 會嘗試針對 CASS 核准的引擎驗證輸入位址,並在可能的情況下進行更正。 如果服務無法做出最終決定,則可能會返回多個地址候選者。 |
DOTS IP 位址驗證 - GetLocationByIP_V4
傳回指定 IP 位址的地理位置、Proxy、主機名稱和美國區域資訊。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
IP位址
|
IPAddress | string |
要查找的 IP 地址 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Desc
|
Error.Desc | string |
Desc |
|
地點
|
Error.Location | string |
地點 |
|
Number
|
Error.Number | string |
Number |
|
確實性
|
Certainty | integer |
對輸出可能準確程度的評級。 |
|
城市
|
City | string |
IP 位址的城市位置。 |
|
區域
|
Region | string |
IP 位址的狀態位置。 |
|
國家
|
Country | string |
IP 位址的國家/地區位置。 |
|
國家ISO3
|
CountryISO3 | string |
3 個字母的國家縮寫。 |
|
國家ISO2
|
CountryISO2 | string |
2 個字母的國家縮寫。 |
|
郵遞區號
|
PostalCode | string |
IP 位址的美國郵遞區號。 |
|
地鐵代碼
|
MetroCode | string |
IP 位址位置的 DMA 的數字大都會代碼。 |
|
DMA
|
DMA | string |
IP 位址位置的指定市場區域。 |
|
狀態FIPS
|
StateFIPS | string |
IP 位址的州聯邦資訊處理標準代碼。 此程式碼可用來唯一識別狀態。 |
|
縣FIPS
|
CountyFIPS | string |
IP 地址位置的縣聯邦信息處理標準代碼。 此代碼用於唯一識別美國各地的縣。 |
|
緯度
|
Latitude | number |
IP 位址的緯度座標。 |
|
經度
|
Longitude | number |
IP 位址的經度座標。 |
|
是代理
|
IsProxy | string |
指出 IP 位址是否為已知 Proxy。 |
|
代理類型
|
ProxyType | string |
指出 Proxy 的類型。 |
|
可能的行動裝置
|
PossibleMobileDevice | string |
指出 IP 位址是否被認為被行動裝置使用。 |
|
ISP
|
ISP | string |
分配IP地址的ISP。 |
|
網路區塊擁有者
|
NetblockOwner | string |
分配 IP 地址的網絡所有者 |
|
主機名稱
|
HostNames | string |
與 IP 位址相關聯的主機名稱。 如果找到多個主機名稱,則會傳回以逗點分隔的清單。 如果找不到主機名稱,則會傳回。 |
|
IP代碼
|
IPNoteCodes | string |
顯示在驗證程序期間找到的 IP 相關附註。 傳回以逗號分隔清單中的零個或多個數字註解代碼。 |
|
註
|
IPNotes | string |
包含與「備註代碼」相對應的備註旗標。 在逗號分隔的清單中傳回零個或多個註釋旗標。 |
|
Debug
|
Debug | string |
Debug |
DOTS 國際鉛驗證 - ValidateLeadInternational
DOTS Lead Validation International (LVI) 評估國際潛在客戶數據,並將數據質量分為通過/失敗/審查類別。 透過評估聯絡人的資訊質量,線上行銷人員可以更有效地剔除詐欺聯絡人。在線欺詐者更有可能提供不准確的聯繫信息,因為地址和電話號碼很容易被追踪。 與其他對單個變量執行簡單數據檢查的驗證服務不同,服務對象潛在客戶驗證解決方案能夠交叉驗證聯繫人的姓名、地址、電話號碼、電子郵件和 IP 地址是否彼此匹配並與消費者相關。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
全名
|
FullName | string |
連絡人的全名 |
|
|
問候
|
Salutation | string |
聯繫人的稱呼 |
|
|
FirstName
|
FirstName | string |
聯絡人的名字 |
|
|
姓氏
|
LastName | string |
聯絡人的姓氏 |
|
|
公司名稱
|
BusinessName | string |
聯繫人公司 |
|
|
商業領域
|
BusinessDomain | string |
與企業關聯的網站網域 |
|
|
商業EIN
|
BusinessEIN | string |
代表公司稅號 |
|
|
地址1
|
Address1 | string |
聯絡人或公司地址的地址 1 |
|
|
地址2
|
Address2 | string |
聯絡人或營業地址的地址 2 |
|
|
地址3
|
Address3 | string |
聯絡人或公司地址的地址 3 |
|
|
地址4
|
Address4 | string |
聯絡人或營業地址的地址4 |
|
|
地址5
|
Address5 | string |
聯絡人或公司地址的地址 5 |
|
|
地區
|
Locality | string |
聯絡人的郵寄地址所在城市 |
|
|
管理區域
|
AdminArea | string |
連絡人的郵寄地址狀態 |
|
|
郵遞區號
|
PostalCode | string |
聯絡人郵寄地址的郵遞區號 |
|
|
國家
|
Country | string |
使用提供的電話號碼驗證的國家/地區 |
|
|
電話1
|
Phone1 | string |
連絡人的主要電話號碼 |
|
|
電話2
|
Phone2 | string |
連絡人的次要電話號碼 |
|
|
Email
|
string |
連絡人的電子郵件地址 |
||
|
IP位址
|
IPAddress | string |
聯絡人的 IP 位址在 IPv4 中 |
|
|
性別
|
Gender | string |
男性、女性或中性 |
|
|
出生日期
|
DateOfBirth | string |
連絡人的出生日期 |
|
|
UTCCapture時間
|
UTCCaptureTime | string |
提交潛在客戶的時間 |
|
|
輸出語言
|
OutputLanguage | string |
某些輸出資訊的語言將是 |
|
|
TestType
|
TestType | string |
您要對此聯絡人執行的驗證類型的名稱 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
整體確定性
|
OverallCertainty | string |
此值代表服務在潛在客戶上提供的整體確定性。 此值的範圍介於 0 到 100 之間。 |
|
整體品質
|
OverallQuality | string |
指出是否應拒絕、審查或接受商機的欄位。 |
|
潛在客戶類型
|
LeadType | string |
指出服務為潛在客戶所做的分類。 |
|
領導國家
|
LeadCountry | string |
與潛在客戶相關的國家/地區,以 ISO 2 的形式給出。 |
|
註代碼
|
NoteCodes | string |
描述性註釋的枚舉清單。 |
|
註解說
|
NoteDesc | string |
對應於 NoteCodes 區段的說明。 |
|
名稱確定性
|
NameCertainty | string |
分數介於 0 到 100 之間,表示給定名稱有效的機率。 |
|
名稱品質
|
NameQuality | string |
指出是否應拒絕、檢閱或接受給定名稱的欄位。 |
|
名字拉丁文
|
FirstNameLatin | string |
沒有變音符號字元的領導人的名字。 |
|
姓氏拉丁文
|
LastNameLatin | string |
沒有變音符號字元的主角姓氏。 |
|
FirstName
|
FirstName | string |
帶有變音符號字符的第一個名字。 |
|
姓氏
|
LastName | string |
帶有變音符號字符的姓氏。 |
|
名稱註代碼
|
NameNoteCodes | string |
列舉的代碼清單,指出有關名稱欄位的更多資訊。 |
|
名稱註解
|
NameNoteDesc | string |
對應至 NameNoteCodes 欄位的描述性附註列舉清單。 |
|
地址確定性
|
AddressCertainty | string |
分數介於 0 到 100 之間,表示給定地址的有效性。 |
|
地址品質
|
AddressQuality | string |
指出是否應拒絕、審查或接受給定地址的欄位。 |
|
位址解析層級
|
AddressResolutionLevel | string |
地址的解析。 |
|
地址欄位1
|
AddressLine1 | string |
已驗證的地址行 1. |
|
地址欄位二
|
AddressLine2 | string |
已驗證的地址行 2. |
|
地址行 3
|
AddressLine3 | string |
已驗證的地址行 3. |
|
位址行 4
|
AddressLine4 | string |
已驗證的地址行 4. |
|
地址行5
|
AddressLine5 | string |
已驗證的地址行 5. |
|
地址地區
|
AddressLocality | string |
與指定輸入位址相關聯的位置。 通常對應城市。 |
|
位址管理區域
|
AddressAdminArea | string |
與輸入位址綁定的管理區域。 通常對應於州或省。 |
|
地址郵遞區號
|
AddressPostalCode | string |
與給定輸入地址相關的郵遞區號。 |
|
地址國家/地區
|
AddressCountry | string |
2 個字元的國家/地區 ISO 代碼。 |
|
地址註代碼
|
AddressNoteCodes | string |
列舉的代碼列表,指示有關給定地址的其他信息。 |
|
地址註解
|
AddressNoteDesc | string |
與 AddressNoteCodes 欄位相關聯的描述性附註列舉清單。 |
|
電子郵件確定性
|
EmailCertainty | string |
介於 0 到 100 之間的分數,表示指定電子郵件地址的有效性 |
|
電子郵件品質
|
EmailQuality | string |
一個欄位,指示是否應該拒絕、審查或接受給定的電子郵件地址。 |
|
電子郵件已更正
|
EmailCorrected | string |
用於測試的電子郵件,包括所做的任何更正。 |
|
電子郵件筆記代碼
|
EmailNoteCodes | string |
列舉的代碼列表,指示有關給定電子郵件地址的其他信息。 |
|
電子郵件註釋說明
|
EmailNoteDesc | string |
與 EmailNoteCodes 欄位相關聯的說明清單。 |
|
IP支持性
|
IPCertainty | string |
分數介於 0 到 100 之間,表示給定 IP 位址的有效性。 |
|
IP品質
|
IPQuality | string |
指示是否應拒絕、審查或接受給定 IP 位址的欄位。 |
|
IP定位
|
IPLocality | string |
與指定IP地址關聯的位置。 |
|
IPAdmin區域
|
IPAdminArea | string |
與指定 IP 位址相關聯的管理區域。 |
|
IP國家
|
IPCountry | string |
與指定 IP 位址相關聯的國家/地區 ISO 2 代碼。 |
|
IP代碼
|
IPNoteCodes | string |
列舉的代碼列表,指示有關給定 IP 地址的其他信息。 |
|
IP註解
|
IPNoteDesc | string |
與 IPNoteCodes 相關聯的描述,指出指定 IP 位址的其他資訊。 |
|
Phone1確定性
|
Phone1Certainty | string |
分數介於 0 到 100 之間,表示 Phone1 欄位中電話號碼的有效性。 |
|
電話1品質
|
Phone1Quality | string |
指出是否應拒絕、檢閱或接受 Phone1 輸入的欄位。 |
|
電話1地區
|
Phone1Locality | string |
與給定電話號碼相關聯的地點。 |
|
電話1管理員區域
|
Phone1AdminArea | string |
與給定電話號碼相關聯的行政區域。 |
|
電話1國家
|
Phone1Country | string |
與 Phone1 欄位中指定電話號碼相關聯的國家/地區 ISO 2 代碼。 |
|
電話1筆記代碼
|
Phone1NoteCodes | string |
列舉的代碼列表,指示有關給定電話的附加信息 1. |
|
電話1註描述
|
Phone1NoteDesc | string |
與「附註代碼」欄位中給出的代碼相關的說明。 |
|
Phone2確定性
|
Phone2Certainty | string |
分數介於 0 到 100 之間,表示 Phone2 欄位中給出的號碼有效性。 |
|
電話2品質
|
Phone2Quality | string |
此欄位指出是否應拒絕、檢閱或接受 Phone2 輸入。 |
|
電話2地點
|
Phone2Locality | string |
與給定電話號碼關聯的地點。 |
|
電話2管理員區域
|
Phone2AdminArea | string |
與給定電話號碼相關聯的行政區域。 |
|
電話2國家
|
Phone2Country | string |
與 Phone2 欄位中指定電話號碼相關聯的國家/地區 ISO 2 代碼。 |
|
電話2筆記代碼
|
Phone2NoteCodes | string |
列舉代碼列表,指示有關給定電話的附加信息 2. |
|
電話2註描述
|
Phone2NoteDesc | string |
與「附註代碼」欄位中給出的代碼相關的說明。 |
|
名稱
|
PhoneContact.Name | string |
連絡人的全名。 |
|
Address
|
PhoneContact.Address | string |
聯絡人的郵寄地址。 |
|
城市
|
PhoneContact.City | string |
聯絡人的郵寄地址所在的城市。 |
|
State
|
PhoneContact.State | string |
聯絡人的郵寄地址狀態。 |
|
壓縮檔
|
PhoneContact.Zip | string |
聯絡人郵寄地址的郵遞區號。 |
|
類型
|
PhoneContact.Type | string |
連絡人電話類型。 |
|
商業確定性
|
BusinessCertainty | string |
分數介於 0 到 100 之間,表示 BusinessName 的有效性。 |
|
商業品質
|
BusinessQuality | string |
此欄位指出是否應拒絕、檢閱或接受「公司名稱」輸入。 |
|
公司名稱
|
BusinessName | string |
提供的企業名稱。 |
|
商業領域
|
BusinessDomain | string |
與企業相關聯的網站網域。 |
|
商務電子郵件
|
BusinessEmail | string |
商務電子郵件。 |
|
商務筆記代碼
|
BusinessNoteCodes | string |
列舉的代碼列表,指示有關給定企業名稱的其他資訊。 |
|
商業筆記描述
|
BusinessNoteDesc | string |
與註釋代碼欄位中給出的代碼相關的描述。 |
|
資訊元件
|
InformationComponents | array of object |
索引鍵值組陣列,其中包含 API 原始輸出結構描述中未定義的其他欄位和資訊。 |
|
名稱
|
InformationComponents.Name | string |
名稱 |
|
價值觀
|
InformationComponents.Value | string |
價值觀 |
|
類型
|
Error.Type | string |
類型 |
|
類型代碼
|
Error.TypeCode | string |
類型代碼 |
|
Desc
|
Error.Desc | string |
Desc |
|
描述代碼
|
Error.DescCode | string |
描述代碼 |
|
偵錯
|
DEBUG | string |
偵錯 |
DOTS 國際電話交換 - GetInternationalExchangeInfo
我們的國際電話交換服務可驗證電話號碼並格式化國際直撥電話,同時傳回線路類型、國家/地區代碼和地理編碼資訊。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
電話號碼
|
PhoneNumber | string |
要解析、驗證和格式化的電話號碼 |
|
|
國家
|
Country | string |
使用提供的電話號碼驗證的國家/地區 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
數字輸入
|
InternationalExchangeInfo.NumberIn | string |
作為輸入提供的電話號碼。 |
|
國家代碼
|
InternationalExchangeInfo.CountryCode | string |
所提供電話號碼的國家/地區代碼。 |
|
格式全國
|
InternationalExchangeInfo.FormatNational | string |
以國家格式提供的電話號碼。 |
|
Extension
|
InternationalExchangeInfo.Extension | string |
從提供的電話號碼剖解析的分機。 |
|
地區
|
InternationalExchangeInfo.Locality | string |
電話號碼所屬的地區。 地區格式通常是地區設定/地區、地區或國家/地區。 |
|
LocalityMatchLevel (局部性匹配級別)
|
InternationalExchangeInfo.LocalityMatchLevel | string |
從找到的地點決定的相符層級。 可能的值包括 (地區設定/區域、區域、國家/地區) 相符。 |
|
TimeZone
|
InternationalExchangeInfo.TimeZone | string |
已驗證電話號碼的時區。 |
|
緯度
|
InternationalExchangeInfo.Latitude | string |
根據電話號碼確定的地點緯度。 |
|
經度
|
InternationalExchangeInfo.Longitude | string |
根據電話號碼確定的地點經度。 |
|
國家
|
InternationalExchangeInfo.Country | string |
已驗證電話號碼所屬的國家/地區。 |
|
國家ISO2
|
InternationalExchangeInfo.CountryISO2 | string |
已驗證電話號碼的 ISO 2 字元國家/地區名稱。 |
|
國家ISO3
|
InternationalExchangeInfo.CountryISO3 | string |
已驗證電話號碼的 ISO 3 字元國家/地區名稱。 |
|
格式國際
|
InternationalExchangeInfo.FormatInternational | string |
提供的國際格式電話號碼。 |
|
格式E164
|
InternationalExchangeInfo.FormatE164 | string |
提供的電話號碼為 E.164 格式。 |
|
承運人
|
InternationalExchangeInfo.Carrier | string |
為電話號碼確定的電信業者。 |
|
線型
|
InternationalExchangeInfo.LineType | string |
為電話號碼決定的線型。 請參閱下面的 InternationalExchangeInfo 行型別表格。 |
|
簡訊地址
|
InternationalExchangeInfo.SMSAddress | string |
所提供行動號碼的 SMS 閘道位址。 |
|
彩信地址
|
InternationalExchangeInfo.MMSAddress | string |
所提供行動號碼的彩信閘道位址。 |
|
是有效
|
InternationalExchangeInfo.IsValid | boolean |
布林值回應類型,可判斷電話號碼是否為有效的電話號碼。 |
|
IsValidForRegion
|
InternationalExchangeInfo.IsValidForRegion | boolean |
布林值回應類型,可判斷電話號碼是否為所提供國家/地區的有效電話號碼。 |
|
註代碼
|
InternationalExchangeInfo.NoteCodes | string |
符合 NoteDescriptions 的對應代碼。 這些值根據測試結果從 1 到 6 不等。 |
|
註說明
|
InternationalExchangeInfo.NoteDescriptions | string |
符合 NoteCodes 的對應說明。 這些值會根據 NoteCodes 而有所不同。 |
|
類型
|
Error.Type | string |
類型 |
|
類型代碼
|
Error.TypeCode | string |
類型代碼 |
|
Desc
|
Error.Desc | string |
Desc |
|
描述代碼
|
Error.DescCode | string |
描述代碼 |
|
Debug
|
Debug | array of string |
Debug |
DOTS 地址 Geocode International - PlaceSearch
PlaceSearch 操作會傳回指定國際地址的緯度和經度,以及其他地址和位置資訊。 它會嘗試在屬性層級對地址進行地理編碼,這通常是某些屬性的屋頂座標,然後級聯到下一個最佳可用解析度,例如街道、社區、郵遞區號、地點等。 對於街道、城市和郵遞區號等非地址地點,座標會傳回通常與該位置相關聯的座標點或區域的質心。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
單線
|
SingleLine | string |
一行完整的地址。 |
|
|
地址1
|
Address1 | string |
國際地址的地址行 1 |
|
|
地址2
|
Address2 | string |
國際地址的地址行 2 |
|
|
地址3
|
Address3 | string |
國際地址第 3 行 |
|
|
地址4
|
Address4 | string |
國際地址的地址第 4 行 |
|
|
地址5
|
Address5 | string |
國際地址的地址第 5 行 |
|
|
地區
|
Locality | string |
相異母體叢集的名稱 |
|
|
行政區域
|
AdministrativeArea | string |
行政區劃的名稱 |
|
|
郵遞區號
|
PostalCode | string |
國際地址的郵遞區號 |
|
|
國家
|
Country | string |
國家/地區的首選名稱 |
|
|
Boundaries
|
Boundaries | string |
*即將推出,目前未使用 |
|
|
最大結果
|
MaxResults | string |
設定作業允許傳回的結果數目上限 |
|
|
搜尋類型
|
SearchType | string |
您要執行的搜尋類型的名稱 |
|
|
額外內容
|
Extras | string |
您想要啟用之額外功能的逗號分隔清單 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
地位
|
SearchInfo.Status | string |
指出服務是否找到一或多個結果,或在處理查詢時是否遇到錯誤。 |
|
位置數目
|
SearchInfo.NumberOfLocations | integer |
指出將列在 LocationInfo 陣列位置中的查詢找到的位置數目。 服務傳回的預設位置數目上限為 10;不過,可以在 'MaxResults' 輸入中設定較低的值。 |
|
註釋
|
SearchInfo.Notes | string |
以逗號分隔的查詢描述性附註代碼清單。 |
|
註解
|
SearchInfo.NotesDesc | string |
對應於「附註」輸出的以逗點分隔的說明清單。 |
|
Warnings
|
SearchInfo.Warnings | string |
查詢相關警示碼的逗點分隔清單。 |
|
警告說明
|
SearchInfo.WarningsDesc | string |
對應至「警告」輸出的逗號分隔描述清單。 |
|
位置
|
Locations | array of object |
包含 LocationInfo 物件的清單。 |
|
精確等級
|
Locations.PrecisionLevel | integer |
指出座標的精確度。 級別範圍為 1 - 16。 數字越高,精度越高。 |
|
類型
|
Locations.Type | string |
指出座標所針對的位置類型。 例如,位置可能是地址、大道、地點或郵遞區號。 |
|
緯度
|
Locations.Latitude | string |
位置的緯度。 最多 10 位數的十進制數,最大精度為小數點後 7 位。 |
|
經度
|
Locations.Longitude | string |
位置的經度。 最多 10 位數的十進制數,最大精度為小數點後 7 位。 |
|
前提編號
|
Locations.AddressComponents.PremiseNumber | string |
與屬性相關聯的號碼。 也稱為地址、街道或門牌號碼。 |
|
衢
|
Locations.AddressComponents.Thoroughfare | string |
大道的名稱。 又稱街道、道路、高速公路等。 |
|
DoubleDependentLocality
|
Locations.AddressComponents.DoubleDependentLocality | string |
雙重相依地區名稱。 |
|
相依地區
|
Locations.AddressComponents.DependentLocality | string |
相依地區名稱。 |
|
地區
|
Locations.AddressComponents.Locality | string |
當地的首選英文名稱,例如城市、城鎮或其他類型的市鎮。 |
|
行政區域4
|
Locations.AddressComponents.AdministrativeArea4 | string |
第四級行政區劃的名稱,例如區或區。 |
|
行政區4縮寫
|
Locations.AddressComponents.AdministrativeArea4Abbreviation | string |
第四級行政區的縮寫名稱。 |
|
行政區域3
|
Locations.AddressComponents.AdministrativeArea3 | string |
第三級行政區劃的名稱,例如行政區或區。 |
|
行政區3縮寫
|
Locations.AddressComponents.AdministrativeArea3Abbreviation | string |
第三行政區的簡稱。 |
|
行政區域2
|
Locations.AddressComponents.AdministrativeArea2 | string |
次要行政區劃的名稱,例如縣或地區。 |
|
行政區2縮寫
|
Locations.AddressComponents.AdministrativeArea2Abbreviation | string |
二級行政區域的簡稱。 |
|
行政區域1
|
Locations.AddressComponents.AdministrativeArea1 | string |
主要行政區劃的名稱,例如州、地區、省、縣、地區或都道府縣。 |
|
行政區1縮寫
|
Locations.AddressComponents.AdministrativeArea1Abbreviation | string |
主要行政區域的縮寫名稱。 |
|
郵遞區號
|
Locations.AddressComponents.PostalCode | string |
國際地址的郵遞區號。 |
|
國家
|
Locations.AddressComponents.Country | string |
國家。 |
|
國家ISO2
|
Locations.AddressComponents.CountryISO2 | string |
2 個字母的國家縮寫。 |
|
國家ISO3
|
Locations.AddressComponents.CountryISO3 | string |
3 個字母的國家縮寫。 |
|
必應地圖網址
|
Locations.AddressComponents.BingMapsURL | string |
Bing 地圖服務 URL,其中包含該位置的座標。 |
|
Google地圖網址
|
Locations.AddressComponents.GoogleMapsURL | string |
Google 地圖 URL 以及該位置的座標。 |
|
地圖任務網址
|
Locations.AddressComponents.MapQuestURL | string |
將 Quest URL 與座標映射到該位置。 |
|
地名
|
Locations.AddressComponents.PlaceName | string |
座標相關聯的地點名稱。 最常見的是市、市、鎮、村莊或社區的名稱。 |
|
是非法人
|
Locations.AddressComponents.IsUnincorporated | string |
指示座標是否適用於未合併的區域。 僅針對街道層級屬性相符專案 (S) 顯示。 |
|
狀態FIPS
|
Locations.AddressComponents.StateFIPS | string |
州 FIPS(聯邦信息處理標準)代碼;用於唯一標識狀態。 |
|
縣FIPS
|
Locations.AddressComponents.CountyFIPS | string |
縣 FIPS(聯邦信息處理標準)代碼;用於唯一標識美國各地的縣。 |
|
人口普查區
|
Locations.AddressComponents.CensusTract | string |
給定地址的人口普查區。 人口普查區是縣的統計細分。 |
|
人口普查區塊
|
Locations.AddressComponents.CensusBlock | string |
指定地址的人口普查區塊。區塊是美國人口普查使用的最小地理單位。 |
|
人口普查地理標識
|
Locations.AddressComponents.CensusGeoID | string |
以人口普查為基礎的地理識別代碼,可唯一識別地理統計區域。 |
|
ClassFP
|
Locations.AddressComponents.ClassFP | string |
定義美國地理位置目前類別的程式碼。 |
|
國會代碼
|
Locations.AddressComponents.CongressCode | string |
國會選區編號。 |
|
SLDUST的
|
Locations.AddressComponents.SLDUST | string |
現行州立法區上議院(參議院)議院代碼。 |
|
SLDLST
|
Locations.AddressComponents.SLDLST | string |
現行州立法區下議院(眾議院)議院代碼 |
|
TimeZone_UTC
|
Locations.AddressComponents.TimeZone_UTC | string |
UTC 偏移格式的時區。 |
|
類型
|
Error.Type | string |
類型 |
|
類型代碼
|
Error.TypeCode | string |
類型代碼 |
|
Desc
|
Error.Desc | string |
Desc |
|
描述代碼
|
Error.DescCode | string |
描述代碼 |
|
Debug
|
Debug | string |
Debug |
DOTS 地址地理編碼國際 - ReverseSearch
ReverseSearch 作業會傳回一組指定座標的地址或地點資訊,以及其他地址和位置資訊。 它會嘗試反轉地理編碼座標,並在屬性層級傳回國際位址,這通常是某些屬性的內部部署層級解析,然後級聯至下一個最佳可用解析,例如街道、社區、郵遞區號、地點等。 對於服務傳回的街道、城市和郵遞區號等非地址地點,回應內文中的座標輸出將代表通常與該區域的位置或質心相關聯的座標點。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
緯度
|
Latitude | string |
位置的緯度 |
|
|
經度
|
Longitude | string |
位置的經度 |
|
|
搜尋半徑
|
SearchRadius | string |
設定的最大搜尋半徑距離(以公里為單位) |
|
|
國家
|
Country | string |
國家/地區的首選名稱 |
|
|
最大結果
|
MaxResults | string |
設定作業結果數目上限 |
|
|
搜尋類型
|
SearchType | string |
您要執行的搜尋類型的名稱 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
地位
|
SearchInfo.Status | string |
指出服務是否找到一或多個結果,或在處理查詢時是否遇到錯誤。 |
|
位置數目
|
SearchInfo.NumberOfLocations | integer |
指出將列在 LocationInfo 陣列位置中的查詢找到的位置數目。 服務傳回的預設位置數目上限為 10 |
|
註釋
|
SearchInfo.Notes | string |
以逗號分隔的查詢描述性附註代碼清單。 |
|
註解
|
SearchInfo.NotesDesc | string |
對應於「附註」輸出的以逗點分隔的說明清單。 |
|
Warnings
|
SearchInfo.Warnings | string |
查詢相關警示碼的逗點分隔清單。 |
|
警告說明
|
SearchInfo.WarningsDesc | string |
對應至「警告」輸出的逗號分隔描述清單。 |
|
位置
|
Locations | array of object |
包含 LocationInfo 物件的清單。 |
|
精確等級
|
Locations.PrecisionLevel | integer |
指出座標的精確度。 級別範圍為 1 - 16。 數字越高,精度越高。 |
|
類型
|
Locations.Type | string |
指出座標所針對的位置類型。 例如,位置可能是地址、大道、地點或郵遞區號。 |
|
緯度
|
Locations.Latitude | string |
位置的緯度。 最多 10 位數的十進制數,最大精度為小數點後 7 位。 |
|
經度
|
Locations.Longitude | string |
位置的經度。 最多 10 位數的十進制數,最大精度為小數點後 7 位。 |
|
前提編號
|
Locations.AddressComponents.PremiseNumber | string |
與屬性相關聯的號碼。 也稱為地址、街道或門牌號碼。 |
|
衢
|
Locations.AddressComponents.Thoroughfare | string |
大道的名稱。 又稱街道、道路、高速公路等。 |
|
DoubleDependentLocality
|
Locations.AddressComponents.DoubleDependentLocality | string |
雙重相依地區名稱。 |
|
相依地區
|
Locations.AddressComponents.DependentLocality | string |
相依地區名稱 |
|
地區
|
Locations.AddressComponents.Locality | string |
當地的首選英文名稱,例如城市、城鎮或其他類型的市鎮。 |
|
行政區域4
|
Locations.AddressComponents.AdministrativeArea4 | string |
第四級行政區劃的名稱,例如區或區。 |
|
行政區4縮寫
|
Locations.AddressComponents.AdministrativeArea4Abbreviation | string |
第四級行政區的縮寫名稱。 |
|
行政區域3
|
Locations.AddressComponents.AdministrativeArea3 | string |
第三級行政區劃的名稱,例如行政區或區。 |
|
行政區3縮寫
|
Locations.AddressComponents.AdministrativeArea3Abbreviation | string |
第三行政區的簡稱。 |
|
行政區域2
|
Locations.AddressComponents.AdministrativeArea2 | string |
次要行政區劃的名稱,例如縣或地區。 |
|
行政區2縮寫
|
Locations.AddressComponents.AdministrativeArea2Abbreviation | string |
二級行政區域的簡稱。 |
|
行政區域1
|
Locations.AddressComponents.AdministrativeArea1 | string |
主要行政區劃的名稱,例如州、地區、省、縣、地區或都道府縣。 |
|
行政區1縮寫
|
Locations.AddressComponents.AdministrativeArea1Abbreviation | string |
主要行政區域的縮寫名稱。 |
|
郵遞區號
|
Locations.AddressComponents.PostalCode | string |
國際地址的郵遞區號。 |
|
國家
|
Locations.AddressComponents.Country | string |
國家。 |
|
國家ISO2
|
Locations.AddressComponents.CountryISO2 | string |
2 個字母的國家縮寫。 |
|
國家ISO3
|
Locations.AddressComponents.CountryISO3 | string |
3 個字母的國家縮寫。 |
|
必應地圖網址
|
Locations.AddressComponents.BingMapsURL | string |
Bing 地圖服務 URL,其中包含該位置的座標。 |
|
Google地圖網址
|
Locations.AddressComponents.GoogleMapsURL | string |
Google 地圖 URL 以及該位置的座標。 |
|
地圖任務網址
|
Locations.AddressComponents.MapQuestURL | string |
將 Quest URL 與座標映射到該位置。 |
|
地名
|
Locations.AddressComponents.PlaceName | string |
座標相關聯的地點名稱。 最常見的是市、市、鎮、村莊或社區的名稱。 |
|
是非法人
|
Locations.AddressComponents.IsUnincorporated | string |
指示座標是否適用於未合併的區域。 僅針對街道層級屬性相符專案 (S) 顯示。 |
|
狀態FIPS
|
Locations.AddressComponents.StateFIPS | string |
州 FIPS(聯邦信息處理標準)代碼;用於唯一標識狀態。 |
|
縣FIPS
|
Locations.AddressComponents.CountyFIPS | string |
縣 FIPS(聯邦信息處理標準)代碼;用於唯一標識美國各地的縣。 |
|
人口普查區
|
Locations.AddressComponents.CensusTract | string |
給定地址的人口普查區。 人口普查區是縣的統計細分。 |
|
人口普查區塊
|
Locations.AddressComponents.CensusBlock | string |
指定地址的人口普查區塊。區塊是美國人口普查使用的最小地理單位。 |
|
人口普查地理標識
|
Locations.AddressComponents.CensusGeoID | string |
以人口普查為基礎的地理識別代碼,可唯一識別地理統計區域。 |
|
ClassFP
|
Locations.AddressComponents.ClassFP | string |
定義美國地理位置目前類別的程式碼。 |
|
國會代碼
|
Locations.AddressComponents.CongressCode | string |
國會選區編號。 |
|
SLDUST的
|
Locations.AddressComponents.SLDUST | string |
現行州立法區上議院(參議院)議院代碼。 |
|
SLDLST
|
Locations.AddressComponents.SLDLST | string |
現行州立法區下議院(眾議院)議院代碼。 |
|
TimeZone_UTC
|
Locations.AddressComponents.TimeZone_UTC | string |
UTC 偏移格式的時區。 |
|
類型
|
Error.Type | string |
類型 |
|
類型代碼
|
Error.TypeCode | string |
類型代碼 |
|
Desc
|
Error.Desc | string |
Desc |
|
描述代碼
|
Error.DescCode | string |
描述代碼 |
|
Debug
|
Debug | string |
Debug |
DOTS 地址驗證國際 - GetAddressInfo
我們的即時國際地址驗證 API 服務可驗證並更正全球郵寄地址,以滿足每個國家/地區、郵寄地址格式和文化特質的獨特要求。 隨著特定國家/地區郵政當局的不斷更新,我們的數據始終 up-to時,地址真實準確。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
地址1
|
Address1 | string |
國際地址的地址行 1 |
|
|
地址2
|
Address2 | string |
國際地址的地址行 2 |
|
|
地址3
|
Address3 | string |
國際地址第 3 行 |
|
|
地址4
|
Address4 | string |
國際地址的地址第 4 行 |
|
|
地址5
|
Address5 | string |
國際地址的地址第 5 行 |
|
|
地區
|
Locality | string |
相異母體叢集的名稱。 |
|
|
行政區域
|
AdministrativeArea | string |
行政區劃的名稱。 |
|
|
郵遞區號
|
PostalCode | string |
國際地址的郵遞區號。 |
|
|
國家
|
Country | string |
國家/地區的偏好名稱或 ISO 3166-1 Alpha-2 國家/地區代碼或 Alpha-3 國家/地區代碼。 |
|
|
輸出語言
|
OutputLanguage | string |
輸出語言。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
地位
|
AddressInfo.Status | string |
指出輸入位址的有效性。 除非傳回錯誤,否則一律會傳回此欄位。 |
|
解析度層級
|
AddressInfo.ResolutionLevel | string |
指出可以解析輸入位址的精確度等級。 |
|
地址1
|
AddressInfo.Address1 | string |
輸入位址的格式化位址 1 行。 |
|
地址2
|
AddressInfo.Address2 | string |
輸入位址的格式化位址 2 行。 |
|
地址3
|
AddressInfo.Address3 | string |
輸入位址的格式化位址 3 行。 |
|
地址4
|
AddressInfo.Address4 | string |
輸入位址的格式化位址 4 行。 |
|
地址5
|
AddressInfo.Address5 | string |
輸入位址的格式化位址 5 行。 |
|
地址6
|
AddressInfo.Address6 | string |
輸入位址的格式化位址 6 行。 |
|
地址7
|
AddressInfo.Address7 | string |
輸入位址的格式化位址 7 行。 |
|
地址8
|
AddressInfo.Address8 | string |
輸入位址的格式化位址 8 行。 |
|
地區
|
AddressInfo.Locality | string |
當地的首選英文名稱,例如城市、城鎮或其他類型的市鎮。 也可以是 AdministrativeArea。 |
|
行政區域
|
AddressInfo.AdministrativeArea | string |
國家/地區行政區劃的首選英文名稱,例如州、地區、省、縣、地區或縣。 |
|
郵遞區號
|
AddressInfo.PostalCode | string |
代表標準化的郵遞區號。 |
|
國家
|
AddressInfo.Country | string |
國家/地區的首選英文名稱。 除非傳回錯誤,否則一律會傳回此欄位。 |
|
國家ISO2
|
AddressInfo.CountryISO2 | string |
代表 ISO 3166-1 Alpha-2 國家/地區代碼。 除非傳回錯誤,否則一律會傳回此欄位。 |
|
國家ISO3
|
AddressInfo.CountryISO3 | string |
代表 ISO 3166-1 Alpha-3 國家/地區代碼。 除非傳回錯誤,否則一律會傳回此欄位。 |
|
資訊元件
|
AddressInfo.InformationComponents | array of object |
索引鍵值組陣列,其中包含 API 原始輸出結構描述中未定義的其他欄位和資訊。 |
|
名稱
|
AddressInfo.InformationComponents.Name | string |
名稱 |
|
價值觀
|
AddressInfo.InformationComponents.Value | string |
價值觀 |
|
類型
|
Error.Type | string |
類型 |
|
類型代碼
|
Error.TypeCode | string |
類型代碼 |
|
Desc
|
Error.Desc | string |
Desc |
|
描述代碼
|
Error.DescCode | string |
描述代碼 |
|
Debug
|
Debug | string |
Debug |
美國 DOTS 地址驗證 3 - GetBestMatches
傳回已剖析和驗證的地址元素,包括遞送點驗證 (DPV)、住宅遞送指標 (RDI) 和套件資料。 GetBestMatches 會嘗試針對 CASS 核准的引擎驗證輸入位址,並在可能的情況下進行更正。 如果服務無法做出最終決定,則可能會返回多個地址候選者。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
公司名稱
|
BusinessName | string |
與此地址相關的企業名稱 |
|
|
Address
|
Address | string |
要驗證的地址的地址行 |
|
|
地址2
|
Address2 | string |
此行適用於不有助於 DPV 編碼地址的地址信息 |
|
|
城市
|
City | string |
要驗證的地址所在城市 |
|
|
State
|
State | string |
要驗證的位址狀態 |
|
|
郵遞區號
|
PostalCode | string |
要驗證的地址的郵遞區號 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Addresses
|
Addresses | array of object |
更正後的地址候選人。 |
|
地址1
|
Addresses.Address1 | string |
更正後的地址行 1. |
|
地址2
|
Addresses.Address2 | string |
更正後的地址行 2. |
|
城市
|
Addresses.City | string |
更正的城市名稱。 |
|
State
|
Addresses.State | string |
更正的州名稱。 |
|
壓縮檔
|
Addresses.Zip | string |
更正後的郵遞區號 + 4。 |
|
是住宅
|
Addresses.IsResidential | string |
指出地址是否為住宅。 |
|
DPV的
|
Addresses.DPV | string |
與 DPV(交付點驗證)結果相關的數字。 顯示該地址是否被 USPS 識別為可交付的指示器 |
|
DPV視頻
|
Addresses.DPVDesc | string |
解釋 DPV 結果。 |
|
DPV註
|
Addresses.DPVNotes | string |
DPVNoNumber,與 DPV 筆記描述相關。 服務對象可以添加或更改筆記描述,但絕不會修改現有的代碼。 |
|
DPV註解
|
Addresses.DPVNotesDesc | string |
有關 DPV 結果的詳細信息。 服務物件可以新增或變更註解描述,但絕不會修改現有程式碼。 |
|
更正
|
Addresses.Corrections | string |
與更正描述相關的數字。 服務物件可以新增或變更更正描述,但絕不會修改現有程式碼。 |
|
更正描述
|
Addresses.CorrectionsDesc | string |
地址中更正內容的描述。 服務物件可以新增或變更更正描述,但絕不會修改現有程式碼。 |
|
條碼數字
|
Addresses.BarcodeDigits | string |
郵局遞送條碼數字 |
|
承運人路線
|
Addresses.CarrierRoute | string |
4 個字元:1 個用於路由類型,3 個用於路由代碼。 識別一組位址,當前面加上 5 位數 Zip 時。 |
|
國會代碼
|
Addresses.CongressCode | string |
國會代碼是國會選區編號。 |
|
縣代碼
|
Addresses.CountyCode | string |
給定地址的縣代碼。 |
|
縣名稱
|
Addresses.CountyName | string |
指定地址所在的縣的名稱。 |
|
碎片屋
|
Addresses.FragmentHouse | string |
指定地址的已解析門牌號碼。 |
|
片段預備方向
|
Addresses.FragmentPreDir | string |
地址街道的剖解析前方向。 |
|
碎片街
|
Addresses.FragmentStreet | string |
指定位址中 streen 的剖析名稱。 |
|
片段尾碼
|
Addresses.FragmentSuffix | string |
指定地址中街道的解析後綴 |
|
片段後目錄
|
Addresses.FragmentPostDir | string |
地址街道的剖解析後方向。 |
|
片段單位
|
Addresses.FragmentUnit | string |
剖析的單位類型 (例如 'Apt' 或 'Ste') |
|
零
|
Addresses.Fragment | string |
剖析的「片段」盒子、公寓或單位號碼。 |
|
片段PMBPrefix
|
Addresses.FragmentPMBPrefix | string |
公寓、盒子、單元等的解析類型。 |
|
片段PMB編號
|
Addresses.FragmentPMBNumber | string |
解析的給定地址的公寓、盒子、單元等編號。 |
|
類型
|
Error.Type | string |
類型 |
|
類型代碼
|
Error.TypeCode | string |
類型代碼 |
|
Desc
|
Error.Desc | string |
Desc |
|
描述代碼
|
Error.DescCode | string |
描述代碼 |
|
是卡斯
|
IsCASS | boolean |
指出未變更的輸入位址是否經過 CASS 認證。 請參閱「什麼是 CASS?」 請參閱下方以獲取更多資訊。 |