Asynchronously loads the given URL as JSON. Returns a promise that will resolve to
a JSON object once loaded, or reject if the URL failed to load. The data is loaded
using XMLHttpRequest, which means that in order to make requests to another origin,
the server must have Cross-Origin Resource Sharing (CORS) headers enabled. This function
adds 'Accept: application/json,*/*;q=0.01' to the request headers, if not
already specified.
Name | Type | Description |
---|---|---|
url |
String | The URL to request. |
headers |
Object | optional HTTP headers to send with the request. 'Accept: application/json,*/*;q=0.01' is added to the request headers automatically if not specified. |
request |
Request | optional The request object. Intended for internal use only. |
Returns:
a promise that will resolve to the requested data when loaded. Returns undefined if
request.throttle
is true and the request does not have high enough priority.
Example:
Cesium.loadJson('http://someUrl.com/someJson.txt').then(function(jsonData) {
// Do something with the JSON object
}).otherwise(function(error) {
// an error occurred
});