參數	型值	說明	範例網址
id	string	使用本網站之入口網ID取得指定的出現紀錄資料	/api/v1/occurrence?id=6540d35818aad00028ecda95
occurrenceID	string	使用來源資料庫 / 典藏單位之物種出現紀錄ID取得指定的出現紀錄資料	/api/v1/occurrence?occurrenceID=TAIF:PLANT:8540:1:1:186874
catalogNumber	string	使用來源典藏單位之館藏號取得指定的出現紀錄資料	/api/v1/occurrence?catalogNumber=186874
recordNumber	string	使用來源典藏單位之採集號取得指定的出現紀錄資料	/api/v1/occurrence?recordNumber=218114
name	string	取得指定學名/中文名/中文別名/同物異名/誤用名的出現紀錄資料	/api/v1/occurrence?name=小白鷺
taxonID	string	取得指定TaiCOL物種編號的出現紀錄資料	/api/v1/occurrence?taxonID=t0052516
higherTaxon	string	取得指定較高分類群的出現紀錄資料，請以TaiCOL物種編號指定	/api/v1/occurrence?higherTaxon=t0002476
bioGroup	string	取得指定物種類群的出現紀錄資料	/api/v1/occurrence?bioGroup=鳥類
taxonRank	string	取得指定鑑定層級的出現紀錄資料，包含：kingdom, phylum, class, order, family, genus, species, infraspecies	/api/v1/occurrence?taxonRank=infraspecies
isCollection	boolean	是否為自然史典藏資料，是=true，否=false	/api/v1/occurrence?isCollection=true
isNative	boolean	是否為原生種，是=true，否=false	/api/v1/occurrence?isNative=true
isProtected	boolean	是否為保育類，是=true，否=false	/api/v1/occurrence?isProtected=true
imagePresence	boolean	有無影像，是=true，否=false	/api/v1/occurrence?imagePresence=true
rightsHolder	string	取得指定來源資料庫 / 典藏單位的出現紀錄資料，可複數查詢	/api/v1/occurrence?rightsHolder=台灣生物多樣性網絡 TBN&rightsHolder=濕地環境資料庫
recordedBy	string	取得指定記錄者的出現紀錄資料	/api/v1/occurrence?recordedBy=志工小組
resourceContacts	string	取得指定資料集聯絡人的出現紀錄資料	/api/v1/occurrence?resourceContacts=台灣兩棲類保育志工團隊
tbiaDatasetID	string	使用本網站之資料集ID取得指定的出現紀錄資料，可複數查詢	/api/v1/occurrence?tbiaDatasetID=d674d7e0ec3bd2c006cefb438
datasetName	string	取得指定資料集的出現紀錄資料，可複數查詢	/api/v1/occurrence?datasetName=100年高雄都會公園環境長期監測研究計畫－生物（動植物）
basisOfRecord	string	取得指定紀錄類型的出現紀錄資料	/api/v1/occurrence?basisOfRecord=HumanObservation
eventDate	date	紀錄日期，日期格式：yyyy-mm-dd。支援區間查詢	/api/v1/occurrence?eventDate=2021-10-21
preservation	string	取得指定保存方式的出現紀錄資料	/api/v1/occurrence?preservation=針插標本
typeStatus	string	取得指定標本類型的出現紀錄資料（一般 / 模式）	/api/v1/occurrence?typeStatus=模式
organismQuantity	number	取得指定數量的出現紀錄資料	/api/v1/occurrence?organismQuantity=100
locality	string	取得指定出現地的出現紀錄資料，可複數查詢	/api/v1/occurrence?locality=高雄市
county	string	取得指定縣市的出現紀錄資料	/api/v1/occurrence?county=高雄市
municipality	string	取得指定鄉鎮市區的出現紀錄資料	/api/v1/occurrence?municipality=楠梓區
boundedBy	string	取得指定四邊形座標範圍內出現紀錄資料，輸入值={最大經度},{最大緯度},{最小經度},{最小緯度}	/api/v1/occurrence?boundedBy=122,24,121,23
polygon	string	取得指定多邊形座標範圍內出現紀錄資料，僅支援WKT格式	/api/v1/occurrence?polygon=POLYGON ((120.761719 23.755182, 120.772705 23.543845, 121.135254 23.5237, 121.135254 23.755182, 120.761719 23.755182))
circle	string	取得指定圓形座標範圍內出現紀錄資料輸入值={經度},{緯度},{半徑}，半徑單位為公里	/api/v1/occurrence?circle=122.51,24.9,10
apikey	string	限制型API金鑰	/api/v1/occurrence?apikey={yourAPIkey}
created	date	資料建立時間，日期格式：yyyy-mm-dd。支援區間查詢	/api/v1/occurrence?created=2023-05-09
modified	date	資料更新時間，日期格式：yyyy-mm-dd。支援區間查詢	/api/v1/occurrence?modified=2023-05-09

