Q: Why can't I find my city/community/neighborhood/area using the Search?
A: First, make sure you are spelling the name correctly when you search. And leave off the state, ZIP Code, etc. If you are not sure of the spelling, try just a few letters to widen the search. At this time, OnTheMap is not very good at handling misspellings. Also, make sure the dropdown is set to "Search All Names".
If you still are unable to find the name you are seeking, then it may not be represented in the official geographic layers provided by the U.S. Census Bureau. The Census Bureau does not always keep the names and boundaries of neighborhoods or small towns without a government structure. If you have questions about why the Census Bureau does not make use of an area name, please contact your Census Bureau Regional Office census.gov/regions/ or the Census Bureau's Geography Division geo.geography@census.gov.
Q: Why can't I find my city/community/neighborhood/area in the map viewer?
A: It may be that the correct layer containing your area of interest is not being displayed. First try going to the Base Map tab and turning off any layers you do not need displayed at this point. Then try turning on some other layers that may contain your area of interest. Most confusion arises from the relationship between Places and County Subdivisions. In some states (mostly in the Northeast and Upper Midwest) the County Subdivision Layer has many of the towns and communities that users expect to see in the Places Layer.
Please note that the Census Bureau does not always keep the names and boundaries of neighborhoods or small towns without a government structure. If you have questions about why the Census Bureau does not make use of an area name, please contact your Census Bureau Regional Office census.gov/regions/ or the Census Bureau's Geography Division geo.geography@census.gov.
Q: Why isn't a school/university/Amtrak station/One-Stop Center/airport in the right location?
A: Point location data on schools (primary and secondary), colleges/universities, airports, Amtrak stations, and On-Stop Career Centers come from external data sources. OnTheMap provides these data "as-is" for reference purposes only. If you believe that a feature in one of these layers is misplaced, we recommend contacting the agency that owns the data. Contact information for the geographic layers can be found at the Geographic Data Sources page.
Q: Why isn't data available for a state/year?
A: Data are available for jobs whose workplaces are located in one of the 50 states (and the District of Columbia) currently in OnTheMap (Puerto Rico and the U.S. Virgin Islands are not yet included). Data are available in all years [an error occurred while processing this directive] except for the following combinations:
It is possible to have home locations in states that are missing job data, however these totals will not be complete and should be used with caution.
Q: Why can't I find the Race, Ethnicity, Education, or Sex variables in my analysis results?
A: Worker Race, Worker Ethnicity, Worker Educational Attainment, and Worker Sex variables can be accessed by performing an Area Profile or Area Comparison Analysis while using data from 2009 or later. All varieties of analysis settings can be used in conjunction with this data, including home/work, job type, and Labor Market Segments.
A: For the purposes of OnTheMap, the LED Partnership defines a job as a link between a worker and a firm at which the worker has been employed during the reference quarter and during the quarter prior to the reference quarter. The reference quarter is Quarter 2 (April-June) of the year of interest. This definition of "job" is sometimes called a "Beginning of Quarter" job because it is assumed that the worker was employed at that firm on the first day of the reference quarter.
A: The LED Partnership builds its data infrastructure based upon several core datasets provided by our state partners. These include Unemployment Insurance wage data and the Quarterly Census of Employment in Wages. With the release of Office of Personnel Management (OPM)-sourced data, OnTheMap now includes Federal Civilian Employees (from 2010 forward). Coverage under these datasets currently excludes several groups of workers. These include:
A project is currently underway to add Self-Employed Workers to the LED data infrastructure. For further updates on this project, please visit the LEHD main page.
If a worker is employed at more than one job during the referenced period and those jobs are covered by the core datasets, then all of those jobs will be captured in the dataset.
A: A primary job is defined as the one job for each worker that provides the most earnings. By analyzing primary jobs, you are seeing "one job per worker," whereas analyzing "All Jobs" you are seeing all the jobs held by the workers selected through your spatial query.
A: OnTheMap makes use of synthetic data methods to protect confidential information about the residential locations of workers. A synthetic dataset is one that has similar statistic properties to an original dataset but has been created in order allow for the release of data in the public domain without compromising confidentiality in cases where the original dataset cannot be released. In general it would be preferable to work with the original dataset if possible; however, synthetic data are created for OnTheMap because the original data cannot be released.
Q: How is the confidentiality of a worker's/employer's data protected?
A: The U.S. Census Bureau, its employees, and contractors working for it are bound by Titles 13 and 26 of the Federal Code to protect the confidentiality of respondents' information. Information provided to the Census Bureau are protected by several different systems.
Q: How do major disruptive events (e.g. hurricanes) affect the quality of the data?
A: There is no specific answer to this question as each case is different. However, a recent report investigates the issue for major hurricanes in 2005.
In The Impact of Hurricanes Katrina, Rita and Wilma on Business Establishments (Journal of Business Valuation and Economic Loss Analysis, 2009 Vol 4, Issue 2), Ron Jarmin and Javier Miranda show that GIS based estimates of the economic impact of the 2005 hurricanes provide a more accurate characterization of affected businesses than estimates constructed from county level data or census block level data. Their methodology relies on mapping business establishments into damage zones defined by remote sensing information provided by FEMA. Their GIS-based estimates indicate the amount of damage using traditional methods is overestimated by as much as 2.1 times when using census block data and as much as 5.6 times when using county based data.
Q: How do I open/read the downloadable OnTheMap data files?
A: The downloadable data files are constructed as Comma Separated Variable (CSV) text files. Each file is then compressed using the GZip alogrithm.
Most archiving/zip applications can handle Gzipped files. Once you uncompress one of the data files, you should be left with a CSV file (ending in ".csv").
This CSV file can be opened in Excel or ArcGIS (as well as other programs); however, on many computers these files are not associated with these applications by default. This means that trying to open the file directly from your desktop by double clicking on it may cause your computer to ask what application you want to use.
The most straightforward way to open the CSV file in Excel is to start by opening a blank document in Excel. Then select Open and navigate to the unzipped file.
Please note, under "Files of type:" select "All Files" or else it may not be visible. Open the CSV file.
To open a CSV file in ArcGIS, follow the download and unzip procedures described above.
Open the CSV in ArcMap by using the Add Data
button and navigating to the CSV on your computer. Once you've added the raw data to your session, it should behave like any other table in the program, although you may need to reformat the census block code if it comes from one of the states which has a leading zero. This can be done in ArcMap by opening the table, right-clicking on the block code column header, and selecting "Field Properties". Then choose a custom number format with 15 consecutive zeroes (e.g. 000000000000000). This will force the field to have a leading zero. In some cases you may need to convert this number to a 15-character string.
Q: How do the LODES data compare to ACS commuting data?
A: LODES and ACS commuting data are sourced from different data, collected by different means, tabulated and protected by different methodologies. As such they may not agree for specific queries. However, the two datasets may provide complementary information on workers and the relationship between workplace and residential locations. A detailed comparison of the two different methodologies is available in Design Comparison Of LODES And ACS Commuting Data Products, a CES Working Paper published in 2014. Additional information about the LODES processing system can be found in a 2025 CES working paper titled LODES Design and Methodology Report: Methodology Version 7.
Q: Why can't I find the Firm Age and Firm Size variables?
A: Firm Age and Firm Size variables can be accessed by performing an Area Profile or Area Comparison Analysis while using data from 2011 or later. Additionally the Firm Age and Firm Size variables are available only for work areas with the "All Private Jobs" job type and the "All Workers" labor market segment.
Q: What does it mean to be employed in a location/area?
A: In LODES the employment location for a job is defined by the location of the business/establishment to which the job is connected. The potential meaning of this location is discussed on pages 5-6 and 12 of https://ideas.repec.org/p/cen/wpaper/14-38.html
, and some additional analysis of LODES' employment location is given in Section 2.2 of https://ideas.repec.org/p/cen/wpaper/17-34.html
. LODES has no information to determine whether a job is remote work or whether the worker physically travels to this location for the worker's regular duties. Some workers may never physically attend the employment location while others may go irregularly, and a worker's travel situation may change from year to year.
Q: Can I compare LODES years to each other as part of a time-series?
A: The LEHD program discourages year-over-year comparisons in LODES due to several factors that can affect the consistency and comparability of the data over time. LEHD recommends users consider each LODES year as a point-in-time measure rather than part of a time-series. Here are the primary reasons for this recommendation:
Q: Why does my analysis time out?
A: Analyses fail to complete because the web server will timeout before the calculation is complete. This typically happens on very large selections (groups of states for many years) or when the server is under a heavy load. To avoid this you can:
A: It's difficult to provide a general answer for this question. Please recheck that your selection area and analysis settings are as expected and try running the analysis again. You may also try running the analysis in a different web browser if possible. If the error/failure persists please send us an email to CES.OnTheMap.Feedback@census.gov with as much descriptive information as possible (analysis area, settings, browser type and version, etc.) so that we can diagnose the problem.
Q: Why do I get a pink screen in the map viewer?
A: The pink screen appears when the web server times out while generating the base map tiles or thermal overlay images. This typically happens during analyses on large selection areas (groups of states) for many years. To avoid this you can restrict your analysis to a single year and/or turn off Thermals in the Map Control section of the Results tab.
Q: Why did my shapefile import fail?
A: A shapefile import may fail because the shapefile is too complex or has too many features. If this appears to be the case (OnTheMap will freeze during the import process), then you should try the following steps:
A: EPSG is a standard for specifying map projections when a .PRJ file is not available for a shapefiles. More information about EPSG codes can be found at either epsg.org
or spatialreference.org
.
Q: The Distance/Direction thermal in my shapefile/KML export seems to be cut off. Why is that?
A: The OnTheMap application limits the geographic scope of the thermals to a large area surrounding the selection area. This is done to prevent users from receiving thermals that span most of the United States when only a small region is of interest (this case would render the thermal useless because only a few pixels of the image would be dedicated to the area of interest). In some cases in which analyses have far-reaching sheds, the application may "clip" the thermal. The distance at which a thermal is clipped is set by taking the maximum of the following distances:
So if your selection area is 5 miles wide in the East-West direction and 10 miles, then the size of the clipped area will be the maximum of 5 miles or 10 miles or 100 miles—which is 100 miles. So the clipping boundary will be a 100 mile square centered at the center of the selection area.
Q: What is the Text-Only Tool and how do I use it?
A: The Text-Only Tool is an easy to use and 508 compliant version of OnTheMap. Users that are visually impaired or working on a smaller screen are able to quickly search for, access, and download local labor statistics on their area of interest. Users not interested in the mapping interface in regular OnTheMap also may benefit from using the Text-Only interface. Imported geographies, freehand selections, and buffered selections are not available in the Text-Only tool. The Paired Area Analysis is also not available, although the other standard five analysis types (Area Profile, Area Comparison, Distance/Direction, Destination, and Inflow/Outflow) can be chosen in the Analysis Settings page.
The Text-Only tool can be accessed at: onthemap.ces.census.gov/tot/. To begin an analysis, enter the name of an area into the Search box and click "Go". To continue, click one of the matching results from available geography layers. Then select the desired analysis settings and click "Run Analysis" to generate the results. The detailed report can then be exported to HTML, PDF, or XLS formats. By checking a box in the Analysis Settings, a companion map and chart can be added to the results, although these images will not included in any of the export formats.
Q: What is a .OTM file and how do I use it (saving and loading an analysis)?
A: A .OTM file is a small file that contains OnTheMap analysis settings. It can be saved for later use or shared with others, and then reopened in OnTheMap on other computers or Internet browsers at a later date. Save a partial or complete analysis by clicking on the "Save" icon in the toolbar above the map view. Open a previously saved analysis by clicking on "Load" in the toolbar above the map viewer (or in the Start tab) and navigating to the saved .OTM file on your computer. Please note, the .OTM files do not save changes made to the Base Map or Results tabs. Also, saved analyses from previous versions of OnTheMap cannot be used in the current version of OnTheMap.
Q: How can I save an image of the map or chart from my analysis?
A: Images of the Chart, Map and Legends are now available for direct download from the application. These can be accessed by clicking the Print Map/Chart option in the Results tab and selecting the choice, "Download as a Collection of Images". The image files are in PNG format, which is readable by most applications. The set of images is delivered in a ZIP file and includes the following: an image of the map, an image of the chart, images of the legends for overlay layers that are shown, a text file that contains any title or subtitle from the Results tab.
Q: What are the files and variables in the shapefile package produced by OnTheMap?
A: OnTheMap makes the results of analyses available for download as a package of shapefiles, which are a standard form of geographic data file. A data dictionary (PDF
[an error occurred while processing this directive]
| XLSX (31 KB)) is provided to outline the contents of each file of the package as well as the definitions of each variable in the files that contain analysis data.