Getting started (3)Create a simple map viewDynamically build a map viewSupport map fragmentDynamic styling (30)HillshadingAdd a vector tile sourceAdd a new layer below labelsAnimate marker positionAdjust a layer's opacityShow time lapseAnimated image source (GIF)Icon update based on API responseChange a layer's colorChange a map's languageColor dependent on zoom levelClick to add photoIndoor MapMarker following routeStyle with missing iconSymbol layer iconsPicture in picturePulsing layer opacityAdd a WMS sourceText anchor positionButton interaction stylingOpacity fadeShow and hide layersSymbolLayer iconsAdjust text labelsMultiple text formatsTransparent render surfaceUse an image sourceAnimated icon movementVariable label placementExtrusions (5)Adjust light location and colorDisplay 3D building height based on vector dataExtrude polygons for 3D indoor mappingRotate and tilt with 3D buildingsUse GeoJSON data to set extrusion heightCamera (5)Animate the map cameraFit camera in bounding boxRestrict map panningRotating cameraZoom to show a cluster's leavesData visualization (33)Baseball spray chartDisplay water depthBiometric fingerprintCalendar integrationCircle icon toggleCircleLayer clustersCircle radiusCircle to icon transitionCreate a line layerCreate hotspots from pointsData time lapseShow heatmap dataDraw a GeoJSON lineDraw a polygon with holesDraw a polygonDraw multiple geometriesJoin local JSON data with vector tile geometriesLine gradientLine behind moving iconMultiple expressionsIcon setting based on Feature propertyOutlined polygon holeSatellite land selectShared preferencesSpinning iconStyle circles categoricallyStyle lines using an identity property functionToggle collision detectionSymbolLayer clusteringSymbol layer info windowZoom-based icon switchUpdate a choropleth layer by zoom levelStyling heatmapsOffline (3)Cache managementA simple offline mapOffline managerQuerying the map (3)Building outlineQuery a map featureSelect a buildingMap style (4)Style attributionLocal style or custom raster styleDefault stylesMapbox Studio styleUser interaction (12)Click on single layerFeature countDrawing search areaHighlighted lineSymbol layer icon size changeInset mapLocation pickerBackground fogRecyclerView DirectionsSearch again in an areaSnaking directionsRecyclerView interactionImage generation (2)Snapshot NotificationShare snapshot imageDevice location (7)Track device locationBasic pulsing locationLocation camera optionsCustom pulsing locationCustomized location iconShow a user's location on a map fragmentShow a user's location

Icon update based on API response

