Read me for Web-services

 

convertServices

 

Converts UTM to Latitude-Longitude and vice-versa

 

Methods

Input:  Latitude, Longitude, spheroid region

Output: UTMx, UTMy Takes the Zone value based on the Longitude

 

Input:  Latitude, Longitude, spheroid region, Zone

Output: UTMx, UTMy Takes the Zone value based on the User Input

 

Input:  UTMx, UTMy, spheroid region, Zone

Output: Latitude, Longitude

 

Return Types (for all methods)

Double[] array

 

 

Example values

Input:  lat 30

             lon -114

          sph 20

 

Output: UTMx 210590.34671932657

   UTMy 3322575.9698298606

 

 

Input:  lat 30

   lon -114

   sph 20

   utmzone 11

 

             UTMy 3322575.9698298606

Note: This method is overriding the default zone value which is 12 as in the getUTM() method and hence has different UTM values.

 

Input: utmx 789409.6532806734

  Utmy 3322575.9698298606

  sph 20

  utmzone 11

 

Output: Lat 30.00000059078302

   Long -113.99999997939832

 

Testing the Web-Service

 

WSDL location

http://iowa.usc.edu/ws/services/convertServices?wsdl

 

Test Client

http://www.soapclient.com/soaptest.html

 

The Input for the 'WSDL' file is the WSDL location link above.

 

There is also the convertservicesClient.java, a sample client that can be downloaded from this site.

To compile the above file:

javac -classpath path\to\the\client-all.jar\file convertservicesClient.java

 

To run this file:

java -cp path\to\the\client-all.jar\file;. convertservicesClient getutm 30 -114 20

 

 

 


Some Terminology

·        UTM

UTM is acronym for Universal Transverse Mercator. The UTM system applies the Transverse Mercator projection to mapping the world, using 60 pre-defined standard zones to supply parameters. UTM zones are six degrees wide. Each zone exists in a North and South variant.

 

Limitations

The accuracy of any Transverse Mercator projection quickly decreases from the central meridian. Therefore, the longitudinal extent of the projected region, when using Universal Transverse Mercator, is 6 degrees from the central meridian.

 

The Universal Transverse Mercator system of projections has 60 pre-defined standard zones, formed by defining 60 different standard projections, each one of which is a different Transverse Mercator projection that is slightly rotated to use a different meridian as the central line of tangency. Each different centerline defines a UTM Zone. The "UTM Zone" is a shorthand way of naming a specific, different projection that consists of a Transverse Mercator projection using a different meridian as the centerline. By rotating the cylinder in 60 steps (six degrees per step) UTM assures that all spots on the Earth will be within 3 degrees of the centerline of one of the 60 cylindrical projections.

 

Reference: http://exchange.manifold.net/manifold/manuals/5_userman/mfd50Universal_Transverse_Mercator_UT.htm

 

 

·        UTM Zones

View this for zone

Refernces: http://www.dmap.co.uk/utmworld.htm

Southern California is in zone 11, 12

 

·        Spheroid Regions

It is a frame of reference.

 

The program provides for using any of these:

 1. Clarke 1866

 2. Clarke 1880

 3. Bessel 1967

 4. New International 1967

 5. International 1909

 6. WGS 72

 7. Everest

 8. WGS 66

 9. GRS 1980

10. Airy

11. Modified Everest

12. Modified Airy

13. Walbeck

14. Southeast Asia

15. Australia National - South American 1969

16. Krassovsky

17. Hough

18. Mercury 1960 (Fischer)

19. Modified Mercury 1968 (Fischer)

20. WGS 84

 

It does the conversion based on the spheroid region chosen by the user; the number represents the code to be used for the respective spheroid region.

The Default value is 20, if any number < 1 or > 20 is provided, default is taken.

 

World Geodetic System 1984

 

WGS 84 is an earth fixed global reference frame, including an earth model. It is defined by a set of primary and secondary parameters: The primary parameters define the shape of an earth ellipsoid, its angular velocity, and the earth mass, which is included in the ellipsoid reference. The secondary parameters define a detailed gravity model of the earth.

 

Reference: http://www.wgs84.com/wgs84/wgs84.htm