Projection | Mapbox Style Spec

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.

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-90 and 18090 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].

"center": [
  -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-90 and 9090 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).

"parallels": [
  29.5,
  45.5
]

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

Was this page helpful?