Welcome to the Road Tracks webservice!

Here you will be able to:

• Generate a set of random tracks
  Possible parameters:
  • start_point_x (int >= 0; default = 0)
  • start_point_y (int >= 0; default = 0)
  • end_point_x (int >= 0; default to maximum coordinate of map)
  • end_point_y (int >= 0; default to maximum coordinate of map)
  • min_steps_straight (int > 0; default = 1) - sets the number of minimum steps on a particular direction
  • max_steps_straight (int >= min_steps_straight; default = min_steps_straight + 5)
  • n_tracks (int > 0; default = 300
  e.g.: https://rse-with-python.arc.ucl.ac.uk/road-tracks/tracks/?start_point_x=0&start_point_y=0&n_tracks=10

Result properties

Unless there's an error with the query, the service should produce a JSON file with the following two keys:

• metadata contains information about the query;
• tracks contains a list of tracks, each containing their property.

metadata field

Metadata field contains the following fields:

• 'start' The (x,y) corrdinates for the requested starting point;
• 'end' the (x,y) coordinates for the requested end point;
• 'datetime' The date time of the request in ISO8601 format;
• 'rangesteps' A tuple with the min and max step length used to find the possible tracks;
• 'resolution' The distance between two points;
• 'units_steps' The units of the resolution in SI;
• 'units_elevation' The units of the elevation provided in SI;
• 'n_tracks' The number of tracks returned;
• 'mapsize' The full size of the map as (size x, size y).

track descriptions

Each track is defined by the following properties:

• 'cc' provides a simplified chain code string (values between 1-4);
• 'road' contains a string with the abbreviated specification of which type of road is used from residential, local and motorway (r, l, m);
• 'terrain' contains a string withthe abbreviiated specifitaion of the state of the road from paved, gravel or dirt (p, g, d);
• 'elevation' gives the elevation of each point;