LatLon (JOSM)

java.lang.Object
- org.openstreetmap.josm.data.coor.Coordinate
- - org.openstreetmap.josm.data.coor.LatLon

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

CachedLatLon
```
public class LatLon
extends Coordinate
```
LatLon are unprojected latitude / longitude coordinates.
Latitude specifies the north-south position in degrees where valid values are in the [-90,90] and positive values specify positions north of the equator.
Longitude specifies the east-west position in degrees where valid values are in the [-180,180] and positive values specify positions east of the prime meridian.

This class is immutable.

See Also:

Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`static DecimalFormat`	`cDdFormatter`
`static DecimalFormat`	`cDdHighPecisionFormatter`
`private static String`	`cDm00`
`private static String`	`cDm60`
`private static DecimalFormat`	`cDmMinuteFormatter`
`private static String`	`cDms00`
`private static String`	`cDms60`
`private static DecimalFormat`	`cDmsMinuteFormatter`
`private static DecimalFormat`	`cDmsSecondFormatter`
`static String`	`EAST`
`static int`	`MAX_SERVER_DIGITS`
`static double`	`MAX_SERVER_INV_PRECISION`
`static double`	`MAX_SERVER_PRECISION` Minimum difference in location to not be represented as the same position.
`static String`	`NORTH`
`private static long`	`serialVersionUID`
`static String`	`SOUTH`
`static String`	`WEST`
`static LatLon`	`ZERO` The (0,0) coordinates.

Fields inherited from class org.openstreetmap.josm.data.coor.Coordinate
x, y

Constructor Summary

Constructors
Modifier Constructor and Description

LatLon(double lat, double lon)
Constructs a new LatLon

LatLon(ICoordinate coor)

protected LatLon(LatLon coor)

Constructors
Modifier	Constructor and Description
	`LatLon(double lat, double lon)` Constructs a new `LatLon`
	`LatLon(ICoordinate coor)`
`protected`	`LatLon(LatLon coor)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`double`	`distance(LatLon ll)` Returns the euclidean distance from this `LatLon` to a specified `LatLon`.
`double`	`distanceSq(LatLon ll)` Returns the square of the euclidean distance from this `LatLon` to a specified `LatLon`.
`static String`	`dm(double pCoordinate)` Replies the coordinate in degrees/minutes format
`static String`	`dms(double pCoordinate)` Replies the coordinate in degrees/minutes/seconds format
`boolean`	`equals(Object obj)`
`boolean`	`equalsEpsilon(LatLon other)`
`LatLon`	`getCenter(LatLon ll2)`
`LatLon`	`getRoundedToOsmPrecision()` Replies a clone of this lat LatLon, rounded to OSM precisions, i.e.
`LatLon`	`getRoundedToOsmPrecisionStrict()` Replies a clone of this lat LatLon, rounded to OSM precisions, i.e.
`double`	`greatCircleDistance(LatLon other)` Computes the distance between this lat/lon and another point on the earth.
`int`	`hashCode()`
`double`	`heading(LatLon other)` Returns the heading, in radians, that you have to use to get from this lat/lon to another.
`LatLon`	`interpolate(LatLon ll2, double proportion)`
`boolean`	`isIn(Area a)` Check if this is contained in given area or area is null.
`boolean`	`isOutSideWorld()` Determines if this lat/lon is outside of the world
`boolean`	`isValid()` Replies true if lat is in the range [-90,90] and lon is in the range [-180,180]
`static boolean`	`isValidLat(double lat)` Replies true if lat is in the range [-90,90]
`static boolean`	`isValidLon(double lon)` Replies true if lon is in the range [-180,180]
`boolean`	`isWithin(Bounds b)` Determines if this lat/lon is within the given bounding box.
`double`	`lat()` Returns the latitude, i.e., the north-south position in degrees.
`String`	`latToString(CoordinateFormat d)`
`double`	`lon()` Returns the longitude, i.e., the east-west position in degrees.
`String`	`lonToString(CoordinateFormat d)`
`static double`	`roundToOsmPrecision(double value)` Returns the value rounded to OSM precisions, i.e.
`static double`	`roundToOsmPrecisionStrict(double value)` Returns the value rounded to OSM precision.
`ICoordinate`	`toCoordinate()`
`String`	`toDisplayString()` Returns this lat/lon pair in human-readable format.
`static double`	`toIntervalLat(double value)`
`static double`	`toIntervalLon(double value)` Returns a valid OSM longitude [-180,+180] for the given extended longitude value.
`String`	`toString()`
`String`	`toStringCSV(String separator)` Returns this lat/lon pair in human-readable format separated by `separator`.

Methods inherited from class org.openstreetmap.josm.data.coor.Coordinate
computeHashCode, distance, distance, distanceSq, distanceSq, getX, getY, toBBox, toBBox

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - serialVersionUID
```
private static final long serialVersionUID
```
    See Also:
    
    Constant Field Values
  - MAX_SERVER_PRECISION
```
public static final double MAX_SERVER_PRECISION
```
    Minimum difference in location to not be represented as the same position. The API returns 7 decimals.
    
    See Also:
    
    Constant Field Values
  - MAX_SERVER_INV_PRECISION
```
public static final double MAX_SERVER_INV_PRECISION
```
    See Also:
    
    Constant Field Values
  - MAX_SERVER_DIGITS
```
public static final int MAX_SERVER_DIGITS
```
    See Also:
    
    Constant Field Values
  - ZERO
```
public static final LatLon ZERO
```
    The (0,0) coordinates.
    
    Since:
    
    6178
  - cDmsMinuteFormatter
```
private static DecimalFormat cDmsMinuteFormatter
```
  - cDmsSecondFormatter
```
private static DecimalFormat cDmsSecondFormatter
```
  - cDmMinuteFormatter
```
private static DecimalFormat cDmMinuteFormatter
```
  - cDdFormatter
```
public static final DecimalFormat cDdFormatter
```
  - cDdHighPecisionFormatter
```
public static final DecimalFormat cDdHighPecisionFormatter
```
  - cDms60
```
private static final String cDms60
```
  - cDms00
```
private static final String cDms00
```
  - cDm60
```
private static final String cDm60
```
  - cDm00
```
private static final String cDm00
```
  - SOUTH
```
public static final String SOUTH
```
  - NORTH
```
public static final String NORTH
```
  - WEST
```
public static final String WEST
```
  - EAST
```
public static final String EAST
```
- Constructor Detail
  - LatLon
```
public LatLon(double lat,
              double lon)
