# eBird對應TBN填入資料欄位說明

<style>
.markdown-body table {
table-layout: auto;
width: 160%;
}
</style>

:::info
撰文者：TBN資料分析師 賴孟辰
建立日期：2023-12-6
:::

### 簡介

本文件由農業部生物多樣性研究所編製，描述如何將原始eBird Taiwan資料集欄位和內容，轉換為台灣生物多樣性網絡（Taiwan Biodiversity Network，TBN）使用欄位格式。

### 轉換參數說明

| TBN 欄位名稱 | eBird 原始欄位名稱 | 類別 | 說明 |
|---|---|---|---|
|catalogNumber|global_unique_identifier|文字|原始eBird資料集global_unique_identifier字串。例:"URN:CornellLabOfOrnithology:EBIRD:OBS887376268"。|
|decimalLatitude|latitude|數值|原始eBird資料集經緯度座標系統為WGS84(4326)，取其原始值直接填入。|
|decimalLongitude|longitude|數值|原始eBird資料集經緯度座標系統為WGS84(4326)，取其原始值直接填入。|
|coordinateUncertaintyInMeters|effort_distance_km|數值|1. 若原始eBird資料集protocol_type欄位為"Traveling"，取原始值並將公里轉換為以公尺為單位之值填入; 2. 若原始eBird資料集protocol_type欄位為"Stationary"，則填入500; 3. 若原始eBird資料集breedind_code 欄位為"flyover"，則不予填入。|
|minimumElevationInMeters||數值|由latitude及longitude計算之衍生欄位，使用美國國家航空暨太空總署(National Aeronautics and Space Administration, NASA)「30米數值地形模型資料(DEM)第三版」圖層（原始資料來源：[ASTER GDEM V3](https://asterweb.jpl.nasa.gov/gdem.asp?fbclid=IwAR1TdjOyhS-fNUav-CQHQdMz4Ad7GkqGY5ZY2Lq_CqpFNZ5c6ogS0DxI-aY)）擷取臺灣地區之圖層，並根據經緯度座標抓取最低海拔欄位資料。此外，若coordinateUncertaintyInMeters為空值，或該數值大於5000，則此欄位不予填入。|
|county|state|文字|使用eBird資料集原始值。|
|municipality||文字|由latitude及longitude計算之衍生欄位，使用政府資料開放平台「臺灣縣市和鄉鎮區界線圖層」（原始資料來源：[直轄市、縣市界線](https://data.gov.tw/dataset/32158)、[鄉鎮市區界線](https://data.gov.tw/dataset/32157)），與海洋保育署「海洋行政區範圍圖層」（原始資料來源:[海洋保育地理資訊圖台](https://iocean.oca.gov.tw/iOceanMap/map.aspx)）進行套疊，再根據經緯度座標抓取鄉鎮區資料。此外，若使用圖層獲取行政區縣市與原始eBird資料集縣市紀錄不同，則保留原eBird資料集縣市資訊，並且此欄位不予填入。|
|year|observation_date|數值|於observation_date字串YYYY-MM-DD中擷取西元年份。|
|month|observation_date|數值|於observation_date字串YYYY-MM-DD中擷取月份。|
|day|observation_date|數值|於observation_date字串YYYY-MM-DD中擷取日期。|
|originalVernacularName|scientific_name|文字|原始eBird Taxonomy對應分類群學名。|
|basisOfRecord||文字|eBird台灣資料觀測方式皆為"人為觀測"。|
|individualCount|observation_count|文字|取其原始值直接填入；若為文字"X"，則轉換為空值。根據原eBird資料集說明，"X"代表無計數，僅記錄該物種有出現。|
|recordedBy|observer_id|文字|使用eBird資料集原始值。|
|samplingProtocol|protocol_type|文字|使用eBird資料集原始值。|
|eventID|sampling_event_identifier|文字|使用eBird資料集原始值。|
| license ||文字|eBird台灣以"CC BY"做為資料授權。|