共用方式為


服務物件 (預覽)

清理、驗證和增強聯絡人資料。 我們的工具會根據數百個權威資料來源驗證和交叉驗證聯絡人的姓名、位置、電話、電子郵件地址和裝置。

此連接器適用於以下產品和區域:

服務 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/
Email 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 位址驗證 - GetLocationByIP_V4

傳回指定 IP 位址的地理位置、Proxy、主機名稱和美國區域資訊。

DOTS 國際鉛驗證 - ValidateLeadInternational

DOTS Lead Validation International (LVI) 評估國際潛在客戶數據,並將數據質量分為通過/失敗/審查類別。 透過評估聯絡人的資訊質量,線上行銷人員可以更有效地剔除詐欺聯絡人。在線欺詐者更有可能提供不准確的聯繫信息,因為地址和電話號碼很容易被追踪。 與其他對單個變量執行簡單數據檢查的驗證服務不同,服務對象潛在客戶驗證解決方案能夠交叉驗證聯繫人的姓名、地址、電話號碼、電子郵件和 IP 地址是否彼此匹配並與消費者相關。

DOTS 國際電話交換 - GetInternationalExchangeInfo

我們的國際電話交換服務可驗證電話號碼並格式化國際直撥電話,同時傳回線路類型、國家/地區代碼和地理編碼資訊。

DOTS 地址 Geocode International - PlaceSearch

PlaceSearch 操作會傳回指定國際地址的緯度和經度,以及其他地址和位置資訊。 它會嘗試在屬性層級對地址進行地理編碼,這通常是某些屬性的屋頂座標,然後級聯到下一個最佳可用解析度,例如街道、社區、郵遞區號、地點等。 對於街道、城市和郵遞區號等非地址地點,座標會傳回通常與該位置相關聯的座標點或區域的質心。

DOTS 地址地理編碼國際 - ReverseSearch

ReverseSearch 作業會傳回一組指定座標的地址或地點資訊,以及其他地址和位置資訊。 它會嘗試反轉地理編碼座標,並在屬性層級傳回國際位址,這通常是某些屬性的內部部署層級解析,然後級聯至下一個最佳可用解析,例如街道、社區、郵遞區號、地點等。 對於服務傳回的街道、城市和郵遞區號等非地址地點,回應內文中的座標輸出將代表通常與該區域的位置或質心相關聯的座標點。

DOTS 地址驗證國際 - GetAddressInfo

我們的即時國際地址驗證 API 服務可驗證並更正全球郵寄地址,以滿足每個國家/地區、郵寄地址格式和文化特質的獨特要求。 隨著特定國家/地區郵政當局的不斷更新,我們的數據始終 up-to時,地址真實準確。

美國 DOTS 地址驗證 3 - GetBestMatches

傳回已剖析和驗證的地址元素,包括遞送點驗證 (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
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?」 請參閱下方以獲取更多資訊。