NASA WorldWind 使用手册（JavaWebAndroid ）英文版本

NASAWorldWind使用手册（Java/Web/Android通用）WorldWind是NASA开源的三维地球可视化SDK，支持Java、Web（JavaScript）、Android平台，用于构建GIS、科研、教育类三维地球应用。一、平台与环境要求1.三大主流版本表格版本适用场景核心依赖运行方式WorldWindJava桌面应用、服务器端Java8+,JOGL,GDALJAR包运行/IDE开发NASAWorldWindWebWorldWind网页端、H5应用现代浏览器（WebGL）HTML+JavaScriptWorldWindAndroid移动端AppAndroid4.4+AndroidStudio开发2.环境准备（Java版）安装JDK8+，配置环境变量下载SDK：GitHubReleasesNASAWorldWind解压后，核心JAR：worldwind.jar、worldwindx.jar、jogl-all.jar、gluegen-rt.jar、gdal.jarNASAWorldWind二、快速入门（Java版）1.运行官方Demo解压SDK到本地目录命令行运行（Windows）：bash运行java-Xmx1024m-Dsun.java2d.noddraw=true-cpworldwind.jar;worldwindx.jar;jogl-all.jar;gluegen-rt.jar;gdal.jargov.nasa.worldwindx.examples.SimplestPossibleExample（Mac/Linux）：bash运行java-Xmx1024m-cpworldwind.jar:worldwindx.jar:jogl-all.jar:gluegen-rt.jar:gdal.jargov.nasa.worldwindx.examples.SimplestPossibleExampleNASAWorldWind2.最简代码示例（Java）java运行importgov.nasa.worldwind.*;importgov.nasa.worldwind.awt.WorldWindowGLCanvas;importjavax.swing.*;publicclassSimplestWorldWind{publicstaticvoidmain(String[]args){//1.创建地球画布WorldWindowGLCanvaswwd=newWorldWindowGLCanvas();wwd.setPreferredSize(newjava.awt.Dimension(1000,800));//2.配置默认图层（地形、影像）Modelmodel=(Model)WorldWind.createConfigurationComponent(AVKey.MODEL_CLASS_NAME);wwd.setModel(model);//3.显示窗口JFrameframe=newJFrame("WorldWind最简示例");frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);frame.add(wwd);frame.pack();frame.setVisible(true);}}三、核心操作与功能1.基础交互（鼠标/触摸）旋转：左键拖动缩放：滚轮/双指捏合平移：中键拖动/Shift+左键定位：双击地点快速聚焦2.图层管理（核心）WorldWind采用分层渲染，可叠加影像、地形、标注、矢量数据。Java代码：添加/移除图层java运行//获取图层列表LayerListlayers=wwd.getModel().getLayers();//1.添加内置图层（如Bing影像）LayerbingLayer=newBingImageryLayer();layers.add(bingLayer);//2.添加标注图层（Placemark）RenderableLayerplacemarkLayer=newRenderableLayer();Placemarkplacemark=newPlacemark(Position.fromDegrees(39.9,116.3,0));//北京placemarkLayer.addRenderable(placemark);layers.add(placemarkLayer);//3.控制显隐bingLayer.setEnabled(false);3.数据支持格式影像：WMS、WMTS、TMS、GeoTIFF、JPG/PNG矢量：Shapefile、KML、GeoJSON、GML地形：DTED、SRTM、GeoTIFF高程网络服务：OGC标准服务、ArcGIS服务4.三维对象绘制点（Placemark）：标记点位、自定义图标/标签线（Path）：航线、边界、轨迹面（Polygon）：区域、热力图、建筑轮廓模型：3D模型（Collada、OBJ）示例（添加多边形）：java运行Polygonpolygon=newPolygon();polygon.setPositions(Arrays.asList(Position.fromDegrees(39.9,116.3,0),Position.fromDegrees(39.9,116.5,0),Position.fromDegrees(40.1,116.5,0),Position.fromDegrees(40.1,116.3,0)));polygon.setFillColor(Color.RED);RenderableLayerlayer=newRenderableLayer();layer.addRenderable(polygon);wwd.getModel().getLayers().add(layer);四、Web版快速上手1.引入依赖html预览<scriptsrc="/web/latest/dist/worldwind.min.js"></script>2.最简网页示例html预览<!DOCTYPEhtml><html><body><canvasid="canvasOne"width="1000"height="800"></canvas><script>//1.创建地球实例constwwd=newWorldWind.WorldWindow("canvasOne");//2.添加基础图层wwd.addLayer(newWorldWind.BMNGLayer());wwd.addLayer(newWorldWind.CoordinatesDisplayLayer(wwd));//3.添加标注constplacemarkLayer=newWorldWind.RenderableLayer();constposition=newWorldWind.Position(39.9,116.3,0);constplacemark=newWorldWind.Placemark(position);placemarkLayer.addRenderable(placemark);wwd.addLayer(placemarkLayer);</script></body></html>五、Android版要点依赖配置：build.gradle添加gradleimplementation'gov.nasa.worldwind.android:worldwind:0.10.0'布局：WorldWindow控件核心API与Java版高度一致，适配触摸交互六、关键配置与优化1.缓存管理缓存目录：~/.worldwind（Windows：C:\Users\<用户>\.worldwind）清理缓存：删除目录下文件，释放空间自定义缓存：Configuration.setValue(AVKey.DATA_CACHE_ROOT,"自定