Add examples to policy/examples/README.md

Author: avatarneil

policy/examples/README.md

@@ -4,14 +4,18 @@ This file presents a series of example [Policy documents](../README.md#schema) f
 
 ## Table of Contents
 
-- [Prohibited Zone](#prohibited-zone)
-- [Provider Cap](#provider-cap)
-- [Idle Time](#idle-time)
-- [Speed Limits](#speed-limits)
-- [Per Trip Fees](#per-trip-fees)
-- [Vehicle Right of Way Fees](#vehicle-right-of-way-fees)
-- [Metered Parking Fees](#metered-parking-fees)
-- [Required Parking](#required-parking)
+- [Policy Examples](#policy-examples)
+  - [Table of Contents](#table-of-contents)
+  - [Prohibited Zone](#prohibited-zone)
+  - [Provider Cap](#provider-cap)
+  - [Idle Time](#idle-time)
+  - [Speed Limits](#speed-limits)
+  - [Per Trip Fees](#per-trip-fees)
+  - [Vehicle Right of Way Fees](#vehicle-right-of-way-fees)
+  - [Metered Parking Fees](#metered-parking-fees)
+  - [Required Parking](#required-parking)
+  - [Tiered Parking Fees Per Hour](#tiered-parking-fees-per-hour)
+  - [Tiered Parking Fees Total](#tiered-parking-fees-total)
 
 ## Prohibited Zone
 
@@ -445,5 +449,124 @@ File: [`required-parking.json`](required-parking.json)
 }
 ```
 
+## Tiered Parking Fees Per Hour
+This policy states parking fees as such:
+- Parking for the first hour costs $2
+- Parking for the second hour costs $4
+- Parking every hour onwards costs $10
+
+For example, say a vehicle is parked for 6.5 hours. It will be charged `$2 (0-1hr) + $4 (1-2hr) + $10 (2-3hr) + $10 (3-4hr) + $10 (4-5hr) + $10 (5-6hr) + $10 (6-6.5hr) = $56`
+File: [`tiered-parking-fees-per-hour.json`](tiered-parking-fees-per-hour.json)
+```
+{
+  "name": "Tiered Dwell Time Example",
+  "description": "First hour $2, second hour $4, every hour onwards $10",
+  "policy_id": "2800cd0a-7827-4110-9713-b9e5bf29e9a1",
+  "start_date": 1558389669540,
+  "publish_date": 1558389669540,
+  "end_date": null,
+  "prev_policies": null,
+  "provider_ids": [],
+  "currency": "USD",
+  "rules": [
+    {
+      "name": "> 2 hours",
+      "rule_id": "9cd1768c-ab9e-484c-93f8-72a7078aa7b9",
+      "rule_type": "time",
+      "rule_units": "hours",
+      "geographies": ["0c77c813-bece-4e8a-84fd-f99af777d198"],
+      "statuses": { "available": [], "non_operational": [] },
+      "vehicle_types": ["bicycle", "scooter"],
+      "maximum": 2,
+      "rate_amount": 1000,
+"rate_recurrence": "each_time_unit"
+    },
+    {
+      "name": "1-2 Hours",
+      "rule_id": "edd6a195-bb30-4eb5-a2cc-44e5a18798a2",
+      "rule_type": "time",
+      "rule_units": "hours",
+      "geographies": ["0c77c813-bece-4e8a-84fd-f99af777d198"],
+      "statuses": { "available": [], "non_operational": [] },
+      "vehicle_types": ["bicycle", "scooter"],
+      "maximum": 1,
+      "rate_amount": 400,
+"rate_recurrence": "each_time_unit"
+    },
+    {
+      "name": "0-1 Hour",
+      "rule_id": "6b6fe61b-dbe5-4367-8e35-84fb14d23c54",
+      "rule_type": "time",
+      "rule_units": "hours",
+      "geographies": ["0c77c813-bece-4e8a-84fd-f99af777d198"],
+      "statuses": { "available": [], "non_operational": [] },
+      "vehicle_types": ["bicycle", "scooter"],
+      "maximum": 0,
+      "rate_amount": 200,
+"rate_recurrence": "each_time_unit"
+    }
+  ]
+}  
+```
+
+## Tiered Parking Fees Total
+This policy states parking fees as such:
+- If parked for less than an hour, $2 on exit
+- If parked for less than 2 hours, $4 on exit
+- If parked for any duration longer than 2 hours, $10 on exit
+
+For example, if a vehicle is parked for 6.5 hours, it will be charged $10 on exit.
+File: [`tiered-parking-fees-total.json`](tiered-parking-fees-total.json)
+```
+{
+  "name": "Tiered Dwell Time Example",
+  "description": "If parked for <1hr $2 upon exit, if parked for 1-2 hours $4 upon exit, if parked for longer than 2 hours $10 upon exit",
+  "policy_id": "2800cd0a-7827-4110-9713-b9e5bf29e9a1",
+  "start_date": 1558389669540,
+  "publish_date": 1558389669540,
+  "end_date": null,
+  "prev_policies": null,
+  "provider_ids": [],
+  "currency": "USD",
+  "rules": [
+    {
+      "name": "> 2 hours",
+      "rule_id": "9cd1768c-ab9e-484c-93f8-72a7078aa7b9",
+      "rule_type": "time",
+      "rule_units": "hours",
+      "geographies": ["0c77c813-bece-4e8a-84fd-f99af777d198"],
+      "statuses": { "available": [], "non_operational": [] },
+      "vehicle_types": ["bicycle", "scooter"],
+      "maximum": 2,
+      "rate_amount": 1000,
+"rate_recurrence": "once_on_unmatch"
+    },
+    {
+      "name": "1-2 Hours",
+      "rule_id": "edd6a195-bb30-4eb5-a2cc-44e5a18798a2",
+      "rule_type": "time",
+      "rule_units": "hours",
+      "geographies": ["0c77c813-bece-4e8a-84fd-f99af777d198"],
+      "statuses": { "available": [], "non_operational": [] },
+      "vehicle_types": ["bicycle", "scooter"],
+      "maximum": 1,
+      "rate_amount": 400,
+"rate_recurrence": "once_on_unmatch"
+    },
+    {
+      "name": "0-1 Hour",
+      "rule_id": "6b6fe61b-dbe5-4367-8e35-84fb14d23c54",
+      "rule_type": "time",
+      "rule_units": "hours",
+      "geographies": ["0c77c813-bece-4e8a-84fd-f99af777d198"],
+      "statuses": { "available": [], "non_operational": [] },
+      "vehicle_types": ["bicycle", "scooter"],
+      "maximum": 0,
+      "rate_amount": 200,
+"rate_recurrence": "once_on_unmatch"
+    }
+  ]
+}
+```
 [Top](#table-of-contents)