Occurrence API 2.5.3版即刻推出，本版本僅作小幅度修改，部分欄位將於2.6版移除，請使用本API者先行準備。細部更動見於文件中。

簡介

本文件由農業部生物多樣性研究所編製，描述所屬台灣生物多樣性網絡（Taiwan Biodiversity Network，TBN）之觀測紀錄（occurrence）開放與限制型API規格。

服務類型

本API之觀測紀錄查詢同時適用於開放與限制型API。開放API對敏感資料會進行部分資訊模糊化以保護敏感物種。限制性則可取得未模糊化資訊。限制性API需另向本API管理單位申請。

查詢參數

參數型態

• 時間：字串，格式為西元10碼+24小時制精度至分之5碼格式，即YYYY-MM-DD HH:MM，台灣時區
• UUID：字串，RFC 4122，需含斷字符號共36個字元
• 數字
• 文字

polygon 參數格式

類型	code	範例網址
	121.29 24.81,121.69 24.83,121.71 24.42,121.01 24.56,121.29 24.81 或     (((121.29 24.81,121.69 24.83,121.71 24.42,121.01 24.56,121.29 24.81)))	https://www.tbn.org.tw/api/v25/occurrence?polygon=(((121.29 24.81,121.69 24.83,121.71 24.42,121.01 24.56,121.29 24.81)))&limit=20
	(((121.59 24.22,121.60 24.22,121.35 23.50,120.40 23.68,121.59 24.22) => 外圈      ,(120.75 23.83,120.82 23.87,120.82 23.79,120.72 23.80,120.75 23.83)))=> 內圈	https://www.tbn.org.tw/api/v25/occurrence?polygon=(((121.59 24.22,121.60 24.22,121.35 23.50,120.40 23.68,121.59 24.22),(120.75 23.83,120.82 23.87,120.82 23.79,120.72 23.80,120.75 23.83)))&limit=20
	(((121.29 24.81,121.69 24.83,121.71 24.42,121.01 24.56,121.29 24.81)),((120.75 23.83,120.82 23.87,120.82 23.79,120.72 23.80,120.75 23.83)))	https://www.tbn.org.tw/api/v25/occurrence?polygon=(((121.29 24.81,121.69 24.83,121.71 24.42,121.01 24.56,121.29 24.81)),((120.75 23.83,120.82 23.87,120.82 23.79,120.72 23.80,120.75 23.83)))&limit=20
	(((121.29 24.81,121.69 24.83,121.71 24.42,121.01 24.56,121.29 24.81)) => polygon1(no hole)     ,((121.59 24.22,121.60 24.22,121.35 23.50,120.40 23.68,121.59 24.22),(120.75 23.83,120.82 23.87,120.82 23.79,120.72 23.80,120.75 23.83))) => polygon2 (with hole)	https://www.tbn.org.tw/api/v25/occurrence?polygon=(((121.29 24.81,121.69 24.83,121.71 24.42,121.01 24.56,121.29 24.81)),((121.59 24.22,121.60 24.22,121.35 23.50,120.40 23.68,121.59 24.22),(120.75 23.83,120.82 23.87,120.82 23.79,120.72 23.80,120.75 23.83)))&limit=20

上表圖片皆使用 By Mwtoews - Own work, CC BY-SA 3.0

複合查詢

各查詢參數均可做聯集查詢。如以下網址查詢「TBN-DP 台灣維管束植物調查及物候觀察」資料集中「大花咸豐草」的觀測紀錄：

https://www.tbn.org.tw/api/v25/occurrence?taxonUUID=9164c378-ef51-4423-a166-1a979c73a97d&datasetUUID=248d6799-bb66-40a5-b7ba-b45bbb818ddc&limit=20

回傳範例：