```
    Constructs a new LatLon
    
    Parameters:
    
    lat - the latitude, i.e., the north-south position in degrees
    
    lon - the longitude, i.e., the east-west position in degrees
  - LatLon
```
protected LatLon(LatLon coor)
```
  - LatLon
```
public LatLon(ICoordinate coor)
```
- Method Detail
  - isValidLat
```
public static boolean isValidLat(double lat)
```
    Replies true if lat is in the range [-90,90]
    
    Parameters:
    
    lat - the latitude
    
    Returns:
    
    true if lat is in the range [-90,90]
  - isValidLon
```
public static boolean isValidLon(double lon)
```
    Replies true if lon is in the range [-180,180]
    
    Parameters:
    
    lon - the longitude
    
    Returns:
    
    true if lon is in the range [-180,180]
  - isValid
```
public boolean isValid()
```
    Replies true if lat is in the range [-90,90] and lon is in the range [-180,180]
    
    Returns:
    
    true if lat is in the range [-90,90] and lon is in the range [-180,180]
  - toIntervalLat
```
public static double toIntervalLat(double value)
```
  - toIntervalLon
```
public static double toIntervalLon(double value)
```
    Returns a valid OSM longitude [-180,+180] for the given extended longitude value. For example, a value of -181 will return +179, a value of +181 will return -179.
    
    Parameters:
    
    value - A longitude value not restricted to the [-180,+180] range.
    
    Returns:
    
    a valid OSM longitude [-180,+180]
  - dms
```
public static String dms(double pCoordinate)
```
    Replies the coordinate in degrees/minutes/seconds format
    
    Parameters:
    
    pCoordinate - The coordinate to convert
    
    Returns:
    
    The coordinate in degrees/minutes/seconds format
  - dm
```
public static String dm(double pCoordinate)
```
    Replies the coordinate in degrees/minutes format
    
    Parameters:
    
    pCoordinate - The coordinate to convert
    
    Returns:
    
    The coordinate in degrees/minutes format
  - lat
```
public double lat()
```
    Returns the latitude, i.e., the north-south position in degrees.
    
    Returns:
    
    the latitude
  - latToString
```
public String latToString(CoordinateFormat d)
```
  - lon
```
public double lon()
```
    Returns the longitude, i.e., the east-west position in degrees.
    
    Returns:
    
    the longitude
  - lonToString
```
public String lonToString(CoordinateFormat d)
```
  - equalsEpsilon
```
public boolean equalsEpsilon(LatLon other)
```
    Parameters:
    
    other - other lat/lon
    
    Returns:
    
    true if the other point has almost the same lat/lon values, only differing by no more than 1 / MAX_SERVER_PRECISION.
  - isOutSideWorld
```
public boolean isOutSideWorld()
```
    Determines if this lat/lon is outside of the world
    
    Returns:
    
    true, if the coordinate is outside the world, compared by using lat/lon.
  - isWithin
```
public boolean isWithin(Bounds b)
```
    Determines if this lat/lon is within the given bounding box.
    
    Parameters:
    
    b - bounding box
    
    Returns:
    
    true if this is within the given bounding box.
  - isIn
```
public boolean isIn(Area a)
```
    Check if this is contained in given area or area is null.
    
    Parameters:
    
    a - Area
    
    Returns:
    
    true if this is contained in given area or area is null.
  - greatCircleDistance
```
public double greatCircleDistance(LatLon other)
```
    Computes the distance between this lat/lon and another point on the earth. Uses Haversine formular.
    
    Parameters:
    
    other - the other point.
    
    Returns:
    
    distance in metres.
  - heading
```
public double heading(LatLon other)
```
    Returns the heading, in radians, that you have to use to get from this lat/lon to another. (I don't know the original source of this formula, but see this question for some hints how it is derived.)
    
    Parameters:
    
    other - the "destination" position
    
    Returns:
    
    heading in the range 0 <= hd < 2*PI
  - toDisplayString
```
public String toDisplayString()
```
    Returns this lat/lon pair in human-readable format.
    
    Returns:
    
    String in the format "lat=1.23456 deg, lon=2.34567 deg"
  - toStringCSV
```
public String toStringCSV(String separator)
```
    Returns this lat/lon pair in human-readable format separated by separator.
    
    Parameters:
    
    separator - values separator
    
    Returns:
    
    String in the format "1.23456[separator]2.34567"
  - interpolate
```
public LatLon interpolate(LatLon ll2,
                          double proportion)
