Polyline google maps android

How to Draw Polyline in Google Maps in Android?

Google Maps is used in many Android applications. While using Google Maps there are many modifications which you will get to see while using Maps in this apps. When we have used Google Maps in different apps such as OLA and Uber we will get to see lines and routes drawn on our Maps. In this article, we will take a look at drawing Polyline on Google Maps in Android.

What we are going to build in this article?

We will be building a simple application in which we will display our Map. On this map, we will display a polygon between three locations as Brisbane, Tamworth, and Newcastle. A sample image is given below to get an idea about what we are going to do in this article. Note that we are going to implement this project using the Java language.

Step by Step Implementation

Step 1: Create a New Project

To create a new project in Android Studio please refer to How to Create/Start a New Project in Android Studio. Note that select Java as the programming language. Make sure to select Maps Activity while creating a new Project.

Step 2: Generating an API key for using Google Maps

To generate the API key for Maps you may refer to How to Generate API Key for Using Google Maps in Android. After generating your API key for Google Maps. We have to add this key to our Project. For adding this key in our app navigate to the values folder > google_maps_api.xml file and at line 23 you have to add your API key in the place of YOUR_API_KEY.

Step 3: Adding Polyline on Google Maps in Android

Источник

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 not closed 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 by Color . 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. See JointType for supported joint types. The default value is DEFAULT . Stroke pattern Solid (default, represented by null ) or a sequence of PatternItem objects to be repeated along the line. Available PatternItem types: 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 GroundOverlay s, TileOverlay s, Circle s, and Polygon s but not Marker s). 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 is false . If this property is set to true , your app will receive notifications to the GoogleMap.OnPolylineClickListener registered through setOnPolylineClickListener(GoogleMap.OnPolylineClickListener) . Tag An Object associated with the polyline. For example, the Object can contain data about what the polyline represents. This is easier than storing a separate Map

. As another example, you can associate a String ID 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 different StrokeStyle on different segments of the polyline.

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

Example

Developer Guide

For more information, read the Shapes developer guide.

Источник

PolylineOptions

Defines options for a polyline.

Developer Guide

For more information, read the Shapes developer guide.

Inherited Constant Summary

int	CONTENTS_FILE_DESCRIPTOR
int	PARCELABLE_WRITE_RETURN_VALUE

Public Constructor Summary

Public Method Summary

Inherited Method Summary

Public Constructors

public PolylineOptions ()

Public Methods

public PolylineOptions add (LatLng. points)

Adds vertices to the end of the polyline being built.

Parameters

Returns

• this PolylineOptions object with the given points on the end.

public PolylineOptions add (LatLng point)

Adds a vertex to the end of the polyline being built.

Parameters

Returns

• this PolylineOptions object with the given point on the end.

points) «> public PolylineOptions addAll (Iterable points)

Adds vertices to the end of the polyline being built.

Parameters

Returns

• this PolylineOptions object with the given points on the end.

spans) «> public PolylineOptions addAllSpans (Iterable spans)

Adds new style spans to the polyline being built.

Parameters

spans	the style spans that will be added to the polyline.

Returns

• this PolylineOptions object with new style spans added.

public PolylineOptions addSpan (StyleSpan span)

Adds a new style span to the polyline being built.

Parameters

span	the style span that will be added to the polyline.

Returns

• this PolylineOptions object with new style span added.

public PolylineOptions addSpan (StyleSpan. spans)

Adds new style spans to the polyline being built.

Parameters

spans	the style spans that will be added to the polyline.

Returns

• this PolylineOptions object with new style spans added.

public PolylineOptions clickable (boolean clickable)

Specifies whether this polyline is clickable. The default setting is false

Parameters

Returns

• this PolylineOptions object with a new clickability setting.

public PolylineOptions color (int color)

Sets the color of the polyline as a 32-bit ARGB color. The default color is black ( 0xff000000 ).

Parameters

Returns

• this PolylineOptions object with a new color set.

