Cesiums JS API

Cesium是一种用于创建3D地球和空间可视化应用程序的开源JavaScript库。它包含了一组强大的API，用于创建和操作3D场景，渲染地图和空间数据，以及实现各种交互和动画效果。以下是Cesium的主要API及其示例代码：

场景 (Scene) API

Cesium.Scene: 表示3D场景的主对象。可以创建一个新的场景对象，或者使用已有的场景对象来添加图形、事件、相机等等。

示例代码：

var viewer = new Cesium.Viewer('cesiumContainer');
var scene = viewer.scene;

Cesium.Viewer: 提供一些便捷的功能，例如预定义的地球场景和图层控制。可以创建一个新的Viewer对象，或者使用已有的Viewer对象来添加场景和图层等等。

示例代码：

var viewer = new Cesium.Viewer('cesiumContainer');

Cesium.Camera: 表示3D相机的主对象。可以使用它来控制相机的位置、方向和视野等等。

示例代码：

var viewer = new Cesium.Viewer('cesiumContainer');
var camera = viewer.camera;

实体 (Entity) API

Cesium.Entity: 表示3D场景中的一个实体，例如点、线、面等等。可以使用它来添加、更新、删除实体，并设置它们的属性和样式等等。

示例代码：

var viewer = new Cesium.Viewer('cesiumContainer');
var entity = viewer.entities.add({
    position: Cesium.Cartesian3.fromDegrees(-74.0707383, 40.7117244),
    point: {
        pixelSize: 10,
        color: Cesium.Color.RED
    }
});

图形 (Primitive) API

Cesium.Primitive: 表示3D场景中的一个图形，例如地形、模型等等。可以使用它来添加、更新、删除图形，并设置它们的属性和样式等等。

示例代码：

var viewer = new Cesium.Viewer('cesiumContainer');
var primitive = new Cesium.Primitive({
    geometryInstances: new Cesium.GeometryInstance({
        geometry: new Cesium.BoxGeometry({
            dimensions: new Cesium.Cartesian3(100000.0, 100000.0, 100000.0)
        })
    }),
    appearance: new Cesium.MaterialAppearance({
        material: Cesium.Material.fromType('Checkerboard')
    })
});
viewer.scene.primitives.add(primitive);

地图 (Map) API

Cesium.Map: 表示3D地球或平面地图的主对象。可以使用它来设置地图的类型、投影、范围等等。

示例代码：

var viewer = new Cesium.Viewer('cesiumContainer', {
    imageryProvider: new Cesium.createTileMapServiceImageryProvider({
        url: './Cesium/Assets/Textures/NaturalEarthII',
        fileExtension: 'jpg'
    }),
    baseLayerPicker: false
});

位置和坐标 (Position and Coordinate) API

Cesium.Cartesian3: 表示3D场景中的一个点或向量的坐标。可以使用它来创建、操作和计算3D坐标。

示例代码：

var position = Cesium.Cartesian3.fromDegrees(-74.0707383, 40.7117244);
var vector = new Cesium.Cartesian3(1.0, 0.0, 0.0);
var result = new Cesium.Cartesian3();
Cesium.Cartesian3.add(position, vector, result);

Cesium.Cartographic: 表示3D场景中的一个地理位置的坐标。可以使用它来创建、操作和计算地理坐标。

示例代码：

var position = Cesium.Cartographic.fromDegrees(-74.0707383, 40.7117244);
var altitude = 1000.0;
var result = new Cesium.Cartesian3();
Cesium.Cartographic.toCartesian(position, Cesium.Ellipsoid.WGS84, result);
result.z += altitude;

数据 (Data) API

Cesium.DataSource: 表示3D场景中的一个数据源，例如地形、影像等等。可以使用它来添加、更新、删除数据源，并设置它们的属性和样式等等。

示例代码：

var viewer = new Cesium.Viewer('cesiumContainer');
var dataSource = new Cesium.CzmlDataSource();
dataSource.load('./path/to/data.czml').then(function() {
    viewer.dataSources.add(dataSource);
});

事件 (Event) API

Cesium.ScreenSpaceEventHandler: 表示3D场景中的一个屏幕事件处理器。可以使用它来监听鼠标、键盘等事件，并响应相应的操作。

示例代码：

var viewer = new Cesium.Viewer('cesiumContainer');
var handler = new Cesium.ScreenSpaceEventHandler(viewer.scene.canvas);
handler.setInputAction(function(movement) {
    console.log('Mouse move:', movement.endPosition);
}, Cesium.ScreenSpaceEventType.MOUSE_MOVE);

动画 (Animation) API

Cesium.Animation: 表示3D场景中的一个动画控制器。可以使用它来控制场景的时间、速度等等，并实现各种动画效果。

示例代码：

var viewer = new Cesium.Viewer('cesiumContainer');
var clock = viewer.clock;
clock.shouldAnimate = true;
clock.multiplier = 2.0;