Accessing Imagery assets

Cesium ion
1

When accessing imagery asset 1, I send an http request to https://api.cesium.com/v1/assets/1/endpoint

This gives information about asset 1 that I need in order to make tile requests. There is a URL that I can append tilemapresource.xml to and receive information. For example:
https://assets.ion.cesium.com/us-east-1/asset_depot/1/CesiumWorldTerrain/v1.2/tilemapresource.xml. When making this request, I add Authorization: [access key] to the header.

I attempt to access imagery asset 3 in the same way. https://api.cesium.com/v1/assets/3/endpoint gives a url of https://dev.virtualearth.net and provides a key. I get an error about missing credentials when I request against https://dev.virtualearth.net/tilemapresource.xml. I’ve tried https://dev.virtualearth.net/tilemapresource.xml?key=[key]. I’ve also tried adding the key to the header as:
Authorization: [key]
key: [key]

I’ve also tried generating a key from https://www.bingmapsportal.com/ and using it instead of the key from https://api.cesium.com/v1/assets/3/endpoint

What am I doing wrong?

2

Asset 1 is Cesium World Terrain which is a terrain asset. Asset 3 is Bing Maps Aerial with labels which is an imagery asset. See the ion REST API documentation on endpoints for more information about the different data types.

Cessium World terrain is a ion hosted asset where Bing Maps is an external asset. These also have different responses and different ways to access the data. The Bing URL is a base URL and needs to have additional information added (see BING documentation)

If you are not familar with the APIs or formats, the easiest way to access the data is to use CesiumJS which already has the loading logic coded. You can also you use that as reference if you feel you need to implement your own version.

Please let us know if this answers questions, or if you have more.

image

3

Sorry, substitute asset 3954 (Sentinel-2) instead of asset 1.

Understood about external assets. I can know an asset is an external asset due to the “externalType” entry?

4

Yes. In the API documentation you will see these two button that you can use to toggle between the different responses for the Cesium hosted assets and external assets. It can be easy to miss so I wanted to make you were able to see the documentation for the external asset data as well.

image
image446×162 8.44 KB

image

5

Got it, thanks!