# WebMercatorTilingScheme

#### new Cesium.WebMercatorTilingScheme(options)
engine/Source/Core/WebMercatorTilingScheme.js 31

A tiling scheme for geometry referenced to a `WebMercatorProjection`, EPSG:3857. This is the tiling scheme used by Google Maps, Microsoft Bing Maps, and most of ESRI ArcGIS Online.

Name | Type | Description
--- | --- | ---
`options` | object | optional Object with the following properties:
Name | Type | Default | Description
--- | --- | --- | ---
`ellipsoid` | Ellipsoid | `Ellipsoid.default` | optional The ellipsoid whose surface is being tiled. Defaults to the default ellipsoid.
`numberOfLevelZeroTilesX` | number | `1` | optional The number of tiles in the X direction at level zero of the tile tree.
`numberOfLevelZeroTilesY` | number | `1` | optional The number of tiles in the Y direction at level zero of the tile tree.
`rectangleSouthwestInMeters` | Cartesian2 |  | optional 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.
`rectangleNortheastInMeters` | Cartesian2 |  | optional 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.

### Members

#### ellipsoid : Ellipsoid
engine/Source/Core/WebMercatorTilingScheme.js 78

Gets the ellipsoid that is tiled by this tiling scheme.

#### projection : MapProjection
engine/Source/Core/WebMercatorTilingScheme.js 100

Gets the map projection used by this tiling scheme.

#### rectangle : Rectangle
engine/Source/Core/WebMercatorTilingScheme.js 89

Gets the rectangle, in radians, covered by this tiling scheme.

### Methods

#### getNumberOfXTilesAtLevel(level) → number
engine/Source/Core/WebMercatorTilingScheme.js 113

Gets the total number of tiles in the X direction at a specified level-of-detail.

Name | Type | Description
--- | --- | ---
`level` | number | The level-of-detail.

##### Returns:

The number of tiles in the X direction at the given level.

#### getNumberOfYTilesAtLevel(level) → number
engine/Source/Core/WebMercatorTilingScheme.js 123

Gets the total number of tiles in the Y direction at a specified level-of-detail.

Name | Type | Description
--- | --- | ---
`level` | number | The level-of-detail.

##### Returns:

The number of tiles in the Y direction at the given level.

#### positionToTileXY(position, level, result) → Cartesian2
engine/Source/Core/WebMercatorTilingScheme.js 245

Calculates the tile x, y coordinates of the tile containing a given cartographic position.

Name | Type | Description
--- | --- | ---
`position` | Cartographic | The position.
`level` | number | The tile level-of-detail. Zero is the least detailed.
`result` | Cartesian2 | optional The instance to which to copy the result, or undefined if a new instance should be created.

##### Returns:

The specified 'result', or a new object containing the tile x, y coordinates if 'result' is undefined.

#### rectangleToNativeRectangle(rectangle, result) → Rectangle
engine/Source/Core/WebMercatorTilingScheme.js 137

Transforms a rectangle specified in geodetic radians to the native coordinate system of this tiling scheme.

Name | Type | Description
--- | --- | ---
`rectangle` | Rectangle | The rectangle to transform.
`result` | Rectangle | optional The instance to which to copy the result, or undefined if a new instance should be created.

##### Returns:

The specified 'result', or a new object containing the native rectangle if 'result' is undefined.

#### tileXYToNativeRectangle(x, y, level, result) → Rectangle
engine/Source/Core/WebMercatorTilingScheme.js 168

Converts tile x, y coordinates and level to a rectangle expressed in the native coordinates of the tiling scheme.

Name | Type | Description
--- | --- | ---
`x` | number | The integer x coordinate of the tile.
`y` | number | The integer y coordinate of the tile.
`level` | number | The tile level-of-detail. Zero is the least detailed.
`result` | object | optional The instance to which to copy the result, or undefined if a new instance should be created.

##### Returns:

The specified 'result', or a new object containing the rectangle if 'result' is undefined.

#### tileXYToRectangle(x, y, level, result) → Rectangle
engine/Source/Core/WebMercatorTilingScheme.js 211

Converts tile x, y coordinates and level to a cartographic rectangle in radians.

Name | Type | Description
--- | --- | ---
`x` | number | The integer x coordinate of the tile.
`y` | number | The integer y coordinate of the tile.
`level` | number | The tile level-of-detail. Zero is the least detailed.
`result` | object | optional The instance to which to copy the result, or undefined if a new instance should be created.

##### Returns:

The specified 'result', or a new object containing the rectangle if 'result' is undefined.

Need help? The fastest way to get answers is from the community and team on the Cesium Forum.