CZML Packet相关声明详细内容

Packet

本页描述CZML文档或流的可能内容。请阅读CZML结构文档说明以了解如何将CZML文档组合在一起。

Packet

描述场景中单个对象（例如单个飞机）的图形属性。

可插值： no

例子：

{
    "id": "Facility/AGI",
    "name": "AGI",
    "availability": "2012-03-15T10:00:00Z/2012-03-16T10:00:00Z",
    "description": "<p>Analytical Graphics, Inc. (AGI) develops commercial modeling and analysis software.</p>",
    "billboard": {
        "eyeOffset": {
            "cartesian": [ 0, 0, 0 ]
        },
        "horizontalOrigin": "CENTER",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAACvSURBVDhPrZDRDcMgDAU9GqN0lIzijw6SUbJJygUeNQgSqepJTyHG91LVVpwDdfxM3T9TSl1EXZvDwii471fivK73cBFFQNTT/d2KoGpfGOpSIkhUpgUMxq9DFEsWv4IXhlyCnhBFnZcFEEuYqbiUlNwWgMTdrZ3JbQFoEVG53rd8ztG9aPJMnBUQf/VFraBJeWnLS0RfjbKyLJA8FkT5seDYS1Qwyv8t0B/5C2ZmH2/eTGNNBgMmAAAAAElFTkSuQmCC",
        "pixelOffset": {
            "cartesian2": [ 0, 0 ]
        },
        "scale": 1.5,
        "show": true,
        "verticalOrigin": "CENTER"
    },
    "label": {
        "fillColor": {
            "rgba": [ 0, 255, 255, 255 ]
        },
        "font": "11pt Lucida Console",
        "horizontalOrigin": "LEFT",
        "outlineColor": {
            "rgba": [ 0, 0, 0, 255 ]
        },
        "outlineWidth": 2,
        "pixelOffset": {
            "cartesian2": [ 12, 0 ]
        },
        "show": true,
        "style": "FILL_AND_OUTLINE",
        "text": "AGI",
        "verticalOrigin": "CENTER"
    },
    "position": {
        "cartesian": [ 1216469.9357990976, -4736121.71856379, 4081386.8856866374 ]
    }
}

{
    "id": "document",
    "name": "My Document",
    "version": "1.0",
    "clock": {
        "interval": "2012-03-15T10:00:00Z/2012-03-16T10:00:00Z",
        "currentTime": "2012-03-15T10:00:00Z",
        "multiplier": 60,
        "range": "LOOP_STOP",
        "step": "SYSTEM_CLOCK_MULTIPLIER"
    }
}

{
    "id": "My Object",
    "delete": true
}

Properties

id - string

该数据包描述的对象的ID。ID不必是GUID，但它们确实需要唯一地标识CZML源中的单个对象以及加载到同一作用域中的任何其他CZML源。如果未指定此属性，则客户端将自动生成一个唯一的属性。但是，这阻止了以后的数据包引用该对象以向其添加更多数据。

delete - boolean

客户端是否应删除该对象的所有现有数据（由ID标识）。如果为true，则将忽略此数据包中的所有其他属性。

name - string

对象的名称。它不必是唯一的，仅供用户使用。

parent - string

父对象的ID（如果有）。

description - String

对象的HTML描述。

clock - Clock

整个数据集的时钟设置。仅对文档对象有效。

version - string

正在编写CZML版本。仅对文档对象有效。

availability - TimeIntervalCollection

一组时间间隔，对象数据可用。该属性可以是指定单个间隔的单个字符串，也可以是表示间隔的字符串数组。如果更高版本的CZML数据包发生更改或发现不正确，则可以更新此可用性。例如，SGP4传播者可能最初报告所有时间的可用性，但随后传播者抛出异常，并且可以将可用性调整为在那时终止。如果此可选属性不存在，则假定该对象一直可用。可用性范围仅限于特定的CZML流，因此两个不同的流可以为单个对象列出不同的可用性。在单个流中，为对象声明的最后一个可用性是有效的那个，并且忽略先前数据包中的任何可用性。

