/SnapToRoads

points

Specify the points that you want to snap to the road the vehicle is most likely traveling along. The points can be the GPS points from a navigation device, the tracks captured using ArcGIS Field Maps, or some other set of points that were collected while driving the vehicle.

The distance between the points will affect the performance and final quality of the output. If the points are close together, the algorithm will have a better chance of deducing the probable roads at the expense of processing time. Fewer points will process faster, but may result in the route that was deduced potentially taking different roads.

Example:

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
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
{
  "features": [
    {
      "attributes": {
        "OBJECTID": 1,
        "location_timestamp": 1704522159000,
        "track_id": "track 1"
      },
      "geometry": {
        "x": -122.43410099956145,
        "y": 37.800155000053394
      }
    },
    {
      "attributes": {
        "OBJECTID": 2,
        "location_timestamp": 1704522171000,
        "track_id": "track 1"
      },
      "geometry": {

f

The response format.

1
f=json

token

Specify a token that provides the identity of a user that has the permissions to access the service. The security and authentication page provides more information about how an access token can be obtained.

1
"token=<yourToken>"

travel_mode

Choose the mode of transportation for the analysis. This is the mode of transportation that matches the track data you are analyzing.

The snap to roads algorithms use the travel mode settings when determining the most likely roads that were traveled. For example, if the travel mode restricts travel on express lanes, the algorithms attempt to return roads that are not express lanes. However, in cases where the track clearly indicates the use of an express lane, the algorithms return the express lane regardless of the restriction setting. In other words, the travel mode settings are used as a guideline to influence the snapping behavior, but they may be overridden when the track data does not match those settings.

To learn more about travel modes, see Configure travel modes.

return_lines

Specify whether or not the service will return output_lines representing the roads traversed.

• true—The output_lines will be returned.
• false—The output_lines will not be returned.

road_properties_on_snapped_points

Allowed values:

• oid_Routing_Streets: The ObjectID of the road segment in Routing_Streets feature class the snapped points locate on. It is a unique identifier for the road segment in Routing_Streets feature class.

• posted_speed_limit_kph: The posted speed limit (in kilometers per hour) of the road segment on which the snapped points are located.
• posted_speed_limit_mph: The posted speed limit (in miles per hour) of the road segment on which the snapped points are located.
• posted_speed_limit_mps: The posted speed limit (in meters per second) of the road segment on which the snapped points are located.
• posted_truck_speed_limit_kph: The posted truck speed limit (in kilometers per hour) of the road segment on which the snapped points are located.
• posted_truck_speed_limit_mph: The posted truck speed limit (in miles per hour) of the road segment on which the snapped points are located.
• posted_truck_speed_limit_mps: The posted truck speed limit (in meters per second) of the road segment on which the snapped points are located.

Specify the road properties that the service should return on the output_snapped_points output.

For example: road_properties_on_snapped_points=["posted_speed_limit_kph", "posted_truck_speed_limit_kph"]

road_properties_on_lines

Allowed values:

• oid_Routing_Streets: The ObjectID of the road segment in Routing_Streets feature class. It is a unique identifier for the road segment in Routing_Streets feature class.

• length_kilometers: The length (in kilometers) of the road segment.
• length_miles: The length (in miles) of the road segment.
• posted_speed_limit_kph: The posted speed limit (in kilometers per hour) of the road segment.
• posted_speed_limit_mph: The posted speed limit (in miles per hour) of the road segment.
• posted_speed_limit_mps: The posted speed limit (in meters per second) of the road segment.
• posted_truck_speed_limit_kph: The posted truck speed limit (in kilometers per hour) of the road segment.
• posted_truck_speed_limit_mph: The posted truck speed limit (in miles per hour) of the road segment.
• posted_truck_speed_limit_mps: The posted truck speed limit (in meters per second) of the road segment.

Specify the road properties that the service should return on the output_lines output.

For example: road_properties_on_lines=["length_miles", "length_kilometers"]

context

This parameter contains additional settings that affect task operation, for example, the spatial reference of the output features.

overrides

output_snapped_points

This output is always returned. It includes all of the fields from the input specified in the points parameter plus any fields for the properties specified in the road_properties_on_snapped_points parameter. The output also contains following attributes that are either generated or altered by the service.

output_lines

This output is returned if return_lines is specified as true in the input. It includes fields for the properties specified in the road_properties_on_lines parameter. The output also contains following attributes that are generated by the service.

usage_cost

This parameter returns the credits used by the analysis.

Example

The following shows an example of the usage_cost parameter in which the analysis generated 9 billable objects (represented by numObjects ) and 4.5 credits were used by the analysis.

1
2
3
4
5
6
7
8
{
  "paramName": "Usage_Cost",
  "dataType": "GPString",
  "value": {
    "numObjects": 9,
    "credits": 4.5
  }
}