Click here to Skip to main content
15,867,835 members
Articles / Programming Languages / Java

Java GIS Coordinate Class

Rate me:
Please Sign up or sign in to vote.
3.40/5 (3 votes)
23 Jun 2004CPOL3 min read 53.4K   465   17   3
This is a JAVA class that can represent a GIS coordinate in your program, and allow you to "move", or translate, the coordinate given distance and direction.

Introduction

This article presents GISCoordinate.java - a class that allows you to represent a GIS coordinate in your JAVA code in decimal degrees (38.4443, e.g. 122.33433), minute degrees (33 44 22E, 122 33 44N), or radian degrees. Also, you can use this class to manipulate the coordinate, moving it around the globe by giving it distances in feet and direction of travel. You can then extract the new coordinate that is calculated after the travel.

Background

In one of my applications, I had to be able to export data that was drawn on a bitmap map to GIS software. I realized I needed some class to represent a GIS coordinate and allow me to manipulate (move) it. The complication here lies in the fact that to generate a new coordinate using an existing coordinate, direction of travel and distance of travel, one needs to take into account the fact that the earth is round, not flat and its roundness is not defined by any standard geometrical shape. Therefore, there are various formulas that you may use for this calculation, depending on what you believe the earth shape to be. The common methods are:

  • Sphere
  • WGS84/NAD83/GRS80
  • Clarke (1866)/NAD27
  • International
  • Krasovsky
  • Bessel (1841)
  • WGS72
  • WGS66
  • FAI sphere

The class presented here allows you to:

Construct itself given a set of coordinates in degree minutes format or decimal degrees (e.g. 37:55:15N , 122:20:59W or their decimal equivalents).

Move the coordinate any number of feet and to any direction (0-360 deg) and have the new Latitude and Longitude automatically updated to the new location. The calculation for the movement will be done using a method of your choice from the above 9 mentioned.

Print out the latitude and longitude in either Decimal Degrees or Degrees Minutes Seconds.

Credits: I based my code on the JavaScript code presented by Ed Williams, at: http://williams.best.vwh.net/gccalc.htm which of course had to be completely re-written in Java and wrapped in a nice object oriented wrapper.

Using the Code

GISCoordinate.java does have a main method that exemplifies the usage of the class. Basically here are a few pointers:

You typically instantiate the class as follows:

Java
GISCoordinate g = new GISCoordinate("37:55:15","N","122:20:59","W");

This provides you with an object that represents the GIS coordinate:

  • Longitude: 37 degrees 55 minutes 15 seconds North
  • Latitude: 122 degrees 20 minutes 59 seconds West

To see the representation of this in Decimal Degrees:

Java
g.printDEGDEC(System.out);

You can then move the coordinate to any direction and any distance:

Java
double movedist=2640;//5280.0;
double movedeg=167; 
System.out.println("Moving "+movedist+" Feet, in a direction of "+movedeg+" degrees...");
g.move(movedist, movedeg, NAD83);

Note that movedist is the distance in feet to move (in this case half a mile) and movedeg is the degree of movement (from 0-360, so this would be south east'ish). Also note that NAD83 method was picked, which assumes the earth to be of a certain shape. Of course, another method could have been used out of the aforementioned 9. Look at the constants declared in the beginning of the class implementation, to see the variable names of the different ones you can choose from.

The new location can be printed again:

Java
g.printDEGDEC(System.out);

The demo is self contained in the actual class. To compile and run the demo:

  1. Extract the zip file (attached to this article) contents into c:\temp while preserving the zip dir structure.
  2. Open cmd and cd into temp. Then issue on the command line:
     javac com\ha\common\gis\*.java 
  3. Then, to run the demo, issue on the command line:
    java -classpath c:\temp\ com.ha.common.gis.GISCoordinate

To use this class in your code, you can modify the package name to suit your package scheme and call on it as per the examples in the main() method.

History

  • Initial version: 6-24-2004

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
United States United States
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
GeneralThanks Pin
tomolsz1-Jul-08 5:24
tomolsz1-Jul-08 5:24 
GeneralThat was the Best Pin
Hossam Abbas11-Jul-04 13:43
Hossam Abbas11-Jul-04 13:43 
GeneralRe: That was the Best Pin
Tomer Petel11-Jul-04 14:28
Tomer Petel11-Jul-04 14:28 
Thank You!
I hope you derive from this class all the benefits you need.
Tomer

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.