Press n or j to go to the next uncovered block, b, p or k for the previous block.
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 | 456x 456x 456x 456x 456x 456x 17x 17x 439x 439x 439x 456x 456x 456x 1x 134x 497x 251x 1x 1821x 1x 1699x 1x 130x 130x 130x 130x 1x 129x 129x 129x 129x 129x 1x 1385x 1385x 1385x 1385x 1385x 1385x 1385x 1385x 1385x 1157x 228x 228x 228x 228x 228x 1x 1307x 1307x 1307x 1307x 1307x 1307x 1307x 1307x 1307x 1x 301x 301x 4x 297x 297x 297x 297x 297x 297x 297x 297x 297x 297x 297x 297x 58x 297x 297x 92x 297x 296x 1x 1x 1x | import Cartesian2 from "./Cartesian2.js";
import Frozen from "./Frozen.js";
import defined from "./defined.js";
import Ellipsoid from "./Ellipsoid.js";
import Rectangle from "./Rectangle.js";
import WebMercatorProjection from "./WebMercatorProjection.js";
/**
* A tiling scheme for geometry referenced to a {@link WebMercatorProjection}, EPSG:3857. This is
* the tiling scheme used by Google Maps, Microsoft Bing Maps, and most of ESRI ArcGIS Online.
*
* @alias WebMercatorTilingScheme
* @constructor
*
* @param {object} [options] Object with the following properties:
* @param {Ellipsoid} [options.ellipsoid=Ellipsoid.default] The ellipsoid whose surface is being tiled. Defaults to
* the default ellipsoid.
* @param {number} [options.numberOfLevelZeroTilesX=1] The number of tiles in the X direction at level zero of
* the tile tree.
* @param {number} [options.numberOfLevelZeroTilesY=1] The number of tiles in the Y direction at level zero of
* the tile tree.
* @param {Cartesian2} [options.rectangleSouthwestInMeters] The southwest corner of the rectangle covered by the
* tiling scheme, in meters. If this parameter or rectangleNortheastInMeters is not specified, the entire
* globe is covered in the longitude direction and an equal distance is covered in the latitude
* direction, resulting in a square projection.
* @param {Cartesian2} [options.rectangleNortheastInMeters] The northeast corner of the rectangle covered by the
* tiling scheme, in meters. If this parameter or rectangleSouthwestInMeters is not specified, the entire
* globe is covered in the longitude direction and an equal distance is covered in the latitude
* direction, resulting in a square projection.
*/
function WebMercatorTilingScheme(options) {
options = options ?? Frozen.EMPTY_OBJECT;
this._ellipsoid = options.ellipsoid ?? Ellipsoid.default;
this._numberOfLevelZeroTilesX = options.numberOfLevelZeroTilesX ?? 1;
this._numberOfLevelZeroTilesY = options.numberOfLevelZeroTilesY ?? 1;
this._projection = new WebMercatorProjection(this._ellipsoid);
if (
defined(options.rectangleSouthwestInMeters) &&
defined(options.rectangleNortheastInMeters)
) {
this._rectangleSouthwestInMeters = options.rectangleSouthwestInMeters;
this._rectangleNortheastInMeters = options.rectangleNortheastInMeters;
} else {
const semimajorAxisTimesPi = this._ellipsoid.maximumRadius * Math.PI;
this._rectangleSouthwestInMeters = new Cartesian2(
-semimajorAxisTimesPi,
-semimajorAxisTimesPi,
);
this._rectangleNortheastInMeters = new Cartesian2(
semimajorAxisTimesPi,
semimajorAxisTimesPi,
);
}
const southwest = this._projection.unproject(
this._rectangleSouthwestInMeters,
);
const northeast = this._projection.unproject(
this._rectangleNortheastInMeters,
);
this._rectangle = new Rectangle(
southwest.longitude,
southwest.latitude,
northeast.longitude,
northeast.latitude,
);
}
Object.defineProperties(WebMercatorTilingScheme.prototype, {
/**
* Gets the ellipsoid that is tiled by this tiling scheme.
* @memberof WebMercatorTilingScheme.prototype
* @type {Ellipsoid}
*/
ellipsoid: {
get: function () {
return this._ellipsoid;
},
},
/**
* Gets the rectangle, in radians, covered by this tiling scheme.
* @memberof WebMercatorTilingScheme.prototype
* @type {Rectangle}
*/
rectangle: {
get: function () {
return this._rectangle;
},
},
/**
* Gets the map projection used by this tiling scheme.
* @memberof WebMercatorTilingScheme.prototype
* @type {MapProjection}
*/
projection: {
get: function () {
return this._projection;
},
},
});
/**
* Gets the total number of tiles in the X direction at a specified level-of-detail.
*
* @param {number} level The level-of-detail.
* @returns {number} The number of tiles in the X direction at the given level.
*/
WebMercatorTilingScheme.prototype.getNumberOfXTilesAtLevel = function (level) {
return this._numberOfLevelZeroTilesX << level;
};
/**
* Gets the total number of tiles in the Y direction at a specified level-of-detail.
*
* @param {number} level The level-of-detail.
* @returns {number} The number of tiles in the Y direction at the given level.
*/
WebMercatorTilingScheme.prototype.getNumberOfYTilesAtLevel = function (level) {
return this._numberOfLevelZeroTilesY << level;
};
/**
* Transforms a rectangle specified in geodetic radians to the native coordinate system
* of this tiling scheme.
*
* @param {Rectangle} rectangle The rectangle to transform.
* @param {Rectangle} [result] The instance to which to copy the result, or undefined if a new instance
* should be created.
* @returns {Rectangle} The specified 'result', or a new object containing the native rectangle if 'result'
* is undefined.
*/
WebMercatorTilingScheme.prototype.rectangleToNativeRectangle = function (
rectangle,
result,
) {
const projection = this._projection;
const southwest = projection.project(Rectangle.southwest(rectangle));
const northeast = projection.project(Rectangle.northeast(rectangle));
if (!defined(result)) {
return new Rectangle(southwest.x, southwest.y, northeast.x, northeast.y);
}
result.west = southwest.x;
result.south = southwest.y;
result.east = northeast.x;
result.north = northeast.y;
return result;
};
/**
* Converts tile x, y coordinates and level to a rectangle expressed in the native coordinates
* of the tiling scheme.
*
* @param {number} x The integer x coordinate of the tile.
* @param {number} y The integer y coordinate of the tile.
* @param {number} level The tile level-of-detail. Zero is the least detailed.
* @param {object} [result] The instance to which to copy the result, or undefined if a new instance
* should be created.
* @returns {Rectangle} The specified 'result', or a new object containing the rectangle
* if 'result' is undefined.
*/
WebMercatorTilingScheme.prototype.tileXYToNativeRectangle = function (
x,
y,
level,
result,
) {
const xTiles = this.getNumberOfXTilesAtLevel(level);
const yTiles = this.getNumberOfYTilesAtLevel(level);
const xTileWidth =
(this._rectangleNortheastInMeters.x - this._rectangleSouthwestInMeters.x) /
xTiles;
const west = this._rectangleSouthwestInMeters.x + x * xTileWidth;
const east = this._rectangleSouthwestInMeters.x + (x + 1) * xTileWidth;
const yTileHeight =
(this._rectangleNortheastInMeters.y - this._rectangleSouthwestInMeters.y) /
yTiles;
const north = this._rectangleNortheastInMeters.y - y * yTileHeight;
const south = this._rectangleNortheastInMeters.y - (y + 1) * yTileHeight;
if (!defined(result)) {
return new Rectangle(west, south, east, north);
}
result.west = west;
result.south = south;
result.east = east;
result.north = north;
return result;
};
/**
* Converts tile x, y coordinates and level to a cartographic rectangle in radians.
*
* @param {number} x The integer x coordinate of the tile.
* @param {number} y The integer y coordinate of the tile.
* @param {number} level The tile level-of-detail. Zero is the least detailed.
* @param {object} [result] The instance to which to copy the result, or undefined if a new instance
* should be created.
* @returns {Rectangle} The specified 'result', or a new object containing the rectangle
* if 'result' is undefined.
*/
WebMercatorTilingScheme.prototype.tileXYToRectangle = function (
x,
y,
level,
result,
) {
const nativeRectangle = this.tileXYToNativeRectangle(x, y, level, result);
const projection = this._projection;
const southwest = projection.unproject(
new Cartesian2(nativeRectangle.west, nativeRectangle.south),
);
const northeast = projection.unproject(
new Cartesian2(nativeRectangle.east, nativeRectangle.north),
);
nativeRectangle.west = southwest.longitude;
nativeRectangle.south = southwest.latitude;
nativeRectangle.east = northeast.longitude;
nativeRectangle.north = northeast.latitude;
return nativeRectangle;
};
/**
* Calculates the tile x, y coordinates of the tile containing
* a given cartographic position.
*
* @param {Cartographic} position The position.
* @param {number} level The tile level-of-detail. Zero is the least detailed.
* @param {Cartesian2} [result] The instance to which to copy the result, or undefined if a new instance
* should be created.
* @returns {Cartesian2} The specified 'result', or a new object containing the tile x, y coordinates
* if 'result' is undefined.
*/
WebMercatorTilingScheme.prototype.positionToTileXY = function (
position,
level,
result,
) {
const rectangle = this._rectangle;
if (!Rectangle.contains(rectangle, position)) {
// outside the bounds of the tiling scheme
return undefined;
}
const xTiles = this.getNumberOfXTilesAtLevel(level);
const yTiles = this.getNumberOfYTilesAtLevel(level);
const overallWidth =
this._rectangleNortheastInMeters.x - this._rectangleSouthwestInMeters.x;
const xTileWidth = overallWidth / xTiles;
const overallHeight =
this._rectangleNortheastInMeters.y - this._rectangleSouthwestInMeters.y;
const yTileHeight = overallHeight / yTiles;
const projection = this._projection;
const webMercatorPosition = projection.project(position);
const distanceFromWest =
webMercatorPosition.x - this._rectangleSouthwestInMeters.x;
const distanceFromNorth =
this._rectangleNortheastInMeters.y - webMercatorPosition.y;
let xTileCoordinate = (distanceFromWest / xTileWidth) | 0;
if (xTileCoordinate >= xTiles) {
xTileCoordinate = xTiles - 1;
}
let yTileCoordinate = (distanceFromNorth / yTileHeight) | 0;
if (yTileCoordinate >= yTiles) {
yTileCoordinate = yTiles - 1;
}
if (!defined(result)) {
return new Cartesian2(xTileCoordinate, yTileCoordinate);
}
result.x = xTileCoordinate;
result.y = yTileCoordinate;
return result;
};
export default WebMercatorTilingScheme;
|