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
- Documentation on the URL scheme structure
- Sample code for iOS (Swift) and Windows (.NET)
Read the following documentation and clone down the appropriate language into your development environment.
####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 the iOS and Windows 10 platforms. Support for Android is coming.
####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¶meter=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¢er=34.0547155,-117.1961714
####Errors If an error is encountered when processing a URL scheme, the user will receive an alert.
- Collector for ArcGIS documentation
- Navigator for ArcGIS integration repository
- Apple's guide to custom URL schemes
Find a bug or want to request a new feature? Please let us know by submitting an issue. Thank you!
Esri welcomes contributions from anyone and everyone. Please see our guidelines for contributing.
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)