Map styles

Contents

The Mobile Maps SDK examples require that you first complete the initial project set-up.

Set the map to night, day, or satellite.

Map Styles

activity_sample_change_styles.xml

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <com.trimblemaps.mapsdk.maps.MapView
        android:id="@+id/mapView"
        android:layout_width="0dp"
        android:layout_height="0dp"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

    <LinearLayout
        android:id="@+id/linearLayout"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:orientation="vertical"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent">

        <Button
            android:onClick="onClickChangeStyle"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="Mobile_Day"
            tools:ignore="HardcodedText" />

        <Button
            android:onClick="onClickChangeStyle"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="Mobile_Night"
            tools:ignore="HardcodedText" />

        <Button
            android:onClick="onClickChangeStyle"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="Mobile_Satellite"
            tools:ignore="HardcodedText" />
        <Button
            android:onClick="onClickChangeStyle"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="Terrain"
            tools:ignore="HardcodedText" />
        <Button
            android:onClick="onClickChangeStyle"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="Transportation"
            tools:ignore="HardcodedText" />
        <Button
            android:onClick="onClickChangeStyle"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="Basic"
            tools:ignore="HardcodedText" />
        <Button
            android:onClick="onClickChangeStyle"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="DataDark"
            tools:ignore="HardcodedText" />
        <Button
            android:onClick="onClickChangeStyle"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="DataLight"
            tools:ignore="HardcodedText" />
        <Button
            android:onClick="onClickChangeStyle"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="Default"
            tools:ignore="HardcodedText" />
        <Button
            android:onClick="onClickChangeStyle"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="Mobile_Default"
            tools:ignore="HardcodedText" />
        <Button
            android:onClick="onClickChangeStyle"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="Satellite"
            tools:ignore="HardcodedText" />
    </LinearLayout>

</androidx.constraintlayout.widget.ConstraintLayout>

SampleChangeStylesActivity.java

Before running the Java or Kotlin code, the theme needs to be set in the Theme.xml file as shown below.

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <style name="Theme.AsyncAcctInit" parent="Theme.AppCompat" />
</resources>

import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.Toast;

import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;

import com.trimblemaps.account.LicensedFeature;
import com.trimblemaps.account.TrimbleMapsAccountManager;
import com.trimblemaps.account.models.TrimbleMapsAccount;
import com.trimblemaps.mapsdk.TrimbleMaps;
import com.trimblemaps.mapsdk.camera.CameraPosition;
import com.trimblemaps.mapsdk.geometry.LatLng;
import com.trimblemaps.mapsdk.maps.MapView;
import com.trimblemaps.mapsdk.maps.OnMapReadyCallback;
import com.trimblemaps.mapsdk.maps.Style;
import com.trimblemaps.mapsdk.maps.TrimbleMapsMap;

public class SampleChangeStylesActivity extends AppCompatActivity implements Style.OnStyleLoaded{

    private MapView mapView;
    private TrimbleMapsMap map;
    private String chosenStyle = "Day Style"; // Used for toasts

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        // Authorize the API key for the session.
        // .apiKey() requires your Trimble Maps API key
        TrimbleMapsAccount trimbleMapsAccount = TrimbleMapsAccount.builder()
            .apiKey("Your-API-key-here")
            .addLicensedFeature(LicensedFeature.MAPS_SDK)
            .build();

        // Initialize the session
        TrimbleMapsAccountManager.initialize(trimbleMapsAccount);
        TrimbleMapsAccountManager.awaitInitialization();

        // Get an instance of the map, done before the layout is set.
        TrimbleMaps.getInstance(this);
        setContentView(R.layout.activity_sample_change_styles);

