Route-Enhanced SDK-Android-Map Kit

HuaweiMapEx provides the following route drawing functions:

Sets route sections based on the traffic condition and point indexes on the route. You can set a style for each section, including the fill color and stroke color.
Shows an arrow indicating the road direction. You can set whether to show the arrow.
Sets different styles for multiple routes (primary and alternative routes).
Supports the route click event.
Displays road names.
Sets route animations, including the extension animation and transparency animation.

Drawing a Route

Call the addRouteLine method of HuaweiMapEx to draw a route on the map.

The sample code is as follows:

Java

Kotlin

Collapse
Word wrap
Dark theme
Copy code
public void addRouteLine(View view) {
    if (null == hMapEx) {
        return;
    }
    if (null != nRouteLine) {
        nRouteLine.remove();
        nRouteLine = null;
    }
    if (null != gRouteLine) {
        gRouteLine.remove();
        gRouteLine = null;
    }
    // Add a route.
    nRouteLine = hMapEx.addRouteLine(new RouteLineOptions().add(new LatLng(47.893478, 2.334595),
        new LatLng(48.993478, 3.434595),
        new LatLng(48.693478, 2.134595),
        new LatLng(48.793478, 2.334595)));
    gRouteLine = hMapEx.addRouteLine(new RouteLineOptions().add(
        new LatLng(47,3),
        new LatLng(47,4),
        new LatLng(48,4),
        new LatLng(48,5),
        new LatLng(48,4),
        new LatLng(49,4))
    );
}

Collapse
Word wrap
Dark theme
Copy code
fun addRouteLine(view: View?) {
    if (null == hMapEx) {
        return
    }
    if (null != nRouteLine) {
        nRouteLine!!.remove()
        nRouteLine = null
    }
    if (null != gRouteLine) {
        gRouteLine!!.remove()
        gRouteLine = null
    }
    // Add a route.
    nRouteLine = hMapEx.addRouteLine(RouteLineOptions().add(LatLng(47.893478, 2.334595),
        LatLng(48.993478, 3.434595),
        LatLng(48.693478, 2.134595),
        LatLng(48.793478, 2.334595)))
    gRouteLine = hMapEx.addRouteLine(RouteLineOptions().add(
        LatLng(47.0, 3.0),
        LatLng(47.0, 4.0),
        LatLng(48.0, 4.0),
        LatLng(48.0, 5.0),
        LatLng(48.0, 4.0),
        LatLng(49.0, 4.0))
    )
}

Click to enlarge

Setting the Road Name

Call the setLabelsText method of RouteLine to set the road name.

The sample code is as follows:

Java

Kotlin

Collapse
Word wrap
Dark theme
Copy code
private final List<String> textListLabel = new ArrayList<>();
private final List<Integer> indexListLabel = new ArrayList<>();
public void setLabelsText(View view) {
    try{
        if (null != nRouteLine) {
            // Set the road name.
            textListLabel.add("text");
            indexListLabel.add(1);
            indexListLabel.add(3);
            nRouteLine.setLabelsText(textListLabel,indexListLabel,"EN",false);
        }
    }catch (Exception e){       
    }
}

Collapse
Word wrap
Dark theme
Copy code
private var textListLabel : ArrayList<String> = ArrayList()
private var indexListLabel: ArrayList<Int> = ArrayList()
fun setLabelsText(view : View?) {
    try{
        if (null != nRouteLine) {
            // Set the road name.
            textListLabel.add("text")
            indexListLabel.add(1)
            indexListLabel.add(3)
            nRouteLine!!.setLabelsText(textListLabel,indexListLabel,"EN",false)
        }
    }catch (e : Exception ){    
    }
}

Click to enlarge

Setting the Extension Animation for a Route

Create a LineExtendAnimation object and set its attributes. Call the setAnimation method of RouteLine to set the extension animation, and then call the startAnimation method to start the animation.

The sample code is as follows:

Java

Kotlin

Collapse
Word wrap
Dark theme
Copy code
public void extendAnimation(View view) {
    if(nRouteLine == null){
        Toast.makeText(this, "Please add RouteLine first.", Toast.LENGTH_SHORT).show();
        return;
    }
    extendAnimation = new LineExtendAnimation();
    extendAnimation.setDuration(5000);
    extendAnimation.setInterpolator(LineAnimation.LineInterpolator.LINEARINTERPOLATOR);
    // Add the extension animation for the route.
    nRouteLine.setAnimation(extendAnimation);
    // Start the animation.
    nRouteLine.startAnimation();
}

Collapse
Word wrap
Dark theme
Copy code
lateinit var extendAnimation : LineExtendAnimation;
fun extendAnimation(view: View?) {
    if (nRouteLine == null) {
        Toast.makeText(this, "Please add RouteLine first.", Toast.LENGTH_SHORT).show()
        return
    }
    extendAnimation = LineExtendAnimation()
    extendAnimation.duration = 5000
    extendAnimation.interpolator = LineAnimation.LineInterpolator.LINEARINTERPOLATOR
    // Add the extension animation for the route.
    nRouteLine!!.setAnimation(extendAnimation)
    // Start the animation.
    nRouteLine!!.startAnimation()
}

Click to enlarge