de.k3b.geo.api

Class GeoPointDto

java.lang.Object

de.k3b.geo.api.GeoPointDto

All Implemented Interfaces:

IGeoPointInfo, ILocation, java.lang.Cloneable

public class GeoPointDto
extends java.lang.Object
implements ILocation, IGeoPointInfo, java.lang.Cloneable

A minimal location or trackpoint implementation of ILocation, IGeoPointInfo.

Created by k3b on 07.01.2015.

Field Summary

Fields inherited from interface de.k3b.geo.api.IGeoPointInfo

NO_LAT_LON, NO_ZOOM

Constructor Summary

Constructors

Constructor and Description
GeoPointDto()
GeoPointDto(double latitude, double longitude, int zoomMin)
GeoPointDto(double latitude, double longitude, java.lang.String name, java.lang.String description)
GeoPointDto(double latitude, double longitude, java.lang.String name, java.lang.String link, java.lang.String symbol, java.lang.String id, java.lang.String description, int zoomMin, int zoomMax, java.util.Date timeOfMeasurement)
GeoPointDto(IGeoPointInfo src)

Method Summary

Modifier and Type	Method and Description
GeoPointDto	clear() Sets all members back to defaultvalue to allow reuse of class.
GeoPointDto	clone() Create a copy.
static boolean	equals(IGeoPointInfo lhs, IGeoPointInfo rhs)
boolean	equals(java.lang.Object other)
java.lang.String	getDescription() Detailed descript of the point displayed in popup on long-click .
java.lang.String	getId() If not null: A unique id for this item.
double	getLatitude() Latitude, in degrees north.
java.lang.String	getLink() Optional: If not null: Link-url belonging to this item.
double	getLongitude() Longitude, in degrees east.
java.lang.String	getName() Short non-unique text used as marker label.
java.lang.String	getSymbol() Optional: If not null: Icon-url belonging to this item.
java.util.Date	getTimeOfMeasurement() Date when the measurement was taken.
int	getZoomMax() Filter: This item is only shown if current zoom-level is <= this value.
int	getZoomMin() Filter: This item is only shown if current zoom-level is >= this value.
static boolean	isEmpty(java.lang.Double value)
static boolean	isEmpty(java.lang.Double latitude, java.lang.Double longitude) return true if either lat or lon is not set (NaN) or if both are 0.
static boolean	isEmpty(ILocation point) return true if either lat or lon is not set (NaN) or if both are 0.
GeoPointDto	setDescription(java.lang.String description) Detailed descript of the point displayed in popup on long-click .
GeoPointDto	setId(java.lang.String id) If not null: A unique id for this item.
GeoPointDto	setLatitude(double latitude) Latitude, in degrees north.
GeoPointDto	setLatLon(double latitude, double longitude)
GeoPointDto	setLink(java.lang.String link) Optional: If not null: Link-url belonging to this item.
GeoPointDto	setLongitude(double longitude) Longitude, in degrees east.
GeoPointDto	setName(java.lang.String name) Short non-unique text used as marker label.
GeoPointDto	setSymbol(java.lang.String symbol) Optional: If not null: Icon-url belonging to this item.
GeoPointDto	setTimeOfMeasurement(java.util.Date timeOfMeasurement) Date when the measurement was taken.
GeoPointDto	setZoomMax(int zoomMax) Filter: This item is only shown if current zoom-level is <= this value.
GeoPointDto	setZoomMin(int zoomMin) Filter: This item is only shown if current zoom-level is >= this value.
java.lang.String	toString() For display/debugging: Either the getName() or #getId().
static java.lang.String	toString(IGeoPointInfo point) For display/debugging: Either the getName() or #getId() plus (lat/lon).

Methods inherited from class java.lang.Object

finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

GeoPointDto

public GeoPointDto()

GeoPointDto

public GeoPointDto(double latitude,
                   double longitude,
                   java.lang.String name,
                   java.lang.String description)

GeoPointDto

public GeoPointDto(double latitude,
                   double longitude,
                   int zoomMin)

GeoPointDto

public GeoPointDto(double latitude,
                   double longitude,
                   java.lang.String name,
                   java.lang.String link,
                   java.lang.String symbol,
                   java.lang.String id,
                   java.lang.String description,
                   int zoomMin,
                   int zoomMax,
                   java.util.Date timeOfMeasurement)

GeoPointDto

public GeoPointDto(IGeoPointInfo src)

Method Detail

setLatLon

public GeoPointDto setLatLon(double latitude,
                             double longitude)

setLatitude

public GeoPointDto setLatitude(double latitude)

Latitude, in degrees north.

IGeoPointInfo.NO_LAT_LON means “not set”.

getLatitude

public double getLatitude()

Latitude, in degrees north.

