Polyline

A polyline is a list of points, where line segments are drawn between consecutive points. A polyline has the following properties:

Points

The vertices of the line. Line segments are drawn between consecutive points. A polyline is notclosed by default; to form a closed polyline, the start and end points must be the same.

Width

Line segment width in screen pixels. The width is constant and independent of the camera's zoom level. The default value is 10.

Color

Line segment color in ARGB format, the same format used byColor. The default value is black (0xff000000).

Start/end cap

Defines the shape to be used at the start or end of a polyline. Supported cap types:ButtCap,SquareCap,RoundCap(applicable for solid stroke pattern) and CustomCap(applicable for any stroke pattern). Default for both start and end: ButtCap.

Joint type

The joint type defines the shape to be used when joining adjacent line segments at all vertices of the polyline except the start and end vertices. SeeJointTypefor supported joint types. The default value isDEFAULT.

Stroke pattern

Solid (default, represented bynull) or a sequence ofPatternItemobjects to be repeated along the line. AvailablePatternItemtypes:Gap(defined by gap length in pixels),Dash(defined by line width and dash length in pixels) and Dot(circular, centered on the line, diameter defined by line width in pixels).

Z-Index

The order in which this tile overlay is drawn with respect to other overlays (including GroundOverlays,TileOverlays,Circles, andPolygons but not Markers). An overlay with a larger z-index is drawn over overlays with smaller z-indices. The order of overlays with the same z-index is arbitrary. The default zIndex is 0.

Visibility

Indicates if the polyline is visible or invisible, i.e., whether it is drawn on the map. An invisible polyline is not drawn, but retains all of its other properties. The default is true,i.e., visible.

Geodesic status

Indicates whether the segments of the polyline should be drawn as geodesics, as opposed to straight lines on the Mercator projection. A geodesic is the shortest path between two points on the Earth's surface. The geodesic curve is constructed assuming the Earth is a sphere

Clickability

If you want to handle events fired when the user clicks the polyline, set this property to true.You can change this value at any time. The default isfalse.If this property is set totrue,your app will receive notifications to theGoogleMap.OnPolylineClickListenerregistered throughsetOnPolylineClickListener(GoogleMap.OnPolylineClickListener).

Tag

AnObjectassociated with the polyline. For example, theObjectcan contain data about what the polyline represents. This is easier than storing a separateMap<Polyline, Object>.As another example, you can associate aStringID corresponding to the ID from a data set. Google Maps SDK for Android neither reads nor writes this property.

Spans

Defines the spans with different styles used to render this polyline. You can use this property to create a polyline with differentStrokeStyleon different segments of the polyline.

Methods in this class must be called on the Android UI thread. If not, anIllegalStateExceptionwill be thrown at runtime.

Example

GoogleMap map;
//... get a map.
// Add a thin red line from London to New York.
Polyline line = map.addPolyline(new PolylineOptions()
.add(new LatLng(51.5, -0.1), new LatLng(40.7, -74.0))
.width(5)
.color(Color.RED));

Developer Guide

For more information, read theShapesdeveloper guide.