Concurrencies

URL:: https://<network-layer-url>/concurrencies
Methods:: GET
Required Capability:: The ArcGIS Location Referencing license is required to use this resource.
Version Introduced:: 10.6.1

Description

This operation calculates concurrencies and dominance for a set of routes and measure ranges. A concurrency is an overlapping section of two or more routes in the same LRS Network that share a common centerline.

This operation determines the dominant route for each concurrency section. Route dominance is based on a set of business rules that can be configured for an LRS network. If the route dominance for a group of concurrent routes cannot be successfully calculated, the response includes a dominanceError property describing the reason. The following table lists the possible dominance errors:

Dominance error	Description
`Tie`	Two or more routes have the same attribute value for a concurrent section.
`NoAttributes`	A route does not have an attribute value for a concurrent section, or the attribute value is null.
`TooManyAttributes`	A route has multiple values of an event attribute for the same location in a concurrent section.
`NotCalibrated`	A concurrent section of a route is not calibrated with measures, or centerline start and endpoints cannot be located along the route.

Request parameters

Parameter Details

Parameter	Details
`f` (Optional)	Specifies the response format. The default response format is `html`. Values: `html` \| `json` \| `pjson`
`locations` (Required)	A list of routes and optional measure ranges where concurrencies can be found. Syntax: Use dark colors for code blocksCopy `1 2 3 4 5 6 7 8 9 10 11 [ { // find concurrencies along an entire route "routeId": "<routeId>" }, { // find concurrencies within a measure range "routeId": "<routeId>", "fromMeasure": <measure>, "toMeasure": <measure> }, ... ]`
`temporalViewDate`	The time instant to use as a temporal view date when locating route features. If this parameter is not specified, the current date is used. The parameter value is a number that represents the number of milliseconds since epoch (January 1, 1970) in UTC. Syntax: Use dark colors for code blocksCopy `1 temporalViewDate=<timeInstant>` Example: Use dark colors for code blocksCopy `1 temporalViewDate=1230768000000 (1 Jan 2009 00:00:00 GMT)`
`fromDate`	The start of a time range to use when locating route features. This parameter cannot be used with the `temporalViewDate` parameter. The parameter value is a number that represents the number of milliseconds since epoch (January 1, 1970) in UTC. Syntax: Use dark colors for code blocksCopy `1 fromDate=<timeInstant>` Example: Use dark colors for code blocksCopy `1 fromDate=1230768000000 (1 Jan 2009 00:00:00 GMT)`
`toDate`	The end of a time range to use when locating route features. This parameter cannot be used with the `temporalViewDate` parameter. The parameter value is a number that represents the number of milliseconds since epoch (January 1, 1970) in UTC. Syntax: Use dark colors for code blocksCopy `1 toDate=<timeInstant>` Example: Use dark colors for code blocksCopy `1 toDate=1230768000000 (1 Jan 2009 00:00:00 GMT)`
`gdbVersion` (Optional)	Specifies the geodatabase version to use. If this parameter is not specified, the published map's version is used. Syntax: Use dark colors for code blocksCopy `1 gdbVersion=<version>` Example: Use dark colors for code blocksCopy `1 gdbVersion="user1.version1"`

f

(Optional)

Specifies the response format. The default response format is html.

Values: html | json | pjson

locations

(Required)

A list of routes and optional measure ranges where concurrencies can be found.

Syntax:

Use dark colors for code blocksCopy
[
  { // find concurrencies along an entire route
    "routeId": "<routeId>"
  },
  { // find concurrencies within a measure range
    "routeId": "<routeId>",
    "fromMeasure": <measure>,
    "toMeasure": <measure>
  },
  ...
]

temporalViewDate

The time instant to use as a temporal view date when locating route features. If this parameter is not specified, the current date is used.

The parameter value is a number that represents the number of milliseconds since epoch (January 1, 1970) in UTC.

Syntax:

Use dark colors for code blocksCopy
temporalViewDate=<timeInstant>

Example:

Use dark colors for code blocksCopy
temporalViewDate=1230768000000 (1 Jan 2009 00:00:00 GMT)

fromDate

The start of a time range to use when locating route features. This parameter cannot be used with the temporalViewDate parameter. The parameter value is a number that represents the number of milliseconds since epoch (January 1, 1970) in UTC.

Syntax:

Use dark colors for code blocksCopy
fromDate=<timeInstant>

Example:

