v15
latestOpenAPI 3.1.02026-07-1295183803.5 KBUpdate a restriction
Path parameters
Unique ID of the restriction. This is the ID that was generated at the time of creating the restriction.
Query parameters
Use this parameter to decide the format for specifying the geofence coordinates. If true, then the coordinates of geofence can be specified as "latitude,longitude" format, otherwise they should be specified in "longitude,latitude" format.
A key is a unique identifier that is required to authenticate a request to the API.
Request body
Specify a custom, descriptive name for the restriction.
Specify the area name. It represents a region where restrictions can be applied. This is a custom field and it is recommended for the users to check with NextBillion.ai support for the right value. Alternatively, users can invoke the Areas method to get a list of available areas for them.
It represents the days and times when the restriction is in effect. Users can use this property to set recurring or one-time restrictions as per the given format for specifying the recurring schedule of the restriction.
Please provided values as per the local time of the region where the restriction is being applied.
Use this parameter to add any custom information about the restriction being created.
Provide a UNIX epoch timestamp in seconds, representing the start time for the restriction to be in-effect.
Provide a UNIX epoch timestamp in seconds, representing the time when the restriction should cease to be in-effect.
Provide the driving modes for which the restriction should be effective. If the value is an empty array or if it is not provided then the restriction would be applied for all modes.
Provide the the fixed speed of the segment where the restriction needs to be applied. Please note that this parameter is mandatory when the restrictionType is fixedspeed.
Provide the the maximum speed of the segment where the restriction needs to be applied. Please note that this parameter is mandatory when the restrictionType is maxspeed.
Represents the traffic direction on the segments to which the restriction will be applied.
Specify the maximum truck weight, in kilograms, that the restriction will allow. A value of 0 indicates no limit.
Please note this parameter is effective only when restriction_type is truck. At least one of truck parameters - weight, height, width and truck - needs to be provided for is truck restriction type.
Specify the maximum truck height, in centimeter, that will be allowed under the restriction. A value of 0 indicates no limit.
Please note this parameter is effective only when restriction_type is truck. At least one of truck parameters - weight, height, width and truck - needs to be provided when restriction type is truck.
Specify the maximum truck width, in centimeter, that will be allowed under the restriction. A value of 0 indicates no limit.
Please note this parameter is effective only when restriction_type is truck. At least one of truck parameters - weight, height, width and truck - needs to be provided when restriction type is truck.
Specify the maximum truck length, in centimeter, that will be allowed under the restriction. A value of 0 indicates no limit.
Please note this parameter is effective only when restriction_type is truck. At least one of truck parameters - weight, height, width and truck - needs to be provided when restriction type is truck.
Example request
{
"repeat_on": "repeatOn=\"Mo-Fr 07:00-09:00,17:00-19:00\""
}Response
Returns the unique ID of the restriction. This ID can be used for update, delete, get operations on the restriction using the available API methods.
Returns the name of the restriction. This value is same as that provided at the time of creating or updating the restriction.
Returns the area to which the restriction belongs to.
Returns the details of the bounding box containing the restriction.
Returns the status of the restriction at the time of making the request i.e. whether the restriction is in force or not. It will have one of the following values: active or inactive.
Please note that this field can not be directly influenced by the users. It will always be calculated using the start_time, end_time and repeat_on parameters.
Returns the time periods during which this restriction active or repeats on. The time values follow a given format.
Returns the comments that were provided for the restriction at the time of creating or updating the request.
The timestamp at which the restriction was created.
The timestamp at which the restriction was updated.
The time when the restriction starts to be in-effect. It is a UNIX timestamp.
The time when the restriction ceases to be in-effect. It is a UNIX timestamp.
Returns an array denoting all the traveling modes the restriction applies on.
Returns the type of restriction. This is the same value as provided when creating or updating the restriction.
Returns the highway information on which the restriction applies to. If no highway is impacted by the restriction, then this field is not present in the response.
Returns the fixed speed of segments. This field is not present in the response if the restriction type is not fixedspeed
Returns the maximum speed of segments. This field is not present in the response if the restriction type is not maxspeed
Returns the direction of travel on the segments to which the restriction applies.
Returns the state of the "restriction" itself - enabled, disabled or deleted. It does not denote if the restriction is actually in effect or not.
Returns the list of coordinates representing the area that was used to apply the given restriction. The geofence returned is same as that provided while creating or updating the restriction.
Example response
{
"bbox": {
"minLat": 0,
"minLon": 0,
"maxLat": 1,
"maxLon": 1
},
"repeat_on": "Mo-Fr 07:00-09:00,17:00-19:00"
}