Still have questions?
Contact support
You are looking at an outdated 7.12.0 version of this document. Switch to the 7.13.0 version to see the up to date information.

Map Projection


A map projection is any method used in cartography to represent the two-dimensional curved surface of the earth or other body on a plane. The term "projection" here refers to any function defined on the earth's surface and with values on the plane, and not necessarily a geometric projection.

Flat maps could not exist without map projections, because a sphere cannot be laid flat over a plane without distortions.

Map projections can be constructed to preserve one or some of map regions properties (area, shape, direction, bearing, distance, scale), though not all of them simultaneously. Each projection preserves or compromises or approximates basic metric properties in different ways. The purpose of the map, then, determines which projection should form the base for the map. Since many purposes exist for maps, so do many projections exist upon which to construct them.

AnyChart allows to display any map in several projections, below you will find a list of all available projections with map samples.

Depending on your visualization task you can choose what projection to use in your project or give end-user an ability to swap projections in real-time.

Important: not only you can change the projection of a map, you can also change projection of any selected region (feature) using featureCrs() method, see Changing Region projection section for this. This feature can come in particularly handy when you need to create a custom map with small regions or a region located in high/low latitudes.

Setting Map Projection

To set map projection you should set its type using .crs() method:

  var map =;"august");

Snippet above shows a string as a parameter for .crs() method. Here is how the projection can be set using enum:

  var map =;;

Available Projections

As far as AnyChart constantly implements new features to improves AnyChart charting library, all new projections in further versions would be added MapProjections enum along with existing ones.

The table below lists all available projection types, samples can be found after the table.

AitoffThe Aitoff projection is a modified azimuthal map projection proposed by David A. Aitoff in 1889. Based on the equatorial form of the azimuthal equidistant projection, Aitoff first halves longitudes, then projects according to the azimuthal equidistant, and then stretches the result horizontally into a 2:1 ellipse to compensate for having halved the longitudes.
AugustThe projection designed by Friedrich August and co-developed by Bellermann was published in 1874 as an alternative to Eisenlohr's design: the range of scale distortion is wider (1 : 8) and not constant at the boundary meridians, but its construction is somewhat simpler. A world map is bounded by an epicycloid, the shape defined by a point on a circle rolling without sliding around another, fixed, circle.
BonneA Bonne projection is a pseudoconical equal-area map projection, sometimes called a dépôt de la guerre or a Sylvanus projection. It is named after Rigobert Bonne (1727-1795), who used this projection considerably.
Eckert1Pseudocylindrical, neither conformal or equal-area, devoloped by Max Eckert (-Greifendorff); in 1906.
Eckert3Pseudocylindrical, neither conformal or equal-area, developed by Max Eckert (-Greifendorff) in 1906.
EquirectangularThe equirectangular projection (also called the equidistant cylindrical projection, geographic projection, or carte parallelogrammatique projection or CPP) is a very simple map projection attributed to Marinus of Tyre, who Ptolemy claims invented the projection about 100 AD. The projection maps meridians to equally spaced vertical straight lines, and parallels to equally spaced horizontal straight lines.
FaheyFahey Modified Gall, pseudocylindrical, neither conformal or equal-area, developed by Lawrence Fahey in 1975.
HammerHammer projection (also known as Hammer-Aitoff projection) produces an equal area map of the entire globe, it is useful for visual representations of geographically related statistical data and distributions. Astronomers use this projection to show the entire celestial sphere on one map in a way that accurately depicts the relative distribution of the stars in different regions of the sky.
MercatorThe Mercator projection is a cylindrical map projection presented by the Flemish geographer and cartographer Gerardus Mercator, in 1569. It became the standard map projection for nautical purposes because of its ability to represent lines of constant true bearing or true course, known as rhumb lines, as straight line segments. While the direction and shapes are accurate on a Mercator projection, it distorts the size.
OrthographicOrthographic projection is a map projection of cartography. Like the Stereographic projection and Gnomonic projection, Orthographic projection is a perspective (or azimuthal) projection, in which the sphere is projected onto a tangent plane or secant plane. The point of perspective for the Orthographic projection is at infinite distance. It depicts a hemisphere of the globe as it appears from outer space. The shapes and areas are distorted, particularly near the edges, but distances are preserved along parallels.
RobinsonA pseudo-cylindrical projection by reason of its straight parallels, along each of which the meridians are spaced evenly. The central meridian is also a straight line; other meridians are curved. Developed by Dr. Arthur H. Robinson in 1963.
Wagner6A pseudocylindrical projection, neither conformal or equal-area, developed by K. H. Wagner in 1932.
WSG84The World Geodetic System (WGS) is a standard for use in cartography, geodesy, and navigation including by GPS. It comprises a standard coordinate system for the Earth, a standard spheroidal reference surface (the datum or reference ellipsoid) for raw altitude data, and a gravitational equipotential surface (the geoid) that defines the nominal sea level.


World map in Aitoff projection:

  var map =;

JsFiddle Playground


World map in August projection:

  var map =;

JsFiddle Playground


World map in August projection:

  var map =;

JsFiddle Playground


World map in Eckert1 projection:

  var map =;

JsFiddle Playground


World map in Eckert3 projection:

  var map =;

JsFiddle Playground


World map in Equirectangular projection:

  var map =;

JsFiddle Playground


World map in Fahey projection:

  var map =;

JsFiddle Playground


World map in Hammer projection:

  var map =;

JsFiddle Playground


World map in Mercator projection:

  var map =;

JsFiddle Playground


World map in Orthographic projection:

  var map =;

JsFiddle Playground


World map in Robinson projection:

  var map =;

JsFiddle Playground


World map in Wagner6 projection:

  var map =;

JsFiddle Playground


World map in WSG84 projection:

  var map =;

JsFiddle Playground

Changing region projection

All samples above show how to change projection of a map, but there is also an option to change projection of any selected region or regions using featureCrs() method. This feature can come in particularly handy when you need to create a custom map with small regions or a region located in high/low latitudes. Usually this method is used along with featureScaleFactor() and featureTranslation(). For the moment regions projection settings can be set only using PROJ.4 strings (this will be improved in future versions on AnyMap), if you need assistance with such settings, do not hesitate to contact AnyChart Support.