Default：0000-00-00T00:00:00Z/9999-12-31T24:00:00Z

properties - CustomProperties

此对象的一组定制属性。

position - Position

对象在世界上的位置。该位置没有直接的视觉表示，但是用于定位广告牌，标签和附加到对象的其他图形项。

例子：

{
    "id": "MyObject",
    "position": {
        "cartographicDegrees": [
            -75.0, 40.0, 0.0
        ]
    }
}

{
    "id": "InternationalSpaceStation",
    "position": {
        "interpolationAlgorithm": "LAGRANGE",
        "interpolationDegree": 5,
        "referenceFrame": "INERTIAL",
        "epoch": "2012-05-02T12:00:00Z",
        "cartesian": [
            0.0, -6668447.2211117, 1201886.45913705, 146789.427467256,
            60.0, -6711432.84684144, 919677.673492462, -214047.552431458,
            90.0, -6721319.92231553, 776899.784034099, -394198.837519575,
            150.0, -6717826.447064, 488820.628328182, -752924.980158179,
            180.0, -6704450.41462847, 343851.784836767, -931084.800346031,
            240.0, -6654518.44949696, 52891.726433174, -1283967.69137678
        ]
    }
}

orientation - Orientation

物体在世界上的方向。方向没有直接的视觉表示，但是用于定向模型，圆锥体，金字塔和附加到对象的其他图形项。

viewFrom - ViewFrom

观看此对象时建议的摄像机位置。该属性被指定为相对于对象位置的东（x），北（y），上（z）参考系中的笛卡尔位置。

billboard - Billboard

广告牌或视口对齐的图像，有时也称为标记。广告牌由position属性放置在场景中。

box - Box

一个盒子，是一个封闭的矩形长方体。该框使用position和orientation属性定位和定向。

corridor - Corridor

走廊，是由中心线和宽度定义的形状。

cylinder - Cylinder

圆柱，圆锥台或由长度，顶部半径和底部半径定义的圆锥。使用position和orientation属性定位和定向圆柱体。

ellipse - Ellipse

椭圆，是地球表面上的闭合曲线。使用position属性定位椭圆。

ellipsoid - Ellipsoid

椭圆体，它是一个闭合的二次曲面，是椭圆的三维类似物。使用position和orientation属性来定位和定向椭球。

label - Label

一串文字。标签通过position属性放置在场景中。

model - Model

3D模型。使用position和orientation属性定位和定向模型。

path - Path

路径，是由对象随时间的运动定义的折线。路径的可能顶点由position属性指定。

point - Point

点或视口对齐的圆。该点由position属性定位在场景中。

polygon - Polygon

多边形，是地球表面上的闭合图形。

polyline - Polyline

折线，这是场景中由多个线段组成的线。

rectangle - Rectangle

符合地球曲率的制图矩形，可以沿着表面或在高空放置。

tileset - Tileset

3D Tiles tileet。

wall - Wall

符合地球曲率的二维墙，可以沿着地面或在高处放置。

agi_conicSensor - ConicSensor

考虑到椭圆体（例如球形）的遮挡的圆锥形传感器体积。使用position和orientation属性定位和定向传感器。

agi_customPatternSensor - CustomPatternSensor

自定义的传感器体积，考虑到椭圆体（例如地球仪）的遮挡。使用position和orientation属性定位和定向传感器。

agi_rectangularSensor - RectangularSensor

考虑到椭圆体（即地球）的遮挡的矩形金字塔传感器体积。使用position和orientation属性定位和定向传感器。

agi_fan - Fan

定义一个风扇，该风扇从一个点或顶点开始，并在从顶点开始的指定方向列表中延伸。每对方向形成一个风扇面，该面延伸到指定的半径。使用position和orientation属性定位和定向风扇。

agi_vector - Vector

定义一个图形矢量，该矢量起源于该position属性，并沿所提供的方向延伸了所提供的长度。使用position属性定位矢量。