Geoprocessing Task that accepts XY coordinates and returns Reference Post (Reference Post Number, Route and County) and LRS Route information.
Example input URL:
https://gdotserver.gdot.gov/arcgis/rest/services/ReferencePostToLRS/GPServer/ReferencePostToLRS/execute?XCoordinate=-85.12126&YCoordinate=34.2167&RoutePriority=nearest_route&SearchDistanceFt=2000
Produces this output JSON:
{"results": [{"paramName": "RefPostInfo", "dataType": "GPString", "value": {"status": "gdotRefPostFoundOK", "refPostMilesToRouteSnapPoint": -0.1543723, "refPostCounty": "Floyd", "refPostDistanceToRefPostFt": 829.930476, "routeSnapMeasure": 22.8603276, "routeSnapY": 34.216249, "routeSnapX": -85.121449, "routeSignName": "SR-20", "routeCode": "00002000", "refPostY": 34.215554, "refPostX": -85.118887, "spatialReference": 4326, "routeDistanceToRouteFt": 173.73487, "refPostNumber": "23", "routeId": "1000100002000INC", "refPostMilepoint": 23.0146999, "refPostMPID": "SR_20_115_23"}}], "messages": []}
| Parameter | Explanation |
|---|---|
| XCoordinate | A valid X coordinate corresponding to InSpatialReferenceWKID (or 4326). |
| YCoordinate | A valid Y coordinate corresponding to InSpatialReferenceWKID (or 4326). |
| InSpatialReferenceWKID (Optional) | Well Known ID (WKID) of input X, Y coordinates. Default value is 4326 (WGS84 geographic [longitude/latitude]). |
| OutSpatialReferenceWKID (Optional) | Well Known ID (WKID) of output X, Y coordinates. Default value is same as InSpatialReferenceWKID. Note that 102604 is the native WKID of GDOT's LRS and ReferencePosts. |
| RouteIdentifier (Optional) | Optional Route Identifier. Can be RouteID (e.g., 1000100002000INC), Route Code (e.g., 00002000) or Route Sign Name (e.g., SR-20). Any returned Reference Post will have this corresponding Route Identifier. |
| RoutePriority (Optional) | Optional Route Priority, Acceptable values are nearest_refpost or nearest_route; if not supplied, RoutePriority defaults to nearest_route. nearest_refpost simply finds the nearest reference post to the input point based on euclidian distance. nearest_route returns the reference post that is closest to the snap point (based on measures) on the route that is closest to the input point. |
| SearchDistanceFt (Optional) | The search distance, in feet, from the input point to the nearest reference post or nearest route (depending on RoutePriority). Default is 5280 (one mile). |
| ActiveDate (Optional) | Active date of Reference Post/LRS in the format m/d/yyyy. Examples are 1/4/2020, 10/23/2022. Default value is current date (today). |
There are no code samples for this tool.
Reference Post, Reference Post Number, LRS, Linear Referencing System
Georgia Department of Transportation.
There are no use limitations for this item.