[Hub Generated] Review request for Route to add version preview/2023-08-01-preview (Azure#23044)

* Adds base for updating Route from version preview/1.0 to version 2023-05-31-preview

* Updates readme

* Updates API version in new specs and examples

* Add directions API

* Update example

* fix lint

* update api-version

* fix lint

* rename to pointTypes

* Add readOnly and reaname object

* Add properties object and add x-ms-client-flatten=true

* Add alternative routes and fix json description

* Update routeOutputOptions

* Add nextLink for batch response

* Add geoJSON and Add 207

* rename details to steps

* Add x-ms-client-name for legs, sublegs and steps

* Add required fields

* Add pathLegRange under legs

* rename Route_PostDirectionsBatch to Route_PostRouteDirectionsBatch

* Fix OperationIdNounVerb

* Fix nextLink

* Remove kind

* two discriminator

* Add description

* Rename JSON object and use enum for featuresProperteisType

---------

Co-authored-by: Will Huang <huangwill@microsoft.com>

Author: 2 people