123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368 |
- import Cartesian2 from "../Core/Cartesian2.js";
- import Cartesian3 from "../Core/Cartesian3.js";
- import Cartographic from "../Core/Cartographic.js";
- import Check from "../Core/Check.js";
- import combine from "../Core/combine.js";
- import Credit from "../Core/Credit.js";
- import defaultValue from "../Core/defaultValue.js";
- import defined from "../Core/defined.js";
- import deprecationWarning from "../Core/deprecationWarning.js";
- import DeveloperError from "../Core/DeveloperError.js";
- import Event from "../Core/Event.js";
- import GeographicProjection from "../Core/GeographicProjection.js";
- import CesiumMath from "../Core/Math.js";
- import Rectangle from "../Core/Rectangle.js";
- import Resource from "../Core/Resource.js";
- import WebMercatorTilingScheme from "../Core/WebMercatorTilingScheme.js";
- import ImageryProvider from "./ImageryProvider.js";
- const templateRegex = /{[^}]+}/g;
- const tags = {
- x: xTag,
- y: yTag,
- z: zTag,
- s: sTag,
- reverseX: reverseXTag,
- reverseY: reverseYTag,
- reverseZ: reverseZTag,
- westDegrees: westDegreesTag,
- southDegrees: southDegreesTag,
- eastDegrees: eastDegreesTag,
- northDegrees: northDegreesTag,
- westProjected: westProjectedTag,
- southProjected: southProjectedTag,
- eastProjected: eastProjectedTag,
- northProjected: northProjectedTag,
- width: widthTag,
- height: heightTag,
- };
- const pickFeaturesTags = combine(tags, {
- i: iTag,
- j: jTag,
- reverseI: reverseITag,
- reverseJ: reverseJTag,
- longitudeDegrees: longitudeDegreesTag,
- latitudeDegrees: latitudeDegreesTag,
- longitudeProjected: longitudeProjectedTag,
- latitudeProjected: latitudeProjectedTag,
- format: formatTag,
- });
- /**
- * @typedef {object} UrlTemplateImageryProvider.ConstructorOptions
- *
- * Initialization options for the UrlTemplateImageryProvider constructor
- *
- * @property {Promise<object>|object} [options] Object with the following properties:
- * @property {Resource|string} url The URL template to use to request tiles. It has the following keywords:
- * <ul>
- * <li><code>{z}</code>: The level of the tile in the tiling scheme. Level zero is the root of the quadtree pyramid.</li>
- * <li><code>{x}</code>: The tile X coordinate in the tiling scheme, where 0 is the Westernmost tile.</li>
- * <li><code>{y}</code>: The tile Y coordinate in the tiling scheme, where 0 is the Northernmost tile.</li>
- * <li><code>{s}</code>: One of the available subdomains, used to overcome browser limits on the number of simultaneous requests per host.</li>
- * <li><code>{reverseX}</code>: The tile X coordinate in the tiling scheme, where 0 is the Easternmost tile.</li>
- * <li><code>{reverseY}</code>: The tile Y coordinate in the tiling scheme, where 0 is the Southernmost tile.</li>
- * <li><code>{reverseZ}</code>: The level of the tile in the tiling scheme, where level zero is the maximum level of the quadtree pyramid. In order to use reverseZ, maximumLevel must be defined.</li>
- * <li><code>{westDegrees}</code>: The Western edge of the tile in geodetic degrees.</li>
- * <li><code>{southDegrees}</code>: The Southern edge of the tile in geodetic degrees.</li>
- * <li><code>{eastDegrees}</code>: The Eastern edge of the tile in geodetic degrees.</li>
- * <li><code>{northDegrees}</code>: The Northern edge of the tile in geodetic degrees.</li>
- * <li><code>{westProjected}</code>: The Western edge of the tile in projected coordinates of the tiling scheme.</li>
- * <li><code>{southProjected}</code>: The Southern edge of the tile in projected coordinates of the tiling scheme.</li>
- * <li><code>{eastProjected}</code>: The Eastern edge of the tile in projected coordinates of the tiling scheme.</li>
- * <li><code>{northProjected}</code>: The Northern edge of the tile in projected coordinates of the tiling scheme.</li>
- * <li><code>{width}</code>: The width of each tile in pixels.</li>
- * <li><code>{height}</code>: The height of each tile in pixels.</li>
- * </ul>
- * @property {Resource|string} [pickFeaturesUrl] The URL template to use to pick features. If this property is not specified,
- * {@link UrlTemplateImageryProvider#pickFeatures} will immediately returned undefined, indicating no
- * features picked. The URL template supports all of the keywords supported by the <code>url</code>
- * parameter, plus the following:
- * <ul>
- * <li><code>{i}</code>: The pixel column (horizontal coordinate) of the picked position, where the Westernmost pixel is 0.</li>
- * <li><code>{j}</code>: The pixel row (vertical coordinate) of the picked position, where the Northernmost pixel is 0.</li>
- * <li><code>{reverseI}</code>: The pixel column (horizontal coordinate) of the picked position, where the Easternmost pixel is 0.</li>
- * <li><code>{reverseJ}</code>: The pixel row (vertical coordinate) of the picked position, where the Southernmost pixel is 0.</li>
- * <li><code>{longitudeDegrees}</code>: The longitude of the picked position in degrees.</li>
- * <li><code>{latitudeDegrees}</code>: The latitude of the picked position in degrees.</li>
- * <li><code>{longitudeProjected}</code>: The longitude of the picked position in the projected coordinates of the tiling scheme.</li>
- * <li><code>{latitudeProjected}</code>: The latitude of the picked position in the projected coordinates of the tiling scheme.</li>
- * <li><code>{format}</code>: The format in which to get feature information, as specified in the {@link GetFeatureInfoFormat}.</li>
- * </ul>
- * @property {object} [urlSchemeZeroPadding] Gets the URL scheme zero padding for each tile coordinate. The format is '000' where
- * each coordinate will be padded on the left with zeros to match the width of the passed string of zeros. e.g. Setting:
- * urlSchemeZeroPadding : { '{x}' : '0000'}
- * will cause an 'x' value of 12 to return the string '0012' for {x} in the generated URL.
- * It the passed object has the following keywords:
- * <ul>
- * <li> <code>{z}</code>: The zero padding for the level of the tile in the tiling scheme.</li>
- * <li> <code>{x}</code>: The zero padding for the tile X coordinate in the tiling scheme.</li>
- * <li> <code>{y}</code>: The zero padding for the the tile Y coordinate in the tiling scheme.</li>
- * <li> <code>{reverseX}</code>: The zero padding for the tile reverseX coordinate in the tiling scheme.</li>
- * <li> <code>{reverseY}</code>: The zero padding for the tile reverseY coordinate in the tiling scheme.</li>
- * <li> <code>{reverseZ}</code>: The zero padding for the reverseZ coordinate of the tile in the tiling scheme.</li>
- * </ul>
- * @property {string|string[]} [subdomains='abc'] The subdomains to use for the <code>{s}</code> placeholder in the URL template.
- * If this parameter is a single string, each character in the string is a subdomain. If it is
- * an array, each element in the array is a subdomain.
- * @property {Credit|string} [credit=''] A credit for the data source, which is displayed on the canvas.
- * @property {number} [minimumLevel=0] The minimum level-of-detail supported by the imagery provider. Take care when specifying
- * this that the number of tiles at the minimum level is small, such as four or less. A larger number is likely
- * to result in rendering problems.
- * @property {number} [maximumLevel] The maximum level-of-detail supported by the imagery provider, or undefined if there is no limit.
- * @property {Rectangle} [rectangle=Rectangle.MAX_VALUE] The rectangle, in radians, covered by the image.
- * @property {TilingScheme} [tilingScheme=WebMercatorTilingScheme] The tiling scheme specifying how the ellipsoidal
- * surface is broken into tiles. If this parameter is not provided, a {@link WebMercatorTilingScheme}
- * is used.
- * @property {Ellipsoid} [ellipsoid] The ellipsoid. If the tilingScheme is specified,
- * this parameter is ignored and the tiling scheme's ellipsoid is used instead. If neither
- * parameter is specified, the WGS84 ellipsoid is used.
- * @property {number} [tileWidth=256] Pixel width of image tiles.
- * @property {number} [tileHeight=256] Pixel height of image tiles.
- * @property {boolean} [hasAlphaChannel=true] true if the images provided by this imagery provider
- * include an alpha channel; otherwise, false. 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 potentially reduced.
- * @property {GetFeatureInfoFormat[]} [getFeatureInfoFormats] The formats in which to get feature information at a
- * specific location when {@link UrlTemplateImageryProvider#pickFeatures} is invoked. If this
- * parameter is not specified, feature picking is disabled.
- * @property {boolean} [enablePickFeatures=true] If true, {@link UrlTemplateImageryProvider#pickFeatures} will
- * request the <code>pickFeaturesUrl</code> and attempt to interpret the features included in the response. If false,
- * {@link UrlTemplateImageryProvider#pickFeatures} will immediately return undefined (indicating no pickable
- * features) without communicating with the server. Set this property to false if you know your data
- * source does not support picking features or if you don't want this provider's features to be pickable. Note
- * that this can be dynamically overridden by modifying the {@link UriTemplateImageryProvider#enablePickFeatures}
- * property.
- * @property {TileDiscardPolicy} [tileDiscardPolicy] A policy for discarding tile images according to some criteria
- * @property {Object} [customTags] Allow to replace custom keywords in the URL template. The object must have strings as keys and functions as values.
- */
- /**
- * Provides imagery by requesting tiles using a specified URL template.
- *
- * @alias UrlTemplateImageryProvider
- * @constructor
- *
- * @param {UrlTemplateImageryProvider.ConstructorOptions} options Object describing initialization options
- *
- * @example
- * // Access Natural Earth II imagery, which uses a TMS tiling scheme and Geographic (EPSG:4326) project
- * const tms = new Cesium.UrlTemplateImageryProvider({
- * url : Cesium.buildModuleUrl('Assets/Textures/NaturalEarthII') + '/{z}/{x}/{reverseY}.jpg',
- * tilingScheme : new Cesium.GeographicTilingScheme(),
- * maximumLevel : 5
- * });
- * // Access the CartoDB Positron basemap, which uses an OpenStreetMap-like tiling scheme.
- * const positron = new Cesium.UrlTemplateImageryProvider({
- * url : 'http://{s}.basemaps.cartocdn.com/light_all/{z}/{x}/{y}.png',
- * credit : 'Map tiles by CartoDB, under CC BY 3.0. Data by OpenStreetMap, under ODbL.'
- * });
- * // Access a Web Map Service (WMS) server.
- * const wms = new Cesium.UrlTemplateImageryProvider({
- * url : 'https://programs.communications.gov.au/geoserver/ows?tiled=true&' +
- * 'transparent=true&format=image%2Fpng&exceptions=application%2Fvnd.ogc.se_xml&' +
- * 'styles=&service=WMS&version=1.1.1&request=GetMap&' +
- * 'layers=public%3AMyBroadband_Availability&srs=EPSG%3A3857&' +
- * 'bbox={westProjected}%2C{southProjected}%2C{eastProjected}%2C{northProjected}&' +
- * 'width=256&height=256',
- * rectangle : Cesium.Rectangle.fromDegrees(96.799393, -43.598214999057824, 153.63925700000001, -9.2159219997013)
- * });
- * // Using custom tags in your template url.
- * const custom = new Cesium.UrlTemplateImageryProvider({
- * url : 'https://yoururl/{Time}/{z}/{y}/{x}.png',
- * customTags : {
- * Time: function(imageryProvider, x, y, level) {
- * return '20171231'
- * }
- * }
- * });
- *
- * @see ArcGisMapServerImageryProvider
- * @see BingMapsImageryProvider
- * @see GoogleEarthEnterpriseMapsProvider
- * @see OpenStreetMapImageryProvider
- * @see SingleTileImageryProvider
- * @see TileMapServiceImageryProvider
- * @see WebMapServiceImageryProvider
- * @see WebMapTileServiceImageryProvider
- */
- function UrlTemplateImageryProvider(options) {
- options = defaultValue(options, defaultValue.EMPTY_OBJECT);
- this._errorEvent = new Event();
- if (defined(options.then)) {
- this._reinitialize(options);
- return;
- }
- //>>includeStart('debug', pragmas.debug);
- Check.defined("options.url", options.url);
- //>>includeEnd('debug');
- const resource = Resource.createIfNeeded(options.url);
- const pickFeaturesResource = Resource.createIfNeeded(options.pickFeaturesUrl);
- this._resource = resource;
- this._urlSchemeZeroPadding = options.urlSchemeZeroPadding;
- this._getFeatureInfoFormats = options.getFeatureInfoFormats;
- this._pickFeaturesResource = pickFeaturesResource;
- let subdomains = options.subdomains;
- if (Array.isArray(subdomains)) {
- subdomains = subdomains.slice();
- } else if (defined(subdomains) && subdomains.length > 0) {
- subdomains = subdomains.split("");
- } else {
- subdomains = ["a", "b", "c"];
- }
- this._subdomains = subdomains;
- this._tileWidth = defaultValue(options.tileWidth, 256);
- this._tileHeight = defaultValue(options.tileHeight, 256);
- this._minimumLevel = defaultValue(options.minimumLevel, 0);
- this._maximumLevel = options.maximumLevel;
- this._tilingScheme = defaultValue(
- options.tilingScheme,
- new WebMercatorTilingScheme({ ellipsoid: options.ellipsoid })
- );
- this._rectangle = defaultValue(
- options.rectangle,
- this._tilingScheme.rectangle
- );
- this._rectangle = Rectangle.intersection(
- this._rectangle,
- this._tilingScheme.rectangle
- );
- this._tileDiscardPolicy = options.tileDiscardPolicy;
- let credit = options.credit;
- if (typeof credit === "string") {
- credit = new Credit(credit);
- }
- this._credit = credit;
- this._hasAlphaChannel = defaultValue(options.hasAlphaChannel, true);
- const customTags = options.customTags;
- const allTags = combine(tags, customTags);
- const allPickFeaturesTags = combine(pickFeaturesTags, customTags);
- this._tags = allTags;
- this._pickFeaturesTags = allPickFeaturesTags;
- this._readyPromise = Promise.resolve(true);
- this._ready = true;
- this._defaultAlpha = undefined;
- this._defaultNightAlpha = undefined;
- this._defaultDayAlpha = undefined;
- this._defaultBrightness = undefined;
- this._defaultContrast = undefined;
- this._defaultHue = undefined;
- this._defaultSaturation = undefined;
- this._defaultGamma = undefined;
- this._defaultMinificationFilter = undefined;
- this._defaultMagnificationFilter = undefined;
- /**
- * Gets or sets a value indicating whether feature picking is enabled. If true, {@link UrlTemplateImageryProvider#pickFeatures} will
- * request the <code>options.pickFeaturesUrl</code> and attempt to interpret the features included in the response. If false,
- * {@link UrlTemplateImageryProvider#pickFeatures} will immediately return undefined (indicating no pickable
- * features) without communicating with the server. Set this property to false if you know your data
- * source does not support picking features or if you don't want this provider's features to be pickable.
- * @type {boolean}
- * @default true
- */
- this.enablePickFeatures = defaultValue(options.enablePickFeatures, true);
- }
- Object.defineProperties(UrlTemplateImageryProvider.prototype, {
- /**
- * Gets the URL template to use to request tiles. It has the following keywords:
- * <ul>
- * <li> <code>{z}</code>: The level of the tile in the tiling scheme. Level zero is the root of the quadtree pyramid.</li>
- * <li> <code>{x}</code>: The tile X coordinate in the tiling scheme, where 0 is the Westernmost tile.</li>
- * <li> <code>{y}</code>: The tile Y coordinate in the tiling scheme, where 0 is the Northernmost tile.</li>
- * <li> <code>{s}</code>: One of the available subdomains, used to overcome browser limits on the number of simultaneous requests per host.</li>
- * <li> <code>{reverseX}</code>: The tile X coordinate in the tiling scheme, where 0 is the Easternmost tile.</li>
- * <li> <code>{reverseY}</code>: The tile Y coordinate in the tiling scheme, where 0 is the Southernmost tile.</li>
- * <li> <code>{reverseZ}</code>: The level of the tile in the tiling scheme, where level zero is the maximum level of the quadtree pyramid. In order to use reverseZ, maximumLevel must be defined.</li>
- * <li> <code>{westDegrees}</code>: The Western edge of the tile in geodetic degrees.</li>
- * <li> <code>{southDegrees}</code>: The Southern edge of the tile in geodetic degrees.</li>
- * <li> <code>{eastDegrees}</code>: The Eastern edge of the tile in geodetic degrees.</li>
- * <li> <code>{northDegrees}</code>: The Northern edge of the tile in geodetic degrees.</li>
- * <li> <code>{westProjected}</code>: The Western edge of the tile in projected coordinates of the tiling scheme.</li>
- * <li> <code>{southProjected}</code>: The Southern edge of the tile in projected coordinates of the tiling scheme.</li>
- * <li> <code>{eastProjected}</code>: The Eastern edge of the tile in projected coordinates of the tiling scheme.</li>
- * <li> <code>{northProjected}</code>: The Northern edge of the tile in projected coordinates of the tiling scheme.</li>
- * <li> <code>{width}</code>: The width of each tile in pixels.</li>
- * <li> <code>{height}</code>: The height of each tile in pixels.</li>
- * </ul>
- * @memberof UrlTemplateImageryProvider.prototype
- * @type {string}
- * @readonly
- */
- url: {
- get: function () {
- return this._resource.url;
- },
- },
- /**
- * Gets the URL scheme zero padding for each tile coordinate. The format is '000' where each coordinate will be padded on
- * the left with zeros to match the width of the passed string of zeros. e.g. Setting:
- * urlSchemeZeroPadding : { '{x}' : '0000'}
- * will cause an 'x' value of 12 to return the string '0012' for {x} in the generated URL.
- * It has the following keywords:
- * <ul>
- * <li> <code>{z}</code>: The zero padding for the level of the tile in the tiling scheme.</li>
- * <li> <code>{x}</code>: The zero padding for the tile X coordinate in the tiling scheme.</li>
- * <li> <code>{y}</code>: The zero padding for the the tile Y coordinate in the tiling scheme.</li>
- * <li> <code>{reverseX}</code>: The zero padding for the tile reverseX coordinate in the tiling scheme.</li>
- * <li> <code>{reverseY}</code>: The zero padding for the tile reverseY coordinate in the tiling scheme.</li>
- * <li> <code>{reverseZ}</code>: The zero padding for the reverseZ coordinate of the tile in the tiling scheme.</li>
- * </ul>
- * @memberof UrlTemplateImageryProvider.prototype
- * @type {object}
- * @readonly
- */
- urlSchemeZeroPadding: {
- get: function () {
- return this._urlSchemeZeroPadding;
- },
- },
- /**
- * Gets the URL template to use to use to pick features. If this property is not specified,
- * {@link UrlTemplateImageryProvider#pickFeatures} will immediately return undefined, indicating no
- * features picked. The URL template supports all of the keywords supported by the
- * {@link UrlTemplateImageryProvider#url} property, plus the following:
- * <ul>
- * <li><code>{i}</code>: The pixel column (horizontal coordinate) of the picked position, where the Westernmost pixel is 0.</li>
- * <li><code>{j}</code>: The pixel row (vertical coordinate) of the picked position, where the Northernmost pixel is 0.</li>
- * <li><code>{reverseI}</code>: The pixel column (horizontal coordinate) of the picked position, where the Easternmost pixel is 0.</li>
- * <li><code>{reverseJ}</code>: The pixel row (vertical coordinate) of the picked position, where the Southernmost pixel is 0.</li>
- * <li><code>{longitudeDegrees}</code>: The longitude of the picked position in degrees.</li>
- * <li><code>{latitudeDegrees}</code>: The latitude of the picked position in degrees.</li>
- * <li><code>{longitudeProjected}</code>: The longitude of the picked position in the projected coordinates of the tiling scheme.</li>
- * <li><code>{latitudeProjected}</code>: The latitude of the picked position in the projected coordinates of the tiling scheme.</li>
- * <li><code>{format}</code>: The format in which to get feature information, as specified in the {@link GetFeatureInfoFormat}.</li>
- * </ul>
- * @memberof UrlTemplateImageryProvider.prototype
- * @type {string}
- * @readonly
- */
- pickFeaturesUrl: {
- get: function () {
- return this._pickFeaturesResource.url;
- },
- },
- /**
- * Gets the proxy used by this provider.
- * @memberof UrlTemplateImageryProvider.prototype
- * @type {Proxy}
- * @readonly
- * @default undefined
- */
- proxy: {
- get: function () {
- return this._resource.proxy;
- },
- },
- /**
- * Gets the width of each tile, in pixels.
- * @memberof UrlTemplateImageryProvider.prototype
- * @type {number}
- * @readonly
- * @default 256
- */
- tileWidth: {
- get: function () {
- return this._tileWidth;
- },
- },
- /**
- * Gets the height of each tile, in pixels.
- * @memberof UrlTemplateImageryProvider.prototype
- * @type {number}
- * @readonly
- * @default 256
- */
- tileHeight: {
- get: function () {
- return this._tileHeight;
- },
- },
- /**
- * Gets the maximum level-of-detail that can be requested, or undefined if there is no limit.
- * @memberof UrlTemplateImageryProvider.prototype
- * @type {number|undefined}
- * @readonly
- * @default undefined
- */
- maximumLevel: {
- get: function () {
- return this._maximumLevel;
- },
- },
- /**
- * Gets the minimum level-of-detail that can be requested.
- * @memberof UrlTemplateImageryProvider.prototype
- * @type {number}
- * @readonly
- * @default 0
- */
- minimumLevel: {
- get: function () {
- return this._minimumLevel;
- },
- },
- /**
- * Gets the tiling scheme used by this provider.
- * @memberof UrlTemplateImageryProvider.prototype
- * @type {TilingScheme}
- * @readonly
- * @default new WebMercatorTilingScheme()
- */
- tilingScheme: {
- get: function () {
- return this._tilingScheme;
- },
- },
- /**
- * Gets the rectangle, in radians, of the imagery provided by this instance.
- * @memberof UrlTemplateImageryProvider.prototype
- * @type {Rectangle}
- * @readonly
- * @default tilingScheme.rectangle
- */
- rectangle: {
- get: function () {
- 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.
- * @memberof UrlTemplateImageryProvider.prototype
- * @type {TileDiscardPolicy}
- * @readonly
- * @default undefined
- */
- tileDiscardPolicy: {
- get: function () {
- 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 UrlTemplateImageryProvider.prototype
- * @type {Event}
- * @readonly
- */
- errorEvent: {
- get: function () {
- return this._errorEvent;
- },
- },
- /**
- * Gets a value indicating whether or not the provider is ready for use.
- * @memberof UrlTemplateImageryProvider.prototype
- * @type {boolean}
- * @readonly
- * @deprecated
- */
- ready: {
- get: function () {
- deprecationWarning(
- "UrlTemplateImageryProvider.ready",
- "UrlTemplateImageryProvider.ready was deprecated in CesiumJS 1.104. It will be in CesiumJS 1.107."
- );
- return this._ready && defined(this._resource);
- },
- },
- /**
- * Gets a promise that resolves to true when the provider is ready for use.
- * @memberof UrlTemplateImageryProvider.prototype
- * @type {Promise<boolean>}
- * @readonly
- * @deprecated
- */
- readyPromise: {
- get: function () {
- deprecationWarning(
- "UrlTemplateImageryProvider.readyPromise",
- "UrlTemplateImageryProvider.readyPromise was deprecated in CesiumJS 1.104. It will be in CesiumJS 1.107."
- );
- return this._readyPromise;
- },
- },
- /**
- * Gets the credit to display when this imagery provider is active. Typically this is used to credit
- * the source of the imagery.
- * @memberof UrlTemplateImageryProvider.prototype
- * @type {Credit}
- * @readonly
- * @default undefined
- */
- 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. When this property is false, memory usage
- * and texture upload time are reduced.
- * @memberof UrlTemplateImageryProvider.prototype
- * @type {boolean}
- * @readonly
- * @default true
- */
- hasAlphaChannel: {
- get: function () {
- return this._hasAlphaChannel;
- },
- },
- /**
- * The default alpha blending value of this provider, with 0.0 representing fully transparent and
- * 1.0 representing fully opaque.
- * @memberof UrlTemplateImageryProvider.prototype
- * @type {Number|undefined}
- * @deprecated
- */
- defaultAlpha: {
- get: function () {
- deprecationWarning(
- "UrlTemplateImageryProvider.defaultAlpha",
- "UrlTemplateImageryProvider.defaultAlpha was deprecated in CesiumJS 1.104. It will be in CesiumJS 1.107. Use ImageryLayer.alpha instead."
- );
- return this._defaultAlpha;
- },
- set: function (value) {
- deprecationWarning(
- "UrlTemplateImageryProvider.defaultAlpha",
- "UrlTemplateImageryProvider.defaultAlpha was deprecated in CesiumJS 1.104. It will be in CesiumJS 1.107. Use ImageryLayer.alpha instead."
- );
- this._defaultAlpha = value;
- },
- },
- /**
- * 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.
- * @memberof UrlTemplateImageryProvider.prototype
- * @type {Number|undefined}
- * @deprecated
- */
- defaultNightAlpha: {
- get: function () {
- deprecationWarning(
- "UrlTemplateImageryProvider.defaultNightAlpha",
- "UrlTemplateImageryProvider.defaultNightAlpha was deprecated in CesiumJS 1.104. It will be in CesiumJS 1.107. Use ImageryLayer.nightAlpha instead."
- );
- return this._defaultNightAlpha;
- },
- set: function (value) {
- deprecationWarning(
- "UrlTemplateImageryProvider.defaultNightAlpha",
- "UrlTemplateImageryProvider.defaultNightAlpha was deprecated in CesiumJS 1.104. It will be in CesiumJS 1.107. Use ImageryLayer.nightAlpha instead."
- );
- this._defaultNightAlpha = value;
- },
- },
- /**
- * 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.
- * @memberof UrlTemplateImageryProvider.prototype
- * @type {Number|undefined}
- * @deprecated
- */
- defaultDayAlpha: {
- get: function () {
- deprecationWarning(
- "UrlTemplateImageryProvider.defaultDayAlpha",
- "UrlTemplateImageryProvider.defaultDayAlpha was deprecated in CesiumJS 1.104. It will be in CesiumJS 1.107. Use ImageryLayer.dayAlpha instead."
- );
- return this._defaultDayAlpha;
- },
- set: function (value) {
- deprecationWarning(
- "UrlTemplateImageryProvider.defaultDayAlpha",
- "UrlTemplateImageryProvider.defaultDayAlpha was deprecated in CesiumJS 1.104. It will be in CesiumJS 1.107. Use ImageryLayer.dayAlpha instead."
- );
- this._defaultDayAlpha = value;
- },
- },
- /**
- * 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.
- * @memberof UrlTemplateImageryProvider.prototype
- * @type {Number|undefined}
- * @deprecated
- */
- defaultBrightness: {
- get: function () {
- deprecationWarning(
- "UrlTemplateImageryProvider.defaultBrightness",
- "UrlTemplateImageryProvider.defaultBrightness was deprecated in CesiumJS 1.104. It will be in CesiumJS 1.107. Use ImageryLayer.brightness instead."
- );
- return this._defaultBrightness;
- },
- set: function (value) {
- deprecationWarning(
- "UrlTemplateImageryProvider.defaultBrightness",
- "UrlTemplateImageryProvider.defaultBrightness was deprecated in CesiumJS 1.104. It will be in CesiumJS 1.107. Use ImageryLayer.brightness instead."
- );
- this._defaultBrightness = value;
- },
- },
- /**
- * 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.
- * @memberof UrlTemplateImageryProvider.prototype
- * @type {Number|undefined}
- * @deprecated
- */
- defaultContrast: {
- get: function () {
- deprecationWarning(
- "UrlTemplateImageryProvider.defaultContrast",
- "UrlTemplateImageryProvider.defaultContrast was deprecated in CesiumJS 1.104. It will be in CesiumJS 1.107. Use ImageryLayer.contrast instead."
- );
- return this._defaultContrast;
- },
- set: function (value) {
- deprecationWarning(
- "UrlTemplateImageryProvider.defaultContrast",
- "UrlTemplateImageryProvider.defaultContrast was deprecated in CesiumJS 1.104. It will be in CesiumJS 1.107. Use ImageryLayer.contrast instead."
- );
- this._defaultContrast = value;
- },
- },
- /**
- * The default hue of this provider in radians. 0.0 uses the unmodified imagery color.
- * @memberof UrlTemplateImageryProvider.prototype
- * @type {Number|undefined}
- * @deprecated
- */
- defaultHue: {
- get: function () {
- deprecationWarning(
- "UrlTemplateImageryProvider.defaultHue",
- "UrlTemplateImageryProvider.defaultHue was deprecated in CesiumJS 1.104. It will be in CesiumJS 1.107. Use ImageryLayer.hue instead."
- );
- return this._defaultHue;
- },
- set: function (value) {
- deprecationWarning(
- "UrlTemplateImageryProvider.defaultHue",
- "UrlTemplateImageryProvider.defaultHue was deprecated in CesiumJS 1.104. It will be in CesiumJS 1.107. Use ImageryLayer.hue instead."
- );
- this._defaultHue = value;
- },
- },
- /**
- * 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.
- * @memberof UrlTemplateImageryProvider.prototype
- * @type {Number|undefined}
- * @deprecated
- */
- defaultSaturation: {
- get: function () {
- deprecationWarning(
- "UrlTemplateImageryProvider.defaultSaturation",
- "UrlTemplateImageryProvider.defaultSaturation was deprecated in CesiumJS 1.104. It will be in CesiumJS 1.107. Use ImageryLayer.saturation instead."
- );
- return this._defaultSaturation;
- },
- set: function (value) {
- deprecationWarning(
- "UrlTemplateImageryProvider.defaultSaturation",
- "UrlTemplateImageryProvider.defaultSaturation was deprecated in CesiumJS 1.104. It will be in CesiumJS 1.107. Use ImageryLayer.saturation instead."
- );
- this._defaultSaturation = value;
- },
- },
- /**
- * The default gamma correction to apply to this provider. 1.0 uses the unmodified imagery color.
- * @memberof UrlTemplateImageryProvider.prototype
- * @type {Number|undefined}
- * @deprecated
- */
- defaultGamma: {
- get: function () {
- deprecationWarning(
- "UrlTemplateImageryProvider.defaultGamma",
- "UrlTemplateImageryProvider.defaultGamma was deprecated in CesiumJS 1.104. It will be in CesiumJS 1.107. Use ImageryLayer.gamma instead."
- );
- return this._defaultGamma;
- },
- set: function (value) {
- deprecationWarning(
- "UrlTemplateImageryProvider.defaultGamma",
- "UrlTemplateImageryProvider.defaultGamma was deprecated in CesiumJS 1.104. It will be in CesiumJS 1.107. Use ImageryLayer.gamma instead."
- );
- this._defaultGamma = value;
- },
- },
- /**
- * The default texture minification filter to apply to this provider.
- * @memberof UrlTemplateImageryProvider.prototype
- * @type {TextureMinificationFilter}
- * @deprecated
- */
- defaultMinificationFilter: {
- get: function () {
- deprecationWarning(
- "UrlTemplateImageryProvider.defaultMinificationFilter",
- "UrlTemplateImageryProvider.defaultMinificationFilter was deprecated in CesiumJS 1.104. It will be in CesiumJS 1.107. Use ImageryLayer.minificationFilter instead."
- );
- return this._defaultMinificationFilter;
- },
- set: function (value) {
- deprecationWarning(
- "UrlTemplateImageryProvider.defaultMinificationFilter",
- "UrlTemplateImageryProvider.defaultMinificationFilter was deprecated in CesiumJS 1.104. It will be in CesiumJS 1.107. Use ImageryLayer.minificationFilter instead."
- );
- this._defaultMinificationFilter = value;
- },
- },
- /**
- * The default texture magnification filter to apply to this provider.
- * @memberof UrlTemplateImageryProvider.prototype
- * @type {TextureMagnificationFilter}
- * @deprecated
- */
- defaultMagnificationFilter: {
- get: function () {
- deprecationWarning(
- "UrlTemplateImageryProvider.defaultMagnificationFilter",
- "UrlTemplateImageryProvider.defaultMagnificationFilter was deprecated in CesiumJS 1.104. It will be in CesiumJS 1.107. Use ImageryLayer.magnificationFilter instead."
- );
- return this._defaultMagnificationFilter;
- },
- set: function (value) {
- deprecationWarning(
- "UrlTemplateImageryProvider.defaultMagnificationFilter",
- "UrlTemplateImageryProvider.defaultMagnificationFilter was deprecated in CesiumJS 1.104. It will be in CesiumJS 1.107. Use ImageryLayer.magnificationFilter instead."
- );
- this._defaultMagnificationFilter = value;
- },
- },
- });
- /**
- * Reinitializes this instance. Reinitializing an instance already in use is supported, but it is not
- * recommended because existing tiles provided by the imagery provider will not be updated.
- * @deprecated
- *
- * @param {Promise<object>|object} options Any of the options that may be passed to the {@link UrlTemplateImageryProvider} constructor.
- */
- UrlTemplateImageryProvider.prototype.reinitialize = function (options) {
- deprecationWarning(
- "UrlTemplateImageryProvider.reinitialize",
- "UrlTemplateImageryProvider.reinitialize was deprecated in CesiumJS 1.104. It will be in CesiumJS 1.107."
- );
- return this._reinitialize(options);
- };
- /**
- * @private
- */
- UrlTemplateImageryProvider.prototype._reinitialize = function (options) {
- const that = this;
- that._readyPromise = Promise.resolve(options).then(function (properties) {
- //>>includeStart('debug', pragmas.debug);
- if (!defined(properties)) {
- throw new DeveloperError("options is required.");
- }
- if (!defined(properties.url)) {
- throw new DeveloperError("options.url is required.");
- }
- //>>includeEnd('debug');
- const customTags = properties.customTags;
- const allTags = combine(tags, customTags);
- const allPickFeaturesTags = combine(pickFeaturesTags, customTags);
- const resource = Resource.createIfNeeded(properties.url);
- const pickFeaturesResource = Resource.createIfNeeded(
- properties.pickFeaturesUrl
- );
- that.enablePickFeatures = defaultValue(
- properties.enablePickFeatures,
- that.enablePickFeatures
- );
- that._urlSchemeZeroPadding = defaultValue(
- properties.urlSchemeZeroPadding,
- that.urlSchemeZeroPadding
- );
- that._tileDiscardPolicy = properties.tileDiscardPolicy;
- that._getFeatureInfoFormats = properties.getFeatureInfoFormats;
- that._subdomains = properties.subdomains;
- if (Array.isArray(that._subdomains)) {
- that._subdomains = that._subdomains.slice();
- } else if (defined(that._subdomains) && that._subdomains.length > 0) {
- that._subdomains = that._subdomains.split("");
- } else {
- that._subdomains = ["a", "b", "c"];
- }
- that._tileWidth = defaultValue(properties.tileWidth, 256);
- that._tileHeight = defaultValue(properties.tileHeight, 256);
- that._minimumLevel = defaultValue(properties.minimumLevel, 0);
- that._maximumLevel = properties.maximumLevel;
- that._tilingScheme = defaultValue(
- properties.tilingScheme,
- new WebMercatorTilingScheme({ ellipsoid: properties.ellipsoid })
- );
- that._rectangle = defaultValue(
- properties.rectangle,
- that._tilingScheme.rectangle
- );
- that._rectangle = Rectangle.intersection(
- that._rectangle,
- that._tilingScheme.rectangle
- );
- that._hasAlphaChannel = defaultValue(properties.hasAlphaChannel, true);
- let credit = properties.credit;
- if (typeof credit === "string") {
- credit = new Credit(credit);
- }
- that._credit = credit;
- that._resource = resource;
- that._tags = allTags;
- that._pickFeaturesResource = pickFeaturesResource;
- that._pickFeaturesTags = allPickFeaturesTags;
- that._ready = true;
- return true;
- });
- };
- /**
- * 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.
- */
- UrlTemplateImageryProvider.prototype.getTileCredits = function (x, y, level) {
- return undefined;
- };
- /**
- * @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.
- */
- UrlTemplateImageryProvider.prototype.requestImage = function (
- x,
- y,
- level,
- request
- ) {
- 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.
- *
- * @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.
- * It may also be undefined if picking is not supported.
- */
- UrlTemplateImageryProvider.prototype.pickFeatures = function (
- x,
- y,
- level,
- longitude,
- latitude
- ) {
- if (
- !this.enablePickFeatures ||
- !defined(this._pickFeaturesResource) ||
- this._getFeatureInfoFormats.length === 0
- ) {
- return undefined;
- }
- let formatIndex = 0;
- const that = this;
- function handleResponse(format, data) {
- return format.callback(data);
- }
- function doRequest() {
- if (formatIndex >= that._getFeatureInfoFormats.length) {
- // No valid formats, so no features picked.
- return Promise.resolve([]);
- }
- const format = that._getFeatureInfoFormats[formatIndex];
- const resource = buildPickFeaturesResource(
- that,
- x,
- y,
- level,
- longitude,
- latitude,
- format.format
- );
- ++formatIndex;
- if (format.type === "json") {
- return resource.fetchJson().then(format.callback).catch(doRequest);
- } else if (format.type === "xml") {
- return resource.fetchXML().then(format.callback).catch(doRequest);
- } else if (format.type === "text" || format.type === "html") {
- return resource.fetchText().then(format.callback).catch(doRequest);
- }
- return resource
- .fetch({
- responseType: format.format,
- })
- .then(handleResponse.bind(undefined, format))
- .catch(doRequest);
- }
- return doRequest();
- };
- let degreesScratchComputed = false;
- const degreesScratch = new Rectangle();
- let projectedScratchComputed = false;
- const projectedScratch = new Rectangle();
- function buildImageResource(imageryProvider, x, y, level, request) {
- degreesScratchComputed = false;
- projectedScratchComputed = false;
- const resource = imageryProvider._resource;
- const url = resource.getUrlComponent(true);
- const allTags = imageryProvider._tags;
- const templateValues = {};
- const match = url.match(templateRegex);
- if (defined(match)) {
- match.forEach(function (tag) {
- const key = tag.substring(1, tag.length - 1); //strip {}
- if (defined(allTags[key])) {
- templateValues[key] = allTags[key](imageryProvider, x, y, level);
- }
- });
- }
- return resource.getDerivedResource({
- request: request,
- templateValues: templateValues,
- });
- }
- let ijScratchComputed = false;
- const ijScratch = new Cartesian2();
- let longitudeLatitudeProjectedScratchComputed = false;
- function buildPickFeaturesResource(
- imageryProvider,
- x,
- y,
- level,
- longitude,
- latitude,
- format
- ) {
- degreesScratchComputed = false;
- projectedScratchComputed = false;
- ijScratchComputed = false;
- longitudeLatitudeProjectedScratchComputed = false;
- const resource = imageryProvider._pickFeaturesResource;
- const url = resource.getUrlComponent(true);
- const allTags = imageryProvider._pickFeaturesTags;
- const templateValues = {};
- const match = url.match(templateRegex);
- if (defined(match)) {
- match.forEach(function (tag) {
- const key = tag.substring(1, tag.length - 1); //strip {}
- if (defined(allTags[key])) {
- templateValues[key] = allTags[key](
- imageryProvider,
- x,
- y,
- level,
- longitude,
- latitude,
- format
- );
- }
- });
- }
- return resource.getDerivedResource({
- templateValues: templateValues,
- });
- }
- function padWithZerosIfNecessary(imageryProvider, key, value) {
- if (
- imageryProvider &&
- imageryProvider.urlSchemeZeroPadding &&
- imageryProvider.urlSchemeZeroPadding.hasOwnProperty(key)
- ) {
- const paddingTemplate = imageryProvider.urlSchemeZeroPadding[key];
- if (typeof paddingTemplate === "string") {
- const paddingTemplateWidth = paddingTemplate.length;
- if (paddingTemplateWidth > 1) {
- value =
- value.length >= paddingTemplateWidth
- ? value
- : new Array(
- paddingTemplateWidth - value.toString().length + 1
- ).join("0") + value;
- }
- }
- }
- return value;
- }
- function xTag(imageryProvider, x, y, level) {
- return padWithZerosIfNecessary(imageryProvider, "{x}", x);
- }
- function reverseXTag(imageryProvider, x, y, level) {
- const reverseX =
- imageryProvider.tilingScheme.getNumberOfXTilesAtLevel(level) - x - 1;
- return padWithZerosIfNecessary(imageryProvider, "{reverseX}", reverseX);
- }
- function yTag(imageryProvider, x, y, level) {
- return padWithZerosIfNecessary(imageryProvider, "{y}", y);
- }
- function reverseYTag(imageryProvider, x, y, level) {
- const reverseY =
- imageryProvider.tilingScheme.getNumberOfYTilesAtLevel(level) - y - 1;
- return padWithZerosIfNecessary(imageryProvider, "{reverseY}", reverseY);
- }
- function reverseZTag(imageryProvider, x, y, level) {
- const maximumLevel = imageryProvider.maximumLevel;
- const reverseZ =
- defined(maximumLevel) && level < maximumLevel
- ? maximumLevel - level - 1
- : level;
- return padWithZerosIfNecessary(imageryProvider, "{reverseZ}", reverseZ);
- }
- function zTag(imageryProvider, x, y, level) {
- return padWithZerosIfNecessary(imageryProvider, "{z}", level);
- }
- function sTag(imageryProvider, x, y, level) {
- const index = (x + y + level) % imageryProvider._subdomains.length;
- return imageryProvider._subdomains[index];
- }
- function computeDegrees(imageryProvider, x, y, level) {
- if (degreesScratchComputed) {
- return;
- }
- imageryProvider.tilingScheme.tileXYToRectangle(x, y, level, degreesScratch);
- degreesScratch.west = CesiumMath.toDegrees(degreesScratch.west);
- degreesScratch.south = CesiumMath.toDegrees(degreesScratch.south);
- degreesScratch.east = CesiumMath.toDegrees(degreesScratch.east);
- degreesScratch.north = CesiumMath.toDegrees(degreesScratch.north);
- degreesScratchComputed = true;
- }
- function westDegreesTag(imageryProvider, x, y, level) {
- computeDegrees(imageryProvider, x, y, level);
- return degreesScratch.west;
- }
- function southDegreesTag(imageryProvider, x, y, level) {
- computeDegrees(imageryProvider, x, y, level);
- return degreesScratch.south;
- }
- function eastDegreesTag(imageryProvider, x, y, level) {
- computeDegrees(imageryProvider, x, y, level);
- return degreesScratch.east;
- }
- function northDegreesTag(imageryProvider, x, y, level) {
- computeDegrees(imageryProvider, x, y, level);
- return degreesScratch.north;
- }
- function computeProjected(imageryProvider, x, y, level) {
- if (projectedScratchComputed) {
- return;
- }
- imageryProvider.tilingScheme.tileXYToNativeRectangle(
- x,
- y,
- level,
- projectedScratch
- );
- projectedScratchComputed = true;
- }
- function westProjectedTag(imageryProvider, x, y, level) {
- computeProjected(imageryProvider, x, y, level);
- return projectedScratch.west;
- }
- function southProjectedTag(imageryProvider, x, y, level) {
- computeProjected(imageryProvider, x, y, level);
- return projectedScratch.south;
- }
- function eastProjectedTag(imageryProvider, x, y, level) {
- computeProjected(imageryProvider, x, y, level);
- return projectedScratch.east;
- }
- function northProjectedTag(imageryProvider, x, y, level) {
- computeProjected(imageryProvider, x, y, level);
- return projectedScratch.north;
- }
- function widthTag(imageryProvider, x, y, level) {
- return imageryProvider.tileWidth;
- }
- function heightTag(imageryProvider, x, y, level) {
- return imageryProvider.tileHeight;
- }
- function iTag(imageryProvider, x, y, level, longitude, latitude, format) {
- computeIJ(imageryProvider, x, y, level, longitude, latitude);
- return ijScratch.x;
- }
- function jTag(imageryProvider, x, y, level, longitude, latitude, format) {
- computeIJ(imageryProvider, x, y, level, longitude, latitude);
- return ijScratch.y;
- }
- function reverseITag(
- imageryProvider,
- x,
- y,
- level,
- longitude,
- latitude,
- format
- ) {
- computeIJ(imageryProvider, x, y, level, longitude, latitude);
- return imageryProvider.tileWidth - ijScratch.x - 1;
- }
- function reverseJTag(
- imageryProvider,
- x,
- y,
- level,
- longitude,
- latitude,
- format
- ) {
- computeIJ(imageryProvider, x, y, level, longitude, latitude);
- return imageryProvider.tileHeight - ijScratch.y - 1;
- }
- const rectangleScratch = new Rectangle();
- const longitudeLatitudeProjectedScratch = new Cartesian3();
- function computeIJ(imageryProvider, x, y, level, longitude, latitude, format) {
- if (ijScratchComputed) {
- return;
- }
- computeLongitudeLatitudeProjected(
- imageryProvider,
- x,
- y,
- level,
- longitude,
- latitude
- );
- const projected = longitudeLatitudeProjectedScratch;
- const rectangle = imageryProvider.tilingScheme.tileXYToNativeRectangle(
- x,
- y,
- level,
- rectangleScratch
- );
- ijScratch.x =
- ((imageryProvider.tileWidth * (projected.x - rectangle.west)) /
- rectangle.width) |
- 0;
- ijScratch.y =
- ((imageryProvider.tileHeight * (rectangle.north - projected.y)) /
- rectangle.height) |
- 0;
- ijScratchComputed = true;
- }
- function longitudeDegreesTag(
- imageryProvider,
- x,
- y,
- level,
- longitude,
- latitude,
- format
- ) {
- return CesiumMath.toDegrees(longitude);
- }
- function latitudeDegreesTag(
- imageryProvider,
- x,
- y,
- level,
- longitude,
- latitude,
- format
- ) {
- return CesiumMath.toDegrees(latitude);
- }
- function longitudeProjectedTag(
- imageryProvider,
- x,
- y,
- level,
- longitude,
- latitude,
- format
- ) {
- computeLongitudeLatitudeProjected(
- imageryProvider,
- x,
- y,
- level,
- longitude,
- latitude
- );
- return longitudeLatitudeProjectedScratch.x;
- }
- function latitudeProjectedTag(
- imageryProvider,
- x,
- y,
- level,
- longitude,
- latitude,
- format
- ) {
- computeLongitudeLatitudeProjected(
- imageryProvider,
- x,
- y,
- level,
- longitude,
- latitude
- );
- return longitudeLatitudeProjectedScratch.y;
- }
- const cartographicScratch = new Cartographic();
- function computeLongitudeLatitudeProjected(
- imageryProvider,
- x,
- y,
- level,
- longitude,
- latitude,
- format
- ) {
- if (longitudeLatitudeProjectedScratchComputed) {
- return;
- }
- if (imageryProvider.tilingScheme.projection instanceof GeographicProjection) {
- longitudeLatitudeProjectedScratch.x = CesiumMath.toDegrees(longitude);
- longitudeLatitudeProjectedScratch.y = CesiumMath.toDegrees(latitude);
- } else {
- const cartographic = cartographicScratch;
- cartographic.longitude = longitude;
- cartographic.latitude = latitude;
- imageryProvider.tilingScheme.projection.project(
- cartographic,
- longitudeLatitudeProjectedScratch
- );
- }
- longitudeLatitudeProjectedScratchComputed = true;
- }
- function formatTag(imageryProvider, x, y, level, longitude, latitude, format) {
- return format;
- }
- export default UrlTemplateImageryProvider;
|