DasEarthv2.0開發(fā)指南2023年9月目 錄第1章前言 1本開發(fā)指南能幫助您了解什么？ 1使用對象 1本書內(nèi)容 1第2章產(chǎn)品介紹 2產(chǎn)品形態(tài) 2產(chǎn)品功能清單 3與前期版本的比較 3第3章環(huán)境準備 4開發(fā)環(huán)境 4運行環(huán)境 4數(shù)據(jù)環(huán)境 5第4章二次開發(fā)簡介 7概述 7組件模塊組成 7創(chuàng)建模塊實例示例代碼 8整體UML結(jié)構(gòu) 8如何接收云端地球的鼠標鍵盤消息 8左鍵單擊事件示例代碼 9如何創(chuàng)建地圖 9創(chuàng)建地圖示例代碼 9如何創(chuàng)建圖層 10創(chuàng)建底圖瓦片示例代碼 10如何繪制各種類型的標繪 10標繪文字示例代碼 11如何進行量算 11量算示例代碼 11如何控制空間分析類 12淹沒分析示例代碼 12第5章快速開發(fā)應用系統(tǒng) 13示例1：平臺入口，快速顯示3D地球 13示例2：加載模型數(shù)據(jù) 15PAGEPAGE1第1章 前言本開發(fā)指南能幫助您了解什么？本開發(fā)指南將在宏觀層面上介紹云端地球的三維二次開發(fā)架構(gòu)，而不會糾纏接口聲明，參數(shù)類型這些細節(jié)（具體細節(jié)可參考《云端地球云平臺API接口》）；本開發(fā)指南將告訴您，如何用JavaScript語言快速搭建一個三維平臺，本開發(fā)指南將明確劃分目前三維二次開發(fā)的能力范圍，告訴您目前能做哪些事，不能做哪些事。反饋。使用對象產(chǎn)品研發(fā)中心，或者其他事業(yè)部，需要用云端地球進行三維項目開發(fā)的程序員們。本書內(nèi)容本書在目錄編排上，以實用易上手為主。不會先列出一堆UML圖讓人云里霧里，手足無措。而是先從開發(fā)環(huán)境開始，手把手教您如何用幾行代碼就能創(chuàng)建一個三維地球窗口，如何再用幾行代碼就能瀏覽傾斜數(shù)據(jù)模型。最后，本書定義了目前二次開發(fā)支持的三維能力，以及項目組對新需求的接受和反饋機制第2章 產(chǎn)介紹產(chǎn)品形態(tài)二次開發(fā)用戶會拿到我們提供的一個名為“Cesium”的文件夾，它就是全部的二次開發(fā)包，含括引入的各種包，如圖2.1-1所示：圖2.1-1產(chǎn)品功能清單圖2.2-1與前期版本的比較01、性能修復，提升軟件穩(wěn)定性；、重構(gòu)鼠標拖拽、平移、旋轉(zhuǎn)方式；03分析、天際線分析及陰影分析等功能；04縫融合；05等功能；06、新增模擬與特效功能模塊：支持煙霧、火、爆炸、煙花的效果模擬；07、增加地形開挖功能：基于實景三維模型繪制分析區(qū)域?qū)崿F(xiàn)挖地形；08、新增行業(yè)解決方案項目展示模塊，可在該模塊中查看應用項目效果；09、新增云端地球功能示例可視化模塊，通過該模塊可查看GIS系統(tǒng)常用的基礎(chǔ)功能。第3章 環(huán)準備開發(fā)環(huán)境平臺開發(fā)環(huán)境如下：表1開發(fā)環(huán)境開發(fā)環(huán)境操作系統(tǒng)Windows10開發(fā)工具VisualStudio2015開發(fā)語言.NET/Javascript數(shù)據(jù)庫Oracle12cWeb容器Tomcat7、IIS8.0瀏覽器IE10或以上（推薦運行環(huán)境postgresqltomcat和nginx，底層環(huán)境為Java。表2運行環(huán)境序號類別臺數(shù)配置信息備注1數(shù)據(jù)存儲服務器1CPU：2顆，每顆8核內(nèi)存：64G硬盤空間：8T網(wǎng)絡(luò)連接：1000Mbps以太網(wǎng)卡操 作 系 統(tǒng) window7/window10/windowserver2008以上用作存儲示范、交換數(shù)據(jù)2平臺1CPU：2顆，每顆8核內(nèi)存：32G硬盤空間：2T系統(tǒng)部署3演示機1CPU：2顆，每顆8核內(nèi)存：32G硬盤空間：4TIIAX10MD系統(tǒng)演示同等級以上）系統(tǒng)要求：Window7、Winow10等瀏覽器：chrome60+數(shù)據(jù)環(huán)境(3dtiles)，手工模型(bimgltf)EntityPrimitive（KMLgeojsonArcGISServer)MP4PAGEPAGE10第4章 二次開發(fā)簡介概述本章介紹云端地球的模塊組成，方便使用者開發(fā)功能時，能夠快速定位到云端地球相應的子模塊去查詢接口函數(shù)。組件模塊組成參考2.2小節(jié)的圖3，云端地球子模塊在功能上，可分為：Map的創(chuàng)建，模塊名“das3d.createMap”；圖層管理，模塊名“das3d.layer”；標繪，模塊名“das3d.Draw”；量算，模塊名“das3d.Measure”；空間分析，模塊名“das3d.analysi”；具體能力見圖4.2-1；圖4.3-1這些模塊不能在外部被實例化，只能由云端地球提供方法獲取。創(chuàng)建模塊實例示例代碼das3d.createMap(<DasMapdas3d.createMap(<DasMapoptions>options)；//創(chuàng)建Mapdas3d.layer.createLayer(Objectitem,ViewerViewer,StringserverURL,FunctionlayerToMap);//創(chuàng)建圖層，平臺內(nèi)部創(chuàng)建圖層，item為配置信息das3d.Draw(viewer,{hasEdit:true});//繪制標繪das3d.Measure({viewer:viewer,terrain:false});//量算das3d.analysi.FloodByEntity(viewer);//淹沒分析UML結(jié)構(gòu)本節(jié)將用UML圖列出部分云端地球?qū)ν獗┞兜墓δ茴惖撵o態(tài)結(jié)構(gòu)。在之后的4.5到4.10小節(jié)，會介紹這些類如何相互配合，完成一個個三維功能。UML結(jié)構(gòu)見圖4.3-1：圖4.3-1如何接收云端地球的鼠標鍵盤消息云端地球設(shè)置了鼠標及鍵盤的監(jiān)聽事件，它會監(jiān)聽用戶輸入的消息，并在這個過程中，自動完成了屏幕點到地理坐標點的轉(zhuǎn)換工作。左鍵單擊事件示例代碼圖4.4-1如何創(chuàng)建地圖將地圖部署在給定ID的DIV容器中，并設(shè)置地圖的選項。創(chuàng)建地圖示例代碼圖4.5-1如何創(chuàng)建圖層das3d.layer靜態(tài)類中有兩個方法，createLayer(Objectitem,StringserverURL，F(xiàn)unctionLayerTomap)為在平臺內(nèi)部創(chuàng)建圖層，createImageryProvider(Objectitem,StringserverURL)（item為配置信息，具體參考配置信息手冊）。創(chuàng)建底圖瓦片示例代碼圖4.6-1如何繪制各種類型的標繪云端地球具有多種類型標繪繪制能力：原生幾何對象繪制；點狀數(shù)據(jù)繪制；線狀數(shù)據(jù)繪制；面狀數(shù)據(jù)繪制；標繪文字示例代碼圖4.7-1如何進行量算功能上，目前支持：長度量算高度量算面積量算量算分析的步驟分為簡單2步：das3d.Measure具體的一個分析函數(shù)；等待分析完成后，接受完成消息。量算示例代碼圖4.8-1如何控制空間分析類功能上，目前支持：淹沒分析光照分析視域分析天際線分析土方量分析熱力圖分析淹沒分析示例代碼圖4.9-1第5章 快速開發(fā)應用系統(tǒng)從本章節(jié)開始將系統(tǒng)的講解如何使用，旨在指導開發(fā)人員快速掌握組件的開發(fā)方法。13D地球新建一個創(chuàng)建文件夾取名為“Example”，拷貝必要的js庫到Example目錄下，如圖5.1-1。圖5.1-1以VisualStudioCode版本為例，將Example用VisualStudioCode打開，如圖5.12：圖5.1-2cesiumHTMLjs,5.1-3（js的順序必須按照5.1-3引入順序）：圖5.1-3加載球體編碼如圖5.1-4：圖5.1-