New Ark 聲學探測標誌NEW ARK聲學探測

聲學探測 · 採購與技術指南 / 599

02 / 3三個獨立問題 · 一個聲學主題

聲學無人機定位系統製造商:要求座標字典,而不只是座標數值

當聲學無人機定位系統製造商傳來看似位置的欄位時,在文件說明其意義之前,這些數字並沒有足夠的用途。GIS 整合工程師需要一份座標字典,說明參考框架、軸順序、單位、高度基準、有效性規則,以及局部座標與地理座標的區別。這是介面定義問題,不是要求提供部署幾何資料。

討論 PCBA 交付聯絡 New Ark
適讀對象599審查製造商定位介面的 GIS 整合工程師

核心摘要

聲學無人機定位系統製造商的輸出需要座標字典

把每個定位值視為帶有型別的欄位,而不是可以互換的數字對。應要求提供座標參考系統、軸名稱與順序、單位、高度參考、精度與不確定性語義、有效性狀態,以及使用中性佔位符的範例。如果輸出是局部或工程座標,介面就應明確說明,不要把它標成緯度和經度。

NEW ARK座標是數值加上參考框架。文件化的介面能避免看似合理的數字被繪製到錯誤位置。

01

聲學無人機定位系統製造商:先確認參考框架,再看欄位名稱

審查製造商定位介面的 GIS 整合工程師

x、y 或 position 這些名稱本身不能識別一個位置。

座標字典應指出座標參考系統(CRS),或清楚說明數值屬於工程座標或感測器局部座標。CRS 提供相對於地球或另一個明確原點解讀座標的參考。沒有這項資訊,GIS 應用程式無法知道一組數字代表地理角度、投影距離,還是任意的局部值。

請要求製造商在可行時提供穩定的 CRS 識別碼、人類可讀名稱,以及轉換適用範圍。EPSG 識別碼、OGC 定義或雙方同意的專案名稱都可能有用,但識別碼必須確實對應輸出。不要根據數字大小或小數位數猜測 CRS;看似經度的數值仍可能是局部 x 座標。

字典也應說明座標框架是固定於地球、繫結於場地參考,還是附著於感測器或平台。如果原點或方向在設定後可能改變,這項變更就是介面契約的一部分。問題在於收到的值屬於哪個參考,以及該參考何時有效,而不是設備應該放在哪裡。

說明基準與轉換責任

地理或投影 CRS 可能依賴基準與轉換參數。整合紀錄應指出轉換由製造商、介面轉接層或客戶應用程式執行,也應在需要重現結果時說明所依據的定義或轉換版本。

簡潔的要求可以是:輸出框架為命名的局部框架;轉換至客戶地圖 CRS 不在感測器訊息內,必須由整合層執行。這比默默轉換數值後呈現虛假的地理確定性更安全。

分開位置、方向與品質

方位、到達方向、類似距離的值與位置估計是不同輸出。地圖可以繪製方向提示,即使沒有收到地理位置。字典應分別命名,並說明哪些欄位是選用、推導、無法取得,或取決於所選配置。

同樣地,信心標籤不必然等於測得的準確度。如果有不確定性欄位,應定義單位、形狀和統計意義。如果沒有,就不應暗示繪製的點具有已知誤差半徑。

02

讓軸順序與單位不可能靠猜

審查製造商定位介面的 GIS 整合工程師

許多整合錯誤,都是有效數值被用錯順序或單位解讀。

字典應按語義名稱、順序、方向與單位列出每一條軸。不要依賴 coordinate1 和 coordinate2 這類名稱,也不要假設所有函式庫都採用同一慣例。應明確說明序列是經度後緯度、緯度後經度、東距後北距,或是由所選 CRS 定義的其他順序。

單位應放在軸定義旁。地理座標可能使用十進制度,而投影或局部軸通常使用線性單位。即使數字大小看起來熟悉,沒有單位的數值仍是不完整的。也要說明正負號規則、允許的空值,以及欄位是角度、距離、高度或無量綱品質值。

如果傳輸格式使用陣列,文件應提供具名結構或物件表示法。{x, y, z} 並不足夠,除非 x、y、z 都連結到框架與單位。若必須使用緊湊陣列,應發布有序含義並在版本間保持順序穩定。

不要讓函式庫預設值定義契約

GIS 與地圖函式庫可能採用不同預設或便利慣例。整合程式應在轉換或顯示前,驗證製造商宣告的順序。能接受陣列的解析器,不代表陣列已被正確解讀。

為了品質檢查,可以建立刻意區分兩條軸的測試資料,但不要使用真實地點。例如在結構範例中使用 AXIS_A_VALUE 與 AXIS_B_VALUE 等符號值,然後確認每個欄位接收哪一個值。這能測試契約而不成為地圖或部署指引。

