# Using multi-stop navigation ### Querying a multi-stop route To query a multistop route a new overload `MPDirectionsService.query` has been introduced `MPDirectionsService.query(from: MPPoint, to: MPPoint, stops: List?, optimize: Boolean)`.

private var directionsService: MPDirectionsService = MPDirectionsService()

//Example of querying an optimized route with multiple stops
fun getRoute() {
    if (directionsService != null) {
        directionsService = MPDirectionsService()
    }
    //Setting listener to receive the queried route
    directionsService.setRouteResultListener { route, error ->
        if (error == null && route != null) {
            //Route is received
        } else {
            Log.i("Directions", "Error: $error")
        }
    }
    //Creating variables to use for the query
    val origin = MPPoint(57.05800975, 9.949916517)
    val destination = MPPoint(57.058278, 9.9512196, 10.0)
    val stops = listOf(MPPoint(57.0582701, 9.9508396, 0.0), MPPoint(57.0580431, 9.9505475, 0.0), MPPoint(57.0580843, 9.9506085, 10.0))
    
    directionsService.query(origin, destination, stops, true)
}

### Showing and configuring a multi-stop route on the map With the introduction of the multi-stop routes. There has also been added new functionality to the `MPDirectionsRenderer` to facilitate the new multi-stop routes. You can still render the route as a Route with stops, using `setRoute(route: MPRoute)` on the DirectionsRenderer. But the interface of the `MPDirectionsRenderer` has been expanded with a `defaultStopIcon` as well as an overload of: `setRoute(route: MPRoute, icons: HashMap?)`

By default route stops will be shown as a red pin with numbers

The `defaultStopIcon` can be configured to show any image. It can also be set to null, to not show any icon for the stops on the Route. We supply the `MPRouteStopIconConfig` that allows you to customize the default pin to fit your application. ```kotlin //Changing the default icon to be blue, with a Meeting Room label and with no number inside the pin val defaultRouteStopIcon = MPRouteStopIconConfig.Builder(myContext) .setColor(Color.BLUE) .setNumbered(false) .setLabel("Meeting Room") .build() directionsRenderer?.setDefaultRouteStopIconConfig(defaultRouteStopIcon) ```

To use your own images, you can extend the MPRouteStopIconProvider with your own class. Here is an example using a bitmap for the image ```kotlin class BitmapRouteStopIcon(val image: Bitmap) : MPRouteStopIconProvider() { override fun getImage(): Bitmap? { return image } } ``` #### Adding a custom image to a specific waypoint It is also possible to render an image specific to a single stop. By using `setRoute(route: MPRoute, icons: HashMap?)` ```kotlin val stopIcons = mapOf(2 to MPRouteStopIconConfig.Builder(this).setColor(Color.BLUE).build()) directionsRenderer?.setRoute(route, HashMap(stopIcons)) ``` Here we will show a blue icon for the third stop. Leaving the first two indexes as null, means that the renderer will use the `defaultStopIcon`. If you want to render a specific known stop on an optimized route. You can find the ordering of the stops on an optimized route through `MPRoute.orderedStopIndexes`. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.mapsindoors.com/sdks-and-frameworks/android/directions/using-multi-stop-navigation.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.