{
    "meta": {
        "status": "SUCCESS",
        "total": 1114,
        "itemsCount": 20,
        "generateDate": "2023-09-17T10:33:35+08:00",
    },
    "links": {
        "self": "https://www.tbn.org.tw/api/v25/occurrence?taxonUUID=9164c378-ef51-4423-a166-1a979c73a97d&datasetUUID=248d6799-bb66-40a5-b7ba-b45bbb818ddc&limit=20",
        "next": "https://www.tbn.org.tw/api/v25/occurrence?taxonuuid=9164c378-ef51-4423-a166-1a979c73a97d&datasetuuid=248d6799-bb66-40a5-b7ba-b45bbb818ddc&limit=20&minID=42313959",
    },
    "data": [
        {
            "occurrenceID": "4d65d374-4c15-4d47-800d-6f5bc4c5f77b",
            "created": "2022-03-21 12:20",
            "modified": "2022-08-14 01:49",
            "recordNumber": null,
            "catalogNumber": null,
            "externalID": "tbn.dp.plant.4d65d374-4c15-4d47-800d-6f5bc4c5f77b",
            "decimalLatitude": "23.47",
            "decimalLongitude": "120.58",
            "coordinateUncertaintyInMeters": "30",
            "minimumElevationInMeters": null,
            "geodeticDatum": "WGS84",
            "coordinatePrecision": null,
            "gridID": "2820-15-11-13",
            "adminareaCode": "10010140",
            "county": "嘉義縣",
            "municipality": "竹崎鄉",
            "year": 2020,
            "month": 12,
            "day": 23,
            "hour": 12,
            "minute": 0,
            "taxonUUID": "9164c378-ef51-4423-a166-1a979c73a97d",
            "originalVernacularName": null,
            "protectedStatusTW": null,
            "categoryIUCN": null,
            "categoryRedlistTW": "不適用",
            "endemism": "非臺灣特有",
            "nativeness": "外來歸化 Naturalized (non-native)",
            "taxonRank": "種下階層",
            "taxonGroup": "被子植物",
            "scientificName": "Bidens pilosa var. radiata (Sch.Bip.) Sherff",
            "simplifiedScientificName": "Bidens pilosa radiata",
            "vernacularName": "大花咸豐草",
            "scientificNameID": null,
            "taiCOLNameCode": null,
            "taiCOLTaxonID": null,
            "tfNameCode": "C303120303050402050559011001500003003",
            "familyScientificName": "Asteraceae",
            "familyVernacularName": "菊科",
            "datasetUUID": "248d6799-bb66-40a5-b7ba-b45bbb818ddc",
            "datasetName": "TBN-DP 臺灣維管束植物調查及物候觀察",
            "datasetURL": "https://www.tbn.org.tw/dataset/248d6799-bb66-40a5-b7ba-b45bbb818ddc",
            "datasetAuthor": "沈明雅、張慧玲、倪旻萱、郭貴嵐、俞佑錚",
            "datasetPublisher": "農業部生物多樣性研究所",
            "resourceCitationIdentifier": "https://www.tbn.org.tw/dataset/248d6799-bb66-40a5-b7ba-b45bbb818ddc",
            "resourceContacts": "沈明雅、張慧玲、倪旻萱、郭貴嵐、俞佑錚",
            "basisOfRecord": "出現紀錄",
            "establishmentMeans": "野生",
            "individualCount": null,
            "organismQuantity": "常見common",
            "organismQuantityType": null,
            "recordedBy": "顏翎(綠保)",
            "partner": null,
            "identificationVerificationStatus": "已鑑定",
            "identifiedBy": "mia",
            "dataSensitiveCategory": null,
            "eventID": null,
            "samplingProtocol": null,
            "associatedMedia": "https://www.tbn.org.tw/sites/ozop/files/occurrence/media/4d/4c/file-2054572-97togkbn.jpeg",
            "mediaLicense": "CC BY",
            "license": "CC BY",
            "source": "https://plant.tbn.org.tw/occurrence/4d65d374-4c15-4d47-800d-6f5bc4c5f77b",
            "selfProduced": true,
            "dataGeneralizations": false,
            "sensitiveCategory": "無",
            "collectionID": null,
            "verbatimEventDate": null,
            "eventDate": "2020-12-23 12",
            "eventTime": "12",
            "eventPlaceAdminarea": "嘉義縣竹崎鄉",
            "countyCode": "10010"
        },
        ...
    ]
}

資料欄位

JSON欄位名

• 欄位名 (JSON field name) 均為羅馬字英文字母，大小寫不同，範圍為[a-zA-Z]。
• 欄位名命名採首字小寫駝峰式 (Camel) 命名法。

資料型態與允許值

• 時間：字串，格式為西元10碼+24小時制精度至分之5碼格式，即YYYY-MM-DD HH:MM，台灣時區
• UUID：字串，RFC 4122，需含斷字符號共36個字元
• 數字
• 文字
• 列舉：為規定值之一
• 布林：為True或False
• 允許多值時，多值以半形分號;分隔
• 無資料時回傳null

回傳欄位表

附表-1：類群表

附表-2：分類階層表

附表-3：國內紅皮書表

附表-4：國際紅皮書表