Routing Schema Update (Azure#34889)

* Drop RegionTravelSummary

* Drop AdminDistrict

* Rename AdminDistrictTruck to AdminDistrict

* Drop regionTravelSummary under routeOutputOptions

* Drop fastestavoidclosurewithouttraffic

* Remove walking mode for SnapToRoads and add truck mode support

* Remove hint

* Drop RoadTypeEnum

* Drop compassDegrees

* Drop resourceId

* Drop viaWaypoint feature output

* Drop SubLeg

* Drop regionTravelSummary under RouteOutputOptions

* Drop compassDirection

* Drop trafficCongestion

* Drop trafficDataUsed

* Remove Only supported for truck travelMode.

* Update snapToRoads descriptions

* Add Short support

* Update to Short

* SnapToRoads  consecutive points must be within 6 kilometer

* Update SnapToRoads example

* update example

* Add trafficCongestion back

* Update batch examples

* Update example

* Add name for SnapToRoads's examples

* update maxRouteCount value

* drop description

---------

Co-authored-by: Will Huang <[email protected]>
Co-authored-by: Faraz Siddiqui <[email protected]>

Author: 3 people

specification/maps/data-plane/Route/preview/2023-10-01-preview/examples/PostRouteDirections.json

@@ -87,10 +87,6 @@
   "responses": {
     "200": {
       "body": {
-        "summary": {
-          "successfulRequests": 2,
-          "totalRequests": 2
-        },
         "batchItems": [
           {
             "type": "FeatureCollection",
@@ -102,15 +98,63 @@
                   "coordinates": []
                 },
                 "properties": {
+                  "distanceInMeters": 2301,
+                  "durationInSeconds": 514,
+                  "departureTime": "2025-06-23T01:38:21+00:00",
+                  "arrivalTime": "2025-06-23T01:47:56+00:00",
+                  "durationTrafficInSeconds": 575,
+                  "trafficCongestion": "Mild",
                   "type": "RoutePath",
-                  "resourceId": "v70,h1207959581,i0,a0,cen-US,dAMA8xD0s2wg1,y1,s1,m1,o1,t0,wWrdB7bfOR0C9UpYhjpVewA2~AJEAEzSxZiQBAADgAYsYlD4B0~N3RoIEF2ZQ2~~~~~~~~v12,w393KEp3NR0ASFhVxOpRewA2~AJEAEzQ5viQBAADgAaehWT4B0~RSBKZWZmZXJzb24gU3Q1~~~~~~~~v12,k0,n2",
-                  "distanceInMeters": 1432.9,
-                  "durationInSeconds": 524,
-                  "durationTrafficInSeconds": 554
+                  "legs": []
                 }
               }
             ],
-            "optionalId": "4C3681A6C8AA4AC3441412763A2A25C81444DC8B"
+            "alternativeRoutes": [
+              {
+                "type": "FeatureCollection",
+                "features": [
+                  {
+                    "type": "Feature",
+                    "geometry": {
+                      "type": "MultiLineString",
+                      "coordinates": []
+                    },
+                    "properties": {
+                      "distanceInMeters": 2297,
+                      "durationInSeconds": 586,
+                      "departureTime": "2025-06-23T01:38:21+00:00",
+                      "arrivalTime": "2025-06-23T01:49:38+00:00",
+                      "durationTrafficInSeconds": 677,
+                      "trafficCongestion": "Mild",
+                      "type": "RoutePath",
+                      "legs": []
+                    }
+                  }
+                ]
+              },
+              {
+                "type": "FeatureCollection",
+                "features": [
+                  {
+                    "type": "Feature",
+                    "geometry": {
+                      "type": "MultiLineString",
+                      "coordinates": []
+                    },
+                    "properties": {
+                      "distanceInMeters": 4253,
+                      "durationInSeconds": 621,
+                      "departureTime": "2025-06-23T01:38:21+00:00",
+                      "arrivalTime": "2025-06-23T01:50:50+00:00",
+                      "durationTrafficInSeconds": 749,
+                      "trafficCongestion": "Medium",
+                      "type": "RoutePath",
+                      "legs": []
+                    }
+                  }
+                ]
+              }
+            ]
           },
           {
             "type": "FeatureCollection",
@@ -122,53 +166,69 @@
                   "coordinates": []
                 },
                 "properties": {
+                  "distanceInMeters": 2301,
+                  "durationInSeconds": 514,
+                  "departureTime": "2025-06-23T01:38:21+00:00",
+                  "arrivalTime": "2025-06-23T01:47:56+00:00",
+                  "durationTrafficInSeconds": 575,
+                  "trafficCongestion": "Mild",
                   "type": "RoutePath",
-                  "resourceId": "v70,h1207959581,i0,a0,cen-US,dAMA8xD0s2wg1,y1,s1,m1,o1,t0,wWrdB7bfOR0C9UpYhjpVewA2~AJEAEzSxZiQBAADgAYsYlD4B0~N3RoIEF2ZQ2~~~~~~~~v12,w393KEp3NR0ASFhVxOpRewA2~AJEAEzQ5viQBAADgAaehWT4B0~RSBKZWZmZXJzb24gU3Q1~~~~~~~~v12,k0,n2",
-                  "distanceInMeters": 1432.9,
-                  "durationInSeconds": 524,
-                  "durationTrafficInSeconds": 554
+                  "legs": []
                 }
               }
             ],
