Projection | Mapbox Style Spec | Mapbox Docs (original) (raw)

Search Style Specification

On this page

• name
• center
• parallels

Additional Developer Resources

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.

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].

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).

Additional Developer Resources