Developer Central Links
Envirofacts Application Programming Interface (API) - Radiation
RadNet is a national network of more than 200 monitoring stations distributed across all 50 states and the American Territories. These stations regularly sample the nation's air, precipitation, drinking water, or pasturized milk for a variety of radionuclides (e.g., iodine-131) and radiation types (e.g., gross beta (β)).
For example, if you are
interested in seeing types of radionuclides and radiation for locations in Oregon, you can query the information directly through the database through the Envirofacts Representational State Transfer (RESTful) data
service API. The Uniform Resource Locator (URL) to do this is:
About the Envirofacts API
Envirofacts has developed a 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, or used as part of a Web mash-up. 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 the types of radionuclides and radiation for locations in Oregon, go to the Envirofacts homepage: http://iaspub.epa.gov/enviro/efservice/V_ERAMS_LOCATION/
Click on any of the program system names to go to a Program System Search page. In this case, click the "RadNet" program link.
The RadNet"Search" page will load. The "Radnet Links" box on the right hand side of the page provides a link to an "Overview" page that describes the available RadNet data, a link to the RadNet "Model" page, and a link to the RadNet customized search. Because of how RadNet is set up, in order to search on multiple tables use the views created for the customized search..
Click the "Overview" link to see a description of the RadNet data.
Click the "Customized Search" link to see the subject areas available for RadNet.
Click a subject area (for example: Sampling Location) and then click the "Step 2: Retrieve tables for selected subjects" button to view the tables available for selection.
Click the checkbox and then click the "Step 3: Select Columns" button to see a description of the table and a list of all columns. "State Abbreviation" is one of the columns available from this table that will be used to limit results to Oregon.
To create the URL use the column name as it appears in the database. By clicking on the hyperlinked column name users can view the column name metadata and the actual column name as it appears in the database.
Repeat these steps to see other subject areas (in this case the "Types of Radionuclides and Radiation" subject).
Click this subject area and then click the "Step 2: Retrieve tables for selected subjects" button to view the tables available for selection.
- Use these tables to build a search that shows the first 10 results for the types of radionuclides and radiation for locations in Oregon in an Excel format.
- The following table shows the breakdown of the components of the types of radionuclides and radiation for locations in Oregon URL: