Routing plugin

The routing plugin allows you to generate safe and legal routes for commercial vehicles and display those routes on the map. (See example.) To use the plugin, add the dependencies in module-level build.gradle file in the following format:

implementation("com.trimblemaps.mapsdk:maps-android-plugin-route:1.4.0")

When initializing the RoutePlugin, you can customize the stop icons and the text color used to draw routes. The code below depicts how you can do this:

 import com.trimblemaps.mapsdk.plugins.route.RoutePlugin;

routePlugin = new RoutePlugin(mapView , trimbleMapsMap , belowLayer ,
	stopStartIconDrawable,
	stopEndIconDrawable,
	bitmapDrawableFromVectorResource(R.drawable.ic_stop_blue),
	Color.parseColor("#FFFFFF"))

import com.trimblemaps.mapsdk.plugins.route.RoutePlugin

routePlugin = RoutePlugin(mapView , trimbleMapsMap , belowLayer ,
	stopStartIconDrawable,
	stopEndIconDrawable,
	bitmapDrawableFromVectorResource(R.drawable.ic_stop_blue),
	Color.parseColor("#FFFFFF"))

Once we have a valid route, we can pass that route into the RoutePlugin and it will draw the route on the map.

routePlugin.addRoute(Route)

routePlugin.addRoute(route)

If you want to clear the route via the RoutePlugin, you just use clearRoutes()

routePlugin.clearRoutes()

routePlugin.clearRoutes()

You can also frame the route passed with the frameRoutes() method. You have the option to set custom padding to the frame if you wish to zoom out or zoom in to the route drawn.

routePlugin.frameRoutes(PaddingLeft, PaddingTop, PaddingRight, PaddingBottom)

routePlugin.frameRoutes(paddingLeft, paddingTop, paddingRight, paddingBottom)

How to generate a route

In order to use the route plugin, you must first create a route to pass in. To generate a route, you need to define and initiate the RouteOptions. If there are only two stops in a trip, then the coordinates origin and destination should be defined and the intermediate stops can be null. If a trip has more than one stop, then you need to define the origin and destination, and put all the other stops in listOfMiddlePoints.

RouteOptions.Builder builder = RouteOptions.builder();
builder.applyDefaultParams()
    .coordinates(originPoint, listOfMiddlePoints, destinationPoint)
    .language(Settings.language.get(MainApplication.sharedPreferences()))
    .voiceUnits(Settings.distanceUnits.get(MainApplication.sharedPreferences()))
    .routeProfile(profile)
    .build();

val builder = RouteOptions.builder()
builder.applyDefaultParams()
    .coordinates(originPoint, listOfMiddlePoints, destinationPoint)
    .language(Settings.language.get(MainApplication.sharedPreferences()))
.voiceUnits(Settings.distanceUnits.get(MainApplication.sharedPreferences()))
    .routeProfile(profile)
val routeOptions = builder.build()

Now we can pass the routeOptions to a Route object.

Route.Builder builder = Route.builder();
builder.routeOptions(routeOptions)
	...
	...
    .build();

val builder = Route.builder()
builder.routeOptions(routeOptions)
	...
	...
val route = builder.build()

And the route can be added to the routePlugin:

routePlugin.addRoute(route)

routePlugin.addRoute(route)