        // Set up the MapView from the layout
        mapView = (MapView) findViewById(R.id.mapView);
        // the onMapReadyCallback is fired when the map is ready to be worked with
        mapView.getMapAsync(new OnMapReadyCallback() {
            @Override
            public void onMapReady(@NonNull TrimbleMapsMap trimbleMapsMap) {
                // The TrimbleMapsMap object is created, now a style can be applied to render a map.
                // Set the initial camera position for a starting location
                map = trimbleMapsMap;
                CameraPosition position = new CameraPosition.Builder()
                    .target(new LatLng(40.7584766,-73.9840227))
                .zoom(13)
                .build();
                map.setCameraPosition(position);

                // Set the style, the callback is implemented into the class.
                map.setStyle(Style.MOBILE_DAY, MainActivity.this);
            }
        });
    }

    // When the buttons in the layout are clicked, this function is called to change the style
    public void onClickChangeStyle(View view) {
        // Simple switch statement on the button's text, style will change depending on it.
        String buttonText = ((Button) view).getText().toString();
        switch (buttonText) {
            case "Mobile_Satellite":
            chosenStyle = "Mobile_Satellite Style";
            map.setStyle(Style.MOBILE_SATELLITE, this);
            break;
            case "Mobile_Day":
            chosenStyle = "Mobile_Day Style";
            map.setStyle(Style.MOBILE_DAY, this);
            break;
            case "Mobile_Night":
            chosenStyle = "Mobile_Night Style";
            map.setStyle(Style.MOBILE_NIGHT, this);
            break;
            case "Terrain":
            chosenStyle = "Terrain Style";
            map.setStyle(Style.TERRAIN,this);
            break;
            case "Transportation":
            chosenStyle = "Transportation Style";
            map.setStyle(Style.TRANSPORTATION,this);
            break;
            case "Basic":
            chosenStyle = "Basic Style";
            map.setStyle(Style.BASIC,this);
            break;
            case "DataDark":
            chosenStyle = "DataDark Style";
            map.setStyle(Style.DATADARK,this);
            break;
            case "DataLight":
            chosenStyle = "DataLight Style";
            map.setStyle(Style.DATALIGHT,this);
            break;
            case "Default":
            chosenStyle = "Default Style";
            map.setStyle(Style.DEFAULT,this);
            break;
            case "Mobile_Default":
            chosenStyle = "Mobile_Default Style";
            map.setStyle(Style.MOBILE_DEFAULT,this);
            break;
            case  "Satellite":
            chosenStyle = "Satellite Style";
            map.setStyle(Style.SATELLITE,this);
            break;
        }
    }

    // Implemented onStyleLoaded to the class. When the style is changed a small toast appears to
    // confirm the choice.
    @Override
    public void onStyleLoaded(@NonNull Style style) {
        Toast toast = Toast.makeText(MainActivity.this, chosenStyle, Toast.LENGTH_SHORT);
        toast.show();
    }

    /**
     * Activity Overrides
     */
    @Override
    public void onLowMemory() {
        super.onLowMemory();
        mapView.onLowMemory();
    }
    @Override
    public void onStart() {
        super.onStart();
        mapView.onStart();
    }
    @Override
    public void onResume() {
        super.onResume();
        mapView.onResume();
    }
    @Override
    public void onStop() {
        super.onStop();
        mapView.onStop();
    }
    @Override
    public void onPause() {
        super.onPause();
        mapView.onPause();
    }
    @Override
    public void onDestroy() {
        super.onDestroy();
        mapView.onDestroy();
    }
}

import android.app.Activity
import android.os.Bundle
import android.view.View
import android.widget.Button
import android.widget.Toast
import com.trimblemaps.account.LicensedFeature
import com.trimblemaps.account.TrimbleMapsAccountManager
import com.trimblemaps.account.models.TrimbleMapsAccount
import com.trimblemaps.mapsdk.TrimbleMaps
import com.trimblemaps.mapsdk.camera.CameraPosition
import com.trimblemaps.mapsdk.geometry.LatLng

import com.trimblemaps.mapsdk.maps.MapView
import com.trimblemaps.mapsdk.maps.Style
import com.trimblemaps.mapsdk.maps.TrimbleMapsMap


class SampleChangeStylesActivity : Activity(), Style.OnStyleLoaded {
    private var mapView: MapView? = null
    private var map: TrimbleMapsMap? = null
    private var chosenStyle = "Day Style" // Used for toasts
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        // Authorize the API key for the session.
        // .apiKey() requires your Trimble Maps API key
        val trimbleMapsAccount = TrimbleMapsAccount.builder()
            .apiKey("Your-API-key-here")
            .addLicensedFeature(LicensedFeature.MAPS_SDK)
            .build()