Use dark colors for code blocksCopy
fromDate=1230768000000 (1 Jan 2009 00:00:00 GMT)

toDate

The end of a time range to use when locating route features. This parameter cannot be used with the temporalViewDate parameter. The parameter value is a number that represents the number of milliseconds since epoch (January 1, 1970) in UTC.

Syntax:

Use dark colors for code blocksCopy
toDate=<timeInstant>

Example:

Use dark colors for code blocksCopy
toDate=1230768000000 (1 Jan 2009 00:00:00 GMT)

gdbVersion

(Optional)

Specifies the geodatabase version to use. If this parameter is not specified, the published map's version is used.

Syntax:

Use dark colors for code blocksCopy
gdbVersion=<version>

Example:

Use dark colors for code blocksCopy
gdbVersion="user1.version1"

Example usage

Example 1

URL for calculating concurrencies for the entire measure span of a route.

Use dark colors for code blocksCopy
https://sampleserver/arcgis/rest/services/MyLRS/MapServer/exts/LRServer/networkLayers/0/concurrencies?f=json&locations=[{"routeId":"I90"}]

Example 2

URL for calculating concurrencies for a measure range on a route.

Use dark colors for code blocksCopy
https://sampleserver/arcgis/rest/services/MyLRS/MapServer/exts/LRServer/networkLayers/0/concurrencies?f=json&locations=[{"routeId":"I90","fromMeasure":25.1,"toMeasure":26.8}]

Example 3

URL for calculating concurrencies for multiple routes.

Use dark colors for code blocksCopy
https://sampleserver/arcgis/rest/services/MyLRS/MapServer/exts/LRServer/networkLayers/0/concurrencies?f=json&locations=[{"routeId":"I90","fromMeasure":25.1,"toMeasure":26.8},{"routeId":"US20"}]

Example 4

URL for calculating concurrencies for a time instant (view date).

Use dark colors for code blocksCopy
https://sampleserver/arcgis/rest/services/MyLRS/MapServer/exts/LRServer/networkLayers/0/concurrencies?f=json&locations=[{"routeId":"I90"}]&temporalViewDate=1230768000000

Example 5

URL for calculating concurrencies for a time range.

Use dark colors for code blocksCopy
https://sampleserver/arcgis/rest/services/MyLRS/MapServer/exts/LRServer/networkLayers/0/concurrencies?f=json&locations=[{"routeId":"I90"}]&fromDate=1230768000000&toDate=1388534400000

JSON response syntax

Use dark colors for code blocksCopy
{
  "locations": [
    {
      // source location properties
      "routeId": "<routeId>",
      "fromMeasure": <measure>,
      "toMeasure": <measure>,

      "concurrencies": [  // a list of all sections with concurrent routes
        {
          "routeId": "<routeId>",
          "fromMeasure": <measure>,
          "toMeasure": <measure>,
          "fromDate": <timestamp>,
          "toDate": <timestamp>,
          "sectionId": <integer>,  // correlates multiple concurrency records for a single section of shared centerline
          "isDominant": <true | false>,
          "dominanceError": "<Tie | NoAttributes | TooManyAttributes | NotCalibrated>"
        },
        ...
      ]
    },
    ...
  ]
}

JSON response example

Use dark colors for code blocksCopy
{
  "locations": [
    {
      "routeId": "US101",
      "fromMeasure": 0,
      "toMeasure": 5.8,
      "concurrencies": [
        {
          "routeId": "US101",
          "fromMeasure": 1.2,
          "toMeasure": 1.65,
          "fromDate": 1230768000000,
          "toDate": null,
          "sectionId": 1,
          "isDominant": true
        },
        {
          "routeId": "SR210",
          "fromMeasure": 37.45,
          "toMeasure": 37.9,
          "fromDate": 1230768000000,
          "toDate": null,
          "sectionId": 1,
          "isDominant": false
        },
        {
          "routeId": "US101",
          "fromMeasure": 5.0,
          "toMeasure": 5.8,
          "fromDate": 1230768000000,
          "toDate": null,
          "sectionId": 2,
          "isDominant": false,
          "dominanceError": "NoAttributes"
        },
        {
          "routeId": "I5",
          "fromMeasure": 81.54,
          "toMeasure": 80.7,
          "fromDate": 1230768000000,
          "toDate": null,
          "sectionId": 2,
          "isDominant": true
        }
      ]
    }
  ]
}