-            "optionalId": "4C3681A6C8AA4AC3441412763A2A25C81444DC8B"
-          }
-        ]
-      }
-    },
-    "207": {
-      "body": {
-        "summary": {
-          "successfulRequests": 1,
-          "totalRequests": 2
-        },
-        "batchItems": [
-          {
-            "type": "FeatureCollection",
-            "features": [
+            "alternativeRoutes": [
               {
-                "type": "Feature",
-                "geometry": {
-                  "type": "MultiLineString",
-                  "coordinates": []
-                },
-                "properties": {
-                  "type": "RoutePath",
-                  "resourceId": "v70,h1207959581,i0,a0,cen-US,dAMA8xD0s2wg1,y1,s1,m1,o1,t0,wWrdB7bfOR0C9UpYhjpVewA2~AJEAEzSxZiQBAADgAYsYlD4B0~N3RoIEF2ZQ2~~~~~~~~v12,w393KEp3NR0ASFhVxOpRewA2~AJEAEzQ5viQBAADgAaehWT4B0~RSBKZWZmZXJzb24gU3Q1~~~~~~~~v12,k0,n2",
-                  "distanceInMeters": 1432.9,
-                  "durationInSeconds": 524,
-                  "durationTrafficInSeconds": 554
-                }
+                "type": "FeatureCollection",
+                "features": [
+                  {
+                    "type": "Feature",
+                    "geometry": {
+                      "type": "MultiLineString",
+                      "coordinates": []
+                    },
+                    "properties": {
+                      "distanceInMeters": 2297,
+                      "durationInSeconds": 586,
+                      "departureTime": "2025-06-23T01:38:21+00:00",
+                      "arrivalTime": "2025-06-23T01:49:38+00:00",
+                      "durationTrafficInSeconds": 677,
+                      "trafficCongestion": "Mild",
+                      "type": "RoutePath",
+                      "legs": []
+                    }
+                  }
+                ]
+              },
+              {
+                "type": "FeatureCollection",
+                "features": [
+                  {
+                    "type": "Feature",
+                    "geometry": {
+                      "type": "MultiLineString",
+                      "coordinates": []
+                    },
+                    "properties": {
+                      "distanceInMeters": 4253,
+                      "durationInSeconds": 621,
+                      "departureTime": "2025-06-23T01:38:21+00:00",
+                      "arrivalTime": "2025-06-23T01:50:50+00:00",
+                      "durationTrafficInSeconds": 749,
+                      "trafficCongestion": "Medium",
+                      "type": "RoutePath",
+                      "legs": []
+                    }
+                  }
+                ]
               }
-            ],
-            "optionalId": "4C3681A6C8AA4AC3441412763A2A25C81444DC8B"
-          },
-          {
-            "error": {
-              "code": "400 BadRequest",
-              "message": "Invalid request"
-            }
+            ]
           }
-        ]
+        ],
+        "summary": {
+          "successfulRequests": 2,
+          "totalRequests": 2
+        }
       }
     }
   }