*區間查詢請用半形逗號分隔起迄時間
範例網址： /api/v1/occurrence?eventDate=2021-10-21,2021-10-25

參數	名稱	型值	備註
id	入口網ID	string
created	入口網資料建立時間	date
modified	入口網資料修改時間	date
standardDate	標準化日期	date
standardLatitude	標準化緯度	float
standardLongitude	標準化經度	float
standardRawLatitude	標準化未模糊化緯度	float	需透過限制型API取得
standardRawLongitude	標準化未模糊化經度	float	需透過限制型API取得
standardOrganismQuantity	標準化數量	float
associatedMedia	影像URL	string	多值以分號;分隔
basisOfRecord	紀錄類型	string	控制詞彙：HumanObservation, MachineObservation, PreservedSpecimen, MaterialSample, LivingSpecimen, FossilSpecimen, MaterialCitation, MaterialEntity, Taxon, Occurrence, Event
catalogNumber	館藏號	string
coordinatePrecision	座標模糊化程度	string	請參考生物多樣性敏感資料開放作業原則文件中的逐條說明第六點
coordinateUncertaintyInMeters	座標誤差（公尺）	string
dataGeneralizations	座標是否有模糊化	boolean
datasetName	資料集名稱	string
tbiaDatasetID	入口網資料集ID	string
sourceDatasetID	來源資料庫資料集ID	string
gbifDatasetID	GBIF資料集ID	string
eventDate	紀錄日期 / 採集日期	string
license	授權狀況	string
locality	出現地 / 採集地	string
mediaLicense	影像授權	string
occurrenceID	occurrenceID	string
organismQuantity	數量	string
organismQuantityType	數量單位	string
originalScientificName	原始紀錄物種	string
preservation	保存方式	string
recordedBy	記錄者 / 採集者	string
recordNumber	採集號	string
references	原資料庫網頁URL	string
resourceContacts	資料集聯絡人	string
rightsHolder	來源資料庫 / 典藏單位	string
sensitiveCategory	敏感層級	string
sourceCreated	來源資料庫資料建立時間	date
sourceModified	來源資料庫資料修改時間	date
sourceScientificName	來源資料庫使用學名	string
sourceVernacularName	來源資料庫使用中文名	string
typeStatus	標本類型	string
verbatimCoordinateSystem	座標系統	string
verbatimLatitude	緯度	string
verbatimLongitude	經度	string
verbatimRawLatitude	未模糊化緯度	string	需透過限制型API取得
verbatimRawLongitude	未模糊化經度	string	需透過限制型API取得
county	縣市	string
municipality	鄉鎮市區	string
rawCounty	未模糊化縣市	string	需透過限制型API取得
rawMunicipality	未模糊化鄉鎮市區	string	需透過限制型API取得
verbatimSRS	空間參考系統	string
scientificNameID	物種代碼	string	原始資料提供之物種代碼，可能為舊TaiCOL namecode
taxonID	物種編號	string	新版TaiCOL物種編號
match_higher_taxon	是否對應到上階層	boolean	若無法對到taxonID，則在taxonID欄位給予可以對到的上階層ID，此時match_higer_taxon標示true，反之為false
scientificName	學名	string
name_author	學名作者	string
bioGroup	物種類群	string	控制詞彙：昆蟲、蜘蛛、魚類、兩棲類、爬蟲類、鳥類、哺乳類、維管束植物、蕨類植物、苔蘚植物、藻類、病毒、真菌、細菌
taxonRank	鑑定層級	string
common_name_c	中文名	string
alternative_name_c	中文別名	string
synonyms	同物異名	string
misapplied	誤用名	string
kingdom	界	string
kingdom_c	界中文名	string
phylum	門	string
phylum_c	門中文名	string
class	綱	string
class_c	綱中文名	string
order	目	string
order_c	目中文名	string
family	科	string
family_c	科中文名	string
genus	屬	string
genus_c	屬中文名	string

參數	型值	說明	範例網址
tbiaDatasetID	string	使用本網站之資料集ID取得指定的資料集	/api/v1/dataset?tbiaDatasetID=d674d7dc6c3bd2c006cefad10
sourceDatasetID	string	使用來源資料庫 / 典藏單位之資料集ID取得指定的資料集	/api/v1/dataset?sourceDatasetID=ac869aba-ac34-4416-9eda-075258fef27a
gbifDatasetID	string	以GBIF的資料集ID取得指定的資料集	/api/v1/dataset?gbifDatasetID=275319e1-f91c-406f-b239-62cb9d4185cb
rightsHolder	string	取得指定來源資料庫 / 典藏單位的資料集	/api/v1/dataset?rightsHolder=台灣生物多樣性網絡 TBN&rightsHolder=濕地環境資料庫
datasetName	string	以資料集名稱查詢，支援部分查詢	/api/v1/dataset?datasetName=eBird
datasetTaxonGroup	string	取得含括指定物種類群的資料集	/api/v1/dataset?datasetTaxonGroup=鳥類
created	date	資料集建立時間，日期格式：yyyy-mm-dd。支援區間查詢	/api/v1/dataset?created=2023-05-09
modified	date	資料集更新時間，日期格式：yyyy-mm-dd。支援區間查詢	/api/v1/dataset?modified=2023-05-09

