com.tomtom.pnd.maplib

Class MapUtils

java.lang.Object

com.tomtom.pnd.maplib.MapUtils

public final class MapUtils
extends java.lang.Object

Utility class for map and geocoding related functions.

Since:

2 (15.2 Fisichella)

Method Summary

Methods

Modifier and Type	Method and Description
static boolean	hasValidAccuracy(android.location.Location location) Check if the hasAccuracy and getAccuracy functions are in sync.
static boolean	hasValidAltitude(android.location.Location location) Check if the hasAltitude and getAltitude functions are in sync.
static boolean	hasValidBearing(android.location.Location location) Deprecated. Android will sometimes return Locations with hasBearing() == true, but getBearing() still returns a value greater than zero. To prevent this noise, this function will be removed in a future release.
static boolean	hasValidSpeed(android.location.Location location) Check if the speed is valid.
static boolean	isValidLocation(double latitude, double longitude) Validates the given coordinates.
static boolean	isValidLocation(android.location.Location location) Validates the information stored in the given Location object: latitude, longitude, accuracy, altitude and speed will be verified.

Methods inherited from class java.lang.Object

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

Method Detail

isValidLocation

public static boolean isValidLocation(double latitude,
                      double longitude)

Validates the given coordinates.

Parameters:

latitude - The latitude degrees of the location, [-90, 90].

longitude - The longitude degrees of the location, [-180, 180).

Returns:

True if latitude and longitude are within the valid range

isValidLocation

public static boolean isValidLocation(android.location.Location location)

Validates the information stored in the given Location object: latitude, longitude, accuracy, altitude and speed will be verified.

Parameters:

location - The Location to validate. May not be null.

Returns:

True if all values are sane; false if any value is out of range or should not have been set.

hasValidAccuracy

public static boolean hasValidAccuracy(android.location.Location location)

Check if the hasAccuracy and getAccuracy functions are in sync.

Parameters:

location - The Location to query.

Returns:

True if the accuracy can be trusted; false otherwise.

hasValidAltitude

public static boolean hasValidAltitude(android.location.Location location)

Check if the hasAltitude and getAltitude functions are in sync.

Parameters:

location - The Location to query.

Returns:

True if the altitude can be trusted; false otherwise.

hasValidBearing

@Deprecated
public static boolean hasValidBearing(android.location.Location location)

Deprecated. Android will sometimes return Locations with hasBearing() == true, but getBearing() still returns a value greater than zero. To prevent this noise, this function will be removed in a future release.

Check if the hasBearing and getBearing functions are in sync.

Parameters:

location - The Location to query.

Returns:

True if the bearing can be trusted; false otherwise.

hasValidSpeed

public static boolean hasValidSpeed(android.location.Location location)

Check if the speed is valid.

Parameters:

location - The Location to query.

Returns:

True if the speed can be trusted; false otherwise.