WSQueryAddr30
下列作業受支援。如需正式定義,請參閱服務描述。
-
QueryAddr
呼叫門牌位置比對服務,需傳入的參數如下 參數名稱 參數說明 oAPPId 應用程式識別碼(APPId),這個值是由使用API的使用者在申請成功後所取得,必須與應用程式介接驗證碼(APIKey)成對使用,這個值是由使用API的使用者在呼叫API時所需傳入 oAPIKey 應用程式介接驗證碼(APIKey),這個值是由使用API的使用者在申請成功後所取得,必須與應用程式識別碼(APPId)成對使用,這個值是由使用API的使用者在呼叫API時所需傳入 oAddress 所要查詢的門牌地址 oSRS 回傳的坐標系統,允許傳入的坐標系統代碼為:EPSG:4326、EPSG:3825、EPSG:3826、EPSG:3827、EPSG:3828 oFuzzyType 目前有下列三種模糊比對的機制: (一) 最近門牌號機制:先找最近且大於輸入的門牌號,找不到則找最近且小於輸入的門牌號;代碼為 0 (二) 單雙號機制:先找最近且大於輸入的單號或雙號門牌號,找不到則找最近且小於輸入的單號或雙號門牌號;代碼為 1 (三) 單雙號機制 + 最近門牌號機制:當單雙號機制找不到門牌時,就改採用最近門牌號機制;代碼為 2
oResultDataType 回傳的資料格式,允許傳入的代碼為:JSON、XML oFuzzyBuffer 模糊比對回傳門牌號的許可誤差範圍,輸入格式為正整數,如輸入 0 則代表不限制誤差範圍 oIsOnlyFullMatch 是否只進行完全比對,允許傳入的值為:true、false,如輸入 true ,模糊比對機制將不被使用 oIsLockCounty 是否鎖定縣市,允許傳入的值為:true、false,如輸入 true ,則代表查詢結果中的 [縣市] 要與所輸入的門牌地址中的 [縣市] 完全相同 oIsLockTown 是否鎖定鄉鎮市區,允許傳入的值為:true、false,如輸入 true ,則代表查詢結果中的 [鄉鎮市區] 要與所輸入的門牌地址中的 [鄉鎮市區] 完全相同 oIsLockVillage 是否鎖定村里,允許傳入的值為:true、false,如輸入 true ,則代表查詢結果中的 [村里] 要與所輸入的門牌地址中的 [村里] 完全相同 oIsLockRoadSection 是否鎖定路段,允許傳入的值為:true、false,如輸入 true ,則代表查詢結果中的 [路段] 要與所輸入的門牌地址中的 [路段] 完全相同 oIsLockLane 是否鎖定巷,允許傳入的值為:true、false,如輸入 true ,則代表查詢結果中的 [巷] 要與所輸入的門牌地址中的 [巷] 完全相同 oIsLockAlley 是否鎖定弄,允許傳入的值為:true、false,如輸入 true ,則代表查詢結果中的 [弄] 要與所輸入的門牌地址中的 [弄] 完全相同 oIsLockArea 是否鎖定地區,允許傳入的值為:true、false,如輸入 true ,則代表查詢結果中的 [地區] 要與所輸入的門牌地址中的 [地區] 完全相同 oIsSameNumber_SubNumber 號之、之號是否視為相同,允許傳入的值為:true、false oCanIgnoreVillage 找不時是否可忽略村里,允許傳入的值為:true、false oCanIgnoreNeighborhood 找不時是否可忽略鄰,允許傳入的值為:true、false oReturnMaxCount 如為多筆時,可限制回傳最大筆數(1~9),輸入格式為正整數,如輸入 0 則以本服務上限10筆進行回傳。 回傳資訊格式為SOAP:XML或JSON
JSON格式
{ Info: [ { InAddress: "臺北市中山區行政里1鄰松江路469巷4號", InSRS: "EPSG:3826", InFuzzyType: "最近門牌號機制", InFuzzyBuffer: "0", InIsOnlyFullMatch: "False", InIsLockCounty: "False", InIsLockTown: "False", InIsLockVillage: "False", InIsLockRoadSection: "False", InIsLockLane: "False", InIsLockAlley: "False", InIsLockArea "False", InIsSameNumber_SubNumber: "True", InCanIgnoreVillage: "True", InCanIgnoreNeighborhood: "True", InReturnMaxCount: "0", OutTotal: "1", OutMatchType: "完全比對", OutMatchCode: "111110100001(+0)", OutTraceInfo: "[臺北市]\t完全比對找到符合的門牌地址" } ], AddressList: [ { FULL_ADDR: "臺北市中山區行政里1鄰松江路469巷4號", COUNTY: "臺北市", TOWN: "中山區", VILLAGE: "行政里", NEIGHBORHOOD: "1鄰", ROAD: "松江路", SECTION: "", LANE: "469巷", ALLEY: "", SUB_ALLEY: "", TONG: "", NUMBER: "4號", X: 303891.5427, Y: 2773226.674 } ] }
JSON格式說明
{ 回傳資訊: [ { 輸入資料: "臺北市中山區行政里1鄰松江路469巷4號", 回傳坐標系統: "EPSG:3826", 比對機制: "最近門牌號機制", 模糊比對的容許誤差範圍(N號): "0", 是否只進行完全比對: "False", 是否鎖定縣市: "False", 是否鎖定鄉鎮市區: "False", 是否鎖定村里: "False", 是否鎖定路名: "False", 是否鎖定巷: "False", 是否鎖定弄: "False", 是否鎖定地區 "False", 號之、之號是否視為相同: "True", 找不時是否可忽略村里: "True", 找不時是否可忽略鄰: "True", 如為多筆時,限制回傳最大筆數: "0", 本次回傳筆數: "1", 比對結果類型: "完全比對", 比對結果代碼: "111110100001(+0)", 比對追蹤訊息: "[臺北市]\t完全比對找到符合的門牌地址" } ], 門牌清單: [ { "完整地址": "臺北市中山區行政里1鄰松江路469巷4號", "縣市": "臺北市", "鄉鎮市區": "中山區", "村里": "行政里", "鄰": "1鄰", "大道路街": "松江路", "段": "", "巷": "469巷", "弄": "", "衖": "", "衕": "", "門牌號碼": "4號", "X坐標": 303891.5427000000, "Y坐標": 2773226.6740000000 } ] }
XML格式
<AddressList InAddress="臺北市中山區行政里1鄰松江路469巷4號" InSRS="EPSG:3826" InFuzzyType="最近門牌號機制" InFuzzyBuffer="0" InIsOnlyFullMatch="False" InIsLockCounty="False" InIsLockTown="False" InIsLockVillage="False" InIsLockRoadSection="False" InIsLockLane="False" InIsLockAlley="False" InIsLockArea="False" InIsSameNumber_SubNumber="True" InCanIgnoreVillage="True" InCanIgnoreNeighborhood="True" InReturnMaxCount="0" OutTotal="1" OutMatchType="完全比對" OutMatchCode="111110100001(+0)" OutTraceInfo="[臺北市] 完全比對找到符合的門牌地址" > <Address> <FULL_ADDR>臺北市中山區行政里1鄰松江路469巷4號</FULL_ADDR> <COUNTY>臺北市</COUNTY> <TOWN>中山區</TOWN> <VILLAGE>行政里</VILLAGE> <NEIGHBORHOOD>1鄰</NEIGHBORHOOD> <ROAD>松江路</ROAD> <SECTION/> <LANE>469巷</LANE> <ALLEY/> <SUB_ALLEY/> <TONG/> <NUMBER>4號</NUMBER> <X>303891.5427000000</X> <Y>2773226.6740000000</Y> </Address> </AddressList>
XML格式說明
<門牌清單 輸入資料="臺北市中山區行政里1鄰松江路469巷4號" 回傳坐標系統="EPSG:3826" 比對機制="最近門牌號機制" 模糊比對的容許誤差範圍(N號)="0" 是否只進行完全比對="False" 是否鎖定縣市="False" 是否鎖定鄉鎮市區="False" 是否鎖定村里="False" 是否鎖定路名="False" 是否鎖定巷="False" 是否鎖定弄="False" 是否鎖定地區="False" 號之、之號是否視為相同="True" 找不時是否可忽略村里="True" 找不時是否可忽略鄰="True" 如為多筆時,限制回傳最大筆數="0" 本次回傳筆數="1" 比對結果類型="完全比對" 比對結果代碼="111110100001(+0)" 比對追蹤訊息="[臺北市] 完全比對找到符合的門牌地址" > <門牌> <完整地址>臺北市中山區行政里1鄰松江路469巷4號</完整地址> <縣市>臺北市</縣市> <鄉鎮市區>中山區</鄉鎮市區> <村里>行政里</村里> <鄰>1鄰</鄰> <大道路街>松江路</大道路街> <段/> <巷>469巷</巷> <弄/> <衖/> <衕/> <門牌號碼>4號</門牌號碼> <X坐標>303891.5427000000</X坐標> <Y坐標>2773226.6740000000</Y坐標> </門牌> </門牌清單>
此 Web 服務以 http://tempuri.org/ 作為預設的命名空間。
建議事項: 請在公開 XML Web 服務之前變更預設的命名空間。
每個 XML Web 服務都需要一個唯一的命名空間供用戶端應用程式辨認,以便和 Web 上的其他服務有所區別。開發中的 XML Web 服務可以使用 http://tempuri.org/,但是已經發行的 XML Web Service 應使用更具永久性的命名空間。
您的 XML Web 服務應該以您所控制的命名空間加以辨認。例如,您可以使用貴公司的網際網路網域名稱做為命名空間的一部分。雖然許多 XML Web 服務的命名空間看起來像是 URL,但它們不需要指向實際的 Web 資源 (XML Web 服務命名空間是 URI)。
對於使用 ASP.NET 建立 XML Web Service,可使用 WebService 屬性的 Namespace 來改變預設的命名空間。WebService 屬性是一種套用在類別上的屬性,其中的類別包含 XML Web 服務的方法。以下是一段設定命名空間為 http://microsoft.com/webservices/ 的程式碼範例:
C#
[WebService(Namespace="http://microsoft.com/webservices/")] public class MyWebService { // 實作 }
Visual Basic
<WebService(Namespace:="http://microsoft.com/webservices/")> Public Class MyWebService ' 實作 End Class
C++
[WebService(Namespace="http://microsoft.com/webservices/")] public ref class MyWebService { // 實作 };
如需 XML 命名空間的詳細資訊,請參閱 XML 中的命名空間 (英文) 中的 W3C 建議事項。
如需 WSDL 的詳細資訊,請參閱 WSDL 規格 (英文)。
如需 URI 的詳細資訊,請參閱 RFC 2396 (英文)。