Creating and considering custom Feature Layers blocking or opening roads
Blocking the closest road to a location
The first example is the most basic example. It shows how to create a custom Feature Layer in binary mode that blocks a road segment by finding a segment via a given coordinate. Then, a route is calculated which takes the newly created Feature Layer into account. Therefore, the JavaScript bindings to the xRoute and xData service APIs are used.
var A = { "$type": "OffRoadWaypoint", "location": { "offRoadCoordinate": { "x": 6.124995946884156, "y": 49.589077328363246 } } }; var B = { "$type": "OffRoadWaypoint", "location": { "offRoadCoordinate": { "x": 6.128221, "y": 49.589744 } } }; var BlockPoint = { "x": 6.1267428913116455, "y": 49.58952524284309 }; var outputString = ""; var map = new L.Map('map', { center: [49.587, 6.220], zoom: 13 }); // Add tile layer to map new L.tileLayer.xserver(xServerUrl + '/services/rest/XMap/experimental/tile/{z}/{x}/{y}' + '?layers=background,transport,labels&contentType=JSON', { pane: "overlayPane", maxZoom: 20, }).addTo(map); // Display the block point L.circle([BlockPoint.y, BlockPoint.x], {radius: 3}).addTo(map); //----- Find segment near coordinate ----- function getSegmentToBlock(searchCoord) { var foundSegmentId; xdata.getSegments({ "$type": "SegmentsByCoordinateRequest", "resultFields": { "polyline": true, "descriptors": true }, "coordinate": searchCoord, "geometryOptions": { "responseGeometryTypes": ["GEOJSON"] } }, function(result, exception) { var geoJson = result.segments[0].polyline.geoJSON; displayGeoJson(geoJson, '#481111'); foundSegmentId = result.segments[0].id; }); return foundSegmentId; } //----- Create FeatureLayer ----- function createFeatureLayer (segmentIdToBlock) { var createdFeatureLayer; xdata.createFeatureLayer({ "themeId" : "PTV_RoadAttributes", "features" : [ { "segmentIds" : [ segmentIdToBlock ], "descriptions" : [ { "attributes" : [ { "key" : "opening", "value" : 0 } ] } ] } ] }, function(result, exception) { createdFeatureLayer = result.binaryFeatureLayer; }); return createdFeatureLayer; }; //----- Route ----- function calculateSpecificRoute(binaryFeatureLayer) { xroute.calculateRoute({ "waypoints": [A, B], "routeOptions": { "binaryFeatureLayer": binaryFeatureLayer }, "resultFields": { "polyline": true }, "geometryOptions": { "responseGeometryTypes": ["GEOJSON"] } }, function(route, exception) { var geoJson = route.polyline.geoJSON; displayGeoJson(geoJson, '#2882C8'); outputString += 'route= ' + route.distance + ' m in ' + route.travelTime + ' s '; print(outputString); }); } function displayGeoJson(geoJson, color) { var jsonObject = JSON.parse(geoJson); var geoJsonLayer = new L.GeoJSON(jsonObject, { style: { color: color, weight: 8 } }).addTo(map); map.fitBounds(geoJsonLayer.getBounds()); }; var segmentId = getSegmentToBlock(BlockPoint); var newBinaryFeatureLayer = createFeatureLayer(segmentId); calculateSpecificRoute(newBinaryFeatureLayer);The function getSegmentToBlock() returns the SegmentId of the road segment to be blocked. The function createFeatureLayer() uses the SegmentId to create the custom Feature Layer in binary mode. At the creation of the custom Feature Layer, the KeyValuePair is filled with "opening = 0" which has the effect of closing the road. The function calculateSpecificRoute() uses the binary custom Feature Layer to calculate the route.
Of course, the requests can be improved to consider other parameters.
Blocking a road in a given direction with a time-dependent restriction
Please pay attention to the digitization direction of the segments, when blocking a road. By default, custom Feature Layers apply the restrictions in both directions. The example below shows how to block a segment in a single direction (here in POLYLINE_DIRECTION). To visualize the digitization direction of the segment, the first point of its polyline is represented by a green circle, and the last point by an orange circle. Moreover, in createFeatureLayer(), a GDF time-domain is applied to block the road between 8.00 am and 6.00 pm only, every day of the week. var A = { "$type": "OffRoadWaypoint", "location": { "offRoadCoordinate": { "x": 6.102114021778108, "y": 49.61157198400649 } } }; var B = { "$type": "OffRoadWaypoint", "location": { "offRoadCoordinate": { "x": 6.101757287979126, "y": 49.61230540624378 } } }; var PointSelector = { "x": 6.101773381233216, "y": 49.611860487909446 }; var firstPoint, endPoint; var outputString = ""; var map = new L.Map('map', { center: [49.587, 6.220], zoom: 13 }); // Add tile layer to map new L.tileLayer.xserver(xServerUrl + '/services/rest/XMap/experimental/tile/{z}/{x}/{y}' + '?layers=background,transport,labels&contentType=JSON', { pane: "overlayPane", maxZoom: 20, }).addTo(map); //----- Find segment near coordinate ----- function getSegmentToBlock(searchCoord) { var foundSegmentId; xdata.getSegments({ "$type": "SegmentsByCoordinateRequest", "resultFields": { "polyline": true, "descriptors": true }, "coordinate": searchCoord, "geometryOptions": { "responseGeometryTypes": ["GEOJSON"] } }, function(result, exception) { var geoJson = result.segments[0].polyline.geoJSON; displayGeoJson(geoJson, '#481111'); foundSegmentId = result.segments[0].id; firstPoint = JSON.parse(result.segments[0].polyline.geoJSON).coordinates[0]; const size = JSON.parse(result.segments[0].polyline.geoJSON).coordinates.length; endPoint = JSON.parse(result.segments[0].polyline.geoJSON).coordinates[size - 1]; }); return foundSegmentId; } //----- Create FeatureLayer ----- function createFeatureLayer(segmentIdToBlock) { var createdFeatureLayer; xdata.createFeatureLayer({ "themeId" : "PTV_RoadAttributes", "features" : [ { "segmentIds" : [ segmentIdToBlock ], "descriptions" : [ { "attributes" : [ { "key" : "opening", "value" : 0 } ], "timeDomain": "[(h8){h10}]" } ], "direction": "POLYLINE_DIRECTION" } ] }, function(result, exception) { createdFeatureLayer = result.binaryFeatureLayer; }); return createdFeatureLayer; }; //----- Route ----- // when the road is blocked. function calculateSpecificRoute(binaryFeatureLayer) { xroute.calculateRoute({ "waypoints": [A, B], "routeOptions": { "binaryFeatureLayer": binaryFeatureLayer, "timeConsideration": { "$type":"SnapshotTimeConsideration", "referenceTime":"2020-09-08T12:00:00+02:00" } }, "resultFields": { "polyline": true }, "geometryOptions": { "responseGeometryTypes": ["GEOJSON"] } }, function(route, exception) { var geoJson = route.polyline.geoJSON; displayGeoJson(geoJson, '#2882C8'); outputString += 'route= ' + route.distance + ' m in ' + route.travelTime + ' s '; L.circle([firstPoint[1], firstPoint[0]], {radius: 5, color:"green"}).addTo(map); L.circle([endPoint[1], endPoint[0]], {radius: 5, color:"orange"}).addTo(map); L.circle([A.location.offRoadCoordinate.y, A.location.offRoadCoordinate.x], {radius: 4, color:"green"}).addTo(map); L.circle([B.location.offRoadCoordinate.y, B.location.offRoadCoordinate.x], {radius: 4, color:"orange"}).addTo(map); print(outputString); }); } function displayGeoJson(geoJson, color) { var jsonObject = JSON.parse(geoJson); var geoJsonLayer = new L.GeoJSON(jsonObject, { style: { color: color, weight: 8 } }).addTo(map); map.fitBounds(geoJsonLayer.getBounds(), {padding: [50, 50]}); }; var segmentId = getSegmentToBlock(PointSelector); var newBinaryFeatureLayer = createFeatureLayer(segmentId); calculateSpecificRoute(newBinaryFeatureLayer);
Opening a one-way street in the reverse direction
Sometimes it is necessary to open a blocked road, e.g. a pedestrian area or even a one-way street in reverse direction. This can be useful for emergency or intervention vehicles (police, firefighter, ambulances). Or this can be useful in case of temporary openings due to roadworks, or when a recent change of driving direction is not yet included in the map. For that, the KeyValuePair "opening = 1" can be used. The same mechanism can be used to open in both direction (or in a single direction). But note that in the case of one-way the polyline geometry describing one segment follows by default the driving direction.
In this example a vehicle can take a roundabout in the opposite direction.
var start = { "$type": "OffRoadWaypoint", "location": { "offRoadCoordinate": { "x": 6.098698287479262, "y": 49.61920894121072 } } }; var destination = { "$type": "OffRoadWaypoint", "location": { "offRoadCoordinate": { "x": 6.0974877997263075, "y": 49.618171744885764 } } }; var openPoint = { "x": 6.0976228745025916, "y": 49.61838450961683 }; var outputString = ""; var map = new L.Map('map', { center: [49.618400, 6.097700], zoom: 18.5 }); // Add tile layer to map new L.tileLayer.xserver(xServerUrl + '/services/rest/XMap/experimental/tile/{z}/{x}/{y}' + '?layers=background,transport,labels&contentType=JSON', { pane: "overlayPane", maxZoom: 25, }).addTo(map); // Display the open point L.circle([openPoint.y, openPoint.x], {radius: 1.5}).addTo(map); // Color the start/end waypoints new L.circle([start.location.offRoadCoordinate.y, start.location.offRoadCoordinate.x], { color: 'green', zIndex: 1000, radius: 4 }).addTo(map); new L.circle([destination.location.offRoadCoordinate.y, destination.location.offRoadCoordinate.x], { color: 'orange', zIndex: 1000, radius: 4 }).addTo(map); //----- Find segment near coordinate ----- function getSegmentToOpen(searchCoord) { var foundSegmentId; xdata.getSegments({ "$type": "SegmentsByCoordinateRequest", "resultFields": { "polyline": true, "descriptors": true }, "coordinate": searchCoord, "geometryOptions": { "responseGeometryTypes": ["GEOJSON"] } }, function(result, exception) { var geoJson = result.segments[0].polyline.geoJSON; displayGeoJson(geoJson, '#481111', 10); foundSegmentId = result.segments[0].id; }); return foundSegmentId; } //----- Create FeatureLayer ----- function createFeatureLayer(segmentIdToOpen) { var createdFeatureLayer; xdata.createFeatureLayer({ "themeId" : "PTV_RoadAttributes", "features" : [ { "segmentIds" : [ segmentIdToOpen ], "descriptions" : [ { "attributes" : [ { "key" : "opening", "value" : 1 } ] } ] } ] }, function(result, exception) { createdFeatureLayer = result.binaryFeatureLayer; }); return createdFeatureLayer; }; //----- Route ----- function calculateSpecificRoute(binaryFeatureLayer) { xroute.calculateRoute({ "waypoints": [start, destination], "routeOptions": { "binaryFeatureLayer": binaryFeatureLayer }, "resultFields": { "polyline": true }, "geometryOptions": { "responseGeometryTypes": ["GEOJSON"] } }, function(route, exception) { var geoJson = route.polyline.geoJSON; displayGeoJson(geoJson, '#2882C8',8); outputString += 'route= ' + route.distance + ' m in ' + route.travelTime + ' s '; print(outputString); }); } function displayGeoJson(geoJson, color, weight) { var jsonObject = JSON.parse(geoJson); var geoJsonLayer = new L.GeoJSON(jsonObject, { style: { color: color, weight: weight, } }).addTo(map); map.fitBounds(geoJsonLayer.getBounds()); }; var segmentId = getSegmentToOpen(openPoint); var newBinaryFeatureLayer = createFeatureLayer(segmentId); calculateSpecificRoute(newBinaryFeatureLayer);Be careful when opening one-way roads. Violations will not be reported if a route takes a segment which has been open by a custom Feature Layer. In addition, opening a route resets all its penalties, except those set by a custom Feature Layer.