Projection

Search Style Specification

Search Style Specification

Join the Mapbox Developers Discord Communityarrow-right

A style's projection property sets which projection a map is rendered in. Mapbox GL supports the following projections:

• Globe: A 3D representation of the Earth.
  • globe
• Equal-area projections: Relative size of regions is accurate, but shapes are distorted.
  • equalEarth
  • albers
• Conformal projections: Shapes and angles are accurate, but sizes are distorted.
  • mercator
  • lambertConformalConic
• Compromise projections: A balance of size and shape distortion.
  • winkelTripel
  • naturalEarth
  • equirectangular

Learn more about supported projections in the projection guide.

name

Required enum . One of "albers", "equalEarth", "equirectangular", "lambertConformalConic", "mercator", "naturalEarth", "winkelTripel", "globe". Defaults to "mercator".

The name of the projection to be used for rendering the map.

"albers":

An Albers equal-area projection centered on the continental United States. You can configure the projection for a different region by setting center and parallels properties. You may want to set max bounds to constrain the map to the relevant region.

"equalEarth":

An Equal Earth projection.

"equirectangular":

An Equirectangular projection. This projection is very similar to the Plate Carrée projection.

"lambertConformalConic":

A Lambert conformal conic projection. You can configure the projection for a region by setting center and parallels properties. You may want to set max bounds to constrain the map to the relevant region.

"mercator":

The Mercator projection is the default projection.

"naturalEarth":

A Natural Earth projection.

"winkelTripel":

A Winkel Tripel projection.

"globe":

A globe projection.

SDK Support	Mapbox GL JS	Android SDK	iOS SDK
basic functionality	>= 2.6.0	>= 10.5.0	>= 10.5.0

center

Optional array of numbers [ between -180 and 180 inclusive, between -90 and 90 inclusive ]. Requires name to be "albers", or "lambertConformalConic".

The reference longitude and latitude of the projection. center takes the form of [lng, lat]. This property is only configurable for conic projections (Albers and Lambert Conformal Conic). All other projections are centered on [0, 0].

[
  -96,
  37.5
]

SDK Support	Mapbox GL JS	Android SDK	iOS SDK
basic functionality	>= 2.6.0	Not yet supported	Not yet supported

parallels

Optional array of numbers [ between -90 and 90 inclusive, between -90 and 90 inclusive ]. Requires name to be "albers", or "lambertConformalConic".

The standard parallels of the projection, denoting the desired latitude range with minimal distortion. parallels takes the form of [lat0, lat1]. This property is only configurable for conic projections (Albers and Lambert Conformal Conic).

[
  29.5,
  45.5
]

SDK Support	Mapbox GL JS	Android SDK	iOS SDK
basic functionality	>= 2.6.0	Not yet supported	Not yet supported

Join the Mapbox Developers Discord Communityarrow-right

Was this page helpful?