123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856 |
- import buildModuleUrl from "../Core/buildModuleUrl.js";
- import Check from "../Core/Check.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 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 WebMercatorTilingScheme from "../Core/WebMercatorTilingScheme.js";
- import BingMapsStyle from "./BingMapsStyle.js";
- import DiscardEmptyTilePolicy from "./DiscardEmptyTileImagePolicy.js";
- import ImageryProvider from "./ImageryProvider.js";
- /**
- * @typedef {Object} BingMapsImageryProvider.ConstructorOptions
- *
- * Initialization options for the BingMapsImageryProvider constructor
- *
- * @property {Resource|String} url The url of the Bing Maps server hosting the imagery.
- * @property {String} key The Bing Maps key for your application, which can be
- * created at {@link https://www.bingmapsportal.com/}.
- * @property {String} [tileProtocol] The protocol to use when loading tiles, e.g. 'http' or 'https'.
- * By default, tiles are loaded using the same protocol as the page.
- * @property {BingMapsStyle} [mapStyle=BingMapsStyle.AERIAL] The type of Bing Maps imagery to load.
- * @property {String} [culture=''] The culture to use when requesting Bing Maps imagery. Not
- * all cultures are supported. See {@link http://msdn.microsoft.com/en-us/library/hh441729.aspx}
- * for information on the supported cultures.
- * @property {Ellipsoid} [ellipsoid] The ellipsoid. If not specified, the WGS84 ellipsoid is used.
- * @property {TileDiscardPolicy} [tileDiscardPolicy] The policy that determines if a tile
- * is invalid and should be discarded. By default, a {@link DiscardEmptyTileImagePolicy}
- * will be used, with the expectation that the Bing Maps server will send a zero-length response for missing tiles.
- * To ensure that no tiles are discarded, construct and pass a {@link NeverTileDiscardPolicy} for this parameter.
- */
- /**
- * Provides tiled imagery using the Bing Maps Imagery REST API.
- *
- * @alias BingMapsImageryProvider
- * @constructor
- *
- * @param {BingMapsImageryProvider.ConstructorOptions} options Object describing initialization options
- *
- * @see ArcGisMapServerImageryProvider
- * @see GoogleEarthEnterpriseMapsProvider
- * @see OpenStreetMapImageryProvider
- * @see SingleTileImageryProvider
- * @see TileMapServiceImageryProvider
- * @see WebMapServiceImageryProvider
- * @see WebMapTileServiceImageryProvider
- * @see UrlTemplateImageryProvider
- *
- *
- * @example
- * const bing = new Cesium.BingMapsImageryProvider({
- * url : 'https://dev.virtualearth.net',
- * key : 'get-yours-at-https://www.bingmapsportal.com/',
- * mapStyle : Cesium.BingMapsStyle.AERIAL
- * });
- *
- * @see {@link http://msdn.microsoft.com/en-us/library/ff701713.aspx|Bing Maps REST Services}
- * @see {@link http://www.w3.org/TR/cors/|Cross-Origin Resource Sharing}
- */
- function BingMapsImageryProvider(options) {
- options = defaultValue(options, defaultValue.EMPTY_OBJECT);
- const accessKey = options.key;
- //>>includeStart('debug', pragmas.debug);
- if (!defined(options.url)) {
- throw new DeveloperError("options.url is required.");
- }
- if (!defined(accessKey)) {
- throw new DeveloperError("options.key 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 1.0
- */
- this.defaultGamma = 1.0;
- /**
- * 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;
- this._key = accessKey;
- this._resource = Resource.createIfNeeded(options.url);
- this._resource.appendForwardSlash();
- this._tileProtocol = options.tileProtocol;
- this._mapStyle = defaultValue(options.mapStyle, BingMapsStyle.AERIAL);
- this._culture = defaultValue(options.culture, "");
- this._tileDiscardPolicy = options.tileDiscardPolicy;
- if (!defined(this._tileDiscardPolicy)) {
- this._tileDiscardPolicy = new DiscardEmptyTilePolicy();
- }
- this._proxy = options.proxy;
- this._credit = new Credit(
- `<a href="http://www.bing.com"><img src="${BingMapsImageryProvider.logoUrl}" title="Bing Imagery"/></a>`
- );
- this._tilingScheme = new WebMercatorTilingScheme({
- numberOfLevelZeroTilesX: 2,
- numberOfLevelZeroTilesY: 2,
- ellipsoid: options.ellipsoid,
- });
- this._tileWidth = undefined;
- this._tileHeight = undefined;
- this._maximumLevel = undefined;
- this._imageUrlTemplate = undefined;
- this._imageUrlSubdomains = undefined;
- this._errorEvent = new Event();
- this._ready = false;
- this._readyPromise = defer();
- let tileProtocol = this._tileProtocol;
- // For backward compatibility reasons, the tileProtocol may end with
- // a `:`. Remove it.
- if (defined(tileProtocol)) {
- if (
- tileProtocol.length > 0 &&
- tileProtocol[tileProtocol.length - 1] === ":"
- ) {
- tileProtocol = tileProtocol.substr(0, tileProtocol.length - 1);
- }
- } else {
- // use http if the document's protocol is http, otherwise use https
- const documentProtocol = document.location.protocol;
- tileProtocol = documentProtocol === "http:" ? "http" : "https";
- }
- const metadataResource = this._resource.getDerivedResource({
- url: `REST/v1/Imagery/Metadata/${this._mapStyle}`,
- queryParameters: {
- incl: "ImageryProviders",
- key: this._key,
- uriScheme: tileProtocol,
- },
- });
- const that = this;
- let metadataError;
- function metadataSuccess(data) {
- if (data.resourceSets.length !== 1) {
- metadataFailure();
- return;
- }
- const resource = data.resourceSets[0].resources[0];
- that._tileWidth = resource.imageWidth;
- that._tileHeight = resource.imageHeight;
- that._maximumLevel = resource.zoomMax - 1;
- that._imageUrlSubdomains = resource.imageUrlSubdomains;
- that._imageUrlTemplate = resource.imageUrl;
- let attributionList = (that._attributionList = resource.imageryProviders);
- if (!attributionList) {
- attributionList = that._attributionList = [];
- }
- for (
- let attributionIndex = 0, attributionLength = attributionList.length;
- attributionIndex < attributionLength;
- ++attributionIndex
- ) {
- const attribution = attributionList[attributionIndex];
- if (attribution.credit instanceof Credit) {
- // If attribution.credit has already been created
- // then we are using a cached value, which means
- // none of the remaining processing needs to be done.
- break;
- }
- attribution.credit = new Credit(attribution.attribution);
- const coverageAreas = attribution.coverageAreas;
- for (
- let areaIndex = 0, areaLength = attribution.coverageAreas.length;
- areaIndex < areaLength;
- ++areaIndex
- ) {
- const area = coverageAreas[areaIndex];
- const bbox = area.bbox;
- area.bbox = new Rectangle(
- CesiumMath.toRadians(bbox[1]),
- CesiumMath.toRadians(bbox[0]),
- CesiumMath.toRadians(bbox[3]),
- CesiumMath.toRadians(bbox[2])
- );
- }
- }
- that._ready = true;
- that._readyPromise.resolve(true);
- TileProviderError.handleSuccess(metadataError);
- }
- function metadataFailure(e) {
- const message = `An error occurred while accessing ${metadataResource.url}.`;
- metadataError = TileProviderError.handleError(
- metadataError,
- that,
- that._errorEvent,
- message,
- undefined,
- undefined,
- undefined,
- requestMetadata
- );
- that._readyPromise.reject(new RuntimeError(message));
- }
- const cacheKey = metadataResource.url;
- function requestMetadata() {
- const promise = metadataResource.fetchJsonp("jsonp");
- BingMapsImageryProvider._metadataCache[cacheKey] = promise;
- promise.then(metadataSuccess).catch(metadataFailure);
- }
- const promise = BingMapsImageryProvider._metadataCache[cacheKey];
- if (defined(promise)) {
- promise.then(metadataSuccess).catch(metadataFailure);
- } else {
- requestMetadata();
- }
- }
- Object.defineProperties(BingMapsImageryProvider.prototype, {
- /**
- * Gets the name of the BingMaps server url hosting the imagery.
- * @memberof BingMapsImageryProvider.prototype
- * @type {String}
- * @readonly
- */
- url: {
- get: function () {
- return this._resource.url;
- },
- },
- /**
- * Gets the proxy used by this provider.
- * @memberof BingMapsImageryProvider.prototype
- * @type {Proxy}
- * @readonly
- */
- proxy: {
- get: function () {
- return this._resource.proxy;
- },
- },
- /**
- * Gets the Bing Maps key.
- * @memberof BingMapsImageryProvider.prototype
- * @type {String}
- * @readonly
- */
- key: {
- get: function () {
- return this._key;
- },
- },
- /**
- * Gets the type of Bing Maps imagery to load.
- * @memberof BingMapsImageryProvider.prototype
- * @type {BingMapsStyle}
- * @readonly
- */
- mapStyle: {
- get: function () {
- return this._mapStyle;
- },
- },
- /**
- * The culture to use when requesting Bing Maps imagery. Not
- * all cultures are supported. See {@link http://msdn.microsoft.com/en-us/library/hh441729.aspx}
- * for information on the supported cultures.
- * @memberof BingMapsImageryProvider.prototype
- * @type {String}
- * @readonly
- */
- culture: {
- get: function () {
- return this._culture;
- },
- },
- /**
- * Gets the width of each tile, in pixels. This function should
- * not be called before {@link BingMapsImageryProvider#ready} returns true.
- * @memberof BingMapsImageryProvider.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 BingMapsImageryProvider#ready} returns true.
- * @memberof BingMapsImageryProvider.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 BingMapsImageryProvider#ready} returns true.
- * @memberof BingMapsImageryProvider.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 BingMapsImageryProvider#ready} returns true.
- * @memberof BingMapsImageryProvider.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 BingMapsImageryProvider#ready} returns true.
- * @memberof BingMapsImageryProvider.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 BingMapsImageryProvider#ready} returns true.
- * @memberof BingMapsImageryProvider.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._tilingScheme.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 BingMapsImageryProvider#ready} returns true.
- * @memberof BingMapsImageryProvider.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 BingMapsImageryProvider.prototype
- * @type {Event}
- * @readonly
- */
- errorEvent: {
- get: function () {
- return this._errorEvent;
- },
- },
- /**
- * Gets a value indicating whether or not the provider is ready for use.
- * @memberof BingMapsImageryProvider.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 BingMapsImageryProvider.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 BingMapsImageryProvider#ready} returns true.
- * @memberof BingMapsImageryProvider.prototype
- * @type {Credit}
- * @readonly
- */
- credit: {
- get: function () {
- return this._credit;
- },
- },
- /**
- * 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. Setting this property to false reduces memory usage
- * and texture upload time.
- * @memberof BingMapsImageryProvider.prototype
- * @type {Boolean}
- * @readonly
- */
- hasAlphaChannel: {
- get: function () {
- return false;
- },
- },
- });
- const rectangleScratch = new Rectangle();
- /**
- * 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.
- */
- BingMapsImageryProvider.prototype.getTileCredits = function (x, y, level) {
- //>>includeStart('debug', pragmas.debug);
- if (!this._ready) {
- throw new DeveloperError(
- "getTileCredits must not be called before the imagery provider is ready."
- );
- }
- //>>includeEnd('debug');
- const rectangle = this._tilingScheme.tileXYToRectangle(
- x,
- y,
- level,
- rectangleScratch
- );
- const result = getRectangleAttribution(
- this._attributionList,
- level,
- rectangle
- );
- return result;
- };
- /**
- * Requests the image for a given tile. This function should
- * not be called before {@link BingMapsImageryProvider#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.
- */
- BingMapsImageryProvider.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');
- const promise = ImageryProvider.loadImage(
- this,
- buildImageResource(this, x, y, level, request)
- );
- if (defined(promise)) {
- return promise.catch(function (error) {
- // One cause of an error here is that the image we tried to load was zero-length.
- // This isn't actually a problem, since it indicates that there is no tile.
- // So, in that case we return the EMPTY_IMAGE sentinel value for later discarding.
- if (defined(error.blob) && error.blob.size === 0) {
- return DiscardEmptyTilePolicy.EMPTY_IMAGE;
- }
- return Promise.reject(error);
- });
- }
- return undefined;
- };
- /**
- * Picking features is not currently supported by this imagery provider, so this function simply returns
- * undefined.
- *
- * @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 {undefined} Undefined since picking is not supported.
- */
- BingMapsImageryProvider.prototype.pickFeatures = function (
- x,
- y,
- level,
- longitude,
- latitude
- ) {
- return undefined;
- };
- /**
- * Converts a tiles (x, y, level) position into a quadkey used to request an image
- * from a Bing Maps server.
- *
- * @param {Number} x The tile's x coordinate.
- * @param {Number} y The tile's y coordinate.
- * @param {Number} level The tile's zoom level.
- *
- * @see {@link http://msdn.microsoft.com/en-us/library/bb259689.aspx|Bing Maps Tile System}
- * @see BingMapsImageryProvider#quadKeyToTileXY
- */
- BingMapsImageryProvider.tileXYToQuadKey = function (x, y, level) {
- let quadkey = "";
- for (let i = level; i >= 0; --i) {
- const bitmask = 1 << i;
- let digit = 0;
- if ((x & bitmask) !== 0) {
- digit |= 1;
- }
- if ((y & bitmask) !== 0) {
- digit |= 2;
- }
- quadkey += digit;
- }
- return quadkey;
- };
- /**
- * Converts a tile's quadkey used to request an image from a Bing Maps server into the
- * (x, y, level) position.
- *
- * @param {String} quadkey The tile's quad key
- *
- * @see {@link http://msdn.microsoft.com/en-us/library/bb259689.aspx|Bing Maps Tile System}
- * @see BingMapsImageryProvider#tileXYToQuadKey
- */
- BingMapsImageryProvider.quadKeyToTileXY = function (quadkey) {
- let x = 0;
- let y = 0;
- const level = quadkey.length - 1;
- for (let i = level; i >= 0; --i) {
- const bitmask = 1 << i;
- const digit = +quadkey[level - i];
- if ((digit & 1) !== 0) {
- x |= bitmask;
- }
- if ((digit & 2) !== 0) {
- y |= bitmask;
- }
- }
- return {
- x: x,
- y: y,
- level: level,
- };
- };
- BingMapsImageryProvider._logoUrl = undefined;
- Object.defineProperties(BingMapsImageryProvider, {
- /**
- * Gets or sets the URL to the Bing logo for display in the credit.
- * @memberof BingMapsImageryProvider
- * @type {String}
- */
- logoUrl: {
- get: function () {
- if (!defined(BingMapsImageryProvider._logoUrl)) {
- BingMapsImageryProvider._logoUrl = buildModuleUrl(
- "Assets/Images/bing_maps_credit.png"
- );
- }
- return BingMapsImageryProvider._logoUrl;
- },
- set: function (value) {
- //>>includeStart('debug', pragmas.debug);
- Check.defined("value", value);
- //>>includeEnd('debug');
- BingMapsImageryProvider._logoUrl = value;
- },
- },
- });
- function buildImageResource(imageryProvider, x, y, level, request) {
- const imageUrl = imageryProvider._imageUrlTemplate;
- const subdomains = imageryProvider._imageUrlSubdomains;
- const subdomainIndex = (x + y + level) % subdomains.length;
- return imageryProvider._resource.getDerivedResource({
- url: imageUrl,
- request: request,
- templateValues: {
- quadkey: BingMapsImageryProvider.tileXYToQuadKey(x, y, level),
- subdomain: subdomains[subdomainIndex],
- culture: imageryProvider._culture,
- },
- queryParameters: {
- // this parameter tells the Bing servers to send a zero-length response
- // instead of a placeholder image for missing tiles.
- n: "z",
- },
- });
- }
- const intersectionScratch = new Rectangle();
- function getRectangleAttribution(attributionList, level, rectangle) {
- // Bing levels start at 1, while ours start at 0.
- ++level;
- const result = [];
- for (
- let attributionIndex = 0, attributionLength = attributionList.length;
- attributionIndex < attributionLength;
- ++attributionIndex
- ) {
- const attribution = attributionList[attributionIndex];
- const coverageAreas = attribution.coverageAreas;
- let included = false;
- for (
- let areaIndex = 0, areaLength = attribution.coverageAreas.length;
- !included && areaIndex < areaLength;
- ++areaIndex
- ) {
- const area = coverageAreas[areaIndex];
- if (level >= area.zoomMin && level <= area.zoomMax) {
- const intersection = Rectangle.intersection(
- rectangle,
- area.bbox,
- intersectionScratch
- );
- if (defined(intersection)) {
- included = true;
- }
- }
- }
- if (included) {
- result.push(attribution.credit);
- }
- }
- return result;
- }
- // Exposed for testing
- BingMapsImageryProvider._metadataCache = {};
- export default BingMapsImageryProvider;
|