        // Initialize the session
        TrimbleMapsAccountManager.initialize(trimbleMapsAccount)
        TrimbleMapsAccountManager.awaitInitialization()

        // Get an instance of the map, done before the layout is set.
        TrimbleMaps.getInstance(this)
        setContentView(R.layout.activity_sample_change_styles)

        // Set up the MapView from the layout
        mapView = findViewById<View>(R.id.mapView) as MapView
        // the onMapReadyCallback is fired when the map is ready to be worked with
        mapView!!.getMapAsync { trimbleMapsMap -> // The TrimbleMapsMap object is created, now a style can be applied to render a map.
            // Set the initial camera position for a starting location
            map = trimbleMapsMap
            val position = CameraPosition.Builder()
                .target(LatLng(40.7584766, -73.9840227))
                .zoom(13.0)
                .build()
            map!!.cameraPosition = position

            // Set the style, the callback is implemented into the class.
            map!!.setStyle(Style.MOBILE_DAY, this@MainActivity)
        }
    }

    // When the buttons in the layout are clicked, this function is called to change the style
    fun onClickChangeStyle(view: View) {
        // Simple switch statement on the button's text, style will change depending on it.
        when ((view as Button).text.toString()) {
            "Mobile_Satellite" -> {
                chosenStyle = "Mobile_Satellite Style"
                map?.setStyle(Style.MOBILE_SATELLITE, this)
            }
            "Mobile_Day" -> {
                chosenStyle = "Mobile_Day Style"
                map?.setStyle(Style.MOBILE_DAY, this)
            }
            "Mobile_Night" -> {
                chosenStyle = "Mobile_Night Style"
                map?.setStyle(Style.MOBILE_NIGHT, this)
            }
            "Terrain" -> {
                chosenStyle = "Terrain Style"
                map?.setStyle(Style.TERRAIN, this)
            }
            "Transportation" -> {
                chosenStyle = "Transportation Style"
                map?.setStyle(Style.TRANSPORTATION, this)
            }
            "Basic" -> {
                chosenStyle = "Basic Style"
                map?.setStyle(Style.BASIC, this)
            }
            "DataDark" -> {
                chosenStyle = "DataDark Style"
                map?.setStyle(Style.DATADARK, this)
            }
            "DataLight" -> {
                chosenStyle = "DataLight Style"
                map?.setStyle(Style.DATALIGHT, this)
            }
            "Default" -> {
                chosenStyle = "Default Style"
                map?.setStyle(Style.DEFAULT, this)
            }
            "Mobile_Default" -> {
                chosenStyle = "Mobile_Default Style"
                map?.setStyle(Style.MOBILE_DEFAULT, this)
            }
            "Satellite" -> {
                chosenStyle = "Satellite Style"
                map?.setStyle(Style.SATELLITE, this)
            }

        }
    }

    // Implemented onStyleLoaded to the class. When the style is changed a small toast appears to
    // confirm the choice.
    override fun onStyleLoaded(style: Style) {
        val toast = Toast.makeText(this@MainActivity, chosenStyle, Toast.LENGTH_SHORT)
        toast.show()
    }

    /**
     * Activity Overrides
     */
    override fun onStart() {
        super.onStart()
        mapView?.onStart()
    }
    override fun onResume() {
        super.onResume()
        mapView?.onResume()
    }
    override fun onPause() {
        super.onPause()
        mapView?.onPause()
    }
    override fun onStop() {
        super.onStop()
        mapView?.onStop()
    }
    override fun onLowMemory() {
        super.onLowMemory()
        mapView?.onLowMemory()
    }
    override fun onDestroy() {
        super.onDestroy()
        mapView?.onDestroy()
    }
}

WEB SDK & APIs

INTERACTIVE MAPS

SOAP APIs (Web Services)

RESTful APIs (Web Services)

MOBILE SDK & APIs

COPILOT NAVIGATION

INTERACTIVE MAPS

Map styles

activity_sample_change_styles.xml

SampleChangeStylesActivity.java