13,005,455 members (57,977 online)
alternative version

#### Stats

45K views
17 bookmarked
Posted 23 Jun 2004

# Java GIS Coordinate Class

, 23 Jun 2004
 Rate this:
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
• 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:

`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:

`g.printDEGDEC(System.out);`

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

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

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:

`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

## Share

 United States
No Biography provided

## You may also be interested in...

 First Prev Next
 Thanks tomolsz1-Jul-08 5:24 tomolsz 1-Jul-08 5:24
 That was the Best H_LionHeart11-Jul-04 13:43 H_LionHeart 11-Jul-04 13:43
 Re: That was the Best Tomer Petel11-Jul-04 14:28 Tomer Petel 11-Jul-04 14:28
 Last Visit: 31-Dec-99 18:00     Last Update: 28-Jun-17 3:21 Refresh 1