*區間查詢請用半形逗號分隔起迄時間
範例網址： /api/v1/dataset?created=2024-01-01,2024-12-31

參數	名稱	型值	備註
datasetName	資料集名稱	string
rightsHolder	來源資料庫 / 典藏單位	string
tbiaDatasetID	入口網資料集ID	string
sourceDatasetID	來源資料庫資料集ID	string
gbifDatasetID	GBIF資料集ID	string
resourceContacts	資料集聯絡人	string
occurrenceCount	含括資料筆數	integer
datasetDateStart	涵蓋日期起始	date
datasetDateEnd	涵蓋日期結束	date
datasetURL	資料集URL	string
datasetPublisher	資料集發布者	string
datasetLicense	資料集授權狀況	string
datasetTaxonGroup	含括物種類群	string
created	入口網資料集建立時間	date
modified	入口網資料集修改時間	date

參數	型值	說明	範例網址
boundedBy	string	取得指定四邊形座標範圍內物種出現紀錄網格資料，輸入值={最大經度},{最大緯度},{最小經度},{最小緯度} *必填	/api/v1/map?boundedBy=122,23,121,22&grid=1
grid	integer	取得指定網格大小，提供1,5,10,100公里網格 *必填，預設為1	/api/v1/map?boundedBy=122,23,121,22&grid=1
taxonID	string	取得指定TaiCOL物種編號的物種網格資料	/api/v1/map?boundedBy=122,23,121,22&grid=1&taxonID=t0052516
bioGroup	string	取得含括指定物種類群的網格資料	/api/v1/map?boundedBy=122,23,121,22&grid=1&bioGroup=鳥類
year	integer	取得指定資料年份的網格資料，年份格式：yyyy。支援區間查詢	/api/v1/map?boundedBy=122,23,121,22&grid=1&year=2024

*因應效能考量，四邊形座標範圍需搭配網格大小(grid)使用，若您需要較大的地理範圍，請先切割成較小範圍分次取得
*一公里網格每次可取得 1 度經緯度範圍，五公里網格可取得 10 度，十公里網格可取得 20 度，一百公里網格可取得 40 度
範例網址：
/api/v1/map?boundedBy=122,23,121,22&grid=1
/api/v1/map?boundedBy=125,25,115,15&grid=5
/api/v1/map?boundedBy=122,23,102,3&grid=10
/api/v1/map?boundedBy=120,25,80,-15&grid=100

*區間查詢請用半形逗號分隔起迄年份
範例網址： /api/v1/map?boundedBy=122,23,121,22&grid=1&year=2020,2025

以GeoJSON格式回傳1,5,10或100公里網格化的多邊形，取得之GeoJSON可直接套疊於地圖上，每個feature代表一個網格，並帶有屬性：
- 網格內資料筆數 (counts)
- 網格大小 (current_grid_level)
- 網格編號 (current_grid)

若您想繪製與入口網相同的地圖，可參考以下資料筆數對應的色碼代號：

資料筆數	色碼
1 - 10	#ffffcc
10 - 100	#ffeda0
100 - 1000	#fed976
1000 - 5000	#feb24c
5000 - 10000	#fd8d3c
10000 - 50000	#fc4e2a
50000 - 100000	#e31a1c
100000+	#bd0026

各查詢參數均可做交集查詢，部分參數可做聯集查詢。當同時使用同一參數查詢多個值，將取聯集；當同時查詢不同參數，則取交集。
範例網址：/api/v1/occurrence?boundedBy=122,24,121,23&rightsHolder=GBIF

參數	說明	範例網址
limit	限制回傳筆數。預設20筆，上限1000	/api/v1/occurrence?limit=1000

*因應效能考量，每次API請求至多回傳1000筆資料，若搜尋的結果大於1000筆，您可以透過回傳的next參數取得下一分頁的網址，並以遞迴方式取得全部資料。

代碼(code)	說明
200	輸入的請求成功
400	輸入的請求無效
404	網址錯誤或資源不存在
500	後端伺服器錯誤

{
	"status": {
		"code": 回傳狀態代碼,
		"message": 回傳狀態說明
	},
	"meta": {
		"total": 符合查詢條件全部筆數,
		"limit": 每頁回傳筆數,
	},
	"links": {
		"self": 本頁網址,
		"next": 下一分頁網址
	  },	
	"data":[結果陣列]
}