FRS REST Services
FRS REST Services
FRS exposes several REST services that allows developers to utilize a live feed of data from the FRS database. This web page is intended for a technical audience and describes the content and purpose of each service available.
This is a collection of query-only or GET web services, that are available through a simple URL http link and provide output in either XML, JSON, or JSONP formats. Currently three services are available:
- get_facilities provides multiple selection criteria against FRS Facilities Data and their associated Program Facility Data.
- get_facilities_wbd returns USGS Watershed Boundary Dataset information for a passed FRS Facility or Program Facility Identifier.
- get_cd_111 returns the 111th Congress Identifier based on passed latitude/longitude geographic coordinates.
1. get_facilities Service Specifications
SELECTION CRITERIA:
Of the selection criteria listed below, those that have an Equal value under the Search Operator column will provide the best performance. Examples are provided at the end of the section to illustrate how selection criteria can be combined.
Search Term | Variable Name | Search Operator | Other |
---|---|---|---|
Facility Registry Id | registry_id | Equal, Optional | |
FRS Facility Name | facility_name | Contains, Optional | Full text search on Program Name |
Program Facility Name | program_name | Contains, Optional | Full text search on Program Name |
Street Address | street_address | Contains, Optional |
Because of the many variabilities involved with street address it is hard to use an address as a search criteria. May be able to provide an address parser to validate address if needed. Suggest you limit to street base name if you want to do a search on street address. |
City | city_name | Equal, Optional | |
County | county_name | Equal, Optional | |
Zip Code | zip_code | Equal, Optional | Will use only first 5 digits of zip code only |
State Abbreviation | state_abbr | Equal, Optional | |
Program Acronym | pgm_sys_acrnm | Equal, Optional | See Appendix A for list of Acronyms |
Program System Id | pgm_sys_id | Equal, Optional | |
Program Output | program_output | Yes/No, Optional | Default is no. Controls whether or not the Program Facility object is output |
Output Format | output | XML, JSON, JSONP Optional | Default is XML. |
Call back JSONP Function | callback | Optional | Default is callback. Can only be used when the output value is JSONP |
Latitude (NAD83) | latitude83 | Equal, Optional |
The latitude coordinate, in decimal degrees format, using the US Standard NAD83 horizontal Datum. Used in conjunction with Search Radius and Longitude (NAD83) to restrict facility selection to a spatial circle of the provide search radius around the provided spatial coordinate. All 3 selection criteria are required. |
Longitude (NAD83) | longitude83 | Equal, Optional |
The longitude coordinate, in decimal degrees format, using the US Standard NAD83 horizontal datum. See Latitude (NAD83) description. |
Search Radius (Miles) | search_radius | Maximum, Optional |
The maximum search radius is 25 miles. See Latitude (NAD83). |
Coordinates Output | coordinates_output | Yes/No, Optional |
A value of "Yes" will output all associated program coordinates for the facilities returned by the query. |
OUTPUTS:
An XML, JSON, or JSONP formatted document with the following output:
For each facility returned there will be a FRSFacility complex object comprised of the following simple and complex objects. For definitions of the elements listed below please see the FRS Physical Data Model and the FRS Geospatial Data Model.
Object Name | Object Type |
---|---|
RegistryId | Simple |
FacilityName | Simple |
LocationAddress | Simple |
SupplementalLocation | Simple |
CityName | Simple |
CountyName | Simple |
StateAbbr | Simple |
ZipCode | Simple |
FIPSCode | Simple |
Latitude83 | Simple |
Longitude83 | Simple |
ProgramFacilities | Complex (optional output) |
Program Facility | Complex (child of ProgramFacilities – one for each program facility comprised of the following simple elements listed below. |
ProgramSystemAcronym | Simple |
ProgramSystemId | Simple |
ProgramFacilityName | Simple |
ProgramCoordinates | Complex (optional output) |
ProgramCoordinate | Complex (optional output). Complex (child of ProgramCoordinates) – one for each program coordinate comprised of the following simple elements listed below. Data element definitions can be found in the V_GEO_PGM_COORDINATE_ALL view of the FRS Geospatial Data model at FRS Geospatial Data Model |
ProgramSystemAcronym | Simple |
ProgramSystemI | Simple |
SubId | Simple |
ObjectId | Simple |
Latitude83 | Simple |
Longitude83 | Simple |
HDatum | Simple |
BestPick | Simple |
CollectionMethod | Simple |
AccuracyValue | Simple |
AccuracyScore | Simple |
ReferencePoint | Simple |
DerivedCity | Simple |
DerivedCounty | Simple |
DerivedZip | Simple |
DerivedWBD | Simple |
DerivedCB2010 | Simple |
DerivedCD112 | Simple |
MetersToBP | Simple - the distance in Meters from the program coordinate to the Best Pick Coordinate |
Example
URL for Facility Name Search containing “Mobil Oil” in State of Virginia, City of Newport News:
http://ofmpub.epa.gov/enviro/frs_rest_services.get_facilities?state_abbr=VA&city_name=Newport%20News&facility_name=mobil%20oil
- Click the arrow to view URL Results (since no output format was specified, XML results are returned):
<Results>
<FRSFacility>
<RegistryId>110038914654</RegistryId>
<FacilityName>EXXON MOBIL OIL CORP 20428</FacilityName>
<LocationAddress>12330 WARWICK BLVD</LocationAddress>
<SupplementalLocation/>
<CityName>NEWPORT NEWS</CityName>
<CountyName>NEWPORT NEWS CITY</CountyName>
<StateAbbr>VA</StateAbbr>
<ZipCode>23606</ZipCode>
<FIPSCode>51700</FIPSCode>
<Latitude83>37.064781</Latitude83>
<Longitude83>-76.490836</Longitude83>
</FRSFacility>
</Results>
URL for searching CERCLIS (Superfund) facilities in zip code 60085 with a program name containing "scrap", with the Program Facility Output turned on and JSON output.
http://ofmpub.epa.gov/enviro/frs_rest_services.get_facilities?pgm_sys_acrnm=CERCLIS&zip_code=60085&program_name=scrap&program_output=yes&output=JSON
- Click the arrow to view URL Results in specified JSON Format:
{
}
"Results": {
"FRSFacility": [
{
"RegistryId": "110009327246",
"FacilityName": "DIAMOND SCRAP YARD",
"LocationAddress": "MARKET STREET AND ELGIN",
"SupplementalLocation": "MARKET STREET AND ELGIN",
"CityName": "WAUKEGAN",
"CountyName": "LAKE",
"StateAbbr": "IL",
"ZipCode": "60085",
"FIPSCode": "17097",
"Latitude83": "42.35249",
"Longitude83": "-87.8285",
"ProgramFacilities": [
{
"ProgramSystemAcronym": "CERCLIS",
"ProgramSystemId": "IL0001093509",
"ProgramFacilityName": "DIAMOND SCRAP YARD"
},
{
"ProgramSystemAcronym": "NCDB",
"ProgramSystemId": "I05#19910625IL005 2",
"ProgramFacilityName": "DIAMOND SCRAP YARDS INC"
}
]
}
]
}
URL for searching CERCLIS (Superfund) facilities within a 3 mile radius of latitude 38.8/longitude -77.01.
http://ofmpub.epa.gov/enviro/frs_rest_services.get_facilities?latitude83=38.8&longitude83=-77.01&search_radius=3&pgm_sys_acrnm=CERCLIS
URL Results:
- Click arrow to view results for URL for searching CERCLIS (Superfund) facilities within a 3 mile radius of latitude 38.8/longitude -77.01.
<Results>
<FRSFacility>
<RegistryId>110009347616</RegistryId>
<FacilityName>ALEXANDRIA TOWN GAS & ORONOCO OUTFALL</FacilityName>
<LocationAddress>ORONOCO STREET</LocationAddress>
<SupplementalLocation>ORONOCO STREET</SupplementalLocation>
<CityName>ALEXANDRIA</CityName>
<CountyName>ALEXANDRIA CITY</CountyName>
<StateAbbr>VA</StateAbbr>
<ZipCode>22314</ZipCode>
<FIPSCode>51510</FIPSCode>
<Latitude83>38.80976</Latitude83>
<Longitude83>-77.04712</Longitude83>
</FRSFacility>
<FRSFacility>
<RegistryId>110002500133</RegistryId>
<FacilityName>BALLOU SENIOR HIGH SCHOOL</FacilityName>
<LocationAddress>3401 4TH STREET SOUTHEAST</LocationAddress>
<SupplementalLocation/>
<CityName>WASHINGTON</CityName>
<CountyName>DISTRICT OF COLUMBIA</CountyName>
<StateAbbr>DC</StateAbbr>
<ZipCode>20032-5406</ZipCode>
<FIPSCode>11001</FIPSCode>
<Latitude83>38.83972</Latitude83>
<Longitude83>-77.00167</Longitude83>
</FRSFacility>
<FRSFacility>
<RegistryId>110013801939</RegistryId>
<FacilityName>FORT FOOTE</FacilityName>
<LocationAddress>8900 FORT FOOTE ROAD</LocationAddress>
<SupplementalLocation>ACROSS FROM JESSICA DRIVE</SupplementalLocation>
<CityName>FORT WASHINGTON</CityName>
<CountyName>PRINCE GEORGE'S</CountyName>
<StateAbbr>MD</StateAbbr>
<ZipCode>20744</ZipCode>
<FIPSCode>24033</FIPSCode>
<Latitude83>38.76771</Latitude83>
<Longitude83>-77.025261</Longitude83>
</FRSFacility>
<FRSFacility>
<RegistryId>110015778176</RegistryId>
<FacilityName>OXON COVE LANDFILL</FacilityName>
<LocationAddress>OXON HILL ROAD</LocationAddress>
<SupplementalLocation/>
<CityName>OXON HILL</CityName>
<CountyName>PRINCE GEORGE'S</CountyName>
<StateAbbr>MD</StateAbbr>
<ZipCode>20745</ZipCode>
<FIPSCode>24033</FIPSCode>
<Latitude83>38.79179</Latitude83>
<Longitude83>-77.00412</Longitude83>
</FRSFacility>
<FRSFacility>
<RegistryId>110009315570</RegistryId>
<FacilityName>RICHMOND, FREDRICKSBURG & POTOMAC RAILRD</FacilityName>
<LocationAddress>JEFFERSON DAVIS & HUME</LocationAddress>
<SupplementalLocation>JEFFERSON DAVIS & HUME</SupplementalLocation>
<CityName>ALEXANDRIA</CityName>
<CountyName>ALEXANDRIA CITY</CountyName>
<StateAbbr>VA</StateAbbr>
<ZipCode>22301</ZipCode>
<FIPSCode>51510</FIPSCode>
<Latitude83>38.82607</Latitude83>
<Longitude83>-77.05046</Longitude83>
</FRSFacility>
</Results>
2. get_facilities_wbd Service Specifications
SELECTION CRITERIA:
Of the selection criteria listed below, those that have an “Equal” value under the Search Operator column will provide the best performance. Examples are provided at the end of the section to illustrate how selection criteria can be combined.
Search Term | Variable Name | Search Operator | Other |
---|---|---|---|
Registry ID | registry_id | Equal, Optional | The facility’s FRS Registry ID |
Program Acronym | pgm_sys_acrnm | Equal, Optional | See Appendix A for list of Acronyms |
Program System ID | pgm_sys_id | Equal, Optional | The program facility system identifier |
Outputs
An XML, JSON, or JSONP formatted document with the following output:
Object Name | Object Type | Comments |
---|---|---|
RegistryId | Simple | The facility’s FRS Registry Identifier |
ChesapeakeBay | Simple | A Y value indicates the facility is within the Chesapeake Bay watershed |
Region Complex | Complex | Lists the HUC 2 USGS Hydroregion number and name for the facility |
Subregion | Complex | Lists the HUC 4 USGS Sub-hydroregion number and name for the facility |
Basin Complex | Complex | Lists the HUC 6 USGS Basin number and name for the facility |
Subbasin | Complex | Lists the HUC 8 USGS Sub-basin number and name for the facility |
Watershed | Complex | Lists the HUC 10 USGS Watershed number and name for the facility |
Subwatershed | Complex | Lists the HUC 12 USGS Sub-watershed number and name for the facility |
EXAMPLE:
URL for a FRS Registry ID:
http://ofmpub.epa.gov/enviro/frs_rest_services.get_facility_wbd?registry_id=110015778176
URL Results:
- Click the arrow to view URL Results
<Results>
<RegistryId>110015778176</RegistryId>
<ChesapeakeBay>Yes</ChesapeakeBay>
<Region>
<HUC_2>02</HUC_2>
<HU_2_NAME>Mid Atlantic Region</HU_2_NAME>
</Region>
<Subregion>
<HUC_4>0207</HUC_4>
<HU_4_NAME>Potomac</HU_4_NAME>
</Subregion>
<Basin>
<HUC_6>020700</HUC_6>
<HU_6_NAME>Potomac</HU_6_NAME>
</Basin>
<Subbasin>
<HUC_8>02070010</HUC_8>
<HU_8_NAME>Middle Potomac-Anacostia-Occoquan</HU_8_NAME>
</Subbasin>
<Watershed>
<HUC_10>0207001003</HUC_10>
<HU_10_NAME/>
</Watershed>
<Subwatershed>
<HUC_12>020700100303</HUC_12>
<HU_12_NAME>Henson Creek</HU_12_NAME>
</Subwatershed>
</Results>
3. get_cd_111 Service Specification
SELECTION CRITERIA:
Of the selection criteria listed below, those that have an "Equal" value under the Search Operator column will provide the best performance. Examples are provided at the end of the section to illustrate how selection criteria can be combined.
Latitude | latitude | Equals, Required | In decimal degrees |
---|---|---|---|
Latitude | latitude | Equal, Optional | In decimal degrees |
Longitude | longitude | Equals, Required | In decimal degrees |
Horizontal Datum | hdatum | Equal, Optional | Default is NAD83, WGS84 is also accepted |
OUTPUTS:
An XML, JSON, or JSONP formatted document with the following output:
Object Name | Object Type | Comment |
---|---|---|
State | Simple | |
CD | Simple | Congressional District Number |
CDName | Simple | Congressional District Name |
EXAMPLE:
Example URL:
http://ofmpub.epa.gov/enviro/frs_rest_services.get_cd_111?latitude=38.8&longitude=-77.01&hdatum=wgs84
URL Results:
- Click arrow to view URL Results
<Results>
<Message>Success</Message>
<State>MD</State>
<CD>04</CD>
<CDName>Congressional District 4</CDName>
</Results>
Appendix A
PGM_SYS_ACRNM | PGM_SYS_ACRNM |
---|---|
ACES | MO-DNR |
ACRES | MS-ENSITE |
AIRS/AFS | T-CEDARS |
AIRS/AQS | NC-FITS |
AZURITE | NCDB |
BIA INDIAN SCHOOL | NCES |
BOILER | ND-FP |
BR | NE-IIS |
BRAC | NEI |
CAMDBS | NEPT |
CASWIS | NH-DES |
CDAFLP | NJ-NJEMS |
CEDS | NM-TEMPO |
CERCLIS | NNEMS |
CIM | NPDES |
CNFRS | NV-FP |
CWNS | OH-CORE |
DTSC-ENVIROSTOR | OK-FMS |
ECOMAP | OR-DEQ |
ECRM | OTAQREG |
EGRID | PA-EFACTS |
EIA-860 | PCS |
EIS | PDS |
FDM | PERMIT TRACKING |
FIS | RADINFO |
FRP | RBLC |
FRS | RCRAINFO |
GEIMS | RFS |
GNIS | RI-PLOVER |
HWTS-DATAMART | RMP |
ICIS | SC-EFIS |
IDNR_EFD | SDWIS |
IN-FRS | SIMS |
ISD | SRPMICEMS |
KS-FP | SSTS |
LA-TEMPO | STATE |
LANDFILL | TBA |
LUST-ARRA | TRIS |
MA-EPICS | TSCA |
MD-EPSC | TX-TCEQ ACR |
MD-PEMIS | UORS |
MD-RCRA | UST |
ME-EFIS | WA-FSIS |
MN-DELTA | WI-ESR |
Appendix B - Examples
URL for Facility Name Search containing “Mobil Oil” in State of Virginia, City of Newport News:
http://ofmpub.epa.gov/enviro/frs_rest_services.get_facilities?state_abbr=VA&city_name=Newport%20News&facility_name=mobil%20oil
URL Results:
- Click the arrow to view URL Results
<Results>
<FRSFacility>
<RegistryId>110038914654</RegistryId>
<FacilityName>EXXON MOBIL OIL CORP 20428</FacilityName>
<LocationAddress>12330 WARWICK BLVD</LocationAddress>
<SupplementalLocation/>
<CityName>NEWPORT NEWS</CityName>
<CountyName>NEWPORT NEWS CITY</CountyName>
<StateAbbr>VA</StateAbbr>
<ZipCode>23606</ZipCode>
<FIPSCode>51700</FIPSCode>
<Latitude83>37.064781</Latitude83>
<Longitude83>-76.490836</Longitude83>
</FRSFacility>
</Results>
URL for Facility Name Search containing “Mobil Oil” in State of Virginia, City of Newport News:
http://ofmpub.epa.gov/enviro/frs_rest_services.get_facilities?state_abbr=VA&city_name=Newport%20News&facility_name=mobil%20oil
URL Results:
- Click the arrow to view URL results.
<Results>
<FRSFacility>
<RegistryId>110009327246</RegistryId>
<FacilityName>DIAMOND SCRAP YARD</FacilityName>
<LocationAddress>MARKET STREET AND ELGIN</LocationAddress>
<SupplementalLocation>MARKET STREET AND ELGIN</SupplementalLocation>
<CityName>WAUKEGAN</CityName>
<CountyName>LAKE</CountyName>
<StateAbbr>IL</StateAbbr>
<ZipCode>60085</ZipCode>
<FIPSCode>17097</FIPSCode>
<Latitude83>42.35249</Latitude83>
<Longitude83>-87.8285</Longitude83>
<ProgramFacilities>
<ProgramFacility>
<ProgramSystemAcronym>CERCLIS</ProgramSystemAcronym>
<ProgramSystemId>IL0001093509</ProgramSystemId>
<ProgramFacilityName>DIAMOND SCRAP YARD</ProgramFacilityName>
</ProgramFacility>
<ProgramFacility>
<ProgramSystemAcronym>NCDB</ProgramSystemAcronym>
<ProgramSystemId>I05#19910625IL005 2</ProgramSystemId>
<ProgramFacilityName>DIAMOND SCRAP YARDS INC</ProgramFacilityName>
</ProgramFacility>
</ProgramFacilities>
</FRSFacility>
</Results>