Skip to main content

Projection

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

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 SupportMapbox GL JSAndroid SDKiOS 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 SupportMapbox GL JSAndroid SDKiOS SDK

basic functionality

>= 2.6.0Not yet supportedNot 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 SupportMapbox GL JSAndroid SDKiOS SDK

basic functionality

>= 2.6.0Not yet supportedNot yet supported
Was this page helpful?