Create Route Layers

routeData (Required)

The item id for the route data item that is used to create route layer items. Before running this task, the route data must be added to your portal as an item.

Syntax:

1
2
3
{
"itemId" : {item id of the route data item}
}

deleteRouteData (Required)

Indicates if the input route data item should be deleted. You may want to delete the route data in case it is no longer required after the route layers have been created from it.

When deleteRouteData is set to true and the task fails to delete the route data item, it will return a warning message but still continue execution.

The default value is false.

Example:

1
"deleteRouteData": "true"

Values: true | false

outputName (Required)

Specify properties such as the title, tags, snippet, and the portal folder for the output route layer items.

• tags: Specify tags used to describe and identify the route layer items. Individual tags are separated using a comma. The route name is always added as a tag even when a value for this property is not specified.
• snippet: Specify the summary displayed as part of the item information for the route layer item. If a value for this property is not specified, a default summary text "Route and directions for <Route Name>" is used.
• title: A qualifier added to the title of every route layer item. This can be used to designate all routes for a specific purpose to have the same prefix in the title. The name of the route is always appended after this qualifier. If a value for this property is not specified, the title for the route layer item is created only using the route name.
• folderId: Specify the id of an existing folder within your personal online workspace where the route layer items will be created. If a value for this property is not specified, the route layer items are created in the root folder of your online workspace.

Syntax:

1
2
3
4
5
6
7
8
{
"itemProperties": {
"title": "<Prefix>",
"tags": "<tag1>,<tag2>",
"snippet": "<A short summary common to every route item.>",
"folderId": "<folder id>"
   }
}

Example:

1
2
3
4
5
6
7
8
{
"itemProperties": {
"title": "Monday Routes",
"tags": "Delivery, Priority2",
"snippet": "Deliveries that must be performed on Monday.",
"folderId": "edffe6469763487cb7749c10a1c39f7d"
   }
}

context

Context contains additional settings that affect task execution. Currently, Create Route Layers does not honor any settings passed as part of context.

f

The response format. The default response format is html.

Values: html | json | pjson

routeLayers

The output route layer items.

Example:

1
{"url": "http://<analysis url>/CreateRouteLayers/jobs/<jobId>/results/routeLayers"}

The result has properties for parameter name, data type, and value. The contents of value include the item ids of the output route layers as well as some additional properties such as the URL for the route layer items.

Syntax:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
{
 "paramName": "routeLayers",
 "dataType": "GPString",
 "value": {
   "items": {
     "<route layer 1 item id>": {
       "url": "<route layer 1 item URL",
       "routeName": "<route name>",
       "title": "<Route name prefix>:  <route name>"
     },
     "<route layer 2 item id>": {
       "url": "<route layer 1 item URL",
       "routeName": "<route name>",
       "title": "<Route name prefix>:  <route name>"
     }
   },
   "folderId": "<folder id>",
   "portalUrl": "<portal url>"
 }
}