Back to all docs
API Reference / Telerik.WinControls.UI / MapTileSystemHelper
New to Telerik UI for WinForms? Start a free 30-day trial

MapTileSystemHelper

Class

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.RadMap.dll

Syntax:
C#
public static class MapTileSystemHelper

Inheritance: objectMapTileSystemHelper

Fields

EarthRadius

C#
public const double EarthRadius = 6378137

MaxLatitude

C#
public const double MaxLatitude = 85.05112878

MaxLongitude

C#
public const double MaxLongitude = 180

MinLatitude

C#
public const double MinLatitude = -85.05112878

MinLongitude

C#
public const double MinLongitude = -180

Methods

GroundResolution(double, int)

Determines the ground resolution (in meters per pixel) at a specified latitude and level of detail.

C#
public static double GroundResolution(double latitude, int levelOfDetail)
Parameters:latitudedouble

Latitude (in degrees) at which to measure the ground resolution.

levelOfDetailint

Level of detail, from 1 (lowest detail) to 23 (highest detail).

Returns:

double

The ground resolution, in meters per pixel.

LatLongToPixelXY(double, double, int, bool)

Converts a point from latitude/longitude WGS-84 coordinates (in degrees) into pixel XY coordinates at a specified level of detail.

C#
public static PointL LatLongToPixelXY(double latitude, double longitude, int levelOfDetail, bool allowWraparound)
Parameters:latitudedouble

Latitude of the point, in degrees.

longitudedouble

Longitude of the point, in degrees.

levelOfDetailint

Level of detail, from 1 (lowest detail) to 23 (highest detail).

allowWraparoundbool

if set to true wraparound is allowed.

Returns:

PointL

LatLongToPixelXY(double, double, int)

Converts a point from latitude/longitude WGS-84 coordinates (in degrees) into pixel XY coordinates at a specified level of detail.

C#
public static PointL LatLongToPixelXY(double latitude, double longitude, int levelOfDetail)
Parameters:latitudedouble

Latitude of the point, in degrees.

longitudedouble

Longitude of the point, in degrees.

levelOfDetailint

Level of detail, from 1 (lowest detail) to 23 (highest detail).

Returns:

PointL

LatLongToPixelXY(PointG, int)

Converts a point from latitude/longitude WGS-84 coordinates (in degrees) into pixel XY coordinates at a specified level of detail.

C#
public static PointL LatLongToPixelXY(PointG location, int levelOfDetail)
Parameters:locationPointG

Location of the point, in degrees.

levelOfDetailint

Level of detail, from 1 (lowest detail) to 23 (highest detail).

Returns:

PointL

MapScale(double, int, int)

Determines the map scale at a specified latitude, level of detail, and screen resolution.

C#
public static double MapScale(double latitude, int levelOfDetail, int screenDpi)
Parameters:latitudedouble

Latitude (in degrees) at which to measure the map scale.

levelOfDetailint

Level of detail, from 1 (lowest detail) to 23 (highest detail).

screenDpiint

Resolution of the screen, in dots per inch.

Returns:

double

The map scale, expressed as the denominator N of the ratio 1 : N.

MapSize(int)

Determines the map width and height (in pixels) at a specified level of detail.

C#
public static long MapSize(int levelOfDetail)
Parameters:levelOfDetailint

Level of detail, from 1 (lowest detail) to 23 (highest detail).

Returns:

long

The map width and height in pixels.

PixelXYToLatLong(long, long, int, bool)

Converts a pixel from pixel XY coordinates at a specified level of detail into latitude/longitude WGS-84 coordinates (in degrees).

C#
public static PointG PixelXYToLatLong(long pixelX, long pixelY, int levelOfDetail, bool allowWraparound)
Parameters:pixelXlong

X coordinate of the point, in pixels.

pixelYlong

Y coordinates of the point, in pixels.

levelOfDetailint

Level of detail, from 1 (lowest detail) to 23 (highest detail).

allowWraparoundbool

if set to true wraparound is allowed.

Returns:

PointG

PointG.

PixelXYToLatLong(long, long, int)

Converts a pixel from pixel XY coordinates at a specified level of detail into latitude/longitude WGS-84 coordinates (in degrees).

C#
public static PointG PixelXYToLatLong(long pixelX, long pixelY, int levelOfDetail)
Parameters:pixelXlong

X coordinate of the point, in pixels.

pixelYlong

Y coordinates of the point, in pixels.

levelOfDetailint

Level of detail, from 1 (lowest detail) to 23 (highest detail).

Returns:

PointG

PixelXYToLatLong(PointL, int)

Converts a pixel from pixel XY coordinates at a specified level of detail into latitude/longitude WGS-84 coordinates (in degrees).

C#
public static PointG PixelXYToLatLong(PointL point, int levelOfDetail)
Parameters:pointPointL

X and Y coordinates of the point, in pixels.

levelOfDetailint

Level of detail, from 1 (lowest detail) to 23 (highest detail).

Returns:

PointG

PixelXYToTileXY(long, long)

Converts pixel XY coordinates into tile XY coordinates of the tile containing the specified pixel.

C#
public static Point PixelXYToTileXY(long pixelX, long pixelY)
Parameters:pixelXlong

Pixel X coordinate.

pixelYlong

Pixel Y coordinate.

Returns:

Point

QuadKeyToTileXY(string, out int, out int, out int)

Converts a QuadKey into tile XY coordinates.

C#
public static void QuadKeyToTileXY(string quadKey, out int tileX, out int tileY, out int levelOfDetail)
Parameters:quadKeystring

QuadKey of the tile.

tileXint

Output parameter receiving the tile X coordinate.

tileYint

Output parameter receiving the tile Y coordinate.

levelOfDetailint

Output parameter receiving the level of detail.

TileXYToPixelXY(int, int)

Converts tile XY coordinates into pixel XY coordinates of the upper-left pixel of the specified tile.

C#
public static PointL TileXYToPixelXY(int tileX, int tileY)
Parameters:tileXint

Tile X coordinate.

tileYint

Tile Y coordinate.

Returns:

PointL

TileXYToQuadKey(int, int, int)

Converts tile XY coordinates into a QuadKey at a specified level of detail.

C#
public static string TileXYToQuadKey(int tileX, int tileY, int levelOfDetail)
Parameters:tileXint

Tile X coordinate.

tileYint

Tile Y coordinate.

levelOfDetailint

Level of detail, from 1 (lowest detail) to 23 (highest detail).

Returns:

string

A string containing the QuadKey.

In this article
DefinitionFieldsEarthRadiusMaxLatitudeMaxLongitudeMinLatitudeMinLongitudeMethodsGroundResolution(double, int)LatLongToPixelXY(double, double, int, bool)LatLongToPixelXY(double, double, int)LatLongToPixelXY(PointG, int)MapScale(double, int, int)MapSize(int)PixelXYToLatLong(long, long, int, bool)PixelXYToLatLong(long, long, int)PixelXYToLatLong(PointL, int)PixelXYToTileXY(long, long)QuadKeyToTileXY(string, out int, out int, out int)TileXYToPixelXY(int, int)TileXYToQuadKey(int, int, int)
Not finding the help you need?
Contact Support