CZML Billboard & Label
- "billboard":
{ "image": "<data URI or URL>", "scale": <number>, "show": true|false } — draws an
icon at the entity's "position". Do not reference an external image/model URL unless the intent
explicitly supplies one.
- "label":
{ "text": "<string>", "font": "<CSS font, e.g. \"14px sans-serif\">", "fillColor": { "rgba": [r,g,b,a] }, "show": true|false } —
draws text next to the entity's "position".
- Both support "scale" and "show"; omit "show" to always display.
- "description":
"<HTML string>" — a top-level packet property (a sibling of "billboard"/"label",
not nested inside either) holding an HTML description shown in the entity's info-box when
clicked, e.g. "<p>Learn more at <a href=\"https://example.com\">example.com</a>.</p>".
Example: a named facility with an icon and a label
[
{ "id": "document", "name": "AGI Headquarters", "version": "1.0" },
{
"id": "agi-hq",
"name": "AGI Headquarters",
"position": { "cartographicDegrees": [-75.596, 40.038, 0] },
"billboard": { "image": "data:image/svg+xml;base64,PHN2Zy8+", "scale": 1.0 },
"label": {
"text": "AGI HQ",
"font": "14px sans-serif",
"fillColor": { "rgba": [255, 255, 255, 255] }
},
"description": "<p>Headquarters of AGI.</p>"
}
]
1---2name: czml-billboard-label3description: CZML billboard icons and text labels for named ground facilities, markers, and pins. Use when the intent describes a named place, marker, icon, pin, waypoint, or a text label shown next to an entity.4---56# CZML Billboard & Label78- "billboard": `{ "image": "<data URI or URL>", "scale": <number>, "show": true|false }` — draws an9 icon at the entity's "position". Do not reference an external image/model URL unless the intent10 explicitly supplies one.11- "label": `{ "text": "<string>", "font": "<CSS font, e.g. \"14px sans-serif\">", "fillColor": { "rgba": [r,g,b,a] }, "show": true|false }` —12 draws text next to the entity's "position".13- Both support "scale" and "show"; omit "show" to always display.14- "description": `"<HTML string>"` — a top-level packet property (a sibling of "billboard"/"label",15 not nested inside either) holding an HTML description shown in the entity's info-box when16 clicked, e.g. `"<p>Learn more at <a href=\"https://example.com\">example.com</a>.</p>"`.1718## Example: a named facility with an icon and a label1920```json21[22 { "id": "document", "name": "AGI Headquarters", "version": "1.0" },23 {24 "id": "agi-hq",25 "name": "AGI Headquarters",26 "position": { "cartographicDegrees": [-75.596, 40.038, 0] },27 "billboard": { "image": "data:image/svg+xml;base64,PHN2Zy8+", "scale": 1.0 },28 "label": {29 "text": "AGI HQ",30 "font": "14px sans-serif",31 "fillColor": { "rgba": [255, 255, 255, 255] }32 },33 "description": "<p>Headquarters of AGI.</p>"34 }35]36```
CesiumGS