Update Trip Avoid Favors
Trip Management’s update trip avoid favors API handles add, update or delete avoid favors associated with a trip. After a trip is planned without avoid favors, user can add them later. After a trip is planned with avoid favors, user can update or delete avoid favors using this API. Planning a trip does not need both afSetIds and afSetNames. When the database is updated, afSetIds and afSetNames are treated as separate entities.
- If both
afSetIdsandafSetNamesare not supplied, all previously saved values for a trip will be removed. - If
afSetIdsare not supplied, ids will be removed. - If
afSetNamesare not supplied, names will be removed. - If a supplied list is different from the previously saved list, the value will be added if any value does not exist in the database; any value stored in the database before does not exit in the supplied list will be removed.
POST /trip/avoidFavors
Resource URL
https://tripmanagement.trimblemaps.com/api/trip/avoidFavors
Request Fields
| Field | Description | Type | Required |
|---|---|---|---|
tripId
| The alkTripId returned when you planned the trip. Note: If no trip is found with the given alkTripId, then an error message will be returned. If the tmsTripId in your planning system is also supplied in the body of this request, then the alkTripId will be ignored irrespective of whether it is valid or not and the trip corresponding to the provided tmsTripId will be updated. In this case, if no trip is found with the given tmsTripId, then an error message will be returned.
|
integer | Yes if tmsTripId is not supplied.
|
tmsTripId
| The tmsTripId of your previously generated route. Note: Even if tripId, which is the alkTripId, is also supplied with this request, it will be ignored and only trip corresponding to the given tmsTripId will be updated. If no trip is found with the given tmsTripId, then an error message will be returned.
|
string | Yes if tripId is not supplied.
|
afSetIds
| An array of avoid favor set ids. |
Array <integer> | No, either set ids or names. |
afSetNames
| An array of avoid favor set names. |
Array <string> | No, either set ids or names. |
Response Fields
| Field | Description | Type |
|---|---|---|
success
| true or false |
boolean |
message
| Error message if there is any. |
string |
Example
Sample Response
{
"success": true,
"message": null
}