Initializing...
© 2023 Boyd Ostroff, all rights reserved
Settings
Map Type+---------- Color Shaders ----------+
Map Size
Vertical Exaggeration 2
Sun Controls
Reset
West <---> East -200
North <---> South -900
Height 250
Brightness 100%
Sharing
Link to this 3d view
Copy to Clipboard
Share on FaceBook
View this location in...
The main boydsmaps web app
Google Maps
Bing Maps
NJPB Maps
Help
Welcome to the boydsmaps 3d terrain viewer!

Unfortunately, the site is not compatible with mobile devices due to the processing demands of 3d terrain. You'll need a computer with a modern web browser and a three-button mouse or trackpad


Coverage area
The viewer currently features high-resolution terrain data for the US Mid-Atlantic region as shown below. This is an ongoing project however, and coverage will be expanded to include all of New England later this summer.


Using the mouse to manipulate the map in three dimensions


You can also press and hold the center button and move the mouse forwards and backwards for a fast "crash zoom" effect.


About the crosshairs
The crosshairs are a three-dimensional object, so they tilt, rotate and change size as the map moves and zooms.



User interface elements



Using the map buttons

The Site Info Button
This button opens a window with information about the site, terms of use and privacy policy. It also features information about the code that powers the site, including credits and licenses for open source software components that are used.


The Sharing Button
Copy a link to the current map view, share directly to FaceBook or view the same location in the main boydsmaps app and other sites. We suggest using the share button for copying links as opposed to just copying the URL from the browser address bar, which might not always be correct. For example, the address bar doesn't update when the map is rotating. When you use the share button, it captures all of your current settings.


The Metadata Button
This button will open a page of information about the current map, including links to source materials.


The Re-Center Button
Use this button when you have dragged the map crosshairs away from their original location. It will download the map data again, with the current location of the crosshairs in the center.


The Go To Coordinates Button
Enter latitude and longitude in the dialog box, separated by a comma. The coordinates of your current map location are shown by default. If the coordinates are within the boydsmaps elevation dataset bounds, the map will re-load, centered on the new coordinates.


The Screenshot Button
This will capture a screenshot of everything you see on the screen without any user interface elements such as menus, buttons, etc.


Using the map controls


Map Types
Map types include aerial imagery from NAIP/USGS, processed at a resolution of about 8 feet per pixel. The grayscale map consists of a solid white surface where the features are revealed by the shadows they cast. The color maps are custom shaders that are computed using the height of each elevation sample. The colors are matched to the exact range of elevations in the current map, making them very colorful. The color scale under the compass on the left side of the screen shows the maximum and minimum elevations in the current map.

Map Size
All maps consist of 4.2 million elevation samples, arranged in a 2048 x 2048 grid. On the highest setting, the grid points are 4 feet apart, producing a high resolution image that covers an area about 1.5 x 1.5 miles. But it can also useful to view larger areas and put things in context. As map size increases, the grid points spread farther apart and resolution decreases, but that shouldn't be much of an issue when viewing from a distance.

Vertical Exaggeration
Vertical exaggeration is a number used used to multiply each elevation sample. For example, if a mountain is 1,000 feet high, it will appear to be 2,000 feet high with an exaggeration factor of 2, or 3,000 feet with a factor of 3. As terrain features are stretched in this fashion, they cast longer shadows which makes them more noticeable. Try slowly moving the slider while observing the effect in 3d view.

Adjusting the lighting with the sun controls
The sun controls are a powerful tool for controlling the appearance of the map and they can bring out hidden details in the terrain when properly set. The lighting changes in real time as you move the controls, so just experiment with different settings and observe what happens.

As you face the map in 3d, the West <---> East slider moves the sun left/right along the X-axis, the North <---> South slider moves the sun forward/backwards along the Z axis and the Height slider moves it up/down along the Y axis. The numbers displayed next to the sliders are the X, Z and Y values of the sun position. Click the Reset button to restore the default settings.




Using the view controls


2d mode shows a traditional, flat map view with North at the top. This view still responds to changes in lighting and vertical exaggeration, just like the 3d view. In 3d view the map can be rotated and viewed from any angle. Click the auto-rotate buttons to make the map spin continuously in either direction at two different speeds. The lighting, vertical exaggeration and mouse controls remain functional while the map is rotating. The reset button will apply default settings to your current view mode (2d or 3d). You may experience an issue at times when the map seems to disappear. Clicking the reset button usually fixes that problem.

