Jump to main content.

Get Entities by Lat/Long Service

Description

Query for identifying details of all water entities within a given radius of a specified geographic location for specific WATERS programs.

Input

Parameters

Parameter Datatype Description
latitude Number Decimal degrees value.
longitude Number Decimal degrees value.
search_radius_miles Number Distance in miles from latitude/longitude location.
programs_list Array of String List of program name abbreviations.

SOAP Service Notes

None at this time.

Output

UML Diagram

Water Object UML

Return Object

program_entity_distance_data

Property Datatype Description
programs_entities_distances Object Object Type: program_entities_distances

Supporting Objects

program_entities_distances

Property Datatype Description
program_name String Name of the program
entities_distances Array of Object Object Type: entity_distance

entity_distance

Property Datatype Description
entity_id String The key identifier of the water entity. This value is used to relate the RAD information back to the program system.
miles_to_location Number The distance in miles

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:getEntitiesByLatLong>
      <latitude xsi:type="xsd:decimal">41.4</latitude>
      <longitude xsi:type="xsd:decimal">-89</longitude>
      <searchRadiusMiles xsi:type="xsd:decimal">5</searchRadiusMiles>
      <programsList
         xmlns:ns1="http://waters9i-waters/SpatialServices.xsd"
         xmlns:xsd="http://www.w3.org/2001/XMLSchema"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:type="ns1:waters9i_waters_PrgList"
      >
        <array
           xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
           xsi:type="SOAP-ENC:Array"
           SOAP-ENC:arrayType="xsd:string[2]"
        >
          <string  xsi:type="xsd:string">303D</string>
          <string  xsi:type="xsd:string">FISH</string>
        </array>
      </programsList>
    </ns1:getEntitiesByLatLong>
  </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:getEntitiesByLatLongResponse
       xmlns:ns1="http://waters9i_waters/SpatialServices.wsdl"
       SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
    >
      <return
         xmlns:ns2="http://waters9i-waters/SpatialServices.xsd"
         xsi:type="ns2:waters9i_waters_WaterDataUser"
      >
        <watersApplications
           xsi:type="ns2:waters9i_waters_WaterApplications"
        >
          <array
             xmlns:ns3="http://schemas.xmlsoap.org/soap/encoding/"
             xsi:type="ns3:Array"
             ns3:arrayType="ns2:waters9i_waters_WaterApplicationUser[1]">
            <item xsi:type="ns2:waters9i_waters_WaterApplicationUser">
              <waterApplicationDescription xsi:type="xsd:string">The National Total Maximum Daily Load (TMDL) Tracking System (NTTS)
              contains information on waters that are Not Supporting their designated uses. These waters are listed by the state as impaired
              under Section 303(d) of the Clean Water Act. The status of TMDLs are also tracked. TMDLs are pollution control measures that
              reduce the discharge of pollutants into impaired waters.  For further information on TMDLs please click
              <a href="http://www.epa.gov/waters/tmdl/">here</a>.</waterApplicationDescription>
              <waterApplicationName xsi:type="xsd:string">Total Maximum Daily Load (TMDL) / NTTS / 303(d)</waterApplicationName>
              <watersEntities xsi:type="ns2:waters9i_waters_WaterEntities">
                <array xsi:type="ns3:Array" ns3:arrayType="ns2:waters9i_waters_WaterEntityUser[1]">
                  <item xsi:type="ns2:waters9i_waters_WaterEntityUser">
                    <endDateDescription xsi:type="xsd:string">2006-APR-01</endDateDescription>
                    <entityId xsi:type="xsd:string">ILD20 _D   20</entityId>
                    <entityName xsi:type="xsd:string">ILLINOIS RIVER</entityName>
                    <entityOrganization xsi:type="xsd:string">IL</entityOrganization>
                    <entityTypeDescription xsi:type="xsd:string">303(d) Impaired Water</entityTypeDescription>
                    <startDateDescription xsi:type="xsd:string">2004-APR-01</startDateDescription>
                    <stateLocationUspsCode xsi:type="xsd:string">IL</stateLocationUspsCode>
                    <watersFeatureTypes xsi:type="ns2:waters9i_waters_WaterFeatureTypes">
                      <array xsi:type="ns3:Array" ns3:arrayType="ns2:waters9i_waters_WaterFeatureTypeUser[2]">
                        <item xsi:type="ns2:waters9i_waters_WaterFeatureTypeUser">
                          <nhdWaterSize xsi:type="xsd:decimal">18.06</nhdWaterSize>
                          <nhdWaterType xsi:type="xsd:string">ArtificialPath</nhdWaterType>
                          <waterSizeUnit xsi:type="xsd:string">MILES</waterSizeUnit>
                        </item>
                        <item xsi:type="ns2:waters9i_waters_WaterFeatureTypeUser">
                          <nhdWaterSize xsi:type="xsd:decimal">0.002</nhdWaterSize>
                          <nhdWaterType xsi:type="xsd:string">StreamRiver</nhdWaterType>
                          <waterSizeUnit xsi:type="xsd:string">MILES</waterSizeUnit>
                        </item>
                      </array>
                    </watersFeatureTypes>
                    <watersHightlights xsi:type="ns2:waters9i_waters_WaterHighlights">
                      <array xsi:type="ns3:Array" ns3:arrayType="ns2:waters9i_waters_WaterHighlightUser[2]">
                        <item xsi:type="ns2:waters9i_waters_WaterHighlightUser">
                          <highlightName xsi:type="xsd:string">Miles to Search Location</highlightName>
                          <highlightValue xsi:type="xsd:string">4.9837</highlightValue>
                        </item>
                        <item xsi:type="ns2:waters9i_waters_WaterHighlightUser">
                          <highlightName xsi:type="xsd:string">Water TMDL Status</highlightName>
                          <highlightValue xsi:type="xsd:string">TMDL Needed</highlightValue>
                        </item>
                      </array>
                    </watersHightlights>
                    <watersHucs xsi:type="ns2:waters9i_waters_WaterHucs">
                      <array xsi:type="ns3:Array" ns3:arrayType="ns2:waters9i_waters_WaterHucUser[1]">
                        <item xsi:type="ns2:waters9i_waters_WaterHucUser">
                          <huc xsi:type="xsd:string">07130001</huc>
                          <hucName xsi:type="xsd:string">LOWER ILLINOIS-SENACHWINE LAKE</hucName>
                        </item>
                      </array>
                    </watersHucs>
                    <watersUrls xsi:type="ns2:waters9i_waters_WaterUrls">
                      <array xsi:type="ns3:Array" ns3:arrayType="ns2:waters9i_waters_WaterUrlUser[1]">
                        <item xsi:type="ns2:waters9i_waters_WaterUrlUser">
                          <urlAddress xsi:type="xsd:string">http://iaspub.epa.gov/waters/enviro.control?p_list_id=ILD20 _D   20</urlAddress>
                          <urlDescription xsi:type="xsd:string">National TMDL Tracking System Listed Water Report</urlDescription>
                        </item>
                      </array>
                    </watersUrls>
                  </item>
                </array>
              </watersEntities>
            </item>
          </array>
        </watersApplications>
      </return>
    </ns1:getEntitiesByLatLongResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Database Service

Database Instance Schema Resource
WATERS10 ow_service waters.spatial_services.get_entities_by_lat_long

Changelog

Version: 1.0 - Released: 2006

Local Navigation

Jump to main content.