<< Click to Display Table of Contents >>
REST 使用說明
在使用 REST(Representational State Transfer 表徵狀態轉移)之前,您需事先於 SuperGIS Server 底下建立一「public」資料夾,之後,參照以下說明,便可存取所有放置於此 public 資料夾中的資料夾與服務資源。 請注意:該資料夾名稱務必為英文「public」,勿使用中文命名該資料夾。 存取public資料夾底下所有資料夾與服務資源: 欲存取 public 資料夾底下所有資料夾與服務資源,請輸入下列 URL 網址: http://xxx.xxx.xxx.xxx/SGSPWS/SGSPAgent.ashx/REST/?format= 請於上述網址中的「xxx」部份輸入您伺服器所使用的 IP 位址,如: http://localhost/SGSPWS/SGSPAgent.ashx/REST/?format= 其中,網址後方的「format」允許使用者下達不同的參數,以獲取不同格式,本產品所提供的格式如以下三種: a. HTML: http://xxx.xxx.xxx.xxx/SGSPWS/SGSPAgent.ashx/REST/?format=HTML b. XML: http://xxx.xxx.xxx.xxx/SGSPWS/SGSPAgent.ashx/REST/?format=XML c. JSON: http://xxx.xxx.xxx.xxx/SGSPWS/SGSPAgent.ashx/REST/?format=JSON 若您將格式後方留白,系統將自動填入預設的 HTML 規格。
欲存取特定服務資源,請輸入下列 URL 網址: http://xxx.xxx.xxx.xxx/SGSPWS/SGSPAgent.ashx/REST/path/resource.cfg/?format= 其中的「path」請填鍵您存放資料夾的路徑,而「resource」則請填入服務資源名稱,舉例如下:
欲存取特定服務資源的某筆圖層,請輸入下列 URL 網址: http://xxx.xxx.xxx.xxx/SGSPWS/SGSPAgent.ashx/REST/path/resource.cfg/n/?format= 「n」代表該筆圖層的順序數,數字 0 代表第一層,舉例如下: http://localhost/SGSPWS/SGSPAgent.ashx/REST/public/test.cfg/1/?format= 輸入此網址,可自 public 資料夾裏的 test.cfg 服務資源存取第二筆圖層。
欲使用查詢功能,您可選擇使用 WKT 或 SQL 這兩種語法。 a. 欲使用 SQL 語法進行查詢,請輸入下列 URL 網址: http://xxx.xxx.xxx.xxx/SGSPWS/SGSPAgent.ashx/REST/path/resource.cfg/n/Query/?format=&expr= 請於「&expr=」字串後輸入 SQL 語法。以下列 URL 網址為例: http://localhost/SGSPWS/SGSPAgent.ashx/REST/public/test.cfg/0/Query/?format=&expr= %5BKIND%5D+%3D+%27School%27 輸入此網址,則您可使用 SQL 語法如:「[KIND] = ‘School’」,查詢 public 資料夾底下,test.cfg 服務資源中的首筆圖層。 自下列說明,您可以得知如何將 SQL 轉換為 URL 的型態: 1. 於您的網頁瀏覽器輸入下列 URL 網址: http://xxx.xxx.xxx.xxx/SGSPWS/SGSPAgent.ashx/REST/path/resource.cfg/n/Query/ 2. 如下圖所示,於瀏覽器中的 SQL 欄位輸入欲查詢的 SQL 語法,例如 [KIND] = ‘School’:
3. 如圖所示,點擊「Query」之後,您便可以於網址處獲得轉換後的 SQL 語法:
b. 欲使用 WKT 語法進行查詢,請輸入下列 URL 網址: http://xxx.xxx.xxx.xxx/SGSPWS/SGSPAgent.ashx/REST/path/resource.cfg/n/Query/?format=&geom= 請於「&geom=」字串後輸入 WKT 語法。以下列 URL 網址為例: http://localhost/SGSPWS/SGSPAgent.ashx/REST/public/test.cfg/0/Query/?format=&geom=POINT+%28121+25%29 輸入此網址,則您可使用WKT 語法如:「POINT (121 25)」,查詢 public 資料夾底下,test.cfg 服務資源的中的首筆圖層。請注意,此處的坐標格式應與您當下所使用的坐標系統格式相符。 以下舉出常用空間查詢的例子:
欲存取已發怖之影像圖,請輸入下列URL 網址: http://xxx.xxx.xxx.xxx/SGSPWS/SGSPAgent.ashx/REST/path/resource.cfg/MapImage/?format=&left=&top=&right=&bottom=&width=&height= 請輸入地圖範圍、影像圖寬度與高度,以下列URL網址為例: http://localhost/SGSPWS/SGSPAgent.ashx/REST/public/test.cfg/MapImage/?format=&left=121&top=25&right=123&bottom=22&width=256&height=256 輸入此網址,您將取得一張尺寸為 256 乘 256(像素)的影像圖,而地圖範圍為「左:經度 121 度;上:緯度 25 度;右:經度 123 度;下:緯度 22 度」。請注意,用來標示此地圖範圍的四個數字,其所採用的標示格式,應與您當下所使用的坐標系統格式相符。 欲取得不同格式圖檔,請於「?format=」字串後輸入您所指定的圖檔格式,如: http://localhost/SGSPWS/SGSPAgent.ashx/REST/public/test.cfg/MapImage/?format=image/png&left=121&top=25&right=123&bottom=22&width=256&height=256
欲存取已發佈服務之圖磚,請輸入下列 URL 網址: http://xxx.xxx.xxx.xxx/SGSPWS/SGSPAgent.ashx/REST/path/resource.cfg/Tile/S/C/R/L 其中,「S」為比例層級;「C」用於指定為「第幾欄」的欄位;「R」用於指定為「第幾列」的資料列;「L」則為圖例索引。以下列 URL 為例: http://localhost/SGSPWS/SGSPAgent.ashx/REST/public/test.cfg/Tile/0/0/0/0 輸入此 URL,您可自 public 資料夾底下,test.cfg 服務資源的首筆圖層中,存取「位於第一列,第一欄」的圖磚,且該圖磚的比例層級為第一階。
欲存取圖例,請輸入下列 URL 網址: http://xxx.xxx.xxx.xxx/SGSPWS/SGSPAgent.ashx/REST/path/resource.cfg/n/Legend/?format= 以下列URL 為例: http://xxx.xxx.xxx.xxx/SGSPWS/SGSPAgent.ashx/REST/public/test.cfg/0/Legend/?format= 輸入該 URL 後,您可存取 public 資料夾底下,test.cfg 服務資源裏首筆圖層的圖例。
請注意: 欲存取其他「非」public 資料夾底下的資料夾或服務資源,您需要先「登入」: 請在瀏覽器網址列輸入網址:「http://xxx.xxx.xxx.xxx/SGSPWS/SGSPAgent.htm」 並前往之,後請輸入您的帳號密碼進行登入。 如下圖所示:
登入後,請於瀏覽器網址列輸入網址:「http://xxx.xxx.xxx.xxx/SGSPWS/SGSPAgent.ashx/REST/?format=」 並前往之,您便可如圖所示般,見到其他「非」public 資料夾底下的資料夾或服務資源:
「登入」是為一種「帶有身份的使用狀態」,而在使用 REST 進行開發的過程中,所要求的則是「無狀態性」(即「無登入」);因此,並不建議您以登入的身份於 REST 進行應用程式開發。最好的方法,是將您所欲發佈的服務均存放於先前所述的「public 資料夾」裏,再進行開發事宜。
©2017 Supergeo Technologies Inc. All rights reserved. |