Developer Central Links
Envirofacts Application Programming Interface (API) - Multisystem (Geospatial)
The Envirofacts Multisystem Search Form allows users to search multiple environmental databases (program systems) for facility information, including toxic chemical releases, water discharge permit compliance, hazardous waste handling processes, Superfund status, and air emission estimates. A facility is a business, site, or place subject to environmental regulations or of environmental interest. The Multisystem search report includes an API link for report data, which provides the facility location including the latitude, longitude, and associated program systems. For example, if a user is interested in seeing the facility location and associated program systems for facilities located in Greenwich, CT, the API Uniform Resource Locator (URL) can be obtained by using the Envirofacts Multisystem Search Form
About the Envirofacts API
Envirofacts has developed a Representational State Transfer (RESTful) data service API to all of its internal data holdings. This functionality provides an Envirofacts user with the ability to query any table through the use of a URL. The default output is in Extensible Markup Language (XML), which can be utilized in other applications, as well as tools such as Microsoft Excel or Access. Output options of Comma-Separated Values (CSV) and Excel can be requested in the URL. The entire Envirofacts database metadata is available online so that all tables and columns within Envirofacts are documented. Having the table structures available in this manner makes most of Envirofacts data easily available through the service.
Constructing a Search
To build a search that shows facility location and associated program systems for facilities located in Greenwich, CT, first visit the Envirofacts homepage: http://iaspub.epa.gov/enviro/efservice/multisystem/minLatitude/
Use the Quick Start Search option or click the "Advanced" link to go to the full Multisystem Search. The Quick Start Search returns results with a scale of 2.5 miles. The advanced search has a scale of 10 miles. To return a larger number of records use the Advanced Search by clicking the "Advanced" link.
The "Multisystem Search" page will load. The Envirofacts database can be searched using any combination of the following criteria: facility name, geography, facility industrial classification, or pollutant. Enter "Greenwich" in the City field and "CT" in the state field.
Click the "Search" button to obtain the Multisystem "Search Results" page that includes the "API Link for Report Data".
Copy and paste the link to view the report data.
- The default URL specifies 500 rows. http://iaspub.epa.gov/enviro/efservice/multisystem/minLatitude/41.00064/maxLatitude/41.138792/minLongitude/-73.722807/maxLongitude/-73.566961/rows/1:500
- The minLatitude, maxLatitude, and minLongitude, maxLongitude values represent the top right and bottom left corners of the map. These parameters can be modified to bring up points anywhere in the US.
- Please note that at this time the only output format available for the Multisystem API is XML.
- The following table shows the breakdown of the components to show Rows 10-15 of the default URL : http://iaspub.epa.gov/enviro/efservice/multisystem/minLatitude/41.00064/maxLatitude/41.138792/minLongitude/-73.722807/maxLongitude/-73.566961/rows/10:15
|multisystem/||Indicates the multisystem table will be searched|
|minLatitude/||Indicates a column in the multisystem table that will be used to limit search results|
|41.00064/||Indicates the value for the minLatitude column|
|maxLatitude/||Indicates a column in the multisystem table that will be used to limit search results|
|41.138792/||Indicates the value for the maxLatitude column|
|minLongitude/||Indicates a column in the multisystem table that will be used to limit search results|
|-73.722807/||Indicates the value for the minLongitude column|
|maxLongitude/||Indicates a column in the multisystem table that will be used to limit search results|
|-73.566961/||Indicates the value for the maxLongitude column|
|rows/||Indicates that there are specific rows a user wants to see in the output|
|10:15||Indicates the specific rows that will be seen|