# pixelSize

type | Number
default | 156543.03392799936
init | cannot be initialized

get

    var pixelSize = $( selector ).geomap( "option", "pixelSize" );

set | read only

The pixel size is the number of map units a single pixel occupies in the current view. A more interesting way to think of it is the Earth-size of the pixel.

Because the default internal projection is web mercator meters, the default return value for pixelSize is in meters even if you set other map values in geodetic coordinates, e.g., lon/lat. The unit type will always match the type you set on tilingScheme for tiled maps or bboxMax for shingled (dynamic) maps. For more information on how the plugin handles projections, please read the geo section of this documentation.

The map's pixel size is read-only. To change it you will need to use one of the mutable properties such as bbox, center or zoom.

pixelSize is calculated based on tilingScheme & zoom for tiled maps. It is based on the bbox/bboxMax ratio for shingled maps.