圖觀™引擎開發小技巧——三維場景地標點繪製

圖觀™引擎開發小技巧系列，是我們策劃的一檔以“數字孿生應用開發實用指南”為主要內容的活動，每篇一個小技能，助您更高效快捷地構建專屬數字孿生應用。

——圖觀™|只為打造精品國產數字孿生應用開發引擎

地標點 簡介

在您建立三維場景的過程中，往往會需要凸顯目標物體、建築、事件等重要要素的地理位置、分佈情況、具體類別的資訊，那麼就會使用到地標點繪製功能。小編整理本篇內容，幫助您更加清晰、快速地瞭解，如何通過圖觀™統一開發API和介面偵錯程式，進行三維場景地標繪製。

（流渲染地標點示意圖）

（端渲染地標點示意圖）

目前，圖觀™統一開發API和介面偵錯程式支援新增和除錯：市政設施、地點建築、人員、交通、飛行器、事件、地名等要素，您只需進行低程式碼修改，即可自定義在場景中繪製地標資料資料。

實用技巧內容

基於圖觀™統一開發API和介面偵錯程式，通過低程式碼調整即可便捷實現地標點的繪製和除錯，配置結果所見即所得，具體操作如下：

· 新增地標點

功能描述：在三維場景中新增地標點。

呼叫方法：

參考描述：

屬性	型別	說明
id	String	圖層 ID （唯一標識）
coordType	Number	圖層物件 id，新建時呼叫者自己傳入的唯一標識，用於各種操作的物件識別 目前該屬性僅支援屬性值為 0
coordTypeZ	Number	Z 軸座標類別，0：相對 3D 世界 0 海拔；1：相對 3D 世界地表；2：相對 3D 模型表面（單位：米） 目前該屬性僅支援屬性值為 0
iconName	String	內建圖示名稱，或根據專案，在場景中預置好的圖示物件的名稱，包含文字樣式定義，具體圖示名稱參考下表和下圖
label	String	圖示標籤文字
coord	Array	XY 軸座標，X： 經度；Y：緯度
coordZ	Number	Z 軸高度（單位：米）

具體內建圖示名稱（iconName）詳情：

具體內建圖示名稱（iconName）效果：

回撥資料：

回撥資料引數描述：

屬性	型別	說明
result	Number	1：代表成功；0：代表失敗
message	String	成功或者失敗原因

· 更新地標點資料

功能描述：更新三維場景中地標點資料

呼叫方法：

引數描述：

屬性	型別	說明
id	String	圖層物件 id，新建時呼叫者自己傳入的唯一標識，用於各種操作的物件識別
coordType	Number	圖層物件 id，新建時呼叫者自己傳入的唯一標識，用於各種操作的物件識別 目前該屬性僅支援屬性值為 0
coordTypeZ	Number	Z 軸座標類別，0：相對 3D 世界 0 海拔；1：相對 3D 世界地表；2：相對 3D 模型表面（單位：米） 目前該屬性僅支援屬性值為 0
coord	Array	XY 軸座標，X：經度；Y：緯度
coordZ	Number	Z 軸高度（單位：米）

回撥資料：

回撥資料引數描述：

屬性	型別	說明
result	Number	1：代表成功；0：代表失敗
message	String	成功或者失敗原因

·更新 地標點樣式

功能描述：更新三維場景中地標點樣式

呼叫方法：

屬性	型別	說明
id	String	圖層物件 id，新建時呼叫者自己傳入的唯一標識，用於各種操作的物件識別
iconName	String	內建圖示名稱，或根據專案，在場景中預置好的圖示物件的名稱，包含文字樣式定義，具體圖示名稱參考上表和上圖
label	String	圖示標籤文字

回撥資料：

回撥資料引數描述：

屬性	型別	說明
result	Number	1：代表成功；0：代表失敗
message	String	成功或者失敗原因

· 查詢地標在點螢幕位置

功能描述：查詢地標點在螢幕上位置

呼叫方法：

引數描述：

查詢地標點基於控制元件矩形區域的 左上角、右上角的位置基於三維場景渲染視窗左上角比值基於三維場景渲染視窗右下角比值回撥資料：

回撥資料引數描述：

屬性	型別	說明
result	Number	1：代表成功；0：代表失敗
message	String	成功或者失敗原因
id	String	圖層物件 id，新建時呼叫者自己傳入的唯一標識，用於各種操作的物件識別
ndc	Array	Native Device Coordinate：左上角為 -1, -1，右下角為 1, 1
screenPosition	Array	螢幕畫素座標，左上角為 0, 0

· 刪除地標點

功能描述：刪除地標點

呼叫方法：

引數描述：

屬性	型別	說明
id	String	圖層物件 id，新建時呼叫者自己傳入的唯一標識，用於各種操作的物件識別
overlayType	String	圖層物件類別

回撥資料：

回撥資料引數描述：

屬性	型別	說明
result	Number	1：代表成功；0：代表失敗
message	String	成功或者失敗原因

本篇內容主要圍繞地標點新增、更新、查詢、刪除等基本操作，下篇，小編將整理“ 地標點事件”相關實用指南，記得一定要關注我們哦~

圖觀™

圖觀™國產數字孿生應用開發引擎，提供雲端三維場景構建、全要素資料融合、場景效果設計、場景服務釋出全流程工具，以及基於使用者自定義場景的二次開發 SDK，是使用者構建數字孿生應用的強有力軟體工具包。圖觀™具有兼顧高渲染效果和大併發訪問的雙渲染核心，具備大中小屏投放的跨終端渲染能力， 渲染核心技術完全自研可控，不受外國技術制約，充分確保使用者系統建設的安全需要。

-官網進入： tuguan.net/login.html

-《 統一開發手冊》詳細介紹傳送地址： tuguan.net/doc/tg-api/

---

9.16日，圖觀™數字孿生視覺化引擎新版本上線了，新版本更新了端渲染場景編輯器部分功能，新增統一介面偵錯程式、統一開發 API功能，詳情可點選詳情可 點選產品|圖觀™V3.0全新上線檢視。

為了更好的幫助夥伴們打造屬於自己的3D視覺化場景，助推企業開拓市場。圖觀™重磅推出 數字孿生精品助推計劃，詳情可點選藍字檢視