com.here.mobility.sdk.core.geo

Class GeoPointsList

java.lang.Object

com.here.mobility.sdk.core.geo.GeoPointsList

All Implemented Interfaces:

Parcelable

public abstract class GeoPointsList
extends Object
implements Parcelable

A points list over LatLng, that describes a path on the planet. The list of locations is ordered, from the first location to the last.

Nested Class Summary

Nested classes/interfaces inherited from interface android.os.Parcelable

Parcelable.ClassLoaderCreator<T>, Parcelable.Creator<T>

Field Summary

Fields inherited from interface android.os.Parcelable

CONTENTS_FILE_DESCRIPTOR, PARCELABLE_WRITE_RETURN_VALUE

Constructor Summary

Constructors

Constructor and Description
GeoPointsList()

Method Summary

Modifier and Type	Method and Description
static GeoPointsList	concat(List<GeoPointsList> geoShape) Creates a new a geo shape which is a concatenation of the given list of geo shape.
static GeoPointsList	create(List<LatLng> locations) Creates a new GeoPointsList from the given list of located objects.
static GeoPointsList	createNoCopy(List<LatLng> locations) Creates a new GeoPointsList with the given list of locations without copying the list.
static GeoPointsList	fromGoogleEncoding(String encoding) Returns a new GeoPointsList from the given Google-encoded string.
GeoBox	getBoundingBox() Returns the bounding box of this geo shape which doesn't cross the ±180 longitude.
GeoBox	getBoundingBox(double uncrossedLongitude) Returns the bounding box of this geo shape, which doesn't cross the given longitude.
LatLng	getGeoPoint(int index) Returns the location at the given index.
int	getGeoPointsCount() Returns the number of locations in the geo shape.
abstract List<LatLng>	getGeoPointsSequence() Returns the unmodifiable list of locations this geo shape consists of.
GeoPointsList	getGeoPointsSubList(int startIndex, int toIndex) Returns a sub-list of this one, starting with fromIndex (inclusive), up to toIndex (exclusive).
String	toGoogleEncoding() Returns the Google-encoding of this geo shape.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface android.os.Parcelable

describeContents, writeToParcel

Constructor Detail

GeoPointsList

public GeoPointsList()

Method Detail

createNoCopy

public static GeoPointsList createNoCopy(List<LatLng> locations)

Creates a new GeoPointsList with the given list of locations without copying the list. Use with care.

create

public static GeoPointsList create(List<LatLng> locations)

Creates a new GeoPointsList from the given list of located objects. Note that only the LatLng objects themselves, as returned by HasLatLng.getLatLng() are stored (in a new list).

getGeoPointsSequence

public abstract List<LatLng> getGeoPointsSequence()

Returns the unmodifiable list of locations this geo shape consists of.

getGeoPoint

public LatLng getGeoPoint(int index)

Returns the location at the given index.

getGeoPointsCount

public int getGeoPointsCount()

Returns the number of locations in the geo shape.

toGoogleEncoding

public String toGoogleEncoding()

Returns the Google-encoding of this geo shape.

fromGoogleEncoding

public static GeoPointsList fromGoogleEncoding(String encoding)

Returns a new GeoPointsList from the given Google-encoded string.

getBoundingBox

public GeoBox getBoundingBox()

Returns the bounding box of this geo shape which doesn't cross the ±180 longitude. See GeoBox.getBounds(HasLatLng, HasLatLng, double) for more information.

getBoundingBox

public GeoBox getBoundingBox(double uncrossedLongitude)

Returns the bounding box of this geo shape, which doesn't cross the given longitude. See GeoBox.getBounds(HasLatLng, HasLatLng, double) for more information.

concat

public static GeoPointsList concat(List<GeoPointsList> geoShape)

Creates a new a geo shape which is a concatenation of the given list of geo shape.

getGeoPointsSubList

public GeoPointsList getGeoPointsSubList(int startIndex,
                                         int toIndex)

Returns a sub-list of this one, starting with fromIndex (inclusive), up to toIndex (exclusive). The underlying list of locations is not copied.