Jump to main content.


Validate Lat/Long Service

Description

Utility function for validating a point's geographic latitude and longitude given in decimal degrees for use against the Reach Address Database (RAD). The default horizontal datum for RAD use is NAD83. If a horizontal datum of NAD27 or WGS84 is provided, the service will convert the given latitude and longitude to NAD83 and return these converted values.

Input

Parameters

Parameter Datatype Required Description
latitude Number True Decimal degree value.
longitude Number True Decimal degree value.
horizontal_datum String   Name of the datum used (NAD27, NAD83, WSG84).

SOAP Service Notes

None at this time.

Output

UML Diagram

VALID_LAT_LONG UML

Return Object

valid_lat_long object

Property Datatype Description
latitude Number Latitude results of the conversion in decimal degrees.
longitude Number Longitude results of the conversion in decimal degrees.
message String Conversion message- if any.

SOAP Service Notes

None at this time.

Web Service (SOAP)

Resource Location
Runtime Endpoint http://iaspub.epa.gov/WATERSWebServices/SpatialServices
WSDL Endpoint http://iaspub.epa.gov/WATERSWebServices/SpatialServices?WSDL

Sample SOAP Request (Oracle 10.2.0.2 OC4J):

  <SOAP-ENV:Envelope
   xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
   xmlns:ns1="http://iaspub.epa.gov/WATERSWebServices/OWServices"
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
  >
    <SOAP-ENV:Body>
      <ns1:validateLatLong>
        <latitude xsi:type="xsd:decimal">43</latitude>
        <longitude xsi:type="xsd:decimal">-89</longitude>
        <horizontalDatum xsi:type="xsd:string">NAD27</horizontalDatum>
      </ns1:validateLatLong>
    </SOAP-ENV:Body>
  </SOAP-ENV:Envelope>

Sample Soap Response:

   <SOAP-ENV:Envelope
    xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
   >
     <SOAP-ENV:Body>
       <ns1:validateLatLongResponse xmlns:ns1="http://iaspub.epa.gov/WATERSWebServices/OWServices"
        SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
    <return xmlns:ns2="http://waters9i-waters/SpatialServices.xsd" xsi:type="ns2:waters9i_waters_ValidLatLongUser">
      <longitude xsi:type="xsd:decimal">-89.0000638504575</longitude>
      <latitude xsi:type="xsd:decimal">43.0000057512995</latitude>
      <message xsi:type="xsd:string">Latitude and longitude were transformed from NAD27 to the North American Datum of 1983</message>
    </return>
       </ns1:validateLatLongResponse>
     </SOAP-ENV:Body>
   </SOAP-ENV:Envelope>

Database Service

Database Instance Schema Resource
WATERS10 ow_service waters.spatial_services.validate_lat_long

Changelog

Version: 2.0 - Released: 2006


Local Navigation


Jump to main content.