說明精度,不要誇大準確度

小數位數描述的是表示方式的精度,不一定是定位準確度。字典可以指定數值型別、允許範圍與序列化精度,同時把不確定性放在獨立欄位。如果有四捨五入、截斷或平滑處理,應指出發生位置,以及傳送值是否不同於顯示值。

當 GIS 系統儲存或重繪觀測結果時,這項區別很重要。長串小數不應被視為實體估計同樣精確的證據。

03

為高度提供獨立的參考定義

審查製造商定位介面的 GIS 整合工程師

水平 CRS 本身不能解釋第三個座標的含義。

如果介面提供高度,請確認數值以什麼為測量基準。可能是橢球面、重力相關垂直基準、指定的局部原點,或內部相對參考。字典應命名垂直參考、正方向、單位與空值行為。只寫「高度」對可靠的 GIS 轉換來說太籠統。

水平與垂直參考可以組成複合 CRS,但仍需分開說明。確認第三個值是高度、深度、相對高度,還是其他量。如果系統不提供高度,應明確說明,而不是填入可能被誤認為地面或海平面的零值。

介面也應說明高度對特定事件是測量、估計、繼承,還是不可用。三維顯示可協助審查,但顯示畫面不能把未定義的第三欄變成已宣稱的三維定位能力。

避免用零值代替地面

缺少高度與真正的零高度是不同狀態。高度未提供時應使用文件定義的 null 或狀態碼。如果格式強制需要數值佔位符,應在有效數值範圍外定義並說明規則,但最好使用明確的有效性欄位。

同樣規則也適用於有水平值但沒有有效垂直值的事件。應用程式可以繪製二維觀測,而不必捏造垂直事實。

把垂直轉換列入範圍

如果客戶 GIS 使用不同垂直參考,應指出誰提供轉換,以及轉換需要哪些輸入中繼資料。不要把工作藏在籠統的「支援座標轉換」中。有效的專案交接應分開列出水平轉換、垂直轉換與資料品質限制。

04

不要把局部座標標成地理位置

審查製造商定位介面的 GIS 整合工程師

局部框架可以有價值,但在 API 與使用者介面中必須明顯保持局部身份。

製造商可能提供相對於感測器、安裝參考或專案原點的數值。這些資料可以支援整合者的內部審查,但不是緯度/經度位置。把局部 x、y 標成地理座標,可能在沒有任何解析錯誤的情況下把觀測放到完全錯誤的地區。

字典應在適合整合的層級說明局部框架的原點、方向、正向、維度與生命週期,也應說明框架是固定、設定、重新校準,還是在建立獨立參考前不可用。這些是介面事實,不是設備排列指引。

如果提供轉換至地理 CRS,請要求輸入假設、輸出 CRS,以及無法轉換時的狀態。如果不提供轉換,就要清楚劃定邊界:應用程式收到的是局部資訊,不得把它宣傳成地圖位置。

使用能攜帶區別的型別

訊息可以包含 frameType,值為 geographic、projected 或 local,再加上 frameId 與座標中繼資料。確切名稱可以由專案決定,但語義區別應可由機器讀取。藏在 PDF 中的自由文字說明,弱於應用程式能驗證的欄位。

當客戶同時需要局部估計與轉換後地圖估計時,應以不同物件表示,並各自擁有有效性與來源資訊。不要互相覆寫,也不要在未執行轉換時暗示已完成轉換。

把設定變更視為資料變更

如果局部原點、方向或框架識別碼改變,下游紀錄需要辨識這項變更的方法。可在訊息中加入設定修訂版或框架版本,或定義應用程式如何取得該版本。否則,不同參考下的歷史值可能看起來仍然可比較。

05

規定未知、過期與無效位置

審查製造商定位介面的 GIS 整合工程師

位置欄位需要有效性模型,讓應用程式區分沒有結果與真正的結果。

請要求明確狀態,例如 valid、unavailable、unknown、stale、rejected 或超出支援範圍,並採用製造商實際的詞彙。零值、空陣列與缺少欄位不應因意外而各自取得不同含義。訊息應說明狀態套用於整個位置、單一軸、高度,或相關品質欄位。

時間中繼資料也是解讀的一部分。若兩者都存在,應分開觀測時間與應用程式收到訊息的時間。如果來源不可用後數值仍可能留在快取中,介面應指出數值年齡或新鮮度狀態。這能避免把最後已知值顯示成目前定位。

驗證規則應涵蓋範圍檢查、框架識別碼、單位宣告與版本相容性。消費端應能拒絕含糊訊息,而非默默繪製。記錄拒絕原因有助於整合支援,但不應與底層定位在實體上準確的證據混為一談。

分開定義空值與錯誤

