Skip To Content

Deploy your map

Once your map is ready for use in the field, deploy it to your mobile workers. Share it with them, and then they can either browse to the map in Collector or tap a custom link you've sent.

Share your map for use in Collector

Collector provides access to maps with editable data that are either owned by the mobile worker or shared with a group containing the mobile worker. For your mobile workers to access your shared map, they need to be members of an ArcGIS organization and have the privilege to edit features.

  1. If the mobile workers aren't already members of an ArcGIS organization (either in ArcGIS Online or ArcGIS Enterprise), you'll need to create accounts for them.
  2. If you don't already have a group that you'll use to manage the mobile workers who have access to your maps and data, create a group.
  3. Add the mobile workers to the group.
  4. Share the map and layers with the group.

Launch your map from a URL

Mobile workers can browse to your map in Collector, or you can provide a URL directly to it. Make it easy for your mobile workers to open the right map and get started on their work by sharing a link directly to your map through an email, text message, web page, or another app. Use the Collector URL scheme for links. When tapped, Collector opens to the map you want the mobile worker to use. You can even start capturing data when the map opens. If your mobile workers are working offline, don't worry: the links still work.

Note:

If you have both Collector and Collector Classic installed on the same device, and you launch your map from a URL (for example, through an email or Workforce for ArcGIS), there is no way to specify which Collector app is used.

Collector URL scheme

The Collector URL scheme uses the identifier arcgis-collector. URL scheme links have the following format: arcgis-collector://?parameter=value&parameter=value, where parameter and value pairs are replaced with the values you want to use to open a map. For example, arcgis-collector://?itemID=3ac4145c1ac44aea86e9ed42e00fbb0d&center=34.0547155,-117.1961714 uses the parameter itemID and the value 3ac4145c1ac44aea86e9ed42e00fbb0d to open the map with that ID. The center parameter and 34.0547155,-117.1961714 value center the map at those coordinates.

Parameters

The following parameters are supported with the Collector URL scheme. If no parameters are passed, tapping the link opens Collector (or prompts you to do so).

ParameterValuesNotes

itemID

The itemID of the map to open

  • The item ID is in the URL of your map's item page. For example, if your map's item page URL is https://www.arcgis.com/home/item.html?id=3ac4145c1ac44aea86e9ed42e00fbb0d, the map's item ID is 3ac4145c1ac44aea86e9ed42e00fbb0d.

center

A set of latitude, longitude (y, x) coordinates at which to center the map

  • Requires itemID.
  • Coordinates must be in WGS84.
  • Separate coordinates with a comma and no spaces.

featureSourceURL

The URL of the layer or table where capture is instantiated

  • Requires itemID.
  • Optionally provide entries for the form using the featureAttributes parameter.
Note:

Not supported on Windows.

featureAttributes

A JSON dictionary of form entries for the newly captured feature

  • Requires itemID and featureSourceURL.
  • Specified entries overwrite any existing values.
  • If an entry isn't present in the editable form, or the type of the value provided is incorrect, the entry is ignored.
  • Dates should be represented as a numeric value using milliseconds since epoch time.
  • Entries with an associated coded value domain use the domain code (not domain description).
  • Entries must be URL encoded before being passed to Collector.
Note:

Not supported on Windows.

Continue reading for examples of using these parameters to achieve specific behavior with the Collector URL scheme.

Open the map

Open the map using the itemID parameter.

The following is an example:

arcgis-collector://?itemID=3ac4145c1ac44aea86e9ed42e00fbb0d

Center the map

Open the map and center it at the provided location using the following parameters:

  • itemID
  • center

The following is an example:

arcgis-collector://?itemID=3ac4145c1ac44aea86e9ed42e00fbb0d&center=34.0547155,-117.1961714

Initiate capturing a feature

Open the map and start capturing a feature using the following parameters. Optionally provide form entries to apply to the new asset or observation.

  • itemID
  • center (optional)—If provided, the center is used as the geometry of a point feature, or the first vertex for a line or polygon. If not provided, the mobile worker's GPS location is used for the point or first vertex.
  • featureSourceURL
  • featureAttributes (optional)

The following are examples:

Libraries

Libraries provided through the Collector Integration GitHub repository can be used to generate URLs with the proper Collector URL scheme. They are provided for use in Swift (iOS), .NET (Windows), Java (Android), and Python code.

Provide help to your mobile workers

While this documentation provides information about using Collector, mobile workers in the field often need something more lightweight—something that can be printed and taken along (especially if working offline). Providing them with a basic, single-page field guide that helps with common tasks and some issues makes your job supporting the mobile workers easier. A field guide template focused on common tasks and written for the mobile worker is provided. Use it to jump-start creating your own reference for your mobile workers.

  1. Download the field guide template.
    Note:

    If you're still using Collector Classic, see the Collector cheat sheet template blog to download the template.

  2. Customize it (add your logo, troubleshooting tips specific to your organization, and so on). Make sure to remove the first section that walks you through customizing it.
  3. Give it to your mobile workers.

    Mobile workers can keep the guide in their pocket, and use this self-service guide to resolve issues while they're in the field.

Related topics