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

Animated image source (GIF)

<?xml version="1.0" encoding="utf-8"?>
package com.mapbox.mapboxandroiddemo.examples.labs;
import android.graphics.Bitmap;
import android.graphics.Canvas;
import android.graphics.Movie;
import android.os.Bundle;
import android.os.Handler;
import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import com.mapbox.mapboxandroiddemo.R;
import com.mapbox.mapboxsdk.Mapbox;
import com.mapbox.mapboxsdk.geometry.LatLng;
import com.mapbox.mapboxsdk.geometry.LatLngQuad;
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.RasterLayer;
import com.mapbox.mapboxsdk.style.sources.ImageSource;
import java.io.InputStream;
* Add an animated image (GIF) anywhere on the map
public class AnimatedImageGifActivity extends AppCompatActivity implements OnMapReadyCallback {
private static final String ID_IMAGE_SOURCE = "animated_image_source";
private static final String ID_IMAGE_LAYER = "animated_image_layer";
private MapView mapView;
private Handler handler;
private Runnable runnable;
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.
mapView = findViewById(R.id.mapView);
public void onMapReady(@NonNull final MapboxMap map) {
map.setStyle(Style.MAPBOX_STREETS, new Style.OnStyleLoaded() {
public void onStyleLoaded(@NonNull Style style) {
// Use the RefreshImageRunnable class and runnable to quickly display images for a GIF/video UI experience
InputStream gifInputStream = getResources().openRawResource(R.raw.waving_bear);
runnable = new RefreshImageRunnable(style, Movie.decodeStream(gifInputStream), handler = new Handler());
handler.postDelayed(runnable, 100);
protected void onStart() {
public void onResume() {
public void onPause() {
protected void onStop() {
if (handler != null) {
protected void onDestroy() {
protected void onSaveInstanceState(Bundle outState) {
private static class RefreshImageRunnable implements Runnable {
private ImageSource imageSource;
private Style style;
private Movie movie;
private Handler handler;
private long movieStart;
private Bitmap bitmap;
private Canvas canvas;
RefreshImageRunnable(Style style, Movie movie, Handler handler) {
this.style = style;
this.movie = movie;
this.handler = handler;
bitmap = Bitmap.createBitmap(movie.width(), movie.height(), Bitmap.Config.ARGB_8888);
canvas = new Canvas(bitmap);
public void run() {
long now = android.os.SystemClock.uptimeMillis();
if (movieStart == 0) {
movieStart = now;
int dur = movie.duration();
if (dur == 0) {
dur = 1000;
movie.setTime((int) ((now - movieStart) % dur));
movie.draw(canvas, 0, 0);
if (imageSource == null) {
// Set the bounds/size of the gif. Then create an image source object with a unique id,
// the bounds, and drawable image
imageSource = new ImageSource(ID_IMAGE_SOURCE,
new LatLngQuad(
new LatLng(46.437, -80.425),
new LatLng(46.437, -71.516),
new LatLng(37.936, -71.516),
new LatLng(37.936, -80.425)), bitmap);
// Add the source to the map
// Create an raster layer with a unique id and the image source created above. Then add the layer to the map.
style.addLayer(new RasterLayer(ID_IMAGE_LAYER, ID_IMAGE_SOURCE));
handler.postDelayed(this, 50);
Was this page helpful?