Mapbox Standard Satellite
Access this Style
Use this Style URL to load this style in any Mapbox SDK or library:
mapbox://styles/mapbox/standard-satellite
Retrieve the full style JSON via the Styles API:
https://api.mapbox.com/styles/v1/mapbox/standard-satellite?access_token=YOUR_MAPBOX_ACCESS_TOKEN
Map Preview
This page provides a comprehensive overview of the Mapbox Standard Satellite style's configuration options. Mapbox Standard Satellite combines the dynamic features of Mapbox Standard with a global satellite imagery base layer.
You can try out many of the configuration options listed below in the Mapbox Standard Style Playground. This interactive tool allows you to see how different configurations affect the map style in real-time, and see the implementation code for web, iOS, and Android projects.
Configuration Properties
The following configurations are available in Mapbox Standard-Satellite starting with the version number indicated in the Compatibility section below.
| Property | Type | Description | Compatibility |
|---|---|---|---|
showRoadsAndTransit | Boolean | Show or hide roads and transit networks. | Android and iOS SDK v11.0.0 and GL-JS v3.0.0 |
showPedestrianRoads | Boolean | Show or hide pedestrian roads, paths, trails. | Android and iOS SDK v11.0.0 and GL-JS v3.0.0 |
showPlaceLabels | Boolean | Show or hide place label layers. | Android and iOS SDK v11.0.0 and GL-JS v3.0.0 |
showPointOfInterestLabels | Boolean | Show or hide POI icons and text. | Android and iOS SDK v11.0.0 and GL-JS v3.0.0 |
showRoadLabels | Boolean | Show or hide road labels, including road shields. | Android and iOS SDK v11.0.0 and GL-JS v3.0.0 |
showTransitLabels | Boolean | Show or hide transit icons and text. | Android and iOS SDK v11.0.0 and GL-JS v3.0.0 |
showAdminBoundaries | Boolean | Show or hide administrative boundaries. | Android and iOS SDK v11.11.0 and GL-JS v3.11.1 |
lightPreset | String | Switches between 4 time-of-day states: dusk, dawn, day, and night. Lights can also be fully customized beyond the presets using the Mapbox style specification. | Android and iOS SDK v11.0.0 and GL-JS v3.0.0 |
font | String | Defines font family for the style, including any custom font uploaded to your account. Mapbox Standard will fallback to a default font if a custom font family doesn't include necessary weights (weights used by the basemap: Bold, Medium, Regular, Italic). We recommend the following default Mapbox fonts: Alegreya, Alegreya SC, Asap, Barlow, DIN Pro, EB Garamond, Faustina, Frank Ruhl Libre, Heebo, Inter, League Mono, Montserrat, Poppins, Raleway, Roboto, Roboto Mono, Rubik, Source, Code Pro, Spectral, Ubuntu, Noto Sans CJK JP, Open Sans, Manrope, Source Sans Pro, Lato. | Android and iOS SDK v11.11.0 and GL-JS v3.14.0 |
colorModePointOfInterestLabels | String | Switches between default and single color modes for POI labels. | Android and iOS SDK v11.11.0 and GL-JS v3.11.1 |
backgroundPointOfInterestLabels | String | Switches between circle and none for the background of POI labels. | Android and iOS SDK v11.11.0 and GL-JS v3.11.1 |
densityPointOfInterestLabels | Number | Set the density of POI labels between 1 and 5, default set to 3. | Android and iOS SDK v11.11.0 and GL-JS v3.11.1 |
fuelingStationModePointOfInterestLabels | String | Control the visibility of fuel and electric charging station POI labels. Default displays both types. | Android and iOS SDK v11.11.0 and GL-JS v3.14.0 |
colorPlaceLabels | Color | Color override for place labels. | Android and iOS SDK v11.11.0 and GL-JS v3.11.1 |
colorRoadLabels | Color | Color override for road labels. | Android and iOS SDK v11.11.0 and GL-JS v3.11.1 |
colorAdminBoundaries | Color | Color override for administrative boundaries. | Android and iOS SDK v11.11.0 and GL-JS v3.11.1 |
colorPointOfInterestLabels | Color | Color override for POI labels with a single color. | Android and iOS SDK v11.11.0 and GL-JS v3.11.1 |
colorMotorways | Color | Color override for motorways. | Android and iOS SDK v11.9.0 and GL-JS v3.9.0 |
colorTrunks | Color | Color override for trunk roads. | Android and iOS SDK v11.9.0 and GL-JS v3.9.0 |
colorRoads | Color | Color override for other roads. | Android and iOS SDK v11.9.0 and GL-JS v3.9.0 |
Featuresets
Mapbox Standard includes several predefined featuresets that can be used to quickly configure the style for specific use cases. Featuresets are a collection of configuration properties that can be applied to the style all at once. The following featuresets are available:
You can use Interactions to retrieve basemap attributes and interact with individual features in POI Label, Place Label and building layers in the basemap.
Featuresets describe a collection of layers that can be interacted with in the Standard style, by setting feature-states to change their appearance when interacted with, or to query feature attributes. The following interactions have been added:
Points of Interest
The poi featureset contains all the point of interest layers in the Mapbox Standard style. This featureset is useful for applications that want to display additional information about points of interest on the map, or to highlight points of interest when a user interacts with them.
Feature State
| Property | Type | Description |
|---|---|---|
hide | Boolean | When true hides the icon and text. Use this state when displaying a custom annotation in place of the hidden symbol. |
Feature Properties
Available for all features in the poi featureset:
| Property | Description |
|---|---|
name | Name of the point of interest. |
class | A broad point of interest category, for example 'food_and_drink'. |
maki | An icon identifier, designed to assign icons using the Maki icon project or other icons that follow the same naming scheme. |
group | A high-level point of interest category like airport, transit, etc. |
Available for features with group = transit:
| Property | Description |
|---|---|
transit_mode | Mode of transport served by a stop/station. |
transit_stop_type | A type of transit stop. |
transit_network | A rail station network identifier that is part of specific local or regional transit systems. |
Available for features with group = airport:
| Property | Description |
|---|---|
airport_ref | A short identifier code of the airport. |
Available for features with group = natural-point:
| Property | Description |
|---|---|
name | Name of the natural feature. |
class | A broad category of the natural feature. |
maki | An icon identifier for the natural feature. |
Place Labels
The place-labels featureset contains all the place label layers in the Mapbox Standard style. This featureset is useful for applications that want to display additional information about places on the map, or to highlight places when a user interacts with them.
Feature State
| Property | Type | Description |
|---|---|---|
hide | Boolean | When true, hides the label. Use this state when displaying a custom annotation in place of the hidden symbol. |
highlight | Boolean | When true, the feature is highlighted. Use this state to create a temporary effect (e.g., hover). |
select | Boolean | When true, the feature is selected. Use this state to create an effect that persists until another state is selected. Note: The select state has a higher priority than highlight. |
Feature Properties
Each feature in the place-labels featureset has the following properties:
| Property | Description |
|---|---|
name | Name of the place label. |
class | Provides a broad distinction between place types. |
You can see select & highlight in action in this demo page.
Slots
Mapbox Standard includes three slot layers to help you control where custom layers will appear relative to other layers in the style. The following slots are available:
| Slot | Description |
|---|---|
bottom | Above the satellite imagery and below all other layers |
middle | Above lines (roads, etc.) and behind street labels |
top | Above POI and street labels and behind Place and Transit labels |
| not specified | Above all existing layers in the style when not using the globe projection. Below labels when using the globe projection. Learn more about projections in the Mapbox Style Spec reference. |