public PolylineOptions endCap (Cap endCap)

Sets the cap at the end vertex of the polyline. The default end cap is ButtCap .

Parameters

Returns

• this PolylineOptions object with a new end cap set.

public PolylineOptions geodesic (boolean geodesic)

Specifies whether to draw each segment of this polyline as a geodesic. The default setting is false

Parameters

Returns

• this PolylineOptions object with a new geodesic setting.

public int getColor ()

Gets the color set for this PolylineOptions object.

Returns

• the color of the polyline in ARGB format.

public Cap getEndCap ()

Gets the cap set for the end vertex in this PolylineOptions object.

Returns

public int getJointType ()

Gets the joint type set in this PolylineOptions object for all vertices except the start and end vertices. See JointType for possible values.

Returns

• the joint type of the polyline.

getPattern () «> public List getPattern ()

Gets the stroke pattern set in this PolylineOptions object for the polyline.

Returns

• the stroke pattern of the polyline.

getPoints () «> public List getPoints ()

Gets the points set for this PolylineOptions object.

Returns

• the list of LatLng s specifying the vertices of the polyline.

public Cap getStartCap ()

Gets the cap set for the start vertex in this PolylineOptions object.

Returns

public float getWidth ()

Gets the width set for this PolylineOptions object.

Returns

• the width of the polyline in screen pixels.

public float getZIndex ()

Gets the zIndex set for this PolylineOptions object.

Returns

public boolean isClickable ()

Gets the clickability setting for this PolylineOptions object.

Returns

• true if the polyline is clickable; false if it is not.

public boolean isGeodesic ()

Gets the geodesic setting for this PolylineOptions object.

Returns

• true if the polyline segments should be geodesics; false they should not be.

public boolean isVisible ()

Gets the visibility setting for this PolylineOptions object.

Returns

• true if the polyline is visible; false if it is not.

public PolylineOptions jointType (int jointType)

Sets the joint type for all vertices of the polyline except the start and end vertices.

See JointType for allowed values. The default value DEFAULT will be used if joint type is undefined or is not one of the allowed values.

Parameters

Returns

• this PolylineOptions object with a new joint type set.

pattern) «> public PolylineOptions pattern (List pattern)

Sets the stroke pattern for the polyline. The default stroke pattern is solid, represented by null .

Parameters

Returns

• this PolylineOptions object with a new stroke pattern set.

public PolylineOptions startCap (Cap startCap)

Sets the cap at the start vertex of the polyline. The default start cap is ButtCap .

Parameters

Returns

• this PolylineOptions object with a new start cap set.

public PolylineOptions visible (boolean visible)

Specifies the visibility for the polyline. The default visibility is true .

Parameters

Returns

• this PolylineOptions object with a new visibility setting.

public PolylineOptions width (float width)

Sets the width of the polyline in screen pixels. The default is 10.

Parameters

Returns

• this PolylineOptions object with a new width set.

public PolylineOptions zIndex (float zIndex)

Specifies the polyline’s zIndex, i.e., the order in which it will be drawn. See the documentation at the top of this class for more information about zIndex.

Parameters

Returns

• this PolylineOptions object with a new zIndex set.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Источник

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 not closed 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 by Color . 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. See JointType for supported joint types. The default value is DEFAULT . Stroke pattern Solid (default, represented by null ) or a sequence of PatternItem objects to be repeated along the line. Available PatternItem types: 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 GroundOverlay s, TileOverlay s, Circle s, and Polygon s but not Marker s). 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 is false . If this property is set to true , your app will receive notifications to the GoogleMap.OnPolylineClickListener registered through setOnPolylineClickListener(GoogleMap.OnPolylineClickListener) . Tag An Object associated with the polyline. For example, the Object can contain data about what the polyline represents. This is easier than storing a separate Map

. As another example, you can associate a String ID 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 different StrokeStyle on different segments of the polyline.

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

Example

Developer Guide

For more information, read the Shapes developer guide.

Источник