Null 可以表示「未提供」,錯誤則可以表示「已嘗試但失敗」。未知分類或不可用座標不應被壓縮成低信心的有效座標。字典應說明位置無效時品質欄位是否仍有意義,以及消費端應如何處理每種組合。

例如,訊息可以帶有 status=unavailable、position=null 與原因碼。這比每個整合團隊都要記住的數值哨兵更容易互通。

版本化含義,而不只是語法

軟體修訂版可能保留相同 JSON 欄位名稱,卻改變框架定義、單位、預設值或狀態含義。應包含介面版本,並在變更說明中指出語義變更。解析器仍能執行,不代表數值仍然可比較。

06

要求能解釋欄位、但不暴露幾何的範例

審查製造商定位介面的 GIS 整合工程師

好的範例能教會契約,同時避免意外宣稱真實場地或性能。

請要求涵蓋有效觀測、不可用位置、局部框架數值,以及版本或設定變更的完整去識別訊息。每個範例都應包含欄位說明、允許值、單位、框架識別碼、時間戳與狀態語義。以符號佔位符或明確的合成值為佳,不要在介面審查中使用真實座標。

範例應展示位置是物件還是有序陣列、CRS 在何處宣告,以及選用高度如何處理。也應展示只有方向可用時消費端收到什麼。目標是讓欄位含義可測試,而不是展示覆蓋區域或部署幾何。

New Ark 公開的 PCBA 交付資料把陣列採集、演算法處理與系統介面描述為專案特定的整合主題。對買方而言,這劃定了一個有用邊界:把座標字典連同相關軟體修訂版與資料品質定義,列入約定的介面套件,而不要把公開產品頁面當成製造商專屬的完整結構描述。

中性的訊息樣式

安全的文件樣式可以展示:eventId=EXAMPLE-001;frameType=local;frameId=FRAME-EXAMPLE;coordinates={axis1:VALUE_A, axis2:VALUE_B};height={value:null, status:unavailable};positionStatus=valid;interfaceVersion=EXAMPLE-VERSION。這個範例刻意使用佔位符,而不是場地座標或陣列幾何。

附帶文字應說明哪一條軸在前、各軸使用的單位、原點如何定義,以及數值是否可轉換。不能暗示範例是實測性能結果。

把字典轉成驗收問題

整合前,請供應商確認結構描述、測試資料與變更說明都屬於交付範圍。接著讓應用程式團隊依照這些資料測試順序、單位、空值處理、框架識別與時間戳。這是一般介面驗證,不是現場部署程序。

專案討論問題

定位座標字典的買方檢查表

  • 每個位置欄位使用哪個命名 CRS、基準或工程框架?識別碼是否有版本?
  • 每個座標值的確切軸順序、方向、維度與單位是什麼?
  • 若提供高度或深度,適用哪個垂直參考、正負規則、單位與有效性狀態?
  • 數值是地理、投影、感測器局部還是專案局部座標?這個區別是否可由機器讀取?
  • 有效、不可用、未知、過期、拒絕及部分缺失的位置如何表示?
  • 哪些時間戳分別代表觀測時間、處理時間與訊息接收時間?
  • 誰負責轉換至客戶 GIS CRS?必須保留哪些假設?
  • 製造商能否提供各狀態的合成、去識別範例,並按介面版本指出語義變更?

參考資料

本文參考來源

以下列明發布者、日期及資料對本文的支持內容。具體產品供應內容請向供應商確認。

Internet Engineering Task Force, RFC 7946 GeoJSON · 2016-08
支持區分經度/緯度順序、選用高度、WGS 84 十進制度座標,以及未定位要素的 null 幾何。

Open Geospatial Consortium, OGC 12-063r5 Well-known text representation of coordinate reference systems · Accessed 2026-11-20
支持明確文件化軸順序、軸方向、軸單位,以及水平/垂直複合座標參考系統。

New Ark, Acoustic core and a local-assembly path for microphone-array UAV detection PCBA · Accessed 2026-11-20
支持將陣列採集、演算法處理與系統介面描述為專案特定的整合主題,而非公開的通用結構描述。

文章常見問題 / 599

關於「聲學無人機定位系統製造商:要求座標字典,而不只是座標數值」的常見問題

以下問題聚焦本文主題及擬採購的產品範圍。

NEW ARK / ARC-PERIMETER常見
問題
聲學探測知識庫

聯繫 New Ark

把座標字典帶進整合審查

如果您的專案正在審查聲學核心、PCBA 或系統介面,請提供 GIS 應用程式必須消費的欄位。與 New Ark 的專案範圍討論可以分開聲學輸出、座標中繼資料、軟體修訂版與客戶端轉換工作,而不預設存在通用介面。

討論 PCBA 交付聯絡 New Ark

香港新方舟智能科技有限公司 · 聲學探測、合作伙伴整合與本地化組裝諮詢。

返回新聞中心