出現紀錄 Occurrence API

簡易查詢

出現紀錄的基本資料,包含出現紀錄ID、學名、觀察記錄日期、經緯度、座標系統、座標誤差、座標是否有模糊化、座標模糊化程度、出現地、數量、數量單位、紀錄(採集)者、紀錄類型、資料集名稱、授權類型跟資料更新進TaiBIF時間。

Resource URL請求方式 (Method)回應資訊(Response)資料描述(Description)呼叫參數(Parameters)
/api/v2/occurrence/basic_occ?GETOccurrence取得出現紀錄的解釋資訊。start_date, end_date, rows, offset

查詢參數說明

參數名稱參數描述查詢範例
start_date資料最後修改開始日期/api/v2/occurrence/basic_occ?start_date=2022-10-24
end_date資料最後修改結束日期/api/v2/occurrence/basic_occ?end_date=2022-10-24&rows=1
rows回傳筆數,預設為10/api/v2/occurrence/basic_occ?rows=10
offset分頁,預設為0/api/v2/occurrence/basic_occ?offset=1

詳細查詢

每筆出現紀錄的所有資訊,包含原始資料跟轉釋資料。

Resource URL請求方式 (Method)回應資訊(Response)資料描述(Description)呼叫參數(Parameters)
/v2/occurrence/searchGETOccurrence取得出現紀錄的詳細資訊,包含原始及詮釋資料。q, country, month, taibif_county, rows, lat, lng

參數說明

參數名稱參數描述查詢範例
q關鍵字查詢/api/v2/occurrence/search?q=Zosterops japonicus
country國家/api/v2/occurrence/search?country=Taiwan
month月份/api/v2/occurrence/search?month=2&month=9
taibif_county台灣縣市/api/v2/occurrence/search?taibif_county=Chiayi County
rows回傳筆數/api/v2/occurrence/search?rows=1
lat&lng座標查詢/api/v2/occurrence/search?lat=-22.24829&lat=-14.21675&lng=-151.29169&lng=-142.59653

資料集 Datset API

查詢方式

Resource URL請求方式 (Method)回應資訊(Response)資料描述(Description)呼叫參數(Parameters)
/api/v2/dataset/searchGETdataset取得資料集的詳細資訊。title, organization_id, organization_name, author, pub_date, mod_date, gbif_dataset_id, license

參數說明

參數名稱參數描述查詢範例
title資料集名稱/api/v1/dataset?title=海龜
organization_idgbif發布單位id/api/v1/dataset?organization_id=7c07cec1-2925-443c-81f1-333e4187bdea
organization_name發布單位名稱/api/v1/dataset?organization_name=Taiwan
author發布者/api/v1/dataset?author=李
pub_date發布日期/api/v1/dataset?pub_date=2013-08-12, 2020-07-01, /api/v1/dataset?pub_date=2020-07-30
mod_date更新日期/api/v1/dataset?mod_date=2022-03-21
gbif_dataset_idgbif資料集id/api/v1/dataset?gbif_dataset_id=233783dc-e13a-4770-9d24-797590ff8716
license資料授權引用格式/api/v1/dataset?license=CC0

發布單位 Publisher API

查詢方式

Resource URL請求方式 (Method)回應資訊(Response)資料描述(Description)呼叫參數(Parameters)
/api/v1/publisherGETPublisher列出所有發布單位資訊。q,id,countrycode
/api/v1/publisher/dataset/idGETPublisher取得發布單位資料集資訊。id

查詢參數說明

參數名稱參數描述查詢範例
q單位名稱/api/v1/publisher?q=Forestry
id單位於TaiBIF的唯一編號/api/v1/publisher?id=1
countrycode單位地理位置/api/v1/publisher?countrycode=PH