Geometry To Measure

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

Description

This operation converts one or more geographic locations into measure values along a set of routes.

If a point location cannot be converted to a measure value, a status message is returned with the reason the conversion failed. The following table lists the possible locating statuses.

Status messages

The following table contains an enumeration of the possible locating statuses:

StatusDescription

esriLocatingOK

Locating was successful.

esriLocatingMultipleLocation

Locating was successful and the input point was located on more than one route.

esriLocatingCannotFindRoute

The route does not exist.

esriLocatingRouteShapeEmpty

The route does not have a shape or the shape is empty.

esriLocatingRouteMeasuresNull

The route does not have measures or the measures are null.

esriLocatingRouteNotMAware

The route is not an m-aware polyline.

esriLocatingCannotFindLocation

The route location's shape cannot be found because the route has no measures or the route location's measures do not exist on the route.

Request parameters

ParameterDetails

f

(Optional)

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

Values: html | json | pjson

locations

(Required)

Lists routes and point locations to convert to measure values. If the route ID is omitted for a given point, the point is located on all nearby routes within the tolerance. In that case, the response contains multiple route IDs and measure values corresponding to the single point location. Syntax:

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
[
  {
    "routeId": "<routeId1>",  // route ID is optional, may be omitted or null
    "geometry": { "x": <x1>, "y": <y1> }
  },
  {
    "routeId": "<routeId2>",  // route ID is optional, may be omitted or null
    "geometry": { "x": <x2>, "y": <y2> }
  },
  ...
]

tolerance

The maximum distance in map units to snap a point to the closest location on a nearby route. If a point is farther than the tolerance from a route, an indication is returned that the point can't be located. If a route ID is provided in the locations parameter in the request, the tolerance parameter is ignored and only the route ID is considered.

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)

inSR

The spatial reference of the input geometry.

The spatial reference can be specified as either a Well-Known ID (WKID) or a spatial reference JSON object.

If inSR is not specified, the geometry is assumed to be in the spatial reference of the map.

outSR

The spatial reference of the returned geometry.

The spatial reference can be specified as either a Well-Known ID (WKID) or a spatial reference JSON object.

If outSR is not specified, the output geometries are in the spatial reference specified by inSR. If inSR is also not specified, the output geometries are in the spatial reference of the map.

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"

Example usage

Example 1

URL for converting a single point to a measure

Use dark colors for code blocksCopy
1
https://sampleserver/arcgis/rest/services/MyLRS/MapServer/exts/LRServer/networkLayers/1/geometryToMeasure?f=json&locations=[{"routeId":"I90","geometry":{"x":-8479115,"y":5326520}}]&tolerance=50&inSR=102100

Example 2

URL for converting multiple points to measures

Use dark colors for code blocksCopy
1
https://sampleserver/arcgis/rest/services/MyLRS/MapServer/exts/LRServer/networkLayers/1/geometryToMeasure?f=json&locations=[{"routeId":"I90","geometry":{"x":-8479115,"y":5326520}},{"routeId":"US20","geometry":{"x":-8472692,"y":5295686}}]&tolerance=25&inSR=102100

Example 3

URL for converting a single point on any nearby route to one or more measures

Use dark colors for code blocksCopy
1
https://sampleserver/arcgis/rest/services/MyLRS/MapServer/exts/LRServer/networkLayers/1/geometryToMeasure?f=json&locations=[{"geometry":{"x":-8479100,"y":5326500}}]&tolerance=100&inSR=102100

JSON Response syntax

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
{
  "unitsOfMeasure": "<units>",
  "spatialReference": <>,
  "locations": [
    { // result(s) for the first point location
      "status": "<status1>",
      "results": [
        {
          "routeId": "<routeId1>",
          "measure": <measure1>,
          "distance": <distance1>, // in xy units of spatial reference, or in meters if the network's spatial reference is a geographic coordinate system
          "geometryType": "<geometryType1>",  // esriGeometryPoint
          "geometry": { "x": <x>, "y": <y> }
        },
        ...
      ]
    },
    { // result(s) for the second point location
      "status": "<status2>",
      "results": [
        {
          "routeId": "<routeId2>",
          "measure": <measure2>,
          "distance": <distance2>,
          "geometryType": "<geometryType2>",
          "geometry": { "x": <x>, "y": <y> }
        },
        ...
      ]
    },
    ...
  ]
}

JSON Response example

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
  "unitsOfMeasure": "esriMeters",
  "spatialReference": { "wkid": 102100 },
  "locations": [
    {
      "status": "esriLocatingOK",
      "results": [
        {
          "routeId": "I90",
          "measure": 25.05,
          "distance": 1.23,
          "geometryType": "esriGeometryPoint",
          "geometry": { "x": -8479118.349, "y": 5326520.134 }
        }
      ]
    }
  ]
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.