gov/nasa/worldwind/formats/nmea/NmeaTrackPoint.java

   1 /*
   2 Copyright (C) 2001, 2006 United States Government
   3 as represented by the Administrator of the
   4 National Aeronautics and Space Administration.
   5 All Rights Reserved.
   6 */
   7 package gov.nasa.worldwind.formats.nmea;
   8
   9 import gov.nasa.worldwind.*;
  10
  11 /**
  12  * @author tag
  13  * @version $Id: NmeaTrackPoint.java 513 2007-01-18 00:33:16Z ericdalgliesh $
  14  */
  15 public class NmeaTrackPoint implements gov.nasa.worldwind.TrackPoint
  16 {
  17     private double latitude;
  18     private double longitude;
  19     private double altitude;
  20     private double geoidHeight;
  21     private String time;
  22
  23     /**
  24      * @param words
  25      * @throws IllegalArgumentException if <code>words</code> is null or has length less than 1
  26      */
  27     public NmeaTrackPoint(String[] words)
  28     {
  29         if (words == null)
  30         {
  31             String msg = WorldWind.retrieveErrMsg("nullValue.ArrayIsNull");
  32             WorldWind.logger().log(java.util.logging.Level.FINE, msg);
  33             throw new IllegalArgumentException(msg);
  34         }
  35         if (words.length < 1)
  36         {
  37             String msg = WorldWind.retrieveErrMsg("generic.arrayInvalidLength") + WorldWind.retrieveErrMsg(
  38                 "punctuation.space") + words.length;
  39             WorldWind.logger().log(java.util.logging.Level.FINE, msg);
  40             throw new IllegalArgumentException(msg);
  41         }
  42
  43         if (words[0].equalsIgnoreCase("GPGGA"))
  44             this.doGGA(words);
  45         else if (words[0].equalsIgnoreCase("GPRMC"))
  46             this.doRMC(words);
  47     }
  48
  49     /**
  50      * @param words
  51      * @throws IllegalArgumentException if <code>words</code> is null or has length less than 6
  52      */
  53     private void doGGA(String[] words)
  54     {
  55         // words won't be null, but it could be the wrong length
  56         if (words.length < 6)
  57         {
  58             String msg = WorldWind.retrieveErrMsg("generic.arrayInvalidLength") + WorldWind.retrieveErrMsg(
  59                 "punctuation.space") + words.length;
  60             WorldWind.logger().log(java.util.logging.Level.FINE, msg);
  61             throw new IllegalArgumentException(msg);
  62         }
  63
  64         this.time = words[1];
  65         this.latitude = this.parseLatitude(words[2], words[3]);
  66         this.longitude = this.parseLongitude(words[4], words[5]);
  67         if (words.length >= 11)
  68             this.altitude = this.parseElevation(words[9], words[10]);
  69         if (words.length >= 13)
  70             this.geoidHeight = this.parseElevation(words[11], words[12]);
  71     }
  72
  73     private void doRMC(String[] words)
  74     {
  75     }
  76
  77     private double parseLatitude(String angle, String direction)
  78     {
  79         if (angle.length() == 0)
  80             return 0;
  81
  82         double minutes = angle.length() > 2 ? Double.parseDouble(angle.substring(2, angle.length())) : 0d;
  83         double degrees = Double.parseDouble(angle.substring(0, 2)) + minutes / 60d;
  84
  85         return direction.equalsIgnoreCase("S") ? -degrees : degrees;
  86     }
  87
  88     private double parseLongitude(String angle, String direction)
  89     {
  90         if (angle.length() == 0)
  91             return 0;
  92
  93         double minutes = angle.length() > 3 ? Double.parseDouble(angle.substring(3, angle.length())) : 0d;
  94         double degrees = Double.parseDouble(angle.substring(0, 3)) + minutes / 60d;
  95
  96         return direction.equalsIgnoreCase("W") ? -degrees : degrees;
  97     }
  98
  99     private double parseElevation(String height, String units)
 100     {
 101         if (height.length() == 0)
 102             return 0;
 103
 104         return Double.parseDouble(height) * unitsToMeters(units);
 105     }
 106
 107     private double unitsToMeters(String units)
 108     {
 109         double f;
 110
 111         if (units.equals("M")) // meters
 112             f = 1d;
 113         else if (units.equals("f")) // feet
 114             f = 3.2808399;
 115         else if (units.equals("F")) // fathoms
 116             f = 0.5468066528;
 117         else
 118             f = 1d;
 119
 120         return f;
 121     }
 122
 123     public double getLatitude()
 124     {
 125         return latitude;
 126     }
 127
 128     /**
 129      * @param latitude
 130      * @throws IllegalArgumentException if <code>latitude</code> is less than -90 or greater than 90
 131      */
 132     public void setLatitude(double latitude)
 133     {
 134         if (latitude > 90 || latitude < -90)
 135         {
 136             String msg = WorldWind.retrieveErrMsg("generic.angleOutOfRange") + WorldWind.retrieveErrMsg(
 137                 "punctuation.space") + latitude;
 138             WorldWind.logger().log(java.util.logging.Level.FINE, msg);
 139             throw new IllegalArgumentException(msg);
 140         }
 141
 142         this.latitude = latitude;
 143     }
 144
 145     public double getLongitude()
 146     {
 147         return longitude;
 148     }
 149
 150     /**
 151      * @param longitude
 152      * @throws IllegalArgumentException if <code>longitude</code> is less than -180 or greater than 180
 153      */
 154     public void setLongitude(double longitude)
 155     {
 156         if (longitude > 180 || longitude < -180)
 157         {
 158             String msg = WorldWind.retrieveErrMsg("generic.angleOutOfRange") + WorldWind.retrieveErrMsg(
 159                 "punctuation.space") + longitude;
 160             WorldWind.logger().log(java.util.logging.Level.FINE, msg);
 161             throw new IllegalArgumentException(msg);
 162         }
 163
 164         this.longitude = longitude;
 165     }
 166
 167     public double getElevation()
 168     {
 169         return this.altitude + this.geoidHeight;
 170     }
 171
 172     public void setElevation(double elevation)
 173     {
 174         this.altitude = elevation;
 175         this.geoidHeight = 0;
 176     }
 177
 178     public String getTime()
 179     {
 180         return time;
 181     }
 182
 183     public void setTime(String time)
 184     {
 185         this.time = time;
 186     }
 187
 188     @Override
 189     public String toString()
 190     {
 191         return String.format("(%10.8f\u00B0, %11.8f\u00B0, %10.4g m, %10.4g m, %s)", this.latitude, this.longitude,
 192             this.altitude, this.geoidHeight, this.time);
 193     }
 194 }