com.google.maps.clients.mapsengine.geojson

Class Point

java.lang.Object

com.google.maps.clients.mapsengine.geojson.Geometry

com.google.maps.clients.mapsengine.geojson.Point

public class Point
extends Geometry

A co-ordinate point on the surface of Earth.

Field Summary

Fields

Modifier and Type	Field and Description
double	altitude
boolean	hasAltitude
double	latitude
double	longitude

Fields inherited from class com.google.maps.clients.mapsengine.geojson.Geometry

FEATURE_TYPE

Constructor Summary

Constructors

Constructor and Description
Point(double lat, double lng) Constructs a point with the specified latitude and longitude.
Point(double lat, double lng, double alt) Constructs a point with the specified latitude, longitude and altitude.
Point(com.google.api.services.mapsengine.model.Feature feature) Converts the provided Feature into a typed Point, discarding properties.
Point(java.util.List<java.lang.Double> rawPoints) Constructs a Point based on the list provided.

Method Summary

Methods

Modifier and Type	Method and Description
com.google.api.services.mapsengine.model.Feature	asFeature(java.util.Map<java.lang.String,java.lang.Object> properties) Returns a Feature that can be used by the Maps Engine API.
boolean	hasAltitude() Test if this Point has an altitude.
java.util.List<java.lang.Double>	toCoordinates()

Methods inherited from class com.google.maps.clients.mapsengine.geojson.Geometry

fromGeoJson

Methods inherited from class java.lang.Object

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

Field Detail

latitude

public final double latitude

longitude

public final double longitude

altitude

public final double altitude

hasAltitude

public final boolean hasAltitude

Constructor Detail

Point

public Point(double lat,
     double lng)

Constructs a point with the specified latitude and longitude.

Parameters:

lat - The latitude, between -90 and 90.

lng - The longitude, between -180 and 180.

Throws:

java.lang.IllegalArgumentException - When latitude or long are out of bounds.

Point

public Point(double lat,
     double lng,
     double alt)

Constructs a point with the specified latitude, longitude and altitude.

Parameters:

lat - The latitude, between -90 and 90.

lng - The longitude, between -180 and 180.

alt - The altitude, in meters.

Point

public Point(com.google.api.services.mapsengine.model.Feature feature)

Converts the provided Feature into a typed Point, discarding properties. Throws an exception if the feature is not a point.

Parameters:

feature - the Feature returned by the API

Throws:

java.lang.IllegalArgumentException - when feature is not a single point

Point

public Point(java.util.List<java.lang.Double> rawPoints)

Constructs a Point based on the list provided. The list is expected to match the format returned by the Maps Engine API, so should be ordered Longitude, then Latitude, and an optional Altitude. Any further elements are silently discarded to match the behaviour of the API.

Parameters:

rawPoints - A list of 2 or more values representing Longitude, Latitude and optionally Altitude

Method Detail

asFeature

public com.google.api.services.mapsengine.model.Feature asFeature(java.util.Map<java.lang.String,java.lang.Object> properties)

Returns a Feature that can be used by the Maps Engine API.

Specified by:

asFeature in class Geometry

Parameters:

properties - The properties to attach to the feature

Returns:

an API-compatible Feature object

toCoordinates

public java.util.List<java.lang.Double> toCoordinates()

hasAltitude

public boolean hasAltitude()

Test if this Point has an altitude.

Returns:

true if the altitude property has been set.