IonResource

new Cesium.IonResource (endpoint, endpointResource)
Core/IonResource.js 27

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

Extends

翻译by:http://cesium.xin

Members

readonly credits : Array.< Credit >
Core/IonResource.js 117

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

readonly extension : String
Core/Resource.js 469

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

hasHeaders : Boolean
Core/Resource.js 517

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

headers : Object
Core/Resource.js 282

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

isBlobUri : Boolean
Core/Resource.js 493

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

isCrossOriginUrl : Boolean
Core/Resource.js 505

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

isDataUri : Boolean
Core/Resource.js 481

如果资源引用数据URI，则为True。
Inherited From:

proxy : Proxy
Core/Resource.js 296

加载资源时要使用的代理。
Inherited From:

readonly queryParameters : Object
Core/Resource.js 419

查询参数附加到URL。
Inherited From:

request : Request
Core/Resource.js 289

将使用的Request对象。仅用于内部使用。
Inherited From:

retryAttempts : Number
Core/Resource.js 310

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

retryCallback : function
Core/Resource.js 303

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

readonly templateValues : Object
Core/Resource.js 433

键/值对，用于替换url中的模板参数。
Inherited From:

url : String
Core/Resource.js 445

资源的url（已设置模板）替换为模板值，附加查询字符串并由代理编码。
Inherited From:

Methods

static Cesium.IonResource.fromAssetId (assetId, options ) → Promise.< IonResource >
Core/IonResource.js 101

异步创建一个实例。
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 ()
Core/Resource.js 758

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

appendQueryParameters (params)
Core/Resource.js 602

组合指定的对象和现有的查询参数。这使您可以一次添加许多参数， 而不是一次将它们一次添加到queryParameters属性。
Name Type Description
params Object 查询参数
Inherited From:

clone ( result ) → Resource
Core/Resource.js 724

复制资源实例。
Name Type Description
result Resource 可选 将结果存储到的对象。
Returns:
修改后的结果参数或一个新的Resource实例（如果未提供）。
Inherited From:

delete ( options ) → Promise.<*>|undefined
Core/Resource.js 1527

异步删除给定资源。返回一个承诺，将解决加载后返回结果，如果资源加载失败，则拒绝。数据已加载使用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
Core/Resource.js 1471

异步加载给定资源。返回一个承诺，将解决加载后返回结果，如果资源加载失败，则拒绝。数据已加载使用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
Core/Resource.js 781

异步将资源作为原始二进制数据加载。返回一个承诺，将解决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
Core/Resource.js 825

异步将给定资源加载为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
Core/Resource.js 878

异步加载给定的图像资源。返回一个承诺，将解决如果 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
Core/Resource.js 1137

异步将给定资源加载为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
Core/Resource.js 1242

使用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
Core/Resource.js 1090

异步加载给定资源为文本。返回一个承诺，将解决一次加载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
Core/Resource.js 1199

异步将给定资源加载为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
Core/Resource.js 751

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

getDerivedResource (options) → Resource
Core/Resource.js 641

返回相对于当前实例的资源。除非在选项中覆盖，否则所有属性均与当前实例相同。
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
Core/Resource.js 542

返回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
Core/Resource.js 1641

异步获取给定资源的选项。返回一个承诺，将解决加载后返回结果，如果资源加载失败，则拒绝。数据已加载使用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
Core/Resource.js 1821

异步将数据修补到给定资源。返回一个承诺，将解决加载后返回结果，如果资源加载失败，则拒绝。数据已加载使用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
Core/Resource.js 1699

异步将数据发布到给定资源。返回一个承诺，将解决加载后返回结果，如果资源加载失败，则拒绝。数据已加载使用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
Core/Resource.js 1760

异步将数据放入给定资源。返回一个承诺，将解决加载后返回结果，如果资源加载失败，则拒绝。数据已加载使用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 )
Core/Resource.js 580

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

setTemplateValues (template, useAsDefault )
Core/Resource.js 617

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

toString () → String
Core/Resource.js 530

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