# Using Billboard.heightReference inside CZML file

**URL:** <https://community.cesium.com/t/using-billboard-heightreference-inside-czml-file/2625>\
**Category:** CesiumJS\
**Created:** [June 11, 2015, 9:10am UTC](https://community.cesium.com/t/using-billboard-heightreference-inside-czml-file/2625 "2015-06-11T09:10:32Z")\
**Posts on this page:** 11\
**Page:** 1

<div class="post-metadata">

**Author:** ![FerZur](https://sea2.discourse-cdn.com/cesium/user_avatar/community.cesium.com/ferzur/32/21930_2.png) [@FerZur](https://community.cesium.com/u/FerZur)\
**Post date:** [June 11, 2015, 9:10am UTC](https://community.cesium.com/t/using-billboard-heightreference-inside-czml-file/2625/1 "2015-06-11T09:10:32Z")

</div>

Can I use the new 1.10 property Billboard.heightReference inside CZML file?.

Thanks in advanced:  
F.Zuriaga

---

<div class="post-metadata">

**Author:** ![Michael\_Lodge-Paoli1](https://avatars.discourse-cdn.com/v4/letter/m/e47774/32.png) [@Michael\_Lodge-Paoli1](https://community.cesium.com/u/Michael_Lodge-Paoli1)\
**Post date:** [June 12, 2015, 3:10pm UTC](https://community.cesium.com/t/using-billboard-heightreference-inside-czml-file/2625/2 "2015-06-12T15:10:50Z")

</div>

We expect that to be part of the 1.11 release in a few weeks.

---

<div class="post-metadata">

**Author:** ![FerZur](https://sea2.discourse-cdn.com/cesium/user_avatar/community.cesium.com/ferzur/32/21930_2.png) [@FerZur](https://community.cesium.com/u/FerZur)\
**Post date:** [June 13, 2015, 7:55am UTC](https://community.cesium.com/t/using-billboard-heightreference-inside-czml-file/2625/3 "2015-06-13T07:55:57Z")

</div>

Great!, I wait for next version.

---

<div class="post-metadata">

**Author:** ![FerZur](https://sea2.discourse-cdn.com/cesium/user_avatar/community.cesium.com/ferzur/32/21930_2.png) [@FerZur](https://community.cesium.com/u/FerZur)\
**Post date:** [July 8, 2015, 12:05pm UTC](https://community.cesium.com/t/using-billboard-heightreference-inside-czml-file/2625/4 "2015-07-08T12:05:30Z")

</div>

I download the new 1.11 version, can I use in this version the property Billboard.heightReference inside CZML file?.

---

<div class="post-metadata">

**Author:** ![Matt\_Amato](https://sea2.discourse-cdn.com/cesium/user_avatar/community.cesium.com/matt_amato/32/1993_2.png) [@Matt\_Amato](https://community.cesium.com/u/Matt_Amato)\
**Post date:** [July 14, 2015, 2:00am UTC](https://community.cesium.com/t/using-billboard-heightreference-inside-czml-file/2625/5 "2015-07-14T02:00:00Z")

</div>

Unfortunately that functionality didn’t make it into the 1.11 release, there are some unexpected problems that need to be worked out before we can bring everything into master. You can try using the entity-clamp-to-ground branch in the mean time if you’d like to use the feature before it’s officially part of a Cesium release.

---

<div class="post-metadata">

**Author:** ![FerZur](https://sea2.discourse-cdn.com/cesium/user_avatar/community.cesium.com/ferzur/32/21930_2.png) [@FerZur](https://community.cesium.com/u/FerZur)\
**Post date:** [December 15, 2015, 10:28am UTC](https://community.cesium.com/t/using-billboard-heightreference-inside-czml-file/2625/6 "2015-12-15T10:28:20Z")

</div>

Hello, is this functionality available at 1.16 version ?  
Thanks in advanced.

---

<div class="post-metadata">

**Author:** ![hannah](https://sea2.discourse-cdn.com/cesium/user_avatar/community.cesium.com/hannah/32/4509_2.png) [@hannah](https://community.cesium.com/u/hannah)\
**Post date:** [December 15, 2015, 5:40pm UTC](https://community.cesium.com/t/using-billboard-heightreference-inside-czml-file/2625/7 "2015-12-15T17:40:12Z")

</div>

Hello,

Sorry, it looks like it might be a while before any of the height reference functionality makes it up through the entities layer to support CZML. There are some other changes that need to be made, and we might wait until we have support for other data types so we can make the changes all at once instead of only for the billboards.

Best,

Hannah

---

<div class="post-metadata">

**Author:** ![Mati\_O](https://avatars.discourse-cdn.com/v4/letter/m/5e9695/32.png) [@Mati\_O](https://community.cesium.com/u/Mati_O)\
**Post date:** [December 22, 2015, 7:23am UTC](https://community.cesium.com/t/using-billboard-heightreference-inside-czml-file/2625/8 "2015-12-22T07:23:39Z")

</div>

It is important to have heightReference available in the Entity API. After surprisingly discovering yesterday it isn’t supported and considering there’s no support for groundPrimitives also, I don’t know whether should I switch to the Primitive API or wait for this feature to be added.  
Any progress on it towards 1.17 or 1.18?

Thanks,

Mati

---

<div class="post-metadata">

**Author:** ![hannah](https://sea2.discourse-cdn.com/cesium/user_avatar/community.cesium.com/hannah/32/4509_2.png) [@hannah](https://community.cesium.com/u/hannah)\
**Post date:** [December 22, 2015, 3:24pm UTC](https://community.cesium.com/t/using-billboard-heightreference-inside-czml-file/2625/9 "2015-12-22T15:24:09Z")

</div>

Hi Mati,

It is likely that we’ll have support for this within the next year, but unlikely that it will be in the next three months. So depending on your timeline, you might want to switch to the Primitive API for now.

Best,

Hannah

---

<div class="post-metadata">

**Author:** ![Matt\_Amato](https://sea2.discourse-cdn.com/cesium/user_avatar/community.cesium.com/matt_amato/32/1993_2.png) [@Matt\_Amato](https://community.cesium.com/u/Matt_Amato)\
**Post date:** [December 22, 2015, 3:36pm UTC](https://community.cesium.com/t/using-billboard-heightreference-inside-czml-file/2625/10 "2015-12-22T15:36:40Z")

</div>

Also, see this explanation for why supporting this at the Entity API level is harder than it sounds: [https://groups.google.com/d/msg/cesium-dev/PsfINmAvdmA/MZc5bLPmDwAJ](https://groups.google.com/d/msg/cesium-dev/PsfINmAvdmA/MZc5bLPmDwAJ)

If you need other features that the Entity API offers that the Primitive API doesn’t, you’ll run into similar problems.

---

<div class="post-metadata">

**Author:** ![Mati\_O](https://avatars.discourse-cdn.com/v4/letter/m/5e9695/32.png) [@Mati\_O](https://community.cesium.com/u/Mati_O)\
**Post date:** [December 22, 2015, 3:57pm UTC](https://community.cesium.com/t/using-billboard-heightreference-inside-czml-file/2625/11 "2015-12-22T15:57:05Z")

</div>

Thanks you both for making it clear. Although it will make my code more complicated, I guess there’s no way around but to go with the Primitive API.