IGeoPointInfo.NO_LAT_LON means “not set”.

Specified by:

getLatitude in interface IGeoPointInfo

Specified by:

getLatitude in interface ILocation

setLongitude

public GeoPointDto setLongitude(double longitude)

Longitude, in degrees east.

IGeoPointInfo.NO_LAT_LON means “not set”.

getLongitude

public double getLongitude()

Longitude, in degrees east.

IGeoPointInfo.NO_LAT_LON means “not set”.

Specified by:

getLongitude in interface IGeoPointInfo

Specified by:

getLongitude in interface ILocation

setTimeOfMeasurement

public GeoPointDto setTimeOfMeasurement(java.util.Date timeOfMeasurement)

Date when the measurement was taken.

Null means unknown.

getTimeOfMeasurement

public java.util.Date getTimeOfMeasurement()

Date when the measurement was taken. Null if unknown.

Specified by:

getTimeOfMeasurement in interface IGeoPointInfo

Specified by:

getTimeOfMeasurement in interface ILocation

setName

public GeoPointDto setName(java.lang.String name)

Short non-unique text used as marker label. Null means “not set”.

getName

public java.lang.String getName()

Short non-unique text used as marker label. Null means “not set”.

Specified by:

getName in interface IGeoPointInfo

setDescription

public GeoPointDto setDescription(java.lang.String description)

Detailed descript of the point displayed in popup on long-click . Null means “not set”.

getDescription

public java.lang.String getDescription()

Detailed descript of the point displayed in popup on long-click . Null means “not set”.

Specified by:

getDescription in interface IGeoPointInfo

getZoomMin

public int getZoomMin()

Filter: This item is only shown if current zoom-level is >= this value. NO_ZOOM means no lower bound.

Specified by:

getZoomMin in interface IGeoPointInfo

setZoomMin

public GeoPointDto setZoomMin(int zoomMin)

Filter: This item is only shown if current zoom-level is >= this value. NO_ZOOM means no lower bound.

getZoomMax

public int getZoomMax()

Filter: This item is only shown if current zoom-level is <= this value. NO_ZOOM means no upper bound.

Specified by:

getZoomMax in interface IGeoPointInfo

setZoomMax

public GeoPointDto setZoomMax(int zoomMax)

Filter: This item is only shown if current zoom-level is <= this value. NO_ZOOM means no upper bound.

getId

public java.lang.String getId()

If not null: A unique id for this item.

Specified by:

getId in interface IGeoPointInfo

setId

public GeoPointDto setId(java.lang.String id)

If not null: A unique id for this item.

getLink

public java.lang.String getLink()

Optional: If not null: Link-url belonging to this item.

After clicking on “>”-button in “show view” of a marker: opens this url.

Persistet in geo-uri as geo:…&link=https://path/to/file.html.

Specified by:

getLink in interface IGeoPointInfo

setLink

public GeoPointDto setLink(java.lang.String link)

Optional: If not null: Link-url belonging to this item.

After clicking on “>”-button in “show view” of a marker: opens this url.

Persistet in geo-uri as geo:…&link=https://path/to/file.html.

getSymbol

public java.lang.String getSymbol()

Optional: If not null: Icon-url belonging to this item.

Persistet in geo-uri as geo:…&s=https://path/to/file.png

Specified by:

getSymbol in interface IGeoPointInfo

setSymbol

public GeoPointDto setSymbol(java.lang.String symbol)

Optional: If not null: Icon-url belonging to this item.

Persistet in geo-uri as geo:…&s=https://path/to/file.png

clear

public GeoPointDto clear()

Sets all members back to defaultvalue to allow reuse of class.

clone() and clear() are used as factory method when reading a list.

Returns:

this to to allow chains

clone

public GeoPointDto clone()

Create a copy.

clone() and clear() are used as factory method when reading a list.

Specified by:

clone in interface IGeoPointInfo

Overrides:

clone in class java.lang.Object

toString

public java.lang.String toString()

For display/debugging: Either the getName() or #getId().

Overrides:

toString in class java.lang.Object

toString

public static java.lang.String toString(IGeoPointInfo point)

For display/debugging: Either the getName() or #getId() plus (lat/lon).

isEmpty

public static boolean isEmpty(ILocation point)

return true if either lat or lon is not set (NaN) or if both are 0.

isEmpty

public static boolean isEmpty(java.lang.Double value)

isEmpty

public static boolean isEmpty(java.lang.Double latitude,
                              java.lang.Double longitude)

return true if either lat or lon is not set (NaN) or if both are 0.

equals

public boolean equals(java.lang.Object other)

Overrides:

equals in class java.lang.Object

equals

public static boolean equals(IGeoPointInfo lhs,
                             IGeoPointInfo rhs)