移至主內容

MAP API說明

服務簡述

TBN Map API提供WFS和WM服務，透過本API可以取得5000種以上物種的點位分布。

範例

WFS

WMS

說明

WFS (Web Feature Service) 是 OGC (Open Geospatial Consortium) 提出用來交換向量式地圖資料的協定。其核心的交換格式為 GML (Geography Markup Language) 。透過WFS，地理空間資料可以透過統一的標準，進行查詢，更新，修改，刪除等功能。

WMS (Web Map Service) 也是由 OGC 提出的協定，WMS用來取得影像用的標準服務，利用WMS，使用者可以從不同來源取得圖資影像，疊合後呈現。

本平臺採用 GeoServer 2.12.0 提供WFS與WMS服務。目前提供資料範圍為www.tbn.org.tw收錄的生物觀測資料，包含的欄位如下表：

欄位名 說明
nid TBN 平台觀測資料識別碼
biogroup TBN 類群名稱
latitude 緯度
longitude 經度
geom WKT 格式的經緯度座標

其中，類群（biogroup）包括：

類群
哺乳類
鳥類
爬蟲類
兩棲類
魚類
蝶類
蛾類
甲蟲類
蜻蛉類
其他昆蟲
魚類
蝦蟹類
蝸牛類
其他無脊椎
蜘蛛類
真菌類
蕨類
裸子植物
被子植物
石松類
原藻類
苔蘚

服務說明

WFS 服務

說明：

  • 服務網址： https://map.tbn.org.tw/geoserver/wfs
  • 需指定 typename （圖層）。目前僅支援 typename: species:occurrence
  • 由於TBN觀測紀錄數量較多，於呼叫時請務必指定查詢條件。請用CQL(ECQL)指定條件，如取得所有「哺乳類」觀測記錄，請使用：
    https://map.tbn.org.tw/geoserver/wfs?request=getFeature&typeName=species:occurrence&CQL_FILTER=biogroup='哺乳類'
  • 本服務並可指定回傳格式，如取得所有「哺乳類」觀測記錄，並以 geojson 格式傳回，請使用：
    https://map.tbn.org.tw/geoserver/wfs?request=getFeature&typeName=species:occurrence&CQL_FILTER=biogroup='哺乳類'&outputformat=json
  • 注意：QGIS不支援CQL查詢。QGIS連結的範例是：
    https://map.tbn.org.tw/geoserver/wfs?request=getFeature&version=1.1.0&typeName=species:occurrence&maxFeatures=250
  • WFS API 相關文件

WMS 服務

說明

  • 服務網址： https://map.tbn.org.tw/geoserver/wms
  • 需指定 typename （圖層）。目前僅支援 typename: species:occurrence
  • 由於TBN觀測紀錄數量較多，於呼叫時請務必指定查詢條件，並需指定取得影像的長和寬，如：
    https://map.tbn.org.tw/geoserver/wms?request=GetMap&service=WMS&version=1.1.1&layers=species:occurrence&bbox=120.52173614501955,23.731297735029496,120.95706939697267,23.882070622337565&width=780&height=780&format=image/png
  • WMS也支援CQL(ECQL)指定條件，如取得前述範圍內所有「哺乳類」觀測記錄，請使用： https://map.tbn.org.tw/geoserver/wms?request=GetMap&service=WMS&version=1.1.1&layers=species:occurrence&bbox=120.52173614501955,23.731297735029496,120.95706939697267,23.882070622337565&width=780&height=780&format=image/png&CQL_FILTER=biogroup='哺乳類'
  • WMS API 相關文件