ArcGIS Maps SDK for Swift Samples

This repository contains Swift sample code demonstrating the capabilities of the ArcGIS Maps SDK for Swift and how to use those capabilities in your own app. The project can be opened in Xcode and run on a simulator or a device. Or you can download the app from the App Store on your iOS device.

Features

• Maps - Open, create, interact with and save maps
• Scenes - Visualize 3D environments and symbols
• Layers - Display vector and raster data in maps and scenes
• Augmented Reality - View data overlaid on the real world through your device's camera
• Visualization - Show graphics, popups, callouts, sketches, and style maps with symbols and renderers
• Edit and Manage Data - Add, delete, and edit features and attachments, and taking data offline
• Search and Query - Find addresses, places, and points of interest
• Routing and Logistics - Calculate routes between locations and around barriers
• Analysis - Perform spatial analysis via geoprocessing tasks and services
• Cloud and Portal - Search for web maps and securely connect to your portal
• Utility Networks - Work with utility networks, performing traces and exploring network elements

Requirements

• ArcGIS Maps SDK for Swift 200.5 (or newer)
• ArcGIS Maps SDK for Swift Toolkit 200.5 (or newer)
• Xcode 15.0 (or newer)

The ArcGIS Maps SDK for Swift Samples app has a Target SDK version of 16.0, meaning that it can run on devices with iOS 16.0 or newer.

Building Samples Using Swift Package Manager

1. Fork and then clone the repository
2. Open the Samples.xcodeproj project file

   The project has been configured to use the arcgis-maps-sdk-swift-toolkit package, which provides the ArcGISToolkit framework as well as the ArcGIS framework.

3. Run the Samples app target

To add the Swift packages to your own projects, consult the documentation for the ArcGIS Maps SDK for Swift Toolkit and ArcGIS Maps SDK for Swift.

Configuring API Keys

[!IMPORTANT] To run this app and access ArcGIS Location Services, follow these steps to obtain an API key access token and store it in a secrets file stored in the project file's directory, $(SRCROOT)/.secrets.

1. Go to the Create an API key tutorial to obtain the API key access token. Ensure that the following privileges are enabled:

• Location services > Basemaps
• Location services > Geocoding
• Location services > Routing

2. Create a hidden secrets file in the project file's directory.

   touch .secrets

3. Add your API key to the aforementioned secrets file. Adding an API key allows you to access ArcGIS location services, such as the basemap styles service.

   echo ARCGIS_API_KEY_IOS=your-api-key >> .secrets

   Replace 'your-api-key' with your API Key access token.

Please see Configure App Secrets for adding license string and other details.

Additional Resources

• Unfamiliar with SwiftUI? Check out Apple's SwiftUI documentation.
• Want to start a new project? Setup your development environment
• New to the API? Explore the documentation: Guide | API Reference
• Got a question? Ask the community on our forum

Contributing

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

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

Licensing

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