Update SetActiveRoute.srv to include a 'choice' field and a destination points array field

[JonSmet]

PR Details

Description

This PR adds a 'choice' enumeration field to the SetActiveRoute service request, which indicates whether a RouteID (the name of a route file) or an array of destination points (specifically, an array of cav_msgs/Position3D points) is being provided. Additionally, a field for an array of cav_msgs/Position3D points is included in order to store the destination points, where the last point is the final destination point. This update is being added in order to enable the Port Drayage Plugin package in carma-platform to set a new active route based on a received destination point from CARMA Streets.

Related PRs:

carma-platform: PR #1321
carma-web-ui: PR #92

Related Issue

Motivation and Context

How Has This Been Tested?

Unit Tested in carma-platform and integration tested (using both port drayage plugin package functionality and typical carma-web-ui route-setting functionality) on the Silver Lexus and Blue Lexus.

Types of changes

• Defect fix (non-breaking change that fixes an issue)
• New feature (non-breaking change that adds functionality)
• Breaking change (fix or feature that cause existing functionality to change)

Checklist:

• I have added any new packages to the sonar-scanner.properties file
• My change requires a change to the documentation.
• I have updated the documentation accordingly.
• I have read the CONTRIBUTING document.
  CARMA Contributing Guide
• I have added tests to cover my changes.
• All new and existing tests passed.

[kjrush]

Approving, but holding merge to sync with usdotfhwastol/carma-platform#1321