public class

GeoLong

extends ValueConstruct
java.lang.Object
   ↳ com.google.gdata.data.AbstractExtension
     ↳ com.google.gdata.data.ValueConstruct
       ↳ com.google.gdata.data.geo.GeoLong

Class Overview

Extension for a W3C geo:long element. It contains the getter/setter for specifying the longitude of a geo-coordinate. The coordinate is contained within the long element as: <geo:long>coordinate</geo:long>. Note that the longitude element does not need to be a child of the geo:Point element. Please see the W3C document http://www.w3.org/2003/01/geo for more information.

See Also

Summary

Constants
int COORDINATE_PRECISION This denotes the number of significant digits after the decimal point for a coordinate when represented by a string.
double MAX_LONG The maximmum acceptable value of a longitude coordinate in degrees.
double MIN_LONG The minimum acceptable value of a longitude coordinate in degrees.
Fields
private static final NumberFormat NUM_FORMAT
private Double lon
[Expand]
Inherited Fields
From class com.google.gdata.data.ValueConstruct
From class com.google.gdata.data.AbstractExtension
Public Constructors
GeoLong()
Creates an instance of the GeoLong extension without a longitude value set.
GeoLong(Double lon)
Creates an immutable instance of GeoLong extension with the coordinate set to the value passed in.
Public Methods
Double getLongitude()
Returns the actual double coordinate for longitude.
void setLongitude(Double longitude)
Sets the longitude represented by this element.
void setValue(String value)
Overrides base implementation by validating that the string represents a longitude coordinate between -180 and 180 degrees.
[Expand]
Inherited Methods
From class com.google.gdata.data.ValueConstruct
From class com.google.gdata.data.AbstractExtension
From class java.lang.Object
From interface com.google.gdata.data.Extension

Constants

public static final int COORDINATE_PRECISION

This denotes the number of significant digits after the decimal point for a coordinate when represented by a string.

Constant Value: 6 (0x00000006)

public static final double MAX_LONG

The maximmum acceptable value of a longitude coordinate in degrees.

Constant Value: 180.0

public static final double MIN_LONG

The minimum acceptable value of a longitude coordinate in degrees.

Constant Value: -180.0

Fields

private static final NumberFormat NUM_FORMAT

private Double lon

Public Constructors

public GeoLong ()

Creates an instance of the GeoLong extension without a longitude value set.

public GeoLong (Double lon)

Creates an immutable instance of GeoLong extension with the coordinate set to the value passed in.

Parameters
lon The longitude coordinate reprensented by this element.
Throws
IllegalArgumentException if the longitude is not between -180 and 180 degrees.

Public Methods

public Double getLongitude ()

Returns the actual double coordinate for longitude. Note this value is not rounded unlike the value returned by getValue().

Returns
  • the longitude represented by this element.

public void setLongitude (Double longitude)

Sets the longitude represented by this element.

Parameters
longitude The longitude of this element.

public void setValue (String value)

Overrides base implementation by validating that the string represents a longitude coordinate between -180 and 180 degrees. Also formats the the string so that it has a consistent number of significant digits after the decimal point.

Parameters
value New value for the value construct or null to reset.