IonResource

new Cesium.IonResource (endpoint, endpointResource)

封装cesium离子资产访问的 Resource 实例。通常不直接实例化此对象,请使用 IonResource.fromAssetId
Name Type Description
endpoint Object Cesium离子资产端点服务的结果。
endpointResource Resource 用于检索端点的资源。
See:

Extends

Members

readonly credits : Array.< Credit >

获取归因于资产所需的功劳。

readonly extension : String

资源的文件扩展名。
Inherited From:

hasHeaders : Boolean

如果资源具有请求标头,则为True。这等效于检查headers属性是否具有任何键。
Inherited From:

headers : Object

与请求一起发送的其他HTTP标头。
Inherited From:

isBlobUri : Boolean

如果资源引用Blob URI,则为true。
Inherited From:

isCrossOriginUrl : Boolean

如果资源引用跨源URL,则为True。
Inherited From:

isDataUri : Boolean

如果资源引用数据URI,则为True。
Inherited From:
加载资源时要使用的代理。
Inherited From:

readonly queryParameters : Object

查询参数附加到URL。
Inherited From:
将使用的Request对象。仅用于内部使用。
Inherited From:

retryAttempts : Number

放弃之前应调用retryCallback的次数。
Inherited From:

retryCallback : function

当对此资源的请求失败时调用的函数。如果返回true或Promise解析为true,则将重试该请求。
Inherited From:

readonly templateValues : Object

键/值对,用于替换url中的模板参数。
Inherited From:
资源的url(已设置模板)替换为模板值,附加查询字符串并由代理编码。
Inherited From:

Methods

static Cesium.IonResource.fromAssetId (assetId, options ) Promise.< IonResource >

异步创建一个实例。
Name Type Description
assetId Number cesium离子资产编号。
options Object 可选 具有以下属性的对象:
名称 类型 默认 说明
accessToken 字符串 Ion.defaultAccessToken 可选 要使用的访问令牌。
服务器 字符串 | 资源 Ion.defaultServer 可选 Cesium ion API服务器的资源。
Returns:
代表cesium离子资产的无极实例。
Examples:
//Load a Cesium3DTileset with asset ID of 124624234
viewer.scene.primitives.add(new Cesium.Cesium3DTileset({ url: Cesium.IonResource.fromAssetId(124624234) }));
//Load a CZML file with asset ID of 10890
Cesium.IonResource.fromAssetId(10890)
  .then(function (resource) {
    viewer.dataSources.add(Cesium.CzmlDataSource.load(resource));
  });

appendForwardSlash ()

在URL后面加上斜杠。
Inherited From:

appendQueryParameters (params)

组合指定的对象和现有的查询参数。这使您可以一次添加许多参数, 而不是一次将它们一次添加到queryParameters属性。
Name Type Description
params Object 查询参数
Inherited From:
复制资源实例。
Name Type Description
result Resource 可选 将结果存储到的对象。
Returns:
修改后的结果参数或一个新的Resource实例(如果未提供)。
Inherited From:

delete ( options ) Promise.<*>|undefined

异步删除给定资源。返回一个承诺,将解决加载后返回结果,如果资源加载失败,则拒绝。数据已加载使用XMLHttpRequest,这意味着为了向另一个来源发出请求,服务器必须启用跨域资源共享(CORS)标头。
Name Type Description
options Object 可选 具有以下属性的对象:
名称 类型 说明
responseType 字符串 可选 响应类型。这样可以控制返回的商品类型。
标题 对象 可选 与请求一起发送的其他HTTP标头(如果有)。
overrideMimeType 字符串 可选 覆盖服务器返回的MIME类型。
Returns:
一个承诺,将在加载时解析为请求的数据。如果未返回,则返回undefined request.throttle 为true,并且请求的优先级不够高。
Inherited From:
Example:
resource.delete()
  .then(function(body) {
      // use the data
  }).otherwise(function(error) {
      // an error occurred
  });
See:

fetch ( options ) Promise.<*>|undefined

异步加载给定资源。返回一个承诺,将解决加载后返回结果,如果资源加载失败,则拒绝。数据已加载使用XMLHttpRequest,这意味着为了向另一个来源发出请求,服务器必须启用跨域资源共享(CORS)标头。建议您使用更具体的功能,例如fetchJson,fetchBlob等。
Name Type Description
options Object 可选 具有以下属性的对象:
名称 类型 说明
responseType 字符串 可选 响应类型。这样可以控制返回的商品类型。
标题 对象 可选 与请求一起发送的其他HTTP标头(如果有)。
overrideMimeType 字符串 可选 覆盖服务器返回的MIME类型。
Returns:
一个承诺,将在加载时解析为请求的数据。如果未返回,则返回undefined request.throttle 为true,并且请求的优先级不够高。
Inherited From:
Example:
resource.fetch()
  .then(function(body) {
      // use the data
  }).otherwise(function(error) {
      // an error occurred
  });