<?xml version="1.0" encoding="utf-8"?>
android:layout_height="match_parent" />
package com.mapbox.mapboxandroiddemo.examples.labs;
import android.graphics.BitmapFactory;
import android.os.Bundle;
import android.os.Handler;
import android.widget.Toast;
import com.mapbox.geojson.Feature;
import com.mapbox.geojson.FeatureCollection;
import com.mapbox.geojson.Point;
import com.mapbox.mapboxandroiddemo.R;
import com.mapbox.mapboxandroiddemo.model.IssModel;
import com.mapbox.mapboxsdk.Mapbox;
import com.mapbox.mapboxsdk.camera.CameraUpdateFactory;
import com.mapbox.mapboxsdk.geometry.LatLng;
import com.mapbox.mapboxsdk.maps.MapView;
import com.mapbox.mapboxsdk.maps.MapboxMap;
import com.mapbox.mapboxsdk.maps.OnMapReadyCallback;
import com.mapbox.mapboxsdk.maps.Style;
import com.mapbox.mapboxsdk.style.layers.SymbolLayer;
import com.mapbox.mapboxsdk.style.sources.GeoJsonSource;
import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import retrofit2.Call;
import retrofit2.Callback;
import retrofit2.Response;
import retrofit2.Retrofit;
import retrofit2.converter.gson.GsonConverterFactory;
import retrofit2.http.GET;
import timber.log.Timber;
import static com.mapbox.mapboxsdk.style.layers.PropertyFactory.iconAllowOverlap;
import static com.mapbox.mapboxsdk.style.layers.PropertyFactory.iconIgnorePlacement;
import static com.mapbox.mapboxsdk.style.layers.PropertyFactory.iconImage;
import static com.mapbox.mapboxsdk.style.layers.PropertyFactory.iconSize;
* Display the space station's real-time location
public class SpaceStationLocationActivity extends AppCompatActivity {
private static final String TAG = "SpaceStationActivity";
private Handler handler;
private Runnable runnable;
private Call<IssModel> call;
// apiCallTime is the time interval when we call the API in milliseconds, by default this is set
// to 2000 and you should only increase the value, reducing the interval will only cause server
// traffic, the latitude and longitude values aren't updated that frequently.
private int apiCallTime = 2000;
// Map variables
private MapView mapView;
private MapboxMap map;
protected void onCreate(Bundle savedInstanceState) {
// Mapbox access token is configured here. This needs to be called either in your application
// object or in the same activity which contains the mapview.
Mapbox.getInstance(this, getString(R.string.access_token));
// This contains the MapView in XML and needs to be called after the access token is configured.
// Initialize the MapView
mapView = findViewById(R.id.mapView);
mapView.getMapAsync(new OnMapReadyCallback() {
public void onMapReady(@NonNull final MapboxMap mapboxMap) {
map = mapboxMap;
mapboxMap.setStyle(Style.SATELLITE_STREETS, new Style.OnStyleLoaded() {
public void onStyleLoaded(@NonNull Style style) {
Toast.makeText(SpaceStationLocationActivity.this, R.string.space_station_toast, Toast.LENGTH_SHORT).show();
private void callApi() {
// Build our client, The API we are using is very basic only returning a handful of
// information, mainly, the current latitude and longitude of the International Space Station.
Retrofit client = new Retrofit.Builder()
final IssApiService service = client.create(IssApiService.class);
// A handler is needed to called the API every x amount of seconds.
handler = new Handler();
runnable = new Runnable() {
public void run() {
// Call the API so we can get the updated coordinates.
call = service.loadLocation();
call.enqueue(new Callback<IssModel>() {
public void onResponse(Call<IssModel> call, Response<IssModel> response) {
// We only need the latitude and longitude from the API.
if (response.body() != null) {
double latitude = response.body().getIssPosition().getLatitude();
double longitude = response.body().getIssPosition().getLongitude();
updateMarkerPosition(new LatLng(latitude, longitude));
public void onFailure(Call<IssModel> call, Throwable throwable) {
// If retrofit fails or the API was unreachable, an error will be called.
//to check if throwable is null, then give a custom message.
if (throwable.getMessage() == null) {
Timber.e("Http connection failed");
} else {
// Schedule the next execution time for this runnable.
handler.postDelayed(this, apiCallTime);
// The first time this runs we don't need a delay so we immediately post.
private void initSpaceStationSymbolLayer(@NonNull Style style) {
this.getResources(), R.drawable.iss));
style.addSource(new GeoJsonSource("source-id"));
style.addLayer(new SymbolLayer("layer-id", "source-id").withProperties(
private void updateMarkerPosition(LatLng position) {
// This method is where we update the marker position once we have new coordinates. First we
// check if this is the first time we are executing this handler, the best way to do this is
// check if marker is null;
if (map.getStyle() != null) {
GeoJsonSource spaceStationSource = map.getStyle().getSourceAs("source-id");
if (spaceStationSource != null) {
Feature.fromGeometry(Point.fromLngLat(position.getLongitude(), position.getLatitude()))
// Lastly, animate the camera to the new position so the user
// wont have to search for the marker and then return.
// Interface used for Retrofit.
public interface IssApiService {
Call<IssModel> loadLocation();
public void onResume() {
// When the user returns to the activity we want to resume the API calling.
if (handler != null && runnable != null) {
protected void onStart() {
protected void onStop() {
public void onPause() {
// When the user leaves the activity, there is no need in calling the API since the map
// isn't in view.
if (handler != null && runnable != null) {
public void onLowMemory() {
protected void onDestroy() {
protected void onSaveInstanceState(Bundle outState) {
Was this page helpful?