Display a globe
This example showcases how to display a map as a 3D globe instead of the default Mercator projection, using the Mapbox Maps SDK for Android.
The code below create a map using the SATELLITE_STREETS style which pulls scanned images of the planet from satellite data and sets the projection mode to ProjectionName.GLOBE to render the 3D globe.
Our satellite data is pulled from various sources. To learn more about it, see our Satellite Documentation.
This example code is part of the Maps SDK for Android Examples App, a working Android project available on GitHub. Android developers are encouraged to run the examples app locally to interact with this example in an emulator and explore other features of the Maps SDK.
See our Run the Maps SDK for Android Examples App tutorial for step-by-step instructions.
package com.mapbox.maps.testapp.examples.globe
import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import com.mapbox.geojson.Point
import com.mapbox.maps.MapView
import com.mapbox.maps.Style
import com.mapbox.maps.dsl.cameraOptions
import com.mapbox.maps.extension.style.atmosphere.generated.atmosphere
import com.mapbox.maps.extension.style.layers.properties.generated.ProjectionName
import com.mapbox.maps.extension.style.projection.generated.projection
import com.mapbox.maps.extension.style.style
/**
* This example uses the Style DSL [projection] to display the map as a 3D globe instead of the default Mercator projection.
* A starry sky and atmosphere effects are added with Style DSL [atmosphere].
*/
class GlobeActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
val mapView = MapView(this)
setContentView(mapView)
mapView.mapboxMap.apply {
setCamera(
cameraOptions {
center(CENTER)
zoom(ZOOM)
}
)
loadStyle(
style(Style.SATELLITE_STREETS) {
+atmosphere { }
+projection(ProjectionName.GLOBE)
}
)
}
}
private companion object {
private const val ZOOM = 0.45
private val CENTER = Point.fromLngLat(30.0, 50.0)
}
}