See:

fetchArrayBuffer () Promise.<ArrayBuffer>|undefined

异步将资源作为原始二进制数据加载。返回一个承诺,将解决ArrayBuffer加载后,如果资源加载失败,则拒绝。数据已加载使用XMLHttpRequest,这意味着为了向另一个来源发出请求,服务器必须启用跨域资源共享(CORS)标头。
Returns:
一个承诺,将在加载时解析为请求的数据。如果未返回,则返回undefined request.throttle 为true,并且请求的优先级不够高。
Inherited From:
Example:
// load a single URL asynchronously
resource.fetchArrayBuffer().then(function(arrayBuffer) {
    // use the data
}).otherwise(function(error) {
    // an error occurred
});
See:

fetchBlob () Promise.<Blob>|undefined

异步将给定资源加载为Blob。返回一个承诺,将解决Blob一旦加载,或者如果资源加载失败,则拒绝。数据已加载使用XMLHttpRequest,这意味着为了向另一个来源发出请求,服务器必须启用跨域资源共享(CORS)标头。
Returns:
一个承诺,将在加载时解析为请求的数据。如果未返回,则返回undefined request.throttle 为true,并且请求的优先级不够高。
Inherited From:
Example:
// load a single URL asynchronously
resource.fetchBlob().then(function(blob) {
    // use the data
}).otherwise(function(error) {
    // an error occurred
});
See:

fetchImage ( options ) Promise.<ImageBitmap>|Promise.<HTMLImageElement>|undefined

异步加载给定的图像资源。返回一个承诺,将解决如果 preferImageBitmap 为true并且浏览器支持 ImageBitmap code> createImageBitmap 或其他 图像 一旦加载,或者如果图像加载失败则拒绝。
Name Type Description
options Object 可选 具有以下属性的对象。
名称 类型 默认 说明
preferBlob 布尔值 错误 可选 如果为true,我们将通过Blob加载图像。
preferImageBitmap 布尔值 错误 可选 如果为true,则将在获取过程中对图像进行解码,并返回 ImageBitmap
flipY 布尔值 错误 可选 如果为true,则在解码期间图像将垂直翻转。仅在浏览器支持 createImageBitmap 时适用。
Returns:
一个承诺,将在加载时解析为请求的数据。如果未返回,则返回undefined request.throttle 为true,并且请求的优先级不够高。
Inherited From:
Example:
// load a single image asynchronously
resource.fetchImage().then(function(image) {
    // use the loaded image
}).otherwise(function(error) {
    // an error occurred
});

// load several images in parallel
when.all([resource1.fetchImage(), resource2.fetchImage()]).then(function(images) {
    // images is an array containing all the loaded images
});
See:

fetchJson () Promise.<*>|undefined

异步将给定资源加载为JSON。返回一个承诺,将解决JSON对象一旦加载,或者如果资源加载失败则拒绝。数据已加载使用XMLHttpRequest,这意味着为了向另一个来源发出请求,服务器必须启用跨域资源共享(CORS)标头。这个功能如果没有,在请求标头中添加' Accept:application/json,*/*; q = 0.01'已经指定。
Returns:
一个承诺,将在加载时解析为请求的数据。如果未返回,则返回undefined request.throttle 为true,并且请求的优先级不够高。
Inherited From:
Example:
resource.fetchJson().then(function(jsonData) {
    // Do something with the JSON object
}).otherwise(function(error) {
    // an error occurred
});
See:

fetchJsonp ( callbackParameterName ) Promise.<*>|undefined

使用JSONP请求资源。
Name Type Default Description
callbackParameterName String 'callback' 可选 服务器期望的回调参数名称。
Returns:
一个承诺,将在加载时解析为请求的数据。如果未返回,则返回undefined request.throttle 为true,并且请求的优先级不够高。
Inherited From:
Example:
// load a data asynchronously
resource.fetchJsonp().then(function(data) {
    // use the loaded data
}).otherwise(function(error) {
    // an error occurred
});
See:

fetchText () Promise.<String>|undefined

