English | 简体中文

Request

new Cesium.Request(options)

Stores information for making a request. In general this does not need to be constructed directly.
Name Type Description
options object optional An object with the following properties:
Name Type Default Description
url string optional The url to request.
requestFunction Request.RequestCallback optional The function that makes the actual data request.
cancelFunction Request.CancelCallback optional The function that is called when the request is cancelled.
priorityFunction Request.PriorityCallback optional The function that is called to update the request's priority, which occurs once per frame.
priority number 0.0 optional The initial priority of the request.
throttle boolean false optional Whether to throttle and prioritize the request. If false, the request will be sent immediately. If true, the request will be throttled and sent based on priority.
throttleByServer boolean false optional Whether to throttle the request by server.
type RequestType RequestType.OTHER optional The type of request.
serverKey string optional A key used to identify the server that a request is going to.

Members

The function that is called when the request is cancelled.
Priority is a unit-less value where lower values represent higher priority. For world-based objects, this is usually the distance from the camera. A request that does not have a priority function defaults to a priority of 0. If priorityFunction is defined, this value is updated every frame with the result of that call.
Default Value: 0.0
The function that is called to update the request's priority, which occurs once per frame.
The function that makes the actual data request.
The current state of the request.

readonly throttle : boolean

Whether to throttle and prioritize the request. If false, the request will be sent immediately. If true, the request will be throttled and sent based on priority.
Default Value: false

readonly throttleByServer : boolean

Whether to throttle the request by server. Browsers typically support about 6-8 parallel connections for HTTP/1 servers, and an unlimited amount of connections for HTTP/2 servers. Setting this value to true is preferable for requests going through HTTP/1 servers.
Default Value: false
Type of request.
Default Value: RequestType.OTHER
The URL to request.

Methods

Duplicates a Request instance.
Name Type Description
result Request optional The object onto which to store the result.
Returns:
The modified result parameter or a new Resource instance if one was not provided.

Type Definitions

Cesium.Request.CancelCallback()

The function that is called when the request is cancelled.

Cesium.Request.PriorityCallback()number

The function that is called to update the request's priority, which occurs once per frame.
Returns:
The updated priority value.

Cesium.Request.RequestCallback()Promise.<void>

The function that makes the actual data request.
Returns:
A promise for the requested data.
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.