| 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;
 |