talllguy / collector-integration

Multi Language repository that contains documentation and sample code for creating custom URL schemes in Collector for ArcGIS.

Collector custom URL scheme

This is a multi-language repository that contains documentation and sample code for creating custom URL schemes in Collector for ArcGIS.

##Supported versions

• Collector for ArcGIS 10.4.0 or later on iOS and Windows 10, and Collector for ArcGIS 10.4.1 or later on Android

What's included

• Documentation on the URL scheme structure
• Sample code for iOS (Swift), Windows (.NET), Android (Java), and Python

Get started

Read the following documentation and clone down the appropriate language into your development environment.

Documentation

####Collector URL scheme overview

A URL scheme allows you to launch a native app from another app, website, or email. You can set options in the URL that will be passed to the app you want to open, causing it to perform specific functions, such as opening a web map and centering the map on a given location. This capability is available on all platforms.

####Basic Collector URL scheme structure

All Collector URL schemes start with the identifier arcgis-collector and can contain additional parameters that follow the form:

arcgis-collector://?parameter=value&parameter=value

The remainder of this topic describes the various parameters Collector currently supports.

####Open a web map

This is one of the simplest schemes that can be used. The following example URL scheme demonstrates how to open a specific map within Collector.

itemID: The web map to open in Collector.

The following example URL defines opening a web map:

arcgis-collector://?itemID=35b1ccecf226485ea7d593f100996b49 

####Center at a given location

The location on which to center the map.

center: (optional) Specified as a set of latitude, longitude (y,x) coordinates. Coordinates must be in WGS84.

The following example URL defines a map to open and a location to center the map:

arcgis-collector://?itemID=35b1ccecf226485ea7d593f100996b49&center=34.0547155,-117.1961714

####Errors If an error is encountered when processing a URL scheme, the user will receive an alert.

Sample code

• Swift (iOS)
• .NET (Windows)
• Java (Android)
• Python

Resources

• Collector for ArcGIS documentation
• Navigator for ArcGIS integration repository
• Apple's guide to custom URL schemes

Issues

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

Contributing

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

Licensing

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

[](Esri Tags: iOS Windows Collector URL-Scheme C-Sharp) [](Esri Language: Swift)