Projection
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.
- Equal-area projections: Relative size of regions is accurate, but shapes are distorted.
- Conformal projections: Shapes and angles are accurate, but sizes are distorted.
- Compromise projections: A balance of size and shape distortion.
Learn more about supported projections in the projection guide.
name
"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
centerandparallelsproperties. 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
centerandparallelsproperties. 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
-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
-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 |