Tasks

Task is a planned route that a driver must follow to collect data. As routes, you can draw polygons or highlight particular roads on the interactive Urbi map, and also upload your own polygons with your unique areas or regions, districts, and others.

If you use a polygon to create a route, all roads inside it are automatically included in the route. If necessary, you can exclude roads from the route. For each task, the total length of roads and the estimated travel time by car are calculated. For tasks with polygons, the area of ​​the polygon is also calculated.

Example of a task with a polygon on the map:

Example of a task with highlighted roads on the map:

In the Task Planner, you can work with tasks for covering territories on the Tasks tab:

• create tasks
• view information about tasks
• check the status of the created tasks
• edit tasks
• complete tasks
• cancel tasks

Creating a task

1. Go to the Tasks tab.

2. Open the page of the required territory and project.

3. Click New task.

4. Create a route in one of the following ways:

   • To draw a polygon on the map, click icon and place at least three points on the map. To remove a point, hover over it and click icon. The points are connected automatically. The polygon lines must not intersect. To close the polygon, connect the start and end points or press Enter.

     

   • To highlight roads on the map, click icon and select the required segments. To delete a segment, click the icon next to the required segment in the list. All road segments are automatically included in the route.

     

   • To upload your own polygon from a file (see file requirements), click icon, drag a file to the upload area, or Select a file on a computer.

   When you create a route, you can use the search by addresses, places, and organizations on the map:

   

5. If you draw or upload a polygon, all roads inside it are automatically included in the route. If you need to exclude some roads from the route (for example, move some roads to another task), use the following methods:

   • Click icon and click on the roads that you need to exclude.
   • Select filters to exclude roads: by road class (main streets, highways, and others), type of surface (asphalt, gravel, and others), and road length in meters.
   

6. Specify task parameters:

   • Task name (mandatory parameter): task name.
   • Driver: driver assigned to the task. You can use the search by the list of drivers and filter drivers by tags. Only the drivers added to the territory are displayed in the list. If necessary, you can skip selecting a driver and assign them later.
   • Due date: task completion date.
   

7. Click Create task.

Polygon file requirements

If you are loading a polygon from a file, make sure that the file meets the requirements:

• Geometry: Polygon
• Formats: .kml, .kmz, .shp, .geojson
• Size: up to 100 MB
• Encoding: UTF-8
• Coordinate system: WGS84(4326)

File example:

{
    "type": "FeatureCollection",
    "features": [
        {
            "type": "Feature",
            "properties": {},
            "geometry": {
                "coordinates": [
                    [
                        [55.250045684992756, 25.214516586337368],
                        [55.23184311284339, 25.190451666684623],
                        [55.250268554857, 25.181176083495615],
                        [55.270626867225474, 25.204838345838027],
                        [55.250045684992756, 25.214516586337368]
                    ]
                ],
                "type": "Polygon"
            }
        }
    ]
}

Viewing information about a task

1. Go to the Tasks tab.
2. Open the page of the required territory and project.
3. Select the required task or click on the corresponding polygon on the map. You can also use the search by the list of tasks and filter tasks by territory, tag, driver, and status.

The following information about the task is displayed:

• ID: unique task identifier.
• Task completion: task completion percentage. Displayed only for tasks with the In Progress or Completed status.
• Due date: scheduled date for task completion. Displayed if you filled in the field when creating or editing the task.
• Creation date: date of the task creation.
• Area: area of ​​the territory (polygon) in km². Displayed only for tasks with polygons.
• Length of roads: total length of roads inside the polygon.
• Detour time: estimated travel time around the polygon by car with traffic jams.
• Driver: driver assigned to the task. Displayed if you filled in the field when creating or editing the task.

Viewing task status

1. Go to the Tasks tab.
2. Open the page of the required territory and project.
3. View the task status in its row. The color of the corresponding polygon or route roads on the map depend on the task status.

Possible task statuses:

• New (blue color): the task is created but is not assigned to a driver. You can edit a task or cancel a task with this status.
• Assigned (yellow color): the task is assigned to a driver, but the driver has not yet started it. You can edit a task or cancel a task with this status.
• In Progress (yellow color): the driver has started the task in the mobile application. The status shows task progress percentage. You can complete a task or cancel a task with this status.
• Completed (green color): the task is marked as completed.
• Canceled: the task is cancelled. Cancelled tasks are not displayed on the map, but all information about them is saved in the task card. Cancelled tasks are not removed from the list.

Editing a task

If the task is in the New or Assigned status, you can edit it:

• edit the route: change the drawn polygon, upload a new one, highlight roads, or exclude roads
• rename the task
• assign to another driver or remove a driver from the task
• change the scheduled completion date of the task

To edit a task:

1. Go to the Tasks tab.
2. Open the page of the required territory and project.
3. Select the required task, and in the opened dialog, click Edit task.
4. Apply necessary changes to the task.
5. Click Save task.

Completing a task

If the task is in the In Progress status, you can mark the task as completed and move it to the Completed status. You can complete a task with any percentage of completion.

1. Go to the Tasks tab.
2. Open the page of the required territory and project.
3. Select the required task.
4. In the opened dialog, click icon and select Complete task.

Canceling a task

If the task is in the New, Assigned, or In Progress status, you can cancel the task and move it to the Canceled status.

1. Go to the Tasks tab.
2. Open the page of the required territory and project.
3. Select the required task.
4. Click icon and select Cancel task.