```
  - getCenter
```
public LatLon getCenter(LatLon ll2)
```
  - distance
```
public double distance(LatLon ll)
```
    Returns the euclidean distance from this LatLon to a specified LatLon.
    
    Parameters:
    
    ll - the specified coordinate to be measured against this LatLon
    
    Returns:
    
    the euclidean distance from this LatLon to a specified LatLon
    
    Since:
    
    6166
  - distanceSq
```
public double distanceSq(LatLon ll)
```
    Returns the square of the euclidean distance from this LatLon to a specified LatLon.
    
    Parameters:
    
    ll - the specified coordinate to be measured against this LatLon
    
    Returns:
    
    the square of the euclidean distance from this LatLon to a specified LatLon
    
    Since:
    
    6166
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - roundToOsmPrecision
```
public static double roundToOsmPrecision(double value)
```
    Returns the value rounded to OSM precisions, i.e. to MAX_SERVER_PRECISION.
    
    Parameters:
    
    value - lat/lon value
    
    Returns:
    
    rounded value
  - roundToOsmPrecisionStrict
```
public static double roundToOsmPrecisionStrict(double value)
```
    Returns the value rounded to OSM precision. This function is now the same as roundToOsmPrecision(double), since the rounding error has been fixed.
    
    Parameters:
    
    value - lat/lon value
    
    Returns:
    
    rounded value
  - getRoundedToOsmPrecision
```
public LatLon getRoundedToOsmPrecision()
```
    Replies a clone of this lat LatLon, rounded to OSM precisions, i.e. to MAX_SERVER_PRECISION
    
    Returns:
    
    a clone of this lat LatLon
  - getRoundedToOsmPrecisionStrict
```
public LatLon getRoundedToOsmPrecisionStrict()
```
    Replies a clone of this lat LatLon, rounded to OSM precisions, i.e. to MAX_SERVER_PRECISION
    
    Returns:
    
    a clone of this lat LatLon
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Coordinate
  - equals
```
public boolean equals(Object obj)
```
    Overrides:
    
    equals in class Coordinate
  - toCoordinate
```
public ICoordinate toCoordinate()
```

Class LatLon

Field Summary

Fields inherited from class org.openstreetmap.josm.data.coor.Coordinate

Constructor Summary

Method Summary

Methods inherited from class org.openstreetmap.josm.data.coor.Coordinate

Methods inherited from class java.lang.Object

Field Detail

serialVersionUID

MAX_SERVER_PRECISION

MAX_SERVER_INV_PRECISION

MAX_SERVER_DIGITS

ZERO

cDmsMinuteFormatter

cDmsSecondFormatter

cDmMinuteFormatter

cDdFormatter

cDdHighPecisionFormatter

cDms60

cDms00

cDm60

cDm00

SOUTH

NORTH

WEST

EAST

Constructor Detail

LatLon

LatLon

LatLon

Method Detail

isValidLat

isValidLon

isValid

toIntervalLat

toIntervalLon

dms

dm

lat

latToString

lon

lonToString

equalsEpsilon

isOutSideWorld

isWithin

isIn

greatCircleDistance

heading

toDisplayString

toStringCSV

interpolate

getCenter

distance

distanceSq

toString

roundToOsmPrecision

roundToOsmPrecisionStrict

getRoundedToOsmPrecision

getRoundedToOsmPrecisionStrict

hashCode

equals

toCoordinate