# HG changeset patch # User Jaroslav Tulach # Date 1404457700 -7200 # Node ID 319edf682ad11f375b272eb10112519fc36fe43a # Parent 039d9a0dea07894bffda526dfc9b6488d9e17a31 A bit more Javadoc copied from the W3C specification diff -r 039d9a0dea07 -r 319edf682ad1 geo/src/main/java/net/java/html/geo/Position.java --- a/geo/src/main/java/net/java/html/geo/Position.java Fri Jul 04 09:07:45 2014 +0200 +++ b/geo/src/main/java/net/java/html/geo/Position.java Fri Jul 04 09:08:20 2014 +0200 @@ -90,24 +90,46 @@ this.data = data; } + /** + * @return geographic coordinate specified in decimal degrees. + */ public double getLatitude() { return ((Number)JsG.get(data, "latitude")).doubleValue(); // NOI18N } + /** + * @return geographic coordinate specified in decimal degrees. + */ public double getLongitude() { return ((Number)JsG.get(data, "longitude")).doubleValue(); // NOI18N - } + } + /** + * The accuracy attribute denotes the accuracy level of the latitude + * and longitude coordinates. It is specified in meters. + * The value of the accuracy attribute must be a non-negative number. + * + * @return accuracy in meters + */ public double getAccuracy() { return ((Number)JsG.get(data, "accuracy")).doubleValue(); // NOI18N } - /** @return may return null, if the information is not available */ + /** Denotes the height of the position, specified in meters above the ellipsoid. + * If the implementation cannot provide altitude information, + * the value of this attribute must be null. + * @return value in meters, may return null, if the information is not available + */ public Double getAltitude() { return (Double)JsG.get(data, "altitude"); // NOI18N } - /** @return may return null, if the information is not available */ + /** The altitude accuracy is specified in meters. + * If the implementation cannot provide altitude information, + * the value of this attribute must be null. Otherwise, the value + * must be a non-negative real number. + * @return value in meters; may return null, if the information is not available + */ public Double getAltitudeAccuracy() { return (Double)JsG.get(data, "altitudeAccuracy"); // NOI18N }