com.mapbox.mapboxsdk.geometry

Class LatLng

java.lang.Object

com.mapbox.mapboxsdk.geometry.LatLng

All Implemented Interfaces:

android.os.Parcelable, ILatLng

public class LatLng
extends java.lang.Object
implements ILatLng, android.os.Parcelable

A geographical location which contains a single latitude, longitude pair, with optional altitude.

Latitude and longitude are expressed as decimal degrees in the WGS84 datum. By default, altitude is 0.0, or sea level.

Mapbox GL displays maps in the Mercator Projection and projects geographical data automatically, so all data enters in the WGS84 datum.

Nested Class Summary

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

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

Field Summary

Fields

Modifier and Type	Field and Description
static android.os.Parcelable.Creator<LatLng>	CREATOR

Fields inherited from interface android.os.Parcelable

CONTENTS_FILE_DESCRIPTOR, PARCELABLE_WRITE_RETURN_VALUE

Constructor Summary

Constructors

Modifier	Constructor and Description
	LatLng() Construct a new latitude, longitude point at (0, 0)
	LatLng(double latitude, double longitude) Construct a new latitude, longitude point given float arguments
	LatLng(double latitude, double longitude, double altitude) Construct a new latitude, longitude, altitude point given float arguments
	LatLng(LatLng aLatLng) Clone an existing latitude longitude point
	LatLng(android.location.Location location) Transform a Location into a LatLng point
protected	LatLng(android.os.Parcel in)

Method Summary

Modifier and Type	Method and Description
int	describeContents()
double	distanceTo(LatLng other) Calculate distance between two points
boolean	equals(java.lang.Object object)
double	getAltitude()
double	getLatitude()
double	getLongitude()
int	hashCode()
void	setAltitude(double altitude)
void	setLatitude(double latitude)
void	setLongitude(double longitude)
java.lang.String	toString()
LatLng	wrap() Return a new LatLng object with a wrapped Longitude.
void	writeToParcel(android.os.Parcel out, int flags)

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

CREATOR

public static final android.os.Parcelable.Creator<LatLng> CREATOR

Constructor Detail

LatLng

public LatLng()

Construct a new latitude, longitude point at (0, 0)

LatLng

public LatLng(double latitude,
              double longitude)

Construct a new latitude, longitude point given float arguments

Parameters:

latitude - Latitude in degrees

longitude - Longitude in degrees

LatLng

public LatLng(double latitude,
              double longitude,
              double altitude)

Construct a new latitude, longitude, altitude point given float arguments

Parameters:

latitude - Latitude in degrees

longitude - Longitude in degress

altitude - Altitude in meters

LatLng

public LatLng(android.location.Location location)

Transform a Location into a LatLng point

Parameters:

location - Android Location

LatLng

public LatLng(LatLng aLatLng)

Clone an existing latitude longitude point

Parameters:

aLatLng - LatLng

LatLng

protected LatLng(android.os.Parcel in)

Method Detail

setLatitude

public void setLatitude(double latitude)

getLatitude

public double getLatitude()

Specified by:

getLatitude in interface ILatLng

setLongitude

public void setLongitude(double longitude)

getLongitude

public double getLongitude()

Specified by:

getLongitude in interface ILatLng

setAltitude

public void setAltitude(double altitude)

getAltitude

public double getAltitude()

Specified by:

getAltitude in interface ILatLng

wrap

public LatLng wrap()

Return a new LatLng object with a wrapped Longitude. This allows original data object to remain unchanged.

Returns:

New LatLng object with wrapped Longitude

equals

public boolean equals(java.lang.Object object)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

describeContents

public int describeContents()

Specified by:

describeContents in interface android.os.Parcelable

writeToParcel

public void writeToParcel(android.os.Parcel out,
                          int flags)

Specified by:

writeToParcel in interface android.os.Parcelable

distanceTo

public double distanceTo(LatLng other)

Calculate distance between two points

Parameters:

other - Other LatLng to compare to

Returns:

distance in meters