异步加载给定资源为文本。返回一个承诺,将解决一次加载String,如果资源加载失败,则拒绝。数据已加载使用XMLHttpRequest,这意味着为了向另一个来源发出请求,服务器必须启用跨域资源共享(CORS)标头。
Returns:
一个承诺,将在加载时解析为请求的数据。如果未返回,则返回undefined request.throttle 为true,并且请求的优先级不够高。
Inherited From:
Example:
// load text from a URL, setting a custom header
var resource = new Resource({
  url: 'http://someUrl.com/someJson.txt',
  headers: {
    'X-Custom-Header' : 'some value'
  }
});
resource.fetchText().then(function(text) {
    // Do something with the text
}).otherwise(function(error) {
    // an error occurred
});
See:

fetchXML () Promise.<XMLDocument>|undefined

异步将给定资源加载为XML。返回一个承诺,将解决XML文档一旦加载,或者如果资源加载失败,则拒绝。数据已加载使用XMLHttpRequest,这意味着为了向另一个来源发出请求,服务器必须启用跨域资源共享(CORS)标头。
Returns:
一个承诺,将在加载时解析为请求的数据。如果未返回,则返回undefined request.throttle 为true,并且请求的优先级不够高。
Inherited From:
Example:
// load XML from a URL, setting a custom header
Cesium.loadXML('http://someUrl.com/someXML.xml', {
  'X-Custom-Header' : 'some value'
}).then(function(document) {
    // Do something with the document
}).otherwise(function(error) {
    // an error occurred
});
See:

getBaseUri ( includeQuery ) String

返回资源的基本路径。
Name Type Default Description
includeQuery Boolean false 可选 是否在uri中包含查询字符串和片段
Returns:
资源的基本URI
Inherited From:

getDerivedResource (options) Resource

返回相对于当前实例的资源。除非在选项中覆盖,否则所有属性均与当前实例相同。
Name Type Description
options Object 具有以下属性的对象
名称 类型 默认 说明
url 字符串 可选 相对于当前实例的URL将被解析的URL。
queryParameters 对象 可选 一个对象,其中包含将与当前实例的查询参数组合的查询参数。
templateValues 对象 可选 用于替换模板值的键/值对(例如{x})。这些将与当前实例的对象合并。
标题 对象 {} 可选 将发送的其他HTTP标头。
proxy 代理 可选 加载资源时要使用的代理。
retryCallback Resource.RetryCallback 可选 加载资源时调用的函数失败。
retryAttempts 数字 可选 放弃之前应调用retryCallback的次数。
request 请求 可选 将使用的Request对象。仅供内部使用。
preserveQueryParameters 布尔值 错误 可选 如果为true,则将保留当前资源和派生资源中的所有查询参数。如果为false,则派生参数将替换当前资源的参数。
Returns:
从当前资源派生的资源。
Inherited From:

getUrlComponent ( query , proxy ) String

返回url(可选)和查询字符串,并由代理处理。
Name Type Default Description
query Boolean false 可选 如果为true,则包含查询字符串。
proxy Boolean false 可选 如果为true,则该URL由代理对象(如果已定义)处理。
Returns:
具有所有要求的组件的URL。
Inherited From:
异步获取标头给定的资源。返回一个承诺,将解决加载后返回结果,如果资源加载失败,则拒绝。数据已加载使用XMLHttpRequest,这意味着为了向另一个来源发出请求,服务器必须启用跨域资源共享(CORS)标头。
Name Type Description
options Object 可选 具有以下属性的对象:
名称 类型 说明
responseType 字符串 可选 响应类型。这样可以控制返回的商品类型。
标题 对象 可选 与请求一起发送的其他HTTP标头(如果有)。
overrideMimeType 字符串 可选 覆盖服务器返回的MIME类型。
Returns:
一个承诺,将在加载时解析为请求的数据。如果未返回,则返回undefined request.throttle 为true,并且请求的优先级不够高。
Inherited From:
Example:
resource.head()
  .then(function(headers) {
      // use the data
  }).otherwise(function(error) {
      // an error occurred
  });
See:

options ( options ) Promise.<*>|undefined

