National Library of Medicine TOXMAP Skip Navigation

How can I link my site to TOXMAP?

You can link directly to custom-made TRI and Superfund maps and facility or on-site release details via special URLs described below. At present, all such URLs link to TOXMAP classic.

How it works
Linking to TOXMAP works by adding a single HTML tag (called an "a" tag) that tells a web page to go to the TOXMAP web site. Information about the custom map requested is passed to TOXMAP through the URL (see examples below) by including specific information about the type of map desired.

There are no restrictions on and no limit to the number of custom maps that can be created; this service is free. The TOXMAP page linked to may be displayed in a frame set or in a new browser window.

Examples of dynamically generated custom-made maps

On-site releases of Toluene Diisocyanate by reporting TRI facilities in the most current TRI year, and Superfund sites containing Toluene Diisocyanate:

TRI facilities and Superfund sites in area of Green Bay, WI:

On-site releases of Mercury Compounds by reporting TRI facilities in 2010 and Superfund sites containing Mercury Compounds in EPA Region 4:

Note: for custom links to start TOXMAP with a pre-defined region selected, see the region's description on the Set Region page.

TRI releases with the specified submission numbers in the area of San Juan County, NM:

TRI or Superfund only Maps

If your URL contains "/tri/" or "/superfund/" instead of "/main/" TOXMAP creates a map showing only the TRI or Superfund data sets. For example,
creates a map of on-site TRI releases of Mercury Compounds by reporting TRI facilities in the current TRI year; Superfund sites containing Mercury Compounds will not be mapped.

Required "Parameters" (CGI variables after the question mark in the URL)

Optional "Parameters"
> city
> state
> otherPlace - a county, body of water, or other place
> regionID - the region ID of a pre-defined or user-defined region
> chemicalName
> registryNumber - CAS registry number (preferred over chemicalName)
> subnos - A comma-delimited list of one or more TRI submission numbers (overrides "chemicalName" and "registryNumber")

Parameter combinations that can be used for specifying a place
> city and state
> state only
> city only
> ZIP code only
> otherPlace only
> regionID only

ZIP code is ignored if a city and state is provided; state is ignored if a ZIP code is provided; all place parameters are ignored if a regionID is provided.

Types of maps
If your URL contains "chemicalName" or "registryNumber," then TOXMAP creates a custom map showing on-site TRI chemical releases in the most recent TRI year as well as all Superfund sites in the National Priorities List (NPL) dataset containing the specified chemical. If your URL contains "subnos", then TOXMAP creates a map showing the TRI chemical releases corresponding to the specified submission numbers. When none of these items is supplied, TOXMAP creates a combination map showing all TRI facilities and Superfund NPL sites, unless the URL has specified only the TRI or Superfund dataset (see above)

If your URL contains place information (city, state, or ZIP), TOXMAP creates a map of that area. If a region is specified, then the map will show results only inside the specified region. When none of these is supplied, TOXMAP creates a map of the entire United States. In all cases, you have full control to zoom or pan the map to see the entire nation and surrounding countries.

URL Rules
1. The URL must follow standard HTML rules
2. There can be no hard returns in the URL
3. There can be no spaces within the HREF. Replace spaces with the plus sign (+). Special characters within the URL must be replaced by their octal equivalent.

> Use %%25 to represent the % character
> Use %%26 to represent the & character
> Use %%30 to represent the + character

Links to facility or on-site release details
TOXMAP supports custom links to TRI facility details (including name, address, on-site chemical release data, etc.). Similar links are available for on-site chemical releases, release trends, or Superfund NPL sites. Contact us at for the format of the URLs of these links.

Get help setting up a TOXMAP link on your site
Contact us at

About this Entry

This page contains a single entry by TOXMAP Administrator published on August 30, 2009 1:00 AM.

What is the Toxics Release Inventory (TRI)? was the previous entry in the FAQ.

What are the future plans for TOXMAP? is the next entry in the FAQ.

Find recent TOXMAP FAQ content on the main index or look in the archives to find all content.