The elevation color scale
The scale is only displayed when you choose one of the color maps. Terrain colors are calculated based on the range of elevations in the map, as indicated by the maximum and minimum values shown on the scale.




For more help, visit the Boyd's Maps forum at NJPinebarrens.com

https://forums.njpinebarrens.com/forums/boyds-maps-forum.39/

Site Info, Terms of Use, Privacy Policy and Software Credits

Site Terms of Use

boydsmaps.com ("the site") is owned and operated by Boyd Ostroff ("management") and access is only granted for personal, non-commercial, non-institutional use. Use of the site is free, but it is not open source software. Unless noted otherwise, all computer code, maps and other content on the site are copyright © 2023 by Boyd Ostroff with all rights reserved.

The site is provided "as-is", without any express or implied warranty. The maps and data displayed on the site are not survey grade, have not been approved by any government agency and absolutely no claims are made with regard to their accuracy. The user acknowledges that this is experimental, beta software which may not always function properly or reliably, sometimes displaying incorrect data. Use the site at your own risk. In no event will management be held liable for any damages arising from use of the site. Management will not be held responsible for any map, data or code errors and no responsibility is assumed for damages or other liabilities due to availability, accuracy, cybersecurity, use or misuse of the site and its content.

It is the sole responsibility of the user to independently determine the accuracy and suitability of the maps and data on the site before using them for any purpose.


Privacy Policy

boydsmaps.com does not collect any personally identifiable information and does not share data with any other parties. The site is privately-owned, not affiliated with any company or organization and has no advertising partners or sponsors. We don't sell anything and haven't accepted contributions from anyone. Since there are no user accounts or registration, we simply don't have any of your personal information.

When you access maps and elevation data, your browser requests a series of tiles from the boydsmaps server. These tiles are logged along with the IP address that requested them. There are numerous ways to obscure your real IP address if you're concerned about privacy.

Data from the logfile at boydsmaps.com is aggregated and used to better understand site usage patterns. This data is only available to the site owner, is not used for marketing purposes and is not shared with any third parties.

boydsmaps.com uses the localstorage API to save user preferences in your browser on your device. This data is only accessible by you and no data is sent to or stored on the boydsmaps server. Default settings are the only data items stored on your computer by the terrain viewer. These preferences are set in the dialog box each time you open the Terrain Viewer by clicking the cube button in the main boydsmaps web app. The main boydsmaps app saves a number of other items on your device, see the App Info screen on the main app for details. Nevertheless, the boydsmaps privacy policy is the same across all apps and sites. We do not collect or share any private information.


Software Credits, Licenses and Copyrights

The site includes the following open source code (or portions of the following code).

three.js - an easy to use, lightweight 3D library with default WebGL renderer:
https://github.com/mrdoob/three.js/

three.js OrbitControls:
https://github.com/mrdoob/three.js/blob/master/examples/js/controls/OrbitControls.js

three.js is copyright © 2010-2020 by the three.js authors
https://github.com/mrdoob/three.js/blob/dev/LICENSE

THE MIT LICENSE
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

threejs_landscape:
https://github.com/lukas2/threejs_landscape

threejs_landscape is copyright © 2014 by Lukas Zielinski
https://github.com/lukas2/threejs_landscape/blob/master/LICENSE

THE MIT LICENSE
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.


The site uses the open source Maptalks API to download tiled elevation data and aerial imagery. Maptalks is licensed under the BSD 3-Clause "New" or "Revised" License as follows:

Maptalks is copyright © 2016, maptalks, All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

* Neither the name of maptalks.js nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.



The site uses data in the Mapbox RGB elevation format. Code from the Mapbox GL JS API is not actually used on the site however and no Mapbox elevation data is used. Mapbox GL JS 2.0 is Copyright © 2020, Mapbox, all rights reserved.

About the Site

boydsmaps.com made its debut in January 2013 and has undergone many changes over the years. It currently consists of the main boydsmaps web app and several smaller, more specialized sites that are accessed as tools from the main app. The 3d Terrain Viewer is the newest of these, launching on June 9, 2023.

Work on a 3d map viewer began in 2019 and in January, 2020 an experimental site named lidar.boydsmaps.com was launched. That site had limited appeal and was short-lived due to its very small coverage area, which was difficult to expand because it depended hand-made maps in a proprietary format. But that software now forms the core of the Terrain Viewer user interface, while the other code has been completely re-written to use the boydsmaps Mid-Atlantic LIDAR Digital Elevation Model (DEM) dataset which covers about 175,000 square miles in 10 states. Work continues on this dataset and full coverage of New York, Massachussetts, New Hampshire, Vermont and Maine is coming in late summer 2023.

In January 2021, boydmaps.com had about 80 gigabytes of locally-hosted map data. Today we have over 1 terabyte of locally-hosted maps and that will grow to 2 terabytes in the coming months with the expansion of the elevation dataset in addition to added coverage for the USGS Legacy and Historic topo maps.



Questions? Comments? Visit the Boyd's Maps Forum at NJPineBarrens.com



Metadata

Aerial Imagery from the US Geological Survey and the National Agriculture Imagery Program

Data Source

This map is locally hosted at boydsmaps.com

Description

This is boydsmaps-cached version of the USGS National Map aerial imagery as of May, 2023. The imagery is primarily from the National Agriculture Imagery Program (NAIP). The original imagery was acquired at 1 meter pixel resolution in "leaf-on" (eg: summer) conditions, however this dataset has been processed at 2.4 meter (about 8 ft) resolution. Collection of NAIP imagery is administered by the U.S. Department of Agriculture's Farm Service Agency (FSA).

The map includes full coverage of New Jersey, Pennsylvania, Maryland, Delaware, Connecticut and Rhode Island with partial coverage of Virginia, West Virginia, New York and Massachussets. This is an ongoing project and coverage will be expanded to a larger area in the future.

Credits

National Agriculture Imagery Program, US Department of Agriculture, Farm Service Bureau Aerial Photography Field Office, US Geological Survey National Geospatial Technical Operations Center

Use Constraints

None. Acknowledgement of the originating agencies would be appreciated in products derived from these data.

Distribution Liability

Although these data have been processed successfully on a computer system at the U.S. Geological Survey, no warranty expressed or implied is made regarding the accuracy or utility of the data on any other system or for general or scientific purposes, nor shall the act of distribution constitute any such warranty. This disclaimer applies both to individual use of the data and aggregate use with other data.

Full Metadata Link

basemap.nationalmap.gov/arcgis/rest/services/USGSImageryOnly/MapServer

Boydsmaps High Resolution LIDAR Digital Elevation Model (DEM) Data

This dataset provides high-resolution elevation data for the US Mid-Atlantic region as shown below.


The dataset was created using DEM data from a variety of sources. Most of the dataset consists of bare-earth LIDAR data with a horizontal resolution of 1.2 meters (~4 feet). Where this was not available, USGS 3DEP 1/9 arc second data was used with a resolution of about 3 meters (~10 feet). In areas where no LIDAR-based DEM was available, legacy USGS NED 1/3 arc second data is used with a resolution of about 10 meters (~33 feet).

LIDAR DEM Credits

South NJ 2019 LIDAR, Northwest NJ 2018 LIDAR, Northeast NJ Post-Sandy 2014 LIDAR, Delaware Valley Regional Planning Commission 2015 LIDAR: NJDEP Bureau of GIS, NJ Office of Information Technology, Office of GIS (NJOIT/OGIS)

PAMAP 2008 Statewide 3.2-foot LIDAR: PA Department of Conservation and Natural Resources, Bureau of Topographic and Geologic Survey, PA Spatial Data Access (PASDA)

1-meter LIDAR DEM, 1/9 arc-second LIDAR DEM, 1/3 arc-second legacy DEM: US Geological Survey 3d Elevation Program (USGS 3DEP), USGS National Elevation Database (NED)

LIDAR DEM Metadata Links

njgin.nj.gov/njgin/edata/elevation
www.pasda.psu.edu/uci/DataSummary.aspx?
pubs.usgs.gov/tm/11/b07/tm11-b7
data.usgs.gov/datacatalog/data/USGS:40e52270
data.usgs.gov/datacatalog/data/USGS:3a81321b

Custom Elevation Shaders

The boydsmaps proprietary shader code starts by finding the minimum and maximum elevations of the map, then dividing that range into 5, 10, 20 or 40 equal groups, depending on the number of colors you choose. The color of each of the 4.2 million pixels in the map is computed based on its position within this scale, such that a smooth transition is made between colors.



Map software is provided "as is", without any express or implied warranty. In no event will boydsmaps.com be held liable for any damages arising from the use of this software. The user assumes all risks associated with the use of this software. boydsmaps.com will not be held responsible for any inaccuracies and no responsibility is assumed for damages or other liabilities due to errors, installation, accuracy, availability, use or misuse of the data presented.