123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918 |
- import Cartesian2 from "../Core/Cartesian2.js";
- import Cartesian3 from "../Core/Cartesian3.js";
- import Cartographic from "../Core/Cartographic.js";
- import Credit from "../Core/Credit.js";
- import defaultValue from "../Core/defaultValue.js";
- import defer from "../Core/defer.js";
- import defined from "../Core/defined.js";
- import DeveloperError from "../Core/DeveloperError.js";
- import Event from "../Core/Event.js";
- import GeographicProjection from "../Core/GeographicProjection.js";
- import GeographicTilingScheme from "../Core/GeographicTilingScheme.js";
- import CesiumMath from "../Core/Math.js";
- import Rectangle from "../Core/Rectangle.js";
- import Resource from "../Core/Resource.js";
- import RuntimeError from "../Core/RuntimeError.js";
- import TileProviderError from "../Core/TileProviderError.js";
- import WebMercatorProjection from "../Core/WebMercatorProjection.js";
- import WebMercatorTilingScheme from "../Core/WebMercatorTilingScheme.js";
- import DiscardMissingTileImagePolicy from "./DiscardMissingTileImagePolicy.js";
- import ImageryLayerFeatureInfo from "./ImageryLayerFeatureInfo.js";
- import ImageryProvider from "./ImageryProvider.js";
- /**
- * @typedef {Object} ArcGisMapServerImageryProvider.ConstructorOptions
- *
- * Initialization options for the ArcGisMapServerImageryProvider constructor
- *
- * @property {Resource|String} url The URL of the ArcGIS MapServer service.
- * @property {String} [token] The ArcGIS token used to authenticate with the ArcGIS MapServer service.
- * @property {TileDiscardPolicy} [tileDiscardPolicy] The policy that determines if a tile
- * is invalid and should be discarded. If this value is not specified, a default
- * {@link DiscardMissingTileImagePolicy} is used for tiled map servers, and a
- * {@link NeverTileDiscardPolicy} is used for non-tiled map servers. In the former case,
- * we request tile 0,0 at the maximum tile level and check pixels (0,0), (200,20), (20,200),
- * (80,110), and (160, 130). If all of these pixels are transparent, the discard check is
- * disabled and no tiles are discarded. If any of them have a non-transparent color, any
- * tile that has the same values in these pixel locations is discarded. The end result of
- * these defaults should be correct tile discarding for a standard ArcGIS Server. To ensure
- * that no tiles are discarded, construct and pass a {@link NeverTileDiscardPolicy} for this
- * parameter.
- * @property {Boolean} [usePreCachedTilesIfAvailable=true] If true, the server's pre-cached
- * tiles are used if they are available. If false, any pre-cached tiles are ignored and the
- * 'export' service is used.
- * @property {String} [layers] A comma-separated list of the layers to show, or undefined if all layers should be shown.
- * @property {Boolean} [enablePickFeatures=true] If true, {@link ArcGisMapServerImageryProvider#pickFeatures} will invoke
- * the Identify service on the MapServer and return the features included in the response. If false,
- * {@link ArcGisMapServerImageryProvider#pickFeatures} will immediately return undefined (indicating no pickable features)
- * without communicating with the server. Set this property to false if you don't want this provider's features to
- * be pickable. Can be overridden by setting the {@link ArcGisMapServerImageryProvider#enablePickFeatures} property on the object.
- * @property {Rectangle} [rectangle=Rectangle.MAX_VALUE] The rectangle of the layer. This parameter is ignored when accessing
- * a tiled layer.
- * @property {TilingScheme} [tilingScheme=new GeographicTilingScheme()] The tiling scheme to use to divide the world into tiles.
- * This parameter is ignored when accessing a tiled server.
- * @property {Ellipsoid} [ellipsoid] The ellipsoid. If the tilingScheme is specified and used,
- * this parameter is ignored and the tiling scheme's ellipsoid is used instead. If neither
- * parameter is specified, the WGS84 ellipsoid is used.
- * @property {Credit|String} [credit] A credit for the data source, which is displayed on the canvas. This parameter is ignored when accessing a tiled server.
- * @property {Number} [tileWidth=256] The width of each tile in pixels. This parameter is ignored when accessing a tiled server.
- * @property {Number} [tileHeight=256] The height of each tile in pixels. This parameter is ignored when accessing a tiled server.
- * @property {Number} [maximumLevel] The maximum tile level to request, or undefined if there is no maximum. This parameter is ignored when accessing
- * a tiled server.
- */
- /**
- * Provides tiled imagery hosted by an ArcGIS MapServer. By default, the server's pre-cached tiles are
- * used, if available.
- *
- * @alias ArcGisMapServerImageryProvider
- * @constructor
- *
- * @param {ArcGisMapServerImageryProvider.ConstructorOptions} options Object describing initialization options
- *
- * @see BingMapsImageryProvider
- * @see GoogleEarthEnterpriseMapsProvider
- * @see OpenStreetMapImageryProvider
- * @see SingleTileImageryProvider
- * @see TileMapServiceImageryProvider
- * @see WebMapServiceImageryProvider
- * @see WebMapTileServiceImageryProvider
- * @see UrlTemplateImageryProvider
- *
- *
- * @example
- * const esri = new Cesium.ArcGisMapServerImageryProvider({
- * url : 'https://services.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer'
- * });
- *
- * @see {@link https://developers.arcgis.com/rest/|ArcGIS Server REST API}
- * @see {@link http://www.w3.org/TR/cors/|Cross-Origin Resource Sharing}
- */
- function ArcGisMapServerImageryProvider(options) {
- options = defaultValue(options, defaultValue.EMPTY_OBJECT);
- //>>includeStart('debug', pragmas.debug);
- if (!defined(options.url)) {
- throw new DeveloperError("options.url is required.");
- }
- //>>includeEnd('debug');
- /**
- * The default alpha blending value of this provider, with 0.0 representing fully transparent and
- * 1.0 representing fully opaque.
- *
- * @type {Number|undefined}
- * @default undefined
- */
- this.defaultAlpha = undefined;
- /**
- * The default alpha blending value on the night side of the globe of this provider, with 0.0 representing fully transparent and
- * 1.0 representing fully opaque.
- *
- * @type {Number|undefined}
- * @default undefined
- */
- this.defaultNightAlpha = undefined;
- /**
- * The default alpha blending value on the day side of the globe of this provider, with 0.0 representing fully transparent and
- * 1.0 representing fully opaque.
- *
- * @type {Number|undefined}
- * @default undefined
- */
- this.defaultDayAlpha = undefined;
- /**
- * The default brightness of this provider. 1.0 uses the unmodified imagery color. Less than 1.0
- * makes the imagery darker while greater than 1.0 makes it brighter.
- *
- * @type {Number|undefined}
- * @default undefined
- */
- this.defaultBrightness = undefined;
- /**
- * The default contrast of this provider. 1.0 uses the unmodified imagery color. Less than 1.0 reduces
- * the contrast while greater than 1.0 increases it.
- *
- * @type {Number|undefined}
- * @default undefined
- */
- this.defaultContrast = undefined;
- /**
- * The default hue of this provider in radians. 0.0 uses the unmodified imagery color.
- *
- * @type {Number|undefined}
- * @default undefined
- */
- this.defaultHue = undefined;
- /**
- * The default saturation of this provider. 1.0 uses the unmodified imagery color. Less than 1.0 reduces the
- * saturation while greater than 1.0 increases it.
- *
- * @type {Number|undefined}
- * @default undefined
- */
- this.defaultSaturation = undefined;
- /**
- * The default gamma correction to apply to this provider. 1.0 uses the unmodified imagery color.
- *
- * @type {Number|undefined}
- * @default undefined
- */
- this.defaultGamma = undefined;
- /**
- * The default texture minification filter to apply to this provider.
- *
- * @type {TextureMinificationFilter}
- * @default undefined
- */
- this.defaultMinificationFilter = undefined;
- /**
- * The default texture magnification filter to apply to this provider.
- *
- * @type {TextureMagnificationFilter}
- * @default undefined
- */
- this.defaultMagnificationFilter = undefined;
- const resource = Resource.createIfNeeded(options.url);
- resource.appendForwardSlash();
- if (defined(options.token)) {
- resource.setQueryParameters({
- token: options.token,
- });
- }
- this._resource = resource;
- this._tileDiscardPolicy = options.tileDiscardPolicy;
- this._tileWidth = defaultValue(options.tileWidth, 256);
- this._tileHeight = defaultValue(options.tileHeight, 256);
- this._maximumLevel = options.maximumLevel;
- this._tilingScheme = defaultValue(
- options.tilingScheme,
- new GeographicTilingScheme({ ellipsoid: options.ellipsoid })
- );
- this._useTiles = defaultValue(options.usePreCachedTilesIfAvailable, true);
- this._rectangle = defaultValue(
- options.rectangle,
- this._tilingScheme.rectangle
- );
- this._layers = options.layers;
- let credit = options.credit;
- if (typeof credit === "string") {
- credit = new Credit(credit);
- }
- this._credit = credit;
- /**
- * Gets or sets a value indicating whether feature picking is enabled. If true, {@link ArcGisMapServerImageryProvider#pickFeatures} will
- * invoke the "identify" operation on the ArcGIS server and return the features included in the response. If false,
- * {@link ArcGisMapServerImageryProvider#pickFeatures} will immediately return undefined (indicating no pickable features)
- * without communicating with the server.
- * @type {Boolean}
- * @default true
- */
- this.enablePickFeatures = defaultValue(options.enablePickFeatures, true);
- this._errorEvent = new Event();
- this._ready = false;
- this._readyPromise = defer();
- // Grab the details of this MapServer.
- const that = this;
- let metadataError;
- function metadataSuccess(data) {
- const tileInfo = data.tileInfo;
- if (!defined(tileInfo)) {
- that._useTiles = false;
- } else {
- that._tileWidth = tileInfo.rows;
- that._tileHeight = tileInfo.cols;
- if (
- tileInfo.spatialReference.wkid === 102100 ||
- tileInfo.spatialReference.wkid === 102113
- ) {
- that._tilingScheme = new WebMercatorTilingScheme({
- ellipsoid: options.ellipsoid,
- });
- } else if (data.tileInfo.spatialReference.wkid === 4326) {
- that._tilingScheme = new GeographicTilingScheme({
- ellipsoid: options.ellipsoid,
- });
- } else {
- const message = `Tile spatial reference WKID ${data.tileInfo.spatialReference.wkid} is not supported.`;
- metadataError = TileProviderError.handleError(
- metadataError,
- that,
- that._errorEvent,
- message,
- undefined,
- undefined,
- undefined,
- requestMetadata
- );
- if (!metadataError.retry) {
- that._readyPromise.reject(new RuntimeError(message));
- }
- return;
- }
- that._maximumLevel = data.tileInfo.lods.length - 1;
- if (defined(data.fullExtent)) {
- if (
- defined(data.fullExtent.spatialReference) &&
- defined(data.fullExtent.spatialReference.wkid)
- ) {
- if (
- data.fullExtent.spatialReference.wkid === 102100 ||
- data.fullExtent.spatialReference.wkid === 102113
- ) {
- const projection = new WebMercatorProjection();
- const extent = data.fullExtent;
- const sw = projection.unproject(
- new Cartesian3(
- Math.max(
- extent.xmin,
- -that._tilingScheme.ellipsoid.maximumRadius * Math.PI
- ),
- Math.max(
- extent.ymin,
- -that._tilingScheme.ellipsoid.maximumRadius * Math.PI
- ),
- 0.0
- )
- );
- const ne = projection.unproject(
- new Cartesian3(
- Math.min(
- extent.xmax,
- that._tilingScheme.ellipsoid.maximumRadius * Math.PI
- ),
- Math.min(
- extent.ymax,
- that._tilingScheme.ellipsoid.maximumRadius * Math.PI
- ),
- 0.0
- )
- );
- that._rectangle = new Rectangle(
- sw.longitude,
- sw.latitude,
- ne.longitude,
- ne.latitude
- );
- } else if (data.fullExtent.spatialReference.wkid === 4326) {
- that._rectangle = Rectangle.fromDegrees(
- data.fullExtent.xmin,
- data.fullExtent.ymin,
- data.fullExtent.xmax,
- data.fullExtent.ymax
- );
- } else {
- const extentMessage = `fullExtent.spatialReference WKID ${data.fullExtent.spatialReference.wkid} is not supported.`;
- metadataError = TileProviderError.handleError(
- metadataError,
- that,
- that._errorEvent,
- extentMessage,
- undefined,
- undefined,
- undefined,
- requestMetadata
- );
- if (!metadataError.retry) {
- that._readyPromise.reject(new RuntimeError(extentMessage));
- }
- return;
- }
- }
- } else {
- that._rectangle = that._tilingScheme.rectangle;
- }
- // Install the default tile discard policy if none has been supplied.
- if (!defined(that._tileDiscardPolicy)) {
- that._tileDiscardPolicy = new DiscardMissingTileImagePolicy({
- missingImageUrl: buildImageResource(that, 0, 0, that._maximumLevel)
- .url,
- pixelsToCheck: [
- new Cartesian2(0, 0),
- new Cartesian2(200, 20),
- new Cartesian2(20, 200),
- new Cartesian2(80, 110),
- new Cartesian2(160, 130),
- ],
- disableCheckIfAllPixelsAreTransparent: true,
- });
- }
- that._useTiles = true;
- }
- if (defined(data.copyrightText) && data.copyrightText.length > 0) {
- that._credit = new Credit(data.copyrightText);
- }
- that._ready = true;
- that._readyPromise.resolve(true);
- TileProviderError.handleSuccess(metadataError);
- }
- function metadataFailure(e) {
- const message = `An error occurred while accessing ${that._resource.url}.`;
- metadataError = TileProviderError.handleError(
- metadataError,
- that,
- that._errorEvent,
- message,
- undefined,
- undefined,
- undefined,
- requestMetadata
- );
- that._readyPromise.reject(new RuntimeError(message));
- }
- function requestMetadata() {
- const resource = that._resource.getDerivedResource({
- queryParameters: {
- f: "json",
- },
- });
- resource
- .fetchJsonp()
- .then(function (result) {
- metadataSuccess(result);
- })
- .catch(function (e) {
- metadataFailure(e);
- });
- }
- if (this._useTiles) {
- requestMetadata();
- } else {
- this._ready = true;
- this._readyPromise.resolve(true);
- }
- }
- function buildImageResource(imageryProvider, x, y, level, request) {
- let resource;
- if (imageryProvider._useTiles) {
- resource = imageryProvider._resource.getDerivedResource({
- url: `tile/${level}/${y}/${x}`,
- request: request,
- });
- } else {
- const nativeRectangle = imageryProvider._tilingScheme.tileXYToNativeRectangle(
- x,
- y,
- level
- );
- const bbox = `${nativeRectangle.west},${nativeRectangle.south},${nativeRectangle.east},${nativeRectangle.north}`;
- const query = {
- bbox: bbox,
- size: `${imageryProvider._tileWidth},${imageryProvider._tileHeight}`,
- format: "png32",
- transparent: true,
- f: "image",
- };
- if (
- imageryProvider._tilingScheme.projection instanceof GeographicProjection
- ) {
- query.bboxSR = 4326;
- query.imageSR = 4326;
- } else {
- query.bboxSR = 3857;
- query.imageSR = 3857;
- }
- if (imageryProvider.layers) {
- query.layers = `show:${imageryProvider.layers}`;
- }
- resource = imageryProvider._resource.getDerivedResource({
- url: "export",
- request: request,
- queryParameters: query,
- });
- }
- return resource;
- }
- Object.defineProperties(ArcGisMapServerImageryProvider.prototype, {
- /**
- * Gets the URL of the ArcGIS MapServer.
- * @memberof ArcGisMapServerImageryProvider.prototype
- * @type {String}
- * @readonly
- */
- url: {
- get: function () {
- return this._resource._url;
- },
- },
- /**
- * Gets the ArcGIS token used to authenticate with the ArcGis MapServer service.
- * @memberof ArcGisMapServerImageryProvider.prototype
- * @type {String}
- * @readonly
- */
- token: {
- get: function () {
- return this._resource.queryParameters.token;
- },
- },
- /**
- * Gets the proxy used by this provider.
- * @memberof ArcGisMapServerImageryProvider.prototype
- * @type {Proxy}
- * @readonly
- */
- proxy: {
- get: function () {
- return this._resource.proxy;
- },
- },
- /**
- * Gets the width of each tile, in pixels. This function should
- * not be called before {@link ArcGisMapServerImageryProvider#ready} returns true.
- * @memberof ArcGisMapServerImageryProvider.prototype
- * @type {Number}
- * @readonly
- */
- tileWidth: {
- get: function () {
- //>>includeStart('debug', pragmas.debug);
- if (!this._ready) {
- throw new DeveloperError(
- "tileWidth must not be called before the imagery provider is ready."
- );
- }
- //>>includeEnd('debug');
- return this._tileWidth;
- },
- },
- /**
- * Gets the height of each tile, in pixels. This function should
- * not be called before {@link ArcGisMapServerImageryProvider#ready} returns true.
- * @memberof ArcGisMapServerImageryProvider.prototype
- * @type {Number}
- * @readonly
- */
- tileHeight: {
- get: function () {
- //>>includeStart('debug', pragmas.debug);
- if (!this._ready) {
- throw new DeveloperError(
- "tileHeight must not be called before the imagery provider is ready."
- );
- }
- //>>includeEnd('debug');
- return this._tileHeight;
- },
- },
- /**
- * Gets the maximum level-of-detail that can be requested. This function should
- * not be called before {@link ArcGisMapServerImageryProvider#ready} returns true.
- * @memberof ArcGisMapServerImageryProvider.prototype
- * @type {Number|undefined}
- * @readonly
- */
- maximumLevel: {
- get: function () {
- //>>includeStart('debug', pragmas.debug);
- if (!this._ready) {
- throw new DeveloperError(
- "maximumLevel must not be called before the imagery provider is ready."
- );
- }
- //>>includeEnd('debug');
- return this._maximumLevel;
- },
- },
- /**
- * Gets the minimum level-of-detail that can be requested. This function should
- * not be called before {@link ArcGisMapServerImageryProvider#ready} returns true.
- * @memberof ArcGisMapServerImageryProvider.prototype
- * @type {Number}
- * @readonly
- */
- minimumLevel: {
- get: function () {
- //>>includeStart('debug', pragmas.debug);
- if (!this._ready) {
- throw new DeveloperError(
- "minimumLevel must not be called before the imagery provider is ready."
- );
- }
- //>>includeEnd('debug');
- return 0;
- },
- },
- /**
- * Gets the tiling scheme used by this provider. This function should
- * not be called before {@link ArcGisMapServerImageryProvider#ready} returns true.
- * @memberof ArcGisMapServerImageryProvider.prototype
- * @type {TilingScheme}
- * @readonly
- */
- tilingScheme: {
- get: function () {
- //>>includeStart('debug', pragmas.debug);
- if (!this._ready) {
- throw new DeveloperError(
- "tilingScheme must not be called before the imagery provider is ready."
- );
- }
- //>>includeEnd('debug');
- return this._tilingScheme;
- },
- },
- /**
- * Gets the rectangle, in radians, of the imagery provided by this instance. This function should
- * not be called before {@link ArcGisMapServerImageryProvider#ready} returns true.
- * @memberof ArcGisMapServerImageryProvider.prototype
- * @type {Rectangle}
- * @readonly
- */
- rectangle: {
- get: function () {
- //>>includeStart('debug', pragmas.debug);
- if (!this._ready) {
- throw new DeveloperError(
- "rectangle must not be called before the imagery provider is ready."
- );
- }
- //>>includeEnd('debug');
- return this._rectangle;
- },
- },
- /**
- * Gets the tile discard policy. If not undefined, the discard policy is responsible
- * for filtering out "missing" tiles via its shouldDiscardImage function. If this function
- * returns undefined, no tiles are filtered. This function should
- * not be called before {@link ArcGisMapServerImageryProvider#ready} returns true.
- * @memberof ArcGisMapServerImageryProvider.prototype
- * @type {TileDiscardPolicy}
- * @readonly
- */
- tileDiscardPolicy: {
- get: function () {
- //>>includeStart('debug', pragmas.debug);
- if (!this._ready) {
- throw new DeveloperError(
- "tileDiscardPolicy must not be called before the imagery provider is ready."
- );
- }
- //>>includeEnd('debug');
- return this._tileDiscardPolicy;
- },
- },
- /**
- * Gets an event that is raised when the imagery provider encounters an asynchronous error. By subscribing
- * to the event, you will be notified of the error and can potentially recover from it. Event listeners
- * are passed an instance of {@link TileProviderError}.
- * @memberof ArcGisMapServerImageryProvider.prototype
- * @type {Event}
- * @readonly
- */
- errorEvent: {
- get: function () {
- return this._errorEvent;
- },
- },
- /**
- * Gets a value indicating whether or not the provider is ready for use.
- * @memberof ArcGisMapServerImageryProvider.prototype
- * @type {Boolean}
- * @readonly
- */
- ready: {
- get: function () {
- return this._ready;
- },
- },
- /**
- * Gets a promise that resolves to true when the provider is ready for use.
- * @memberof ArcGisMapServerImageryProvider.prototype
- * @type {Promise.<Boolean>}
- * @readonly
- */
- readyPromise: {
- get: function () {
- return this._readyPromise.promise;
- },
- },
- /**
- * Gets the credit to display when this imagery provider is active. Typically this is used to credit
- * the source of the imagery. This function should not be called before {@link ArcGisMapServerImageryProvider#ready} returns true.
- * @memberof ArcGisMapServerImageryProvider.prototype
- * @type {Credit}
- * @readonly
- */
- credit: {
- get: function () {
- return this._credit;
- },
- },
- /**
- * Gets a value indicating whether this imagery provider is using pre-cached tiles from the
- * ArcGIS MapServer. If the imagery provider is not yet ready ({@link ArcGisMapServerImageryProvider#ready}), this function
- * will return the value of `options.usePreCachedTilesIfAvailable`, even if the MapServer does
- * not have pre-cached tiles.
- * @memberof ArcGisMapServerImageryProvider.prototype
- *
- * @type {Boolean}
- * @readonly
- * @default true
- */
- usingPrecachedTiles: {
- get: function () {
- return this._useTiles;
- },
- },
- /**
- * Gets a value indicating whether or not the images provided by this imagery provider
- * include an alpha channel. If this property is false, an alpha channel, if present, will
- * be ignored. If this property is true, any images without an alpha channel will be treated
- * as if their alpha is 1.0 everywhere. When this property is false, memory usage
- * and texture upload time are reduced.
- * @memberof ArcGisMapServerImageryProvider.prototype
- *
- * @type {Boolean}
- * @readonly
- * @default true
- */
- hasAlphaChannel: {
- get: function () {
- return true;
- },
- },
- /**
- * Gets the comma-separated list of layer IDs to show.
- * @memberof ArcGisMapServerImageryProvider.prototype
- *
- * @type {String}
- */
- layers: {
- get: function () {
- return this._layers;
- },
- },
- });
- /**
- * Gets the credits to be displayed when a given tile is displayed.
- *
- * @param {Number} x The tile X coordinate.
- * @param {Number} y The tile Y coordinate.
- * @param {Number} level The tile level;
- * @returns {Credit[]} The credits to be displayed when the tile is displayed.
- *
- * @exception {DeveloperError} <code>getTileCredits</code> must not be called before the imagery provider is ready.
- */
- ArcGisMapServerImageryProvider.prototype.getTileCredits = function (
- x,
- y,
- level
- ) {
- return undefined;
- };
- /**
- * Requests the image for a given tile. This function should
- * not be called before {@link ArcGisMapServerImageryProvider#ready} returns true.
- *
- * @param {Number} x The tile X coordinate.
- * @param {Number} y The tile Y coordinate.
- * @param {Number} level The tile level.
- * @param {Request} [request] The request object. Intended for internal use only.
- * @returns {Promise.<ImageryTypes>|undefined} A promise for the image that will resolve when the image is available, or
- * undefined if there are too many active requests to the server, and the request should be retried later.
- *
- * @exception {DeveloperError} <code>requestImage</code> must not be called before the imagery provider is ready.
- */
- ArcGisMapServerImageryProvider.prototype.requestImage = function (
- x,
- y,
- level,
- request
- ) {
- //>>includeStart('debug', pragmas.debug);
- if (!this._ready) {
- throw new DeveloperError(
- "requestImage must not be called before the imagery provider is ready."
- );
- }
- //>>includeEnd('debug');
- return ImageryProvider.loadImage(
- this,
- buildImageResource(this, x, y, level, request)
- );
- };
- /**
- /**
- * Asynchronously determines what features, if any, are located at a given longitude and latitude within
- * a tile. This function should not be called before {@link ImageryProvider#ready} returns true.
- *
- * @param {Number} x The tile X coordinate.
- * @param {Number} y The tile Y coordinate.
- * @param {Number} level The tile level.
- * @param {Number} longitude The longitude at which to pick features.
- * @param {Number} latitude The latitude at which to pick features.
- * @return {Promise.<ImageryLayerFeatureInfo[]>|undefined} A promise for the picked features that will resolve when the asynchronous
- * picking completes. The resolved value is an array of {@link ImageryLayerFeatureInfo}
- * instances. The array may be empty if no features are found at the given location.
- *
- * @exception {DeveloperError} <code>pickFeatures</code> must not be called before the imagery provider is ready.
- */
- ArcGisMapServerImageryProvider.prototype.pickFeatures = function (
- x,
- y,
- level,
- longitude,
- latitude
- ) {
- //>>includeStart('debug', pragmas.debug);
- if (!this._ready) {
- throw new DeveloperError(
- "pickFeatures must not be called before the imagery provider is ready."
- );
- }
- //>>includeEnd('debug');
- if (!this.enablePickFeatures) {
- return undefined;
- }
- const rectangle = this._tilingScheme.tileXYToNativeRectangle(x, y, level);
- let horizontal;
- let vertical;
- let sr;
- if (this._tilingScheme.projection instanceof GeographicProjection) {
- horizontal = CesiumMath.toDegrees(longitude);
- vertical = CesiumMath.toDegrees(latitude);
- sr = "4326";
- } else {
- const projected = this._tilingScheme.projection.project(
- new Cartographic(longitude, latitude, 0.0)
- );
- horizontal = projected.x;
- vertical = projected.y;
- sr = "3857";
- }
- let layers = "visible";
- if (defined(this._layers)) {
- layers += `:${this._layers}`;
- }
- const query = {
- f: "json",
- tolerance: 2,
- geometryType: "esriGeometryPoint",
- geometry: `${horizontal},${vertical}`,
- mapExtent: `${rectangle.west},${rectangle.south},${rectangle.east},${rectangle.north}`,
- imageDisplay: `${this._tileWidth},${this._tileHeight},96`,
- sr: sr,
- layers: layers,
- };
- const resource = this._resource.getDerivedResource({
- url: "identify",
- queryParameters: query,
- });
- return resource.fetchJson().then(function (json) {
- const result = [];
- const features = json.results;
- if (!defined(features)) {
- return result;
- }
- for (let i = 0; i < features.length; ++i) {
- const feature = features[i];
- const featureInfo = new ImageryLayerFeatureInfo();
- featureInfo.data = feature;
- featureInfo.name = feature.value;
- featureInfo.properties = feature.attributes;
- featureInfo.configureDescriptionFromProperties(feature.attributes);
- // If this is a point feature, use the coordinates of the point.
- if (feature.geometryType === "esriGeometryPoint" && feature.geometry) {
- const wkid =
- feature.geometry.spatialReference &&
- feature.geometry.spatialReference.wkid
- ? feature.geometry.spatialReference.wkid
- : 4326;
- if (wkid === 4326 || wkid === 4283) {
- featureInfo.position = Cartographic.fromDegrees(
- feature.geometry.x,
- feature.geometry.y,
- feature.geometry.z
- );
- } else if (wkid === 102100 || wkid === 900913 || wkid === 3857) {
- const projection = new WebMercatorProjection();
- featureInfo.position = projection.unproject(
- new Cartesian3(
- feature.geometry.x,
- feature.geometry.y,
- feature.geometry.z
- )
- );
- }
- }
- result.push(featureInfo);
- }
- return result;
- });
- };
- export default ArcGisMapServerImageryProvider;
|