异步获取给定资源的选项。返回一个承诺,将解决加载后返回结果,如果资源加载失败,则拒绝。数据已加载使用XMLHttpRequest,这意味着为了向另一个来源发出请求,服务器必须启用跨域资源共享(CORS)标头。
Name Type Description
options Object 可选 具有以下属性的对象:
名称 类型 说明
responseType 字符串 可选 响应类型。这样可以控制返回的商品类型。
标题 对象 可选 与请求一起发送的其他HTTP标头(如果有)。
overrideMimeType 字符串 可选 覆盖服务器返回的MIME类型。
Returns:
一个承诺,将在加载时解析为请求的数据。如果未返回,则返回undefined request.throttle 为true,并且请求的优先级不够高。
Inherited From:
Example:
resource.options()
  .then(function(headers) {
      // use the data
  }).otherwise(function(error) {
      // an error occurred
  });
See:

patch (data, options ) Promise.<*>|undefined

异步将数据修补到给定资源。返回一个承诺,将解决加载后返回结果,如果资源加载失败,则拒绝。数据已加载使用XMLHttpRequest,这意味着为了向另一个来源发出请求,服务器必须启用跨域资源共享(CORS)标头。
Name Type Description
data Object 与资源一起发布的数据。
options Object 可选 具有以下属性的对象:
名称 类型 说明
responseType 字符串 可选 响应类型。这样可以控制返回的商品类型。
标题 对象 可选 与请求一起发送的其他HTTP标头(如果有)。
overrideMimeType 字符串 可选 覆盖服务器返回的MIME类型。
Returns:
一个承诺,将在加载时解析为请求的数据。如果未返回,则返回undefined request.throttle 为true,并且请求的优先级不够高。
Inherited From:
Example:
resource.patch(data)
  .then(function(result) {
      // use the result
  }).otherwise(function(error) {
      // an error occurred
  });
See:

post (data, options ) Promise.<*>|undefined

异步将数据发布到给定资源。返回一个承诺,将解决加载后返回结果,如果资源加载失败,则拒绝。数据已加载使用XMLHttpRequest,这意味着为了向另一个来源发出请求,服务器必须启用跨域资源共享(CORS)标头。
Name Type Description
data Object 与资源一起发布的数据。
options Object 可选 具有以下属性的对象:
名称 类型 说明
数据 对象 可选 与资源一起发布的数据。
responseType 字符串 可选 响应类型。这样可以控制返回的商品类型。
标题 对象 可选 与请求一起发送的其他HTTP标头(如果有)。
overrideMimeType 字符串 可选 覆盖服务器返回的MIME类型。
Returns:
一个承诺,将在加载时解析为请求的数据。如果未返回,则返回undefined request.throttle 为true,并且请求的优先级不够高。
Inherited From:
Example:
resource.post(data)
  .then(function(result) {
      // use the result
  }).otherwise(function(error) {
      // an error occurred
  });
See:

put (data, options ) Promise.<*>|undefined

异步将数据放入给定资源。返回一个承诺,将解决加载后返回结果,如果资源加载失败,则拒绝。数据已加载使用XMLHttpRequest,这意味着为了向另一个来源发出请求,服务器必须启用跨域资源共享(CORS)标头。
Name Type Description
data Object 与资源一起发布的数据。
options Object 可选 具有以下属性的对象:
名称 类型 说明
responseType 字符串 可选 响应类型。这样可以控制返回的商品类型。
标题 对象 可选 与请求一起发送的其他HTTP标头(如果有)。
overrideMimeType 字符串 可选 覆盖服务器返回的MIME类型。
Returns:
一个承诺,将在加载时解析为请求的数据。如果未返回,则返回undefined request.throttle 为true,并且请求的优先级不够高。
Inherited From:
Example:
resource.put(data)
  .then(function(result) {
      // use the result
  }).otherwise(function(error) {
      // an error occurred
  });
See:

setQueryParameters (params, useAsDefault )

组合指定的对象和现有的查询参数。这使您可以一次添加许多参数, 而不是一次将它们一次添加到queryParameters属性。如果已经设置了一个值,它将被新值替换。
Name Type Default Description
params Object 查询参数
useAsDefault Boolean false 可选 如果为true,则将使用参数作为默认值,因此只有在未定义参数的情况下才会设置这些参数。
Inherited From:

setTemplateValues (template, useAsDefault )

组合指定的对象和现有的模板值。这样您可以一次添加多个值, 而不是一次将它们一次添加到templateValues属性。如果已经设置了一个值,它将成为一个数组并附加新值。
Name Type Default Description
template Object 模板值
useAsDefault Boolean false 可选 如果为true,则将这些值用作默认值,因此只有在未定义它们时才设置它们。
Inherited From:

toString () String

覆盖Object#toString,以便隐式字符串转换为此资源表示的完整URL。
Returns:
此资源表示的URL
Inherited From: