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 相關文件