imclab / arcgis-maps-sdk-unreal-engine-samples

Sample code for the ArcGIS Maps SDK for Unreal Engine.

arcgis-maps-sdk-unreal-engine-samples

Here is an Unreal Engine 5 project containing a set of samples showing you how to accomplish various things using the combined features of Unreal Engine 5 and the ArcGIS Maps SDK for Unreal Engine. The main branch is configured to work with our most recent release (1.1.0) if you want to use the sample repo with an older release check out the corresponding tag of the sample repo, git checkout 1.0.0 for the sample repo that worked with our 1.0.0 release.

Features

• Feature Layer - Query objects from a feature layer and show them on the map in Unreal Engine.
• Geocoding - Search for an address or click on the surface to get the address of that location.
• Line of sight - See how to check the line of sight between two objects.
• Measure - Click on the map to get real world distances between points.
• Routing - Show a route between two points on a map using Esri's routing service REST API.
• Third Person Character Controller - See how to run around a virtual city in Unreal Engine.

Instructions

1. Clone this repo. Note On Windows there is a 260 character limit in your file path. The ArcGISMapsSDK for Unreal Engine Plugin is ~160 characters at the longest point. This samples repo by default adds arcgis-maps-sdk-unreal-engine-samples\sample_project for a total of ~215 characters. You can use git clone <git_repo_url> <your_custom_directory_name> to remove the lengthy arcgis-maps-sdk-unreal-engine-samples to give you more freedom for where it can be cloned.
2. Refer to the ArcGIS Maps SDK for Unreal Engine's documentation on getting started on how to download Unreal Engine 5 and the ArcGIS Maps SDK for Unreal Engine.
3. Launch the Unreal Engine project. Note If you are prompted that there is a version mismatch, the project may need to be re-compiled. You will need to launch it through Visual Studio.
4. Install the plugin into this project.
5. Launch the SampleViewer level. You will be prompted to enter an API Key for the samples to work. To avoid entering it each time you run the viewer, go to Edit -> Project Settings -> Plugins -> ArcGIS Maps SDK and set the API Key for the project. To learn more about API keys, read the developer documentation.

Requirements

• Refer to the ArcGIS Maps SDK for Unreal Engine's documentation on system requirements

Resources

• ArcGIS Maps SDK for Unreal Engine's documentation
• Esri Community forum
• Obtaining an API key
• Unreal Engine's documentation

Issues

Find a bug or want to request a new feature? Please let us know by submitting an issue.

Contributing

Esri welcomes contributions from anyone and everyone. Please see our guidelines for contributing.

Licensing

Copyright 2022 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.txt file.