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 SDKmacOS SDK

basic functionality

>= 2.6.0Not yet supportedNot yet supportedNot yet supported

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

basic functionality

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

basic functionality

>= 2.6.0Not yet supportedNot yet supportedNot yet supported