- URL:
- https://<network-layer-url>/exportNetwork
- Methods:
GET
- Required Capability:
- The ArcGIS Location Referencing license is required to use this resource.
- Version Introduced:
- 10.9
Description
This operation exports an LRS Network then maintains the differences (deltas), which can be queried to list changes that have been made to route features during a period of time. External systems can use this information at regular intervals to synchronize themselves to route edits in the LRS Network.
Request parameters
Parameter | Details |
---|---|
(Optional) |
Specifies the response format. The default response format is Values: |
(Optional) | Specifies the time value of the last time this operation was executed. When an external system makes an export network request, the time of the request is returned in the response (based on the date and time of the ArcGIS Server system time). The external system should pass this date and time back to this call on subsequent requests if they only want changes to the LRS since the last time they made this request. If no value is provided, all routes and related information are exported across all time. If the Changed routes are exported according to the provided time parameters (
The parameter value for Syntax:
Example:
|
(Optional) |
Specifies the temporal view date on which route edits are inspected. ArcGIS Location Referencing stores routes and other network details with different representations across time. This parameter can be used to focus the time view of the network changes to be processed, which is especially useful for external systems that don't support multiple representations of the LRS network across time. For such systems, a specific time snapshot of the LRS can be requested. If no value is provided, then all routes and related information are exported across all time. If a value is provided, it is used as a temporal filter to export changed routes, along with The parameter value for Syntax:
Example:
|
(Optional) |
Specifies the The provided value is used to identify route changes that have already been exported in previous invocations. If a value is provided, it is used as a temporal filter along with If no value is provided, all routes and related information are exported across all time. The parameter value for Syntax:
Example:
|
(Optional) |
Determines the data format of the output event records. The following output formats are supported:
Syntax:
Example 2:
Example 1:
|
(Optional) | Specifies the spatial reference to output. Syntax:
Example:
|
(Optional) | Defines the number of decimal places to use for rounding measure values. Syntax:
Example:
|
(Optional) | Specifies LRS Networks for which to translate exported routes. Syntax:
Example:
|
(Optional) |
Specifies the geodatabase version to use. If this parameter is not specified, the published map's version is used. Syntax:
Example:
|
Output file format
The network can be exported as either a file geodatabase or as a JSON-formatted file. The file geodatabase format is the default.
In FGDB format, the output file contains one feature class (Route) and five tables (ExportDetails, Networks, Gap, Concurrency, and LrmTranslation). In JSON format, the output contains one JSON file each for the route and the tables.
The following tables define the schema of the output file geodatabase.
Route feature class
Column name | Data type | Length |
---|---|---|
Network_ID | Long | N/a |
Route_ID | Text | 255 |
Start_Measure | Double | N/a |
End_Measure | Double | N/a |
Start_Date | Date | N/a |
End_Date | Date | N/a |
ExportDetails table
Column name | Data type | Length |
---|---|---|
LRS_Time | Date | N/a |
Last_LRS_Time | Date | N/a |
Invoked_Time | Date | N/a |
Last_Invoked_Time | Date | N/a |
Out_Sr_Wkid | Long | N/a |
Precision | Long | N/a |
Lrm_Translations | Text | 100 |
Networks table
Column name | Data type | Length |
---|---|---|
Network_ID | Long | N/a |
Network_Name | Text | 100 |
Units_of_Measure | Long | N/a |
Gap table
Column name | Data type | Length |
---|---|---|
Route_ID | Text | 255 |
Gap_Start_Measure | Double | N/a |
Gap_End_Measure | Double | N/a |
Gap_Type | Long | N/a |
Start_Date | Date | N/a |
End_Date | Date | N/a |
Concurrency table
Column Name | Data Type | Length |
---|---|---|
Dominant_Route_ID | Text | 255 |
Dominant_Start_Measure | Double | N/a |
Dominant_End_Measure | Double | N/a |
Subordinate_Route_ID | Text | 255 |
Subordinate_Start_Measure | Double | N/a |
Subordinate_End_Measure | Double | N/a |
Start_Date | Date | N/a |
End_Date | Date | N/a |
LrmTranslation table
Column Name | Data Type | Length |
---|---|---|
Base_Route_ID | Text | 255 |
Base_Start_Measure | Double | N/a |
Base_End_Measure | Double | N/a |
Translated_Network_ID | Long | N/a |
Translated_Route_ID | Text | 255 |
Translated_Start_Measure | Double | N/a |
Translated_End_Measure | Double | N/a |
Start_Date | Date | N/a |
End_Date | Date | N/a |
Example usage
The following example URL exports a network using all time parameters.
https://sampleserver/arcgis/rest/services/MyLRS/MapServer/exts/LRServer/networkLayers/6/ exportNetwork?lastInvokedTime=1609200000000&lrsTime=1609200000000&lastLrsTime=1609027200000&outputFormat=FGDB&outputSrWkid=&precision=7&lrmTranslations&gdbVersion=ExportNetwork&f=html
JSON Response syntax
The following is an example of response syntax for a status
:
{
"statusURL": <jobIdURL>
}
JSON Response example
Initial status response
The following is an example status
returned with a job
, which is used to make additional status calls:
{"statusURL":"https://sampleserver/arcgis/rest/services/MyLRS/MapServer/exts/LRServer/jobs/je9b6aa1da1904a23ab0d1a5513fba6f5"}
Subsequent status response
The subsequent call uses the job
returned above.
{
"status": "esriJobSucceeded",
"percentComplete": 100,
"exportNetworkJobResult ":
{
"url": <URL>,
"invokedTime": <dateTime>
}
}
The following example demonstrates a response for calls using the job
returned above:
{
"status": "esriJobSucceeded",
"percentComplete": 100,
"exportNetworkJobResult": {
"url": https://sampleServer/server/rest/directories/arcgisoutput/_ags_lrs_429B4209-7B0B-4A15-B7FD-2696DB757706.zip,
"invokedTime": 1611137603000
}
}