feat: Add distance tolls specifications

Author: sebastienpro

specification/paths/distance/distanceTolls.yml

@@ -0,0 +1,72 @@
+servers:
+  - url: https://api.woosmap.com
+tags:
+  - Distance API
+description: >
+  Get Tolls
+security:
+  - PublicApiKeyAuth: []
+    RefererHeader: []
+  - PrivateApiKeyAuth: []
+  - PrivateApiKeyHeaderAuth: []
+parameters:
+  - $ref: "../../parameters/distance/origin.yml"
+  - $ref: "../../parameters/distance/destination.yml"
+  - $ref: "../../parameters/distance/mode.yml"
+  - $ref: "../../parameters/distance/language.yml"
+  - $ref: "../../parameters/distance/units.yml"
+  - $ref: "../../parameters/distance/alternatives.yml"
+  - $ref: "../../parameters/distance/waypoints.yml"
+  - $ref: "../../parameters/distance/method.yml"
+  - $ref: "../../parameters/distance/departure_time.yml"
+  - $ref: "../../parameters/distance/arrival_time.yml"
+
+responses:
+  "200":
+    description: Tolls successfully retrieved
+    content:
+      application/json:
+        schema:
+          $ref: "../../schemas/DistanceRouteResponse.yml"
+        examples:
+          default:
+            summary: Distance Tolls Result for driving from origin `49.31067,4.14525` to destination `49.31344,4.15293` and retrieving alternatives routes.
+            value:
+              $ref: "../../responses/woosmap_http_distance_route_response.yml"
+  "401":
+    description: Unauthorized. Incorrect authentication credentials.
+    content:
+      application/json:
+        schema:
+          $ref: "../../schemas/Error401.yml"
+        examples:
+          Unauthorized:
+            summary: Error 401
+            value:
+              detail: "Incorrect authentication credentials. Please check or use a valid API Key"
+  "403":
+    description: Forbidden. This Woosmap API is not enabled for this project.
+    content:
+      application/json:
+        schema:
+          $ref: "../../schemas/Error403.yml"
+        examples:
+          Forbidden:
+            summary: Error 403
+            value:
+              detail: "This Woosmap API is not enabled for this project."
+  "429":
+    description: Too Many Requests. The rate limit for this endpoint has been exceeded.
+    content:
+      application/json:
+        schema:
+          $ref: "../../schemas/Error429.yml"
+        examples:
+          Forbidden:
+            summary: Error 429
+            value:
+              detail: "The rate limit for this endpoint has been exceeded"
+x-codeSamples:
+  - $ref:  "../../snippets/woosmap_http_distance_route/woosmap_http_distance_route.curl.yml"
+  - $ref:  "../../snippets/woosmap_http_distance_route/woosmap_http_distance_route.javascript.yml"
+  - $ref:  "../../snippets/woosmap_http_distance_route/woosmap_http_distance_route.python.yml"

specification/schemas/DistanceTollsElementsResponse.yml

@@ -0,0 +1,14 @@
+title: DistanceTollsElementsResponse
+type: object
+description: Attributes describing routes from an origin to a destination returned in distance tolls response.
+required: [overview_polyline, bounds, legs]
+properties:
+  overview_polyline:
+    $ref: "./EncodedPolyline.yml"
+  bounds:
+    $ref: "./Bounds.yml"
+  legs:
+    type: array
+    description: Legs part of the route response
+    items:
+      $ref: "./DistanceTollsLeg.yml"

specification/schemas/DistanceTollsLeg.yml

@@ -0,0 +1,23 @@
+title: DistanceLeg
+type: object
+description: Leg in a route
+properties:
+  distance:
+    $ref: "./DistanceValue.yml"
+  duration:
+    $ref: "./DurationValue.yml"
+  start_location:
+    $ref: "./LatLngLiteral.yml"
+  end_location:
+    $ref: "./LatLngLiteral.yml"
+  tolls:
+    type: object
+    additionalProperties: {}
+    description: the ending address of the leg
+    example: "{tolls datas}"
+example: {
+  "distance": { "text": "1 km", "value": 1038 },
+  "duration": { "text": "1 min", "value": 75 },
+  "start_location": { "lat": 49.31067, "lng": 4.14525 },
+  "end_location": { "lat": 49.31344, "lng": 4.15293 }
+}

specification/schemas/DistanceTollsResponse.yml

@@ -0,0 +1,14 @@
+title: DistanceTollsResponse
+type: object
+description: Attributes describing a distance tolls response.
+properties:
+  status:
+    $ref: "./DistanceStatus.yml"
+  routes:
+    description: Contains an array of routes with tolls informations from origin to destination
+    type: array
+    items:
+      $ref: "./DistanceTollsElementsResponse.yml"
+
+# example:
+#   $ref: "../responses/woosmap_http_distance_tolls_response.yml"

specification/schemas/_index.yml

@@ -178,6 +178,8 @@ DistanceRouteElementsResponse:
   $ref: "./DistanceRouteElementsResponse.yml"
 DistanceRouteResponse:
   $ref: "./DistanceRouteResponse.yml"
+DistanceTollsResponse:
+  $ref: "./DistanceTollsResponse.yml"
 DistanceStatus:
   $ref: "./DistanceStatus.yml"
 DistanceMatrixRequest: