The World Imagery Wayback App provides a dynamic browsing experience where previous World Imagery versions are presented within the map, along a timeline, and as a list. Versions that resulted in local changes are dynamically presented to the user based on location and scale. Preview changes by hovering and/or selecting individual layers. When ready, one or more Wayback layers can be added to an export queue and pushed to a new ArcGIS Online web map.
To run this application locally, you need to clone the repository, it is recommended to fork it first, then clone your forked repository to your local machine.
Ensure you have Node.js and NPM installed on your machine. You can download them from the Node.js website. The current Long Term Support (LTS) release is recommended for this project.
Before running the application, ensure you have a .env
file in the root directory of the project. You can create this file by copying the provided .env.template
file.
In the .env
file, you must specify the ARCGIS_OAUTH_CLIENT_ID
, which is required for authenticating with ArcGIS services. Follow the How to implement user authentication guide to obtain your OAuth Client ID.
Here is an example of the .env
file configuration:
# ArcGIS OAuth Client ID for the application.
# Replace 'your-client-id' with your actual ArcGIS OAuth Client ID.
ARCGIS_OAUTH_CLIENT_ID=your-client-id
# Custom hostname for starting the Webpack Dev server (optional).
# Defaults to 'localhost' if not specified.
WEBPACK_DEV_SERVER_HOSTNAME=my-custom-hostname.com
Make sure to replace your-client-id
with your actual ArcGIS OAuth Client ID.
From the project's root directory, install the required packages (dependencies):
npm install
To test the app on your local machine, start the webpack dev server:
# This will start a server instance and begin listening for connections from localhost on port 8080
npm run start
To build and prepare the app for deployment, run:
# This will place all files needed for deployment into the /build directory
npm run build
- Wayback - 81 Flavors of World Imagery
- A Fresh Look for Wayback
- World Imagery Wayback Export
- World Imagery Wayback - 2025 Enhancements
- Wayback Imagery group
- ArcGIS Living Atlas of the World
Find a bug or want to request a new feature? Please let us know by submitting an issue.
Esri welcomes contributions from anyone and everyone. Please see our guidelines for contributing.
The imagery presented in the Wayback app is subject to the terms and conditions set forth in the Esri Master Agreement or Terms of Use. See World Imagery for additional details on the imagery content and applicable Terms of Use.
Copyright 2024 Esri
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
A copy of the license is available in the repository's LICENSE file.