---
title: Part 2-1 11.3 共同資料存取介面要求事項
tags: 5G 智慧杆系統技術規範
image:
---

# 11.3 共同資料存取介面要求事項

## 11.3.1 存取介面

應用伺服器之共同資料存取介面應支援 IPv6 或 IPv4，IP 位址應使用網際網路公開位址。

共同資料存取介面應提供 HTTPS 伺服器端功能，並應支援 OGC SensorThings v1.0[12]規定之應用程式介面(application programming interface, API)。

共同資料存取介面應完整支援 **GET** 存取方法，其存取控制、其他存取方法 (例: **PATCH**、**DELETE**等)、鑑別方式及權限管理等，皆依實作而定。

## 11.3.2 Thing 物件實例

應用伺服器應依物聯網設備之應用服務,提供 **Thing** 物件實例及其他附屬物件。**Thing** 物件實例內容應符合依 OGC SensorThings v1.0[12]規定。**Thing** 物件實例之 **properties** 參數內容格式應符合 C.1 規定。
**Thing** 物件實例數量應與物聯網設備應用服務匹配，包含設備授權申請封包中 **priApp** 及 **extApp** 參數列舉之所有應用服務，皆應個別對應至 1 組 **Thing** 物件實例。不同物聯網設備或不同應用服務不可重複對應至同一 **Thing** 物件實例。

## 11.3.3 補充詮釋資料

共同資料存取介面除 OGC SensorThings v1.0[12]規定之物件實例 URI 以外，應額外提供包含細部管理資訊之補充詮釋資料。所有應用服務皆應提供對應之補充詮釋資訊，不同物聯網設備或不同應用服務不可重複對應至同一補充詮釋資料。

補充詮釋資料之內容格式應符合 C.2 規定，編碼方式應符合 6.2 規定。補充詮釋資料之 URI 路徑依實作而定，但應與上述 **properties** 參數中 **profile** 參數內容一致。補充詮釋資料之存取方法應與其他SensorThings[12]物件實例相同，但可使用不同之存取權限控管設定。

## 11.3.4 Location 物件實例

應用伺服器應提供 1 組以上之 **Locations** 物件實例，包含該應用服務之實際安裝位置座標。

**Locations** 物件實例所有內容皆依 OGC SensorThings v1.0[12]規定，並正確關聯至 **Thing** 物件實例。

## 11.3.5 Datastream 及 Observation 物件實例

### 11.3.5.1 共同要求

**Datastream** 物件實例之數量及型式及內容可依實際需求自行設計，**Thing** 物件實例可關聯至不限定數量之**Datastream** 物件實例，但不同 **Thing** 物件實例不可關聯至相同之 **Datastream** 物件實例。**Datastream** 物件實例內容宜與應用服務型式 (參照 A.7)一致。
**Observation** 物件實例之內容應配合 **Datastream** 物件實例型式。

不同應用服務型式對應 **Datastream** 及 **Observation** 物件實例之內容可參考 11.3.5.2、
11.3.5.3 及 11.3.5.4。

### 11.3.5.2 感測型式應用服務

量測物理量資訊並回傳之應用服務，其 **Datastream** 物件實例宜代表包含經轉換、計算或統計後、符合觀測標的物理量量測單位之數值 (例: 降雨事件應累加計算並轉換為時雨量或日雨量)。

**Datastream** 物件實例之 **unitOfMeasurement** 參數應依 SensorThing[12]規定，優先使用計量單位統一代碼 (Unified Code for Units of Measure) 表示。

常見物理量及其對應參數內容可參照 D.7。

### 11.3.5.3 媒體紀錄型式應用服務

記錄視訊、音訊等媒體資訊之應用服務，其 **Datastream** 物件實例依實際需求而定 (例: 攝影機或麥克風之原始資料串流，或者由不同視訊軌及音軌混合之事件紀錄)。

**Datastream** 物件實例之 **unitOfMeasurement** 參數內容宜使用足以說明該媒體紀錄性質之資訊 (例: D.7 之 **媒體串流** 項次)。
**observationType** 參數宜使用 **OM_Observation** 型式之對應 URI (參照 OGC SensorThing v1.0[12]規範文件之表 12)。

**Observation** 物件實例之 **result** 參數內容宜為與媒體紀錄相關之 URI (例: 原始串流資料、經轉換過之影片、圖片或音訊檔案、可存取該應用服務之控制介面或存取方式之說明文件等)。

該 URI 存取介面之域名、存取控制、權限管理及通訊協定等，皆依媒體資源型式而定 [例: FTP、HTTP、HLS (HTTP live streaming)、DASH (dynamic adaptive streaming over HTTP)、RTMP (real-time messaging protocol)、RTSP (real-time streaming protocol)、WebRTC (real-time communication) 或其他客制化應用程式之專屬 URI]。

### 11.3.5.4 其他型式應用服務

非屬感測器及媒體串流型式之應用服務，**Datastream** 物件實例數量不規定。內容格式可提供系統維護紀錄 ( 例: 參照 D.8) 或自行設計。

自行設計之物件實例應符合 SensorThings[12]規定。

**Observation** 物件實例之內容格式宜提供系統維護紀錄 (例: 參照 D.9) 或自行設計。

自行設計之物件實例應符合 OGC SensorThings v1.0[12]規定。

## 11.3.6 其他物件實例

其他物件實例，包含 **HistoricalLocation**、**Sensor**、**ObservationProperty** 及 **FeatureOfInterest**，皆應依 OGC SensorThing v1.0[12]規定建置，並正確設定對應關係。