From f41436e88ddcce2e91e6f2ffe3f3d8a214575e41 Mon Sep 17 00:00:00 2001
From: josee-sabourin <josee@mobilitydata.org>
Date: Tue, 21 Jul 2020 13:03:17 -0400
Subject: [PATCH 01/12] Core Pricing

Addition of Core Pricing for new PR in response to Kristian's original proposal.
---
 gbfs.md | 46 +++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 43 insertions(+), 3 deletions(-)

diff --git a/gbfs.md b/gbfs.md
index 680b290e..4e2b7f0a 100644
--- a/gbfs.md
+++ b/gbfs.md
@@ -567,18 +567,58 @@ Field Name | Required | Type | Defines
 \-&nbsp;`name` | Yes | String | Public name for this region.
 
 ### system_pricing_plans.json
-Describes pricing for the system.
+Describes pricing for the system. <br /><br />Additional proposed extensions supporting zone-dependent pricing, multi-unit pricing and price capping can be found [here](https://docs.google.com/document/d/1xzC0nS3M-ora32k5RbfhFCsfZp4B-wVKK2-pOokpxmQ/edit?usp=sharing).
 
 Field Name | Required | Type | Defines
 ---|---|---|---
-`plans` | Yes | Array | Array of objects as defined below.
+`plans` | Yes | Array | Array of objects as defined below.<br /><br /> In the event of colliding plans, the earlier plan (ir order of the JSON file) takes precedence.
 \-&nbsp;`plan_id` | Yes | ID | Identifier for a pricing plan in the system.
+\-&nbsp;`days` | Optional | Array | An array of abbreviations (first 3 letters) of English names of the days of the week when this plan is active. <br /><br /> Valid values are:<br /><br /><ul><li>`mon`</li><li>`tue`</li><li>`wed`</li><li>`thu`</li></li>`fri`</li></li>`sat`</li></li>`sun`</li></li> <br /><br />If this field is empty, the plan does not vary depending on day of the week.
+\-&nbsp;`months` | Optional | Array | An array of abbreviations (first 3 letters) of English names of the months of the year when this plan is active. <br /><br /> Valid values are: <br /><br /><ul><li>`jan`</li><li>`feb`</li><li>`mar`</li><li>`apr`</li><li>`may`</li><li>`jun`</li><li>`jul`</li><li>`aug`</li><li>`sep`</li><li>`oct`</li><li>`nov`</li><li>`dec`<br /><br />If this field is empty, the plan does not vary depending on month.
+\-&nbsp;`start_time` | Conditionally Required | Time | Time of the day when this plan starts being active. <br /><br /> If this field is empty, the plan does not vary depending on time of day.<br /><br />Conditionally Required: Required if `system_pricing_plans.end_time` is provided. Optional otherwise.
+\-&nbsp;`end_time` | Conditionally Required | Time | Time of the day when this plan stops being active. <br /><br /> If this field is empty, the plan does not vary depending on time of day.<br /><br />Conditionally Required: Required if `system_pricing_plans.start_time` is provided. Optional otherwise.
+\-&nbsp;`vehicle_type_id` | Optional | Array | `vehicle_type_id` of the vehicle eligible for this pricing plan as described in [vehicle_types.json](#vehicle_typesjson-added-in-v21-rc).<br /><br />If this field is empty, the plan applies to all vehicle types defined in the dataset.<br /><br />In the case of a vehicle type being attributed to different plans, all plans associated with the vehicle type are valid.   
 \-&nbsp;`url` | Optional | URL | URL where the customer can learn more about this pricing plan.
 \-&nbsp;`name` | Yes | String | Name of this pricing plan.
 \-&nbsp;`currency` | Yes | String | Currency used to pay the fare. <br /><br /> This pricing is in ISO 4217 code: http://en.wikipedia.org/wiki/ISO_4217 <br />(e.g. `CAD` for Canadian dollars, `EUR` for euros, or `JPY` for Japanese yen.)
-\-&nbsp;`price` | Yes | Non-negative float OR String | Fare price, in the unit specified by currency. If String, must be in decimal monetary value.
+\-&nbsp;`price` | Yes | Non-negative float OR String | Fare price, in the unit specified by currency. If String, must be in decimal monetary value.<br /><br />In case of non-variable price, this field is the total price. In case of variable price, this field is the base price that is charged only once per trip (e.g., price for unlocking).
 \-&nbsp;`is_taxable` | Yes | Boolean | Will additional tax be added to the base price?<br /><br />`true` - Yes.<br />  `false` - No.  <br /><br />`false` may be used to indicate that tax is not charged or that tax is included in the base price.
 \-&nbsp;`description` | Yes | String | Customer-readable description of the pricing plan. This should include the duration, price, conditions, etc. that the publisher would like users to see.
+\-&nbsp;`variable_price` | Optional | Array | Array of segments when `variable_unit` varies.<br /><br />The total variable price in the unit specified by the currency becomes the sum of prices issued of rate segments and flat segments.<br /><br /> If this array is not provided, there are no variable prices.
+&emsp;\-&nbsp;`variable_unit` | Yes | Enum | Unit of the rate.<br /><br />Valid issues are:<br /><br /><ul><li>`km`</li><li>`min`</li><li>`hour`</li><li>`day`</li><li>`week`<br /><br />Each variable_unit can be used only once in the array `variable_price`.
+&emsp;\-&nbsp;`rate_segments` | Conditionally Required | Array | Array of the rate in increasing order. Each `rate_segment` defines one rate per `variable_unit` of riding in the pricing plan currency. The variable price become the sum of `rate_segment` prices. A `rate_segment` price depends on the rate per `variable_unit` elapsed.<br /><br />At least one `rate_segment` or `flat_segment` is required.
+&emsp;&emsp;\-&nbsp;`start` | Optional | Non-Negative Integer | Number of units that have to elapse before this segment starts applying.<br /><br />If this field is empty, the price issued from this segment is charged immediately upon rental.
+&emsp;&emsp;\-&nbsp;`rate` | Yes | Float | Rate that serves to calculate the variable price based on the amount of variable unites. The rate is valid for the segment. Can be a negative number.
+&emsp;\-&nbsp;`flat_segments` | Conditionally Required | Array | Array of flat prices in increasing order. Each segment defines the flat price and the interval of `variable_unit` of riding in the pricing plan currency, in which the flat price is reapplied.<br /><br />At least on `rate_segment` or `flat_segment` is required.
+&emsp;&emsp;\-&nbsp;`price` | Required | Float | Flat price charged per interval. Currency is defined by the `currency` field.
+&emsp;&emsp;\-&nbsp;`interval` | Required | Non-Negative Integer | Interval in `variable_unit` at which the price of this segment is charged.
+&emsp;&emsp;\-&nbsp;`start` | Optional | Non-Negative Integer | Number of units that have to elapse before this segment starts applying.<br /><br />If this field is empty, the price issued from this segment is charged immediately upon rental.
+\-&nbsp;`surge_pricing` | Optional | Non-Negative Float | Multiplier that is applied during period of increased demand. If this field is empty, there is no surge pricing.
+
+Example:
+
+```jsonc
+ "variable_price": {
+   "variable_unit": "km",
+   "rate_segments": [
+     {
+       "start": 10,
+       "rate": 1
+     },
+     {
+       "start": 25,
+       "rate": 0.5
+     }
+   ]
+   "flat_segments": [
+     {
+       "start": 25,
+       "price": 3,
+       "interval": 5,
+     }
+   ]
+ }
+```
 
 ### system_alerts.json
 This feed is intended to inform customers about changes to the system that do not fall within the normal system operations. For example, system closures due to weather would be listed here, but a system that only operated for part of the year would have that schedule listed in the system_calendar.json feed.<br />

From a7552c2ffcaebb7a00258c6739d307f1d48251ca Mon Sep 17 00:00:00 2001
From: josee-sabourin <josee@mobilitydata.org>
Date: Tue, 21 Jul 2020 17:37:44 -0400
Subject: [PATCH 02/12] formatting updates

---
 gbfs.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/gbfs.md b/gbfs.md
index 4e2b7f0a..012dc984 100644
--- a/gbfs.md
+++ b/gbfs.md
@@ -567,14 +567,14 @@ Field Name | Required | Type | Defines
 \-&nbsp;`name` | Yes | String | Public name for this region.
 
 ### system_pricing_plans.json
-Describes pricing for the system. <br /><br />Additional proposed extensions supporting zone-dependent pricing, multi-unit pricing and price capping can be found [here](https://docs.google.com/document/d/1xzC0nS3M-ora32k5RbfhFCsfZp4B-wVKK2-pOokpxmQ/edit?usp=sharing).
+Describes pricing for the system. <br /><br />Additional proposed extensions supporting zone-dependent pricing, multi-unit pricing, and price capping can be found [here](https://docs.google.com/document/d/1xzC0nS3M-ora32k5RbfhFCsfZp4B-wVKK2-pOokpxmQ/edit?usp=sharing).
 
 Field Name | Required | Type | Defines
 ---|---|---|---
 `plans` | Yes | Array | Array of objects as defined below.<br /><br /> In the event of colliding plans, the earlier plan (ir order of the JSON file) takes precedence.
 \-&nbsp;`plan_id` | Yes | ID | Identifier for a pricing plan in the system.
-\-&nbsp;`days` | Optional | Array | An array of abbreviations (first 3 letters) of English names of the days of the week when this plan is active. <br /><br /> Valid values are:<br /><br /><ul><li>`mon`</li><li>`tue`</li><li>`wed`</li><li>`thu`</li></li>`fri`</li></li>`sat`</li></li>`sun`</li></li> <br /><br />If this field is empty, the plan does not vary depending on day of the week.
-\-&nbsp;`months` | Optional | Array | An array of abbreviations (first 3 letters) of English names of the months of the year when this plan is active. <br /><br /> Valid values are: <br /><br /><ul><li>`jan`</li><li>`feb`</li><li>`mar`</li><li>`apr`</li><li>`may`</li><li>`jun`</li><li>`jul`</li><li>`aug`</li><li>`sep`</li><li>`oct`</li><li>`nov`</li><li>`dec`<br /><br />If this field is empty, the plan does not vary depending on month.
+\-&nbsp;`days` | Optional | Array | An array of abbreviations (first 3 letters) of English names of the days of the week when this plan is active. <br /><br /> Valid values are:<br /><br /><ul><li>`mon`</li><li>`tue`</li><li>`wed`</li><li>`thu`</li><li>`fri`</li><li>`sat`</li><li>`sun`</li></ul>If this field is empty, the plan does not vary depending on day of the week.
+\-&nbsp;`months` | Optional | Array | An array of abbreviations (first 3 letters) of English names of the months of the year when this plan is active. <br /><br /> Valid values are: <br /><br /><ul><li>`jan`</li><li>`feb`</li><li>`mar`</li><li>`apr`</li><li>`may`</li><li>`jun`</li><li>`jul`</li><li>`aug`</li><li>`sep`</li><li>`oct`</li><li>`nov`</li><li>`dec`</li></ul>If this field is empty, the plan does not vary depending on month.
 \-&nbsp;`start_time` | Conditionally Required | Time | Time of the day when this plan starts being active. <br /><br /> If this field is empty, the plan does not vary depending on time of day.<br /><br />Conditionally Required: Required if `system_pricing_plans.end_time` is provided. Optional otherwise.
 \-&nbsp;`end_time` | Conditionally Required | Time | Time of the day when this plan stops being active. <br /><br /> If this field is empty, the plan does not vary depending on time of day.<br /><br />Conditionally Required: Required if `system_pricing_plans.start_time` is provided. Optional otherwise.
 \-&nbsp;`vehicle_type_id` | Optional | Array | `vehicle_type_id` of the vehicle eligible for this pricing plan as described in [vehicle_types.json](#vehicle_typesjson-added-in-v21-rc).<br /><br />If this field is empty, the plan applies to all vehicle types defined in the dataset.<br /><br />In the case of a vehicle type being attributed to different plans, all plans associated with the vehicle type are valid.   
@@ -585,7 +585,7 @@ Field Name | Required | Type | Defines
 \-&nbsp;`is_taxable` | Yes | Boolean | Will additional tax be added to the base price?<br /><br />`true` - Yes.<br />  `false` - No.  <br /><br />`false` may be used to indicate that tax is not charged or that tax is included in the base price.
 \-&nbsp;`description` | Yes | String | Customer-readable description of the pricing plan. This should include the duration, price, conditions, etc. that the publisher would like users to see.
 \-&nbsp;`variable_price` | Optional | Array | Array of segments when `variable_unit` varies.<br /><br />The total variable price in the unit specified by the currency becomes the sum of prices issued of rate segments and flat segments.<br /><br /> If this array is not provided, there are no variable prices.
-&emsp;\-&nbsp;`variable_unit` | Yes | Enum | Unit of the rate.<br /><br />Valid issues are:<br /><br /><ul><li>`km`</li><li>`min`</li><li>`hour`</li><li>`day`</li><li>`week`<br /><br />Each variable_unit can be used only once in the array `variable_price`.
+&emsp;\-&nbsp;`variable_unit` | Yes | Enum | Unit of the rate.<br /><br />Valid issues are:<br /><br /><ul><li>`km`</li><li>`min`</li><li>`hour`</li><li>`day`</li><li>`week`</li></ul>Each variable_unit can be used only once in the array `variable_price`.
 &emsp;\-&nbsp;`rate_segments` | Conditionally Required | Array | Array of the rate in increasing order. Each `rate_segment` defines one rate per `variable_unit` of riding in the pricing plan currency. The variable price become the sum of `rate_segment` prices. A `rate_segment` price depends on the rate per `variable_unit` elapsed.<br /><br />At least one `rate_segment` or `flat_segment` is required.
 &emsp;&emsp;\-&nbsp;`start` | Optional | Non-Negative Integer | Number of units that have to elapse before this segment starts applying.<br /><br />If this field is empty, the price issued from this segment is charged immediately upon rental.
 &emsp;&emsp;\-&nbsp;`rate` | Yes | Float | Rate that serves to calculate the variable price based on the amount of variable unites. The rate is valid for the segment. Can be a negative number.

From 87853b8171ed32eb19a48f44427f49326808de83 Mon Sep 17 00:00:00 2001
From: Josee Sabourin <66266820+josee-sabourin@users.noreply.github.com>
Date: Fri, 24 Jul 2020 08:08:48 -0400
Subject: [PATCH 03/12] Update gbfs-corepricing

Co-authored-by: Sean Barbeau <sjbarbeau@gmail.com>
---
 gbfs.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/gbfs.md b/gbfs.md
index 012dc984..9e2bca31 100644
--- a/gbfs.md
+++ b/gbfs.md
@@ -575,7 +575,7 @@ Field Name | Required | Type | Defines
 \-&nbsp;`plan_id` | Yes | ID | Identifier for a pricing plan in the system.
 \-&nbsp;`days` | Optional | Array | An array of abbreviations (first 3 letters) of English names of the days of the week when this plan is active. <br /><br /> Valid values are:<br /><br /><ul><li>`mon`</li><li>`tue`</li><li>`wed`</li><li>`thu`</li><li>`fri`</li><li>`sat`</li><li>`sun`</li></ul>If this field is empty, the plan does not vary depending on day of the week.
 \-&nbsp;`months` | Optional | Array | An array of abbreviations (first 3 letters) of English names of the months of the year when this plan is active. <br /><br /> Valid values are: <br /><br /><ul><li>`jan`</li><li>`feb`</li><li>`mar`</li><li>`apr`</li><li>`may`</li><li>`jun`</li><li>`jul`</li><li>`aug`</li><li>`sep`</li><li>`oct`</li><li>`nov`</li><li>`dec`</li></ul>If this field is empty, the plan does not vary depending on month.
-\-&nbsp;`start_time` | Conditionally Required | Time | Time of the day when this plan starts being active. <br /><br /> If this field is empty, the plan does not vary depending on time of day.<br /><br />Conditionally Required: Required if `system_pricing_plans.end_time` is provided. Optional otherwise.
+\-&nbsp;`start_time` | Conditionally Required | Time | Time of the day when this plan starts being active. <br /><br /> If this field is empty, the plan does not vary depending on time of day.<br /><br />Conditionally Required: `start_time` and `end_time` must both be populated, or both be omitted  - feeds cannot contain one field without the other.
 \-&nbsp;`end_time` | Conditionally Required | Time | Time of the day when this plan stops being active. <br /><br /> If this field is empty, the plan does not vary depending on time of day.<br /><br />Conditionally Required: Required if `system_pricing_plans.start_time` is provided. Optional otherwise.
 \-&nbsp;`vehicle_type_id` | Optional | Array | `vehicle_type_id` of the vehicle eligible for this pricing plan as described in [vehicle_types.json](#vehicle_typesjson-added-in-v21-rc).<br /><br />If this field is empty, the plan applies to all vehicle types defined in the dataset.<br /><br />In the case of a vehicle type being attributed to different plans, all plans associated with the vehicle type are valid.   
 \-&nbsp;`url` | Optional | URL | URL where the customer can learn more about this pricing plan.

From 8541633165d13dc4e4b080e90ccc76fec0df1c0f Mon Sep 17 00:00:00 2001
From: Josee Sabourin <66266820+josee-sabourin@users.noreply.github.com>
Date: Fri, 24 Jul 2020 08:09:10 -0400
Subject: [PATCH 04/12] Update gbfs-corepricing

Co-authored-by: Sean Barbeau <sjbarbeau@gmail.com>
---
 gbfs.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/gbfs.md b/gbfs.md
index 9e2bca31..1539472b 100644
--- a/gbfs.md
+++ b/gbfs.md
@@ -576,7 +576,7 @@ Field Name | Required | Type | Defines
 \-&nbsp;`days` | Optional | Array | An array of abbreviations (first 3 letters) of English names of the days of the week when this plan is active. <br /><br /> Valid values are:<br /><br /><ul><li>`mon`</li><li>`tue`</li><li>`wed`</li><li>`thu`</li><li>`fri`</li><li>`sat`</li><li>`sun`</li></ul>If this field is empty, the plan does not vary depending on day of the week.
 \-&nbsp;`months` | Optional | Array | An array of abbreviations (first 3 letters) of English names of the months of the year when this plan is active. <br /><br /> Valid values are: <br /><br /><ul><li>`jan`</li><li>`feb`</li><li>`mar`</li><li>`apr`</li><li>`may`</li><li>`jun`</li><li>`jul`</li><li>`aug`</li><li>`sep`</li><li>`oct`</li><li>`nov`</li><li>`dec`</li></ul>If this field is empty, the plan does not vary depending on month.
 \-&nbsp;`start_time` | Conditionally Required | Time | Time of the day when this plan starts being active. <br /><br /> If this field is empty, the plan does not vary depending on time of day.<br /><br />Conditionally Required: `start_time` and `end_time` must both be populated, or both be omitted  - feeds cannot contain one field without the other.
-\-&nbsp;`end_time` | Conditionally Required | Time | Time of the day when this plan stops being active. <br /><br /> If this field is empty, the plan does not vary depending on time of day.<br /><br />Conditionally Required: Required if `system_pricing_plans.start_time` is provided. Optional otherwise.
+\-&nbsp;`end_time` | Conditionally Required | Time | Time of the day when this plan stops being active. <br /><br /> If this field is empty, the plan does not vary depending on time of day.<br /><br />Conditionally Required: `start_time` and `end_time` must both be populated, or both be omitted  - feeds cannot contain one field without the other.
 \-&nbsp;`vehicle_type_id` | Optional | Array | `vehicle_type_id` of the vehicle eligible for this pricing plan as described in [vehicle_types.json](#vehicle_typesjson-added-in-v21-rc).<br /><br />If this field is empty, the plan applies to all vehicle types defined in the dataset.<br /><br />In the case of a vehicle type being attributed to different plans, all plans associated with the vehicle type are valid.   
 \-&nbsp;`url` | Optional | URL | URL where the customer can learn more about this pricing plan.
 \-&nbsp;`name` | Yes | String | Name of this pricing plan.

From 62538f5fe996d1b9d39b0716d8a222e2fc4888f5 Mon Sep 17 00:00:00 2001
From: josee-sabourin <josee@mobilitydata.org>
Date: Fri, 24 Jul 2020 08:15:32 -0400
Subject: [PATCH 05/12] Update gbfs.md

---
 gbfs.md | 46 +++++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 41 insertions(+), 5 deletions(-)

diff --git a/gbfs.md b/gbfs.md
index 1539472b..e7a6dba6 100644
--- a/gbfs.md
+++ b/gbfs.md
@@ -567,7 +567,7 @@ Field Name | Required | Type | Defines
 \-&nbsp;`name` | Yes | String | Public name for this region.
 
 ### system_pricing_plans.json
-Describes pricing for the system. <br /><br />Additional proposed extensions supporting zone-dependent pricing, multi-unit pricing, and price capping can be found [here](https://docs.google.com/document/d/1xzC0nS3M-ora32k5RbfhFCsfZp4B-wVKK2-pOokpxmQ/edit?usp=sharing).
+Describes pricing for the system.
 
 Field Name | Required | Type | Defines
 ---|---|---|---
@@ -581,21 +581,57 @@ Field Name | Required | Type | Defines
 \-&nbsp;`url` | Optional | URL | URL where the customer can learn more about this pricing plan.
 \-&nbsp;`name` | Yes | String | Name of this pricing plan.
 \-&nbsp;`currency` | Yes | String | Currency used to pay the fare. <br /><br /> This pricing is in ISO 4217 code: http://en.wikipedia.org/wiki/ISO_4217 <br />(e.g. `CAD` for Canadian dollars, `EUR` for euros, or `JPY` for Japanese yen.)
-\-&nbsp;`price` | Yes | Non-negative float OR String | Fare price, in the unit specified by currency. If String, must be in decimal monetary value.<br /><br />In case of non-variable price, this field is the total price. In case of variable price, this field is the base price that is charged only once per trip (e.g., price for unlocking).
+\-&nbsp;`price` | Yes | Non-negative float OR String | Fare price, in the unit specified by currency. If String, must be in decimal monetary value.<br /><br />In case of non-variable price, this field is the total price. In case of variable price, this field is the base price that is charged only once per trip (e.g., price for unlocking). See `variable_price` for details.
 \-&nbsp;`is_taxable` | Yes | Boolean | Will additional tax be added to the base price?<br /><br />`true` - Yes.<br />  `false` - No.  <br /><br />`false` may be used to indicate that tax is not charged or that tax is included in the base price.
 \-&nbsp;`description` | Yes | String | Customer-readable description of the pricing plan. This should include the duration, price, conditions, etc. that the publisher would like users to see.
 \-&nbsp;`variable_price` | Optional | Array | Array of segments when `variable_unit` varies.<br /><br />The total variable price in the unit specified by the currency becomes the sum of prices issued of rate segments and flat segments.<br /><br /> If this array is not provided, there are no variable prices.
 &emsp;\-&nbsp;`variable_unit` | Yes | Enum | Unit of the rate.<br /><br />Valid issues are:<br /><br /><ul><li>`km`</li><li>`min`</li><li>`hour`</li><li>`day`</li><li>`week`</li></ul>Each variable_unit can be used only once in the array `variable_price`.
 &emsp;\-&nbsp;`rate_segments` | Conditionally Required | Array | Array of the rate in increasing order. Each `rate_segment` defines one rate per `variable_unit` of riding in the pricing plan currency. The variable price become the sum of `rate_segment` prices. A `rate_segment` price depends on the rate per `variable_unit` elapsed.<br /><br />At least one `rate_segment` or `flat_segment` is required.
 &emsp;&emsp;\-&nbsp;`start` | Optional | Non-Negative Integer | Number of units that have to elapse before this segment starts applying.<br /><br />If this field is empty, the price issued from this segment is charged immediately upon rental.
-&emsp;&emsp;\-&nbsp;`rate` | Yes | Float | Rate that serves to calculate the variable price based on the amount of variable unites. The rate is valid for the segment. Can be a negative number.
+&emsp;&emsp;\-&nbsp;`rate` | Yes | Float | Rate that serves to calculate the variable price based on the amount of variable unites. The rate is valid for the segment. Can be a negative number, which indicated that the traveller will receive a discount.
 &emsp;\-&nbsp;`flat_segments` | Conditionally Required | Array | Array of flat prices in increasing order. Each segment defines the flat price and the interval of `variable_unit` of riding in the pricing plan currency, in which the flat price is reapplied.<br /><br />At least on `rate_segment` or `flat_segment` is required.
-&emsp;&emsp;\-&nbsp;`price` | Required | Float | Flat price charged per interval. Currency is defined by the `currency` field.
-&emsp;&emsp;\-&nbsp;`interval` | Required | Non-Negative Integer | Interval in `variable_unit` at which the price of this segment is charged.
+&emsp;&emsp;\-&nbsp;`price` | Yes | Float | Flat price charged per interval. Currency is defined by the `currency` field.
+&emsp;&emsp;\-&nbsp;`interval` | Yes | Non-Negative Integer | Interval in `variable_unit` at which the price of this segment is charged.
 &emsp;&emsp;\-&nbsp;`start` | Optional | Non-Negative Integer | Number of units that have to elapse before this segment starts applying.<br /><br />If this field is empty, the price issued from this segment is charged immediately upon rental.
 \-&nbsp;`surge_pricing` | Optional | Non-Negative Float | Multiplier that is applied during period of increased demand. If this field is empty, there is no surge pricing.
 
 Example:
+This example demonstrates a pricing scheme that has a rate both by minute and by km. The user is charged $0.25 per km as well as $0.50 per minute. Both of these rates happen concurrently and are not dependent on one another. 
+```jsonc
+{
+  "plans": {
+    "plan_id": "plan2",
+    "start_time": "7:00:00",
+    "end_time": "9:30:00",
+    "vehicle_type_id": "def",
+    "name": "Rush Hour Rate",
+    "currency": "CAD",
+    "price": 3,
+    "is_taxable": true,
+    "description": "$3 unlock fee, $0.25 per kilometer and $0.50 per minute",
+    "variable_price": [
+      {
+        "variable_unit": "km",
+        "rate_segments": {
+          "start": 0,
+          "rate": 0.25
+        }
+      },
+      {
+        "variable_unit": "minute",
+        "rate_segments": {
+          "start": 0,
+          "rate": 0.5
+        }
+      }
+    ]
+  }
+}
+```
+
+Example:
+
+The user does not pay more than the base price for the first 10 km. After 10 km the user pays $1 per km. After 25 km the user pays $0.50 per km and an additional $3 every 5 km, the extension price, in addition to $0.50 per km. 
 
 ```jsonc
  "variable_price": {

From 649cd2c3bec644aab43160f845873d53cacdc990 Mon Sep 17 00:00:00 2001
From: josee-sabourin <josee@mobilitydata.org>
Date: Fri, 24 Jul 2020 08:27:19 -0400
Subject: [PATCH 06/12] Add float

---
 gbfs.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/gbfs.md b/gbfs.md
index e7a6dba6..cf7f9422 100644
--- a/gbfs.md
+++ b/gbfs.md
@@ -127,6 +127,7 @@ Example: `41.890169` for the Colosseum in Rome.
 Example: `12.492269` for the Colosseum in Rome.
 * Non-negative Integer - An integer greater than or equal to 0.
 * Non-negative Float - A floating point number greater than or equal to 0.
+* Float - A floating point number.
 * Timezone - TZ timezone from the https://www.iana.org/time-zones. Timezone names never contain the space character but may contain an underscore. Refer to http://en.wikipedia.org/wiki/List_of_tz_zones for a list of valid values.
 Example: `Asia/Tokyo`, `America/Los_Angeles` or `Africa/Cairo`.
 * URI *(added in v1.1)* - A fully qualified URI that includes the scheme (e.g., `com.abcrental.android://`), and any special characters in the URI must be correctly escaped. See the following http://www.w3.org/Addressing/URL/4_URI_Recommentations.html for a description of how to create fully qualified URI values. Note that URIs may be URLs.

From 52aa49beb71987d8b7f8433202d9d213c445fc74 Mon Sep 17 00:00:00 2001
From: josee-sabourin <josee@mobilitydata.org>
Date: Tue, 15 Sep 2020 10:59:39 -0400
Subject: [PATCH 07/12] Pricing v2.1

---
 gbfs.md | 114 ++++++++++++++++++++++++++++----------------------------
 1 file changed, 56 insertions(+), 58 deletions(-)

diff --git a/gbfs.md b/gbfs.md
index cf7f9422..a09be019 100644
--- a/gbfs.md
+++ b/gbfs.md
@@ -574,10 +574,6 @@ Field Name | Required | Type | Defines
 ---|---|---|---
 `plans` | Yes | Array | Array of objects as defined below.<br /><br /> In the event of colliding plans, the earlier plan (ir order of the JSON file) takes precedence.
 \-&nbsp;`plan_id` | Yes | ID | Identifier for a pricing plan in the system.
-\-&nbsp;`days` | Optional | Array | An array of abbreviations (first 3 letters) of English names of the days of the week when this plan is active. <br /><br /> Valid values are:<br /><br /><ul><li>`mon`</li><li>`tue`</li><li>`wed`</li><li>`thu`</li><li>`fri`</li><li>`sat`</li><li>`sun`</li></ul>If this field is empty, the plan does not vary depending on day of the week.
-\-&nbsp;`months` | Optional | Array | An array of abbreviations (first 3 letters) of English names of the months of the year when this plan is active. <br /><br /> Valid values are: <br /><br /><ul><li>`jan`</li><li>`feb`</li><li>`mar`</li><li>`apr`</li><li>`may`</li><li>`jun`</li><li>`jul`</li><li>`aug`</li><li>`sep`</li><li>`oct`</li><li>`nov`</li><li>`dec`</li></ul>If this field is empty, the plan does not vary depending on month.
-\-&nbsp;`start_time` | Conditionally Required | Time | Time of the day when this plan starts being active. <br /><br /> If this field is empty, the plan does not vary depending on time of day.<br /><br />Conditionally Required: `start_time` and `end_time` must both be populated, or both be omitted  - feeds cannot contain one field without the other.
-\-&nbsp;`end_time` | Conditionally Required | Time | Time of the day when this plan stops being active. <br /><br /> If this field is empty, the plan does not vary depending on time of day.<br /><br />Conditionally Required: `start_time` and `end_time` must both be populated, or both be omitted  - feeds cannot contain one field without the other.
 \-&nbsp;`vehicle_type_id` | Optional | Array | `vehicle_type_id` of the vehicle eligible for this pricing plan as described in [vehicle_types.json](#vehicle_typesjson-added-in-v21-rc).<br /><br />If this field is empty, the plan applies to all vehicle types defined in the dataset.<br /><br />In the case of a vehicle type being attributed to different plans, all plans associated with the vehicle type are valid.   
 \-&nbsp;`url` | Optional | URL | URL where the customer can learn more about this pricing plan.
 \-&nbsp;`name` | Yes | String | Name of this pricing plan.
@@ -585,78 +581,80 @@ Field Name | Required | Type | Defines
 \-&nbsp;`price` | Yes | Non-negative float OR String | Fare price, in the unit specified by currency. If String, must be in decimal monetary value.<br /><br />In case of non-variable price, this field is the total price. In case of variable price, this field is the base price that is charged only once per trip (e.g., price for unlocking). See `variable_price` for details.
 \-&nbsp;`is_taxable` | Yes | Boolean | Will additional tax be added to the base price?<br /><br />`true` - Yes.<br />  `false` - No.  <br /><br />`false` may be used to indicate that tax is not charged or that tax is included in the base price.
 \-&nbsp;`description` | Yes | String | Customer-readable description of the pricing plan. This should include the duration, price, conditions, etc. that the publisher would like users to see.
-\-&nbsp;`variable_price` | Optional | Array | Array of segments when `variable_unit` varies.<br /><br />The total variable price in the unit specified by the currency becomes the sum of prices issued of rate segments and flat segments.<br /><br /> If this array is not provided, there are no variable prices.
-&emsp;\-&nbsp;`variable_unit` | Yes | Enum | Unit of the rate.<br /><br />Valid issues are:<br /><br /><ul><li>`km`</li><li>`min`</li><li>`hour`</li><li>`day`</li><li>`week`</li></ul>Each variable_unit can be used only once in the array `variable_price`.
-&emsp;\-&nbsp;`rate_segments` | Conditionally Required | Array | Array of the rate in increasing order. Each `rate_segment` defines one rate per `variable_unit` of riding in the pricing plan currency. The variable price become the sum of `rate_segment` prices. A `rate_segment` price depends on the rate per `variable_unit` elapsed.<br /><br />At least one `rate_segment` or `flat_segment` is required.
-&emsp;&emsp;\-&nbsp;`start` | Optional | Non-Negative Integer | Number of units that have to elapse before this segment starts applying.<br /><br />If this field is empty, the price issued from this segment is charged immediately upon rental.
-&emsp;&emsp;\-&nbsp;`rate` | Yes | Float | Rate that serves to calculate the variable price based on the amount of variable unites. The rate is valid for the segment. Can be a negative number, which indicated that the traveller will receive a discount.
-&emsp;\-&nbsp;`flat_segments` | Conditionally Required | Array | Array of flat prices in increasing order. Each segment defines the flat price and the interval of `variable_unit` of riding in the pricing plan currency, in which the flat price is reapplied.<br /><br />At least on `rate_segment` or `flat_segment` is required.
-&emsp;&emsp;\-&nbsp;`price` | Yes | Float | Flat price charged per interval. Currency is defined by the `currency` field.
-&emsp;&emsp;\-&nbsp;`interval` | Yes | Non-Negative Integer | Interval in `variable_unit` at which the price of this segment is charged.
-&emsp;&emsp;\-&nbsp;`start` | Optional | Non-Negative Integer | Number of units that have to elapse before this segment starts applying.<br /><br />If this field is empty, the price issued from this segment is charged immediately upon rental.
-\-&nbsp;`surge_pricing` | Optional | Non-Negative Float | Multiplier that is applied during period of increased demand. If this field is empty, there is no surge pricing.
+\-&nbsp;`per_km_pricing` | Optional | Array | Array of segments when the price is a function of distance travelled, displayed in kilometers.<br /><br />If this array is not provided, there are no variable prices based on distance.
+&emsp;&emsp;\-&nbsp;`start` | Yes | Non-Negative Integer | Number of kilometers that have to elapse before this segment starts applying.
+&emsp;&emsp;\-&nbsp;`rate` | Yes | Float | Rate that is charged after the `start`. Can be a negative number, which indicates that the traveller will receive a discount.
+&emsp;&emsp;\-&nbsp;`interval` | Yes | Non-Negative Integer | Interval in kilometers at which the `rate` of this segment is reapplied indefinitely, unless defined by `end`.<br /><br />An interval of 0 indicates the rate is only charged once.
+&emsp;&emsp;\-&nbsp; `end` | Optional | Non-Negative Integer | Number of kilometers that have to elapse after this segment has started before this segment stops applying.<br /><br /> If this field is empty, the price issued form this segment is charged until the trip ends, in addition to following segments.
+\-&nbsp;`per_min_pricing` | Optional | Array | Array of segments when the price is a function of time travelled, displayed in minutes.<br /><br />If this array is not provided, there are no variable prices based on time.
+&emsp;&emsp;\-&nbsp;`start` | Yes | Non-Negative Integer | Number of minutes that have to elapse before this segment starts applying.
+&emsp;&emsp;\-&nbsp;`rate` | Yes | Float | Rate that is charged after the `start`. Can be a negative number, which indicates that the traveller will receive a discount.
+&emsp;&emsp;\-&nbsp;`interval` | Yes | Non-Negative Integer | Interval in minutes at which the `rate` of this segment is reapplied indefinitely, unless defined by `end`.<br /><br />An interval of 0 indicates the rate is only charged once.
+&emsp;&emsp;\-&nbsp; `end` | Yes | Non-Negative Integer | Number of minutes that have to elapse after this segment has started, before this segment stops applying.<br /><br />If this field is empty, the price issued from this segment is charged until the trip ends, in addition to following segments. 
+\-&nbsp;`surge_pricing` | Optional | Boolean | Is there currently an increase in price in response to increased demand in this pricing plan? If this field is empty, it means these is no surge pricing in effect.<br /><br />`true` - Surge pricing is in effect.<br />  `false` - Surge pricing is not in effect. 
+
 
 Example:
-This example demonstrates a pricing scheme that has a rate both by minute and by km. The user is charged $0.25 per km as well as $0.50 per minute. Both of these rates happen concurrently and are not dependent on one another. 
+
+The user does not pay more than the base price for the first 10 km. After 10 km the user pays $1 per km. After 25 km the user pays $0.50 per km and an additional $3 every 5 km, the extension price, in addition to $0.50 per km. 
+
 ```jsonc
 {
   "plans": {
     "plan_id": "plan2",
-    "start_time": "7:00:00",
-    "end_time": "9:30:00",
-    "vehicle_type_id": "def",
-    "name": "Rush Hour Rate",
-    "currency": "CAD",
-    "price": 3,
-    "is_taxable": true,
-    "description": "$3 unlock fee, $0.25 per kilometer and $0.50 per minute",
-    "variable_price": [
+    "vehicle_type_id": "bike1",
+    "name": "One-Way",
+    "currency": "USD",
+    "price": 2,
+    "is_taxable": false,
+    "description": "Includes 10km, overage fees apply after 10km.",
+    "per_km_pricing": [
       {
-        "variable_unit": "km",
-        "rate_segments": {
-          "start": 0,
-          "rate": 0.25
-        }
+        "start": 10,
+        "rate": 1,
+        "interval": 1,
+        "end": 25
+      }, 
+      {
+        "start": 25,
+        "rate": 0.5,
+        "interval": 1
       },
       {
-        "variable_unit": "minute",
-        "rate_segments": {
-          "start": 0,
-          "rate": 0.5
-        }
+        "start": 25,
+        "rate": 3,
+        "interval": 5
       }
     ]
   }
 }
 ```
-
 Example:
 
-The user does not pay more than the base price for the first 10 km. After 10 km the user pays $1 per km. After 25 km the user pays $0.50 per km and an additional $3 every 5 km, the extension price, in addition to $0.50 per km. 
-
+This example demonstrates a pricing scheme that has a rate both by minute and by km. The user is charged $0.25 per km as well as $0.50 per minute. Both of these rates happen concurrently and are not dependent on one another. 
 ```jsonc
- "variable_price": {
-   "variable_unit": "km",
-   "rate_segments": [
-     {
-       "start": 10,
-       "rate": 1
-     },
-     {
-       "start": 25,
-       "rate": 0.5
-     }
-   ]
-   "flat_segments": [
-     {
-       "start": 25,
-       "price": 3,
-       "interval": 5,
-     }
-   ]
- }
+{
+  "plans": {
+    "plan_id": "plan3",
+    "vehicle_type_id": "scooter1",
+    "name": "Simple Rate",
+    "currency": "CAD",
+    "price": 3,
+    "is_taxable": true,
+    "description": "$3 unlock fee, $0.25 per kilometer and 0.50 per minute.",
+    "per_km_pricing": {
+      "start": 0,
+      "rate": 0.25,
+      "interval": 1,
+    },
+    "per_min_pricing": {
+      "start": 0,
+      "rate": 0.50,
+      "interval": 1
+    }
+  }
+}
 ```
-
 ### system_alerts.json
 This feed is intended to inform customers about changes to the system that do not fall within the normal system operations. For example, system closures due to weather would be listed here, but a system that only operated for part of the year would have that schedule listed in the system_calendar.json feed.<br />
 Obsolete alerts should be removed so the client application can safely present to the end user everything present in the feed.

From 3ccda0532089bd3f9596d488def734dd637eea63 Mon Sep 17 00:00:00 2001
From: josee-sabourin <josee@mobilitydata.org>
Date: Mon, 28 Sep 2020 10:14:58 -0400
Subject: [PATCH 08/12] Reflect @kanagy's suggested changes

---
 gbfs.md | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/gbfs.md b/gbfs.md
index a09be019..05a58dfb 100644
--- a/gbfs.md
+++ b/gbfs.md
@@ -572,25 +572,25 @@ Describes pricing for the system.
 
 Field Name | Required | Type | Defines
 ---|---|---|---
-`plans` | Yes | Array | Array of objects as defined below.<br /><br /> In the event of colliding plans, the earlier plan (ir order of the JSON file) takes precedence.
+`plans` | Yes | Array | Array of objects as defined below.
 \-&nbsp;`plan_id` | Yes | ID | Identifier for a pricing plan in the system.
 \-&nbsp;`vehicle_type_id` | Optional | Array | `vehicle_type_id` of the vehicle eligible for this pricing plan as described in [vehicle_types.json](#vehicle_typesjson-added-in-v21-rc).<br /><br />If this field is empty, the plan applies to all vehicle types defined in the dataset.<br /><br />In the case of a vehicle type being attributed to different plans, all plans associated with the vehicle type are valid.   
 \-&nbsp;`url` | Optional | URL | URL where the customer can learn more about this pricing plan.
 \-&nbsp;`name` | Yes | String | Name of this pricing plan.
 \-&nbsp;`currency` | Yes | String | Currency used to pay the fare. <br /><br /> This pricing is in ISO 4217 code: http://en.wikipedia.org/wiki/ISO_4217 <br />(e.g. `CAD` for Canadian dollars, `EUR` for euros, or `JPY` for Japanese yen.)
-\-&nbsp;`price` | Yes | Non-negative float OR String | Fare price, in the unit specified by currency. If String, must be in decimal monetary value.<br /><br />In case of non-variable price, this field is the total price. In case of variable price, this field is the base price that is charged only once per trip (e.g., price for unlocking). See `variable_price` for details.
+\-&nbsp;`price` | Yes | Non-negative float OR String | Fare price, in the unit specified by currency. If String, must be in decimal monetary value.<br /><br />In case of non-rate price, this field is the total price. In case of rate price, this field is the base price that is charged only once per trip (e.g., price for unlocking) in addition to `per_km_pricing` and/or `per_min_pricing`.
 \-&nbsp;`is_taxable` | Yes | Boolean | Will additional tax be added to the base price?<br /><br />`true` - Yes.<br />  `false` - No.  <br /><br />`false` may be used to indicate that tax is not charged or that tax is included in the base price.
 \-&nbsp;`description` | Yes | String | Customer-readable description of the pricing plan. This should include the duration, price, conditions, etc. that the publisher would like users to see.
-\-&nbsp;`per_km_pricing` | Optional | Array | Array of segments when the price is a function of distance travelled, displayed in kilometers.<br /><br />If this array is not provided, there are no variable prices based on distance.
+\-&nbsp;`per_km_pricing` | Optional | Array | Array of segments when the price is a function of distance travelled, displayed in kilometers.<br /><br />Total price is the addition of `price` and all segments in `per_km_pricing` and `per_min_pricing`. If this array is not provided, there are no variable prices based on distance.
 &emsp;&emsp;\-&nbsp;`start` | Yes | Non-Negative Integer | Number of kilometers that have to elapse before this segment starts applying.
-&emsp;&emsp;\-&nbsp;`rate` | Yes | Float | Rate that is charged after the `start`. Can be a negative number, which indicates that the traveller will receive a discount.
-&emsp;&emsp;\-&nbsp;`interval` | Yes | Non-Negative Integer | Interval in kilometers at which the `rate` of this segment is reapplied indefinitely, unless defined by `end`.<br /><br />An interval of 0 indicates the rate is only charged once.
-&emsp;&emsp;\-&nbsp; `end` | Optional | Non-Negative Integer | Number of kilometers that have to elapse after this segment has started before this segment stops applying.<br /><br /> If this field is empty, the price issued form this segment is charged until the trip ends, in addition to following segments.
-\-&nbsp;`per_min_pricing` | Optional | Array | Array of segments when the price is a function of time travelled, displayed in minutes.<br /><br />If this array is not provided, there are no variable prices based on time.
+&emsp;&emsp;\-&nbsp;`rate` | Yes | Float | Rate that is charged for each kilometer `interval` after the `start`. Can be a negative number, which indicates that the traveller will receive a discount.
+&emsp;&emsp;\-&nbsp;`interval` | Yes | Non-Negative Integer | Interval in kilometers at which the `rate` of this segment is either reapplied indefinitely, or if defined, up until (but not including) `end` kilometer.<br /><br />An interval of 0 indicates the rate is only charged once.
+&emsp;&emsp;\-&nbsp; `end` | Optional | Non-Negative Integer | The kilometer at which the rate will no longer apply.<br /><br /> If this field is empty, the price issued for this segment is charged until the trip ends, in addition to following segments.
+\-&nbsp;`per_min_pricing` | Optional | Array | Array of segments when the price is a function of time travelled, displayed in minutes.<br /><br />Total price is the addition of `price` and all segments in `per_km_pricing` and `per_min_pricing`. If this array is not provided, there are no variable prices based on time.
 &emsp;&emsp;\-&nbsp;`start` | Yes | Non-Negative Integer | Number of minutes that have to elapse before this segment starts applying.
-&emsp;&emsp;\-&nbsp;`rate` | Yes | Float | Rate that is charged after the `start`. Can be a negative number, which indicates that the traveller will receive a discount.
-&emsp;&emsp;\-&nbsp;`interval` | Yes | Non-Negative Integer | Interval in minutes at which the `rate` of this segment is reapplied indefinitely, unless defined by `end`.<br /><br />An interval of 0 indicates the rate is only charged once.
-&emsp;&emsp;\-&nbsp; `end` | Yes | Non-Negative Integer | Number of minutes that have to elapse after this segment has started, before this segment stops applying.<br /><br />If this field is empty, the price issued from this segment is charged until the trip ends, in addition to following segments. 
+&emsp;&emsp;\-&nbsp;`rate` | Yes | Float | Rate that is charged for each minute `interval` after the `start`. Can be a negative number, which indicates that the traveller will receive a discount.
+&emsp;&emsp;\-&nbsp;`interval` | Yes | Non-Negative Integer | Interval in minutes at which the `rate` of this segment is either reapplied indefinitely, or if defined, up until (but not including) `end` minute.<br /><br />An interval of 0 indicates the rate is only charged once.
+&emsp;&emsp;\-&nbsp; `end` | Yes | Non-Negative Integer | The minute at which the rate will no longer apply.<br /><br />If this field is empty, the price issued for this segment is charged until the trip ends, in addition to following segments. 
 \-&nbsp;`surge_pricing` | Optional | Boolean | Is there currently an increase in price in response to increased demand in this pricing plan? If this field is empty, it means these is no surge pricing in effect.<br /><br />`true` - Surge pricing is in effect.<br />  `false` - Surge pricing is not in effect. 
 
 

From 50a194c65a89897bb4ea6437ccf0858d83834e50 Mon Sep 17 00:00:00 2001
From: josee-sabourin <josee@mobilitydata.org>
Date: Mon, 28 Sep 2020 14:12:17 -0400
Subject: [PATCH 09/12] reflect changes from #261 and #216

---
 gbfs.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/gbfs.md b/gbfs.md
index 05a58dfb..1cf6394b 100644
--- a/gbfs.md
+++ b/gbfs.md
@@ -469,6 +469,7 @@ Field Name | Required | Type | Defines
 \- `vehicle_type_id` <br/>*(added in v2.1-RC)* | Conditionally Required | ID | The vehicle_type_id of this vehicle as described in [vehicle_types.json](#vehicle_typesjson-added-in-v21-rc). This field is required if the [vehicle_types.json](#vehicle_typesjson-added-in-v21-rc) is defined.
 \- `last_reported` <br/>*(added in v2.1-RC)* | Optional | Timestamp | The last time this vehicle reported its status to the operator's backend.
 \- `current_range_meters` <br/>*(added in v2.1-RC)* | Conditionally Required | Non-negative float | If the corresponding vehicle_type definition for this vehicle has a motor, then this field is required. This value represents the furthest distance in meters that the vehicle can travel without recharging or refueling with the vehicle's current charge or fuel.
+\- `pricing_plan_id` | Optional | ID | The `plan_id` of the pricing plan this vehicle is eligible for as described in [system_pricing_plans.json](#system_pricing_plans.json). 
 
 Example:
 
@@ -574,21 +575,20 @@ Field Name | Required | Type | Defines
 ---|---|---|---
 `plans` | Yes | Array | Array of objects as defined below.
 \-&nbsp;`plan_id` | Yes | ID | Identifier for a pricing plan in the system.
-\-&nbsp;`vehicle_type_id` | Optional | Array | `vehicle_type_id` of the vehicle eligible for this pricing plan as described in [vehicle_types.json](#vehicle_typesjson-added-in-v21-rc).<br /><br />If this field is empty, the plan applies to all vehicle types defined in the dataset.<br /><br />In the case of a vehicle type being attributed to different plans, all plans associated with the vehicle type are valid.   
 \-&nbsp;`url` | Optional | URL | URL where the customer can learn more about this pricing plan.
 \-&nbsp;`name` | Yes | String | Name of this pricing plan.
 \-&nbsp;`currency` | Yes | String | Currency used to pay the fare. <br /><br /> This pricing is in ISO 4217 code: http://en.wikipedia.org/wiki/ISO_4217 <br />(e.g. `CAD` for Canadian dollars, `EUR` for euros, or `JPY` for Japanese yen.)
-\-&nbsp;`price` | Yes | Non-negative float OR String | Fare price, in the unit specified by currency. If String, must be in decimal monetary value.<br /><br />In case of non-rate price, this field is the total price. In case of rate price, this field is the base price that is charged only once per trip (e.g., price for unlocking) in addition to `per_km_pricing` and/or `per_min_pricing`.
+\-&nbsp;`price` | Yes | String | Fare price, in the unit specified by currency. Must be in decimal monetary value.<br /><br />In case of non-rate price, this field is the total price. In case of rate price, this field is the base price that is charged only once per trip (e.g., price for unlocking) in addition to `per_km_pricing` and/or `per_min_pricing`.
 \-&nbsp;`is_taxable` | Yes | Boolean | Will additional tax be added to the base price?<br /><br />`true` - Yes.<br />  `false` - No.  <br /><br />`false` may be used to indicate that tax is not charged or that tax is included in the base price.
 \-&nbsp;`description` | Yes | String | Customer-readable description of the pricing plan. This should include the duration, price, conditions, etc. that the publisher would like users to see.
 \-&nbsp;`per_km_pricing` | Optional | Array | Array of segments when the price is a function of distance travelled, displayed in kilometers.<br /><br />Total price is the addition of `price` and all segments in `per_km_pricing` and `per_min_pricing`. If this array is not provided, there are no variable prices based on distance.
 &emsp;&emsp;\-&nbsp;`start` | Yes | Non-Negative Integer | Number of kilometers that have to elapse before this segment starts applying.
-&emsp;&emsp;\-&nbsp;`rate` | Yes | Float | Rate that is charged for each kilometer `interval` after the `start`. Can be a negative number, which indicates that the traveller will receive a discount.
+&emsp;&emsp;\-&nbsp;`rate` | Yes | String | Rate that is charged for each kilometer `interval` after the `start`. Must be in decimal monetary value. Can be a negative number, which indicates that the traveller will receive a discount.
 &emsp;&emsp;\-&nbsp;`interval` | Yes | Non-Negative Integer | Interval in kilometers at which the `rate` of this segment is either reapplied indefinitely, or if defined, up until (but not including) `end` kilometer.<br /><br />An interval of 0 indicates the rate is only charged once.
 &emsp;&emsp;\-&nbsp; `end` | Optional | Non-Negative Integer | The kilometer at which the rate will no longer apply.<br /><br /> If this field is empty, the price issued for this segment is charged until the trip ends, in addition to following segments.
 \-&nbsp;`per_min_pricing` | Optional | Array | Array of segments when the price is a function of time travelled, displayed in minutes.<br /><br />Total price is the addition of `price` and all segments in `per_km_pricing` and `per_min_pricing`. If this array is not provided, there are no variable prices based on time.
 &emsp;&emsp;\-&nbsp;`start` | Yes | Non-Negative Integer | Number of minutes that have to elapse before this segment starts applying.
-&emsp;&emsp;\-&nbsp;`rate` | Yes | Float | Rate that is charged for each minute `interval` after the `start`. Can be a negative number, which indicates that the traveller will receive a discount.
+&emsp;&emsp;\-&nbsp;`rate` | Yes | String | Rate that is charged for each minute `interval` after the `start`. Must be in decimal monetary value. Can be a negative number, which indicates that the traveller will receive a discount.
 &emsp;&emsp;\-&nbsp;`interval` | Yes | Non-Negative Integer | Interval in minutes at which the `rate` of this segment is either reapplied indefinitely, or if defined, up until (but not including) `end` minute.<br /><br />An interval of 0 indicates the rate is only charged once.
 &emsp;&emsp;\-&nbsp; `end` | Yes | Non-Negative Integer | The minute at which the rate will no longer apply.<br /><br />If this field is empty, the price issued for this segment is charged until the trip ends, in addition to following segments. 
 \-&nbsp;`surge_pricing` | Optional | Boolean | Is there currently an increase in price in response to increased demand in this pricing plan? If this field is empty, it means these is no surge pricing in effect.<br /><br />`true` - Surge pricing is in effect.<br />  `false` - Surge pricing is not in effect. 

From 672e3207c7e2f0e7df8203f940f74cc8eb763fbf Mon Sep 17 00:00:00 2001
From: josee-sabourin <josee@mobilitydata.org>
Date: Tue, 29 Sep 2020 14:45:28 -0400
Subject: [PATCH 10/12] Update gbfs.md

---
 gbfs.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/gbfs.md b/gbfs.md
index 1cf6394b..669f1f75 100644
--- a/gbfs.md
+++ b/gbfs.md
@@ -126,8 +126,8 @@ Example: `41.890169` for the Colosseum in Rome.
 * Longitude - WGS84 longitude in decimal degrees. The value must be greater than or equal to -180.0 and less than or equal to 180.0.
 Example: `12.492269` for the Colosseum in Rome.
 * Non-negative Integer - An integer greater than or equal to 0.
-* Non-negative Float - A floating point number greater than or equal to 0.
-* Float - A floating point number.
+* Non-negative Float - A 32-bit floating point number greater than or equal to 0.
+* Float - A 32-bit floating point number.
 * Timezone - TZ timezone from the https://www.iana.org/time-zones. Timezone names never contain the space character but may contain an underscore. Refer to http://en.wikipedia.org/wiki/List_of_tz_zones for a list of valid values.
 Example: `Asia/Tokyo`, `America/Los_Angeles` or `Africa/Cairo`.
 * URI *(added in v1.1)* - A fully qualified URI that includes the scheme (e.g., `com.abcrental.android://`), and any special characters in the URI must be correctly escaped. See the following http://www.w3.org/Addressing/URL/4_URI_Recommentations.html for a description of how to create fully qualified URI values. Note that URIs may be URLs.
@@ -578,17 +578,17 @@ Field Name | Required | Type | Defines
 \-&nbsp;`url` | Optional | URL | URL where the customer can learn more about this pricing plan.
 \-&nbsp;`name` | Yes | String | Name of this pricing plan.
 \-&nbsp;`currency` | Yes | String | Currency used to pay the fare. <br /><br /> This pricing is in ISO 4217 code: http://en.wikipedia.org/wiki/ISO_4217 <br />(e.g. `CAD` for Canadian dollars, `EUR` for euros, or `JPY` for Japanese yen.)
-\-&nbsp;`price` | Yes | String | Fare price, in the unit specified by currency. Must be in decimal monetary value.<br /><br />In case of non-rate price, this field is the total price. In case of rate price, this field is the base price that is charged only once per trip (e.g., price for unlocking) in addition to `per_km_pricing` and/or `per_min_pricing`.
+\-&nbsp;`price` | Yes | Non-Negative float OR String | Fare price, in the unit specified by currency. If string must be in decimal monetary value. Note: v3.0 will only allow non-negative float, therefore future implementations must be non-negative float.<br /><br />In case of non-rate price, this field is the total price. In case of rate price, this field is the base price that is charged only once per trip (e.g., price for unlocking) in addition to `per_km_pricing` and/or `per_min_pricing`.
 \-&nbsp;`is_taxable` | Yes | Boolean | Will additional tax be added to the base price?<br /><br />`true` - Yes.<br />  `false` - No.  <br /><br />`false` may be used to indicate that tax is not charged or that tax is included in the base price.
 \-&nbsp;`description` | Yes | String | Customer-readable description of the pricing plan. This should include the duration, price, conditions, etc. that the publisher would like users to see.
 \-&nbsp;`per_km_pricing` | Optional | Array | Array of segments when the price is a function of distance travelled, displayed in kilometers.<br /><br />Total price is the addition of `price` and all segments in `per_km_pricing` and `per_min_pricing`. If this array is not provided, there are no variable prices based on distance.
 &emsp;&emsp;\-&nbsp;`start` | Yes | Non-Negative Integer | Number of kilometers that have to elapse before this segment starts applying.
-&emsp;&emsp;\-&nbsp;`rate` | Yes | String | Rate that is charged for each kilometer `interval` after the `start`. Must be in decimal monetary value. Can be a negative number, which indicates that the traveller will receive a discount.
+&emsp;&emsp;\-&nbsp;`rate` | Yes | Float | Rate that is charged for each kilometer `interval` after the `start`. Can be a negative number, which indicates that the traveller will receive a discount.
 &emsp;&emsp;\-&nbsp;`interval` | Yes | Non-Negative Integer | Interval in kilometers at which the `rate` of this segment is either reapplied indefinitely, or if defined, up until (but not including) `end` kilometer.<br /><br />An interval of 0 indicates the rate is only charged once.
 &emsp;&emsp;\-&nbsp; `end` | Optional | Non-Negative Integer | The kilometer at which the rate will no longer apply.<br /><br /> If this field is empty, the price issued for this segment is charged until the trip ends, in addition to following segments.
 \-&nbsp;`per_min_pricing` | Optional | Array | Array of segments when the price is a function of time travelled, displayed in minutes.<br /><br />Total price is the addition of `price` and all segments in `per_km_pricing` and `per_min_pricing`. If this array is not provided, there are no variable prices based on time.
 &emsp;&emsp;\-&nbsp;`start` | Yes | Non-Negative Integer | Number of minutes that have to elapse before this segment starts applying.
-&emsp;&emsp;\-&nbsp;`rate` | Yes | String | Rate that is charged for each minute `interval` after the `start`. Must be in decimal monetary value. Can be a negative number, which indicates that the traveller will receive a discount.
+&emsp;&emsp;\-&nbsp;`rate` | Yes | Float | Rate that is charged for each minute `interval` after the `start`. Can be a negative number, which indicates that the traveller will receive a discount.
 &emsp;&emsp;\-&nbsp;`interval` | Yes | Non-Negative Integer | Interval in minutes at which the `rate` of this segment is either reapplied indefinitely, or if defined, up until (but not including) `end` minute.<br /><br />An interval of 0 indicates the rate is only charged once.
 &emsp;&emsp;\-&nbsp; `end` | Yes | Non-Negative Integer | The minute at which the rate will no longer apply.<br /><br />If this field is empty, the price issued for this segment is charged until the trip ends, in addition to following segments. 
 \-&nbsp;`surge_pricing` | Optional | Boolean | Is there currently an increase in price in response to increased demand in this pricing plan? If this field is empty, it means these is no surge pricing in effect.<br /><br />`true` - Surge pricing is in effect.<br />  `false` - Surge pricing is not in effect. 

From ebea2c4e0c3a33203a804cfd785950f0c9806aa9 Mon Sep 17 00:00:00 2001
From: Josee Sabourin <66266820+josee-sabourin@users.noreply.github.com>
Date: Wed, 14 Oct 2020 16:18:52 -0400
Subject: [PATCH 11/12] Fixed some typos and mistakes

---
 gbfs.md | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/gbfs.md b/gbfs.md
index 669f1f75..ed24d58d 100644
--- a/gbfs.md
+++ b/gbfs.md
@@ -578,7 +578,7 @@ Field Name | Required | Type | Defines
 \-&nbsp;`url` | Optional | URL | URL where the customer can learn more about this pricing plan.
 \-&nbsp;`name` | Yes | String | Name of this pricing plan.
 \-&nbsp;`currency` | Yes | String | Currency used to pay the fare. <br /><br /> This pricing is in ISO 4217 code: http://en.wikipedia.org/wiki/ISO_4217 <br />(e.g. `CAD` for Canadian dollars, `EUR` for euros, or `JPY` for Japanese yen.)
-\-&nbsp;`price` | Yes | Non-Negative float OR String | Fare price, in the unit specified by currency. If string must be in decimal monetary value. Note: v3.0 will only allow non-negative float, therefore future implementations must be non-negative float.<br /><br />In case of non-rate price, this field is the total price. In case of rate price, this field is the base price that is charged only once per trip (e.g., price for unlocking) in addition to `per_km_pricing` and/or `per_min_pricing`.
+\-&nbsp;`price` | Yes | Non-Negative float OR String | Fare price, in the unit specified by currency. If string, must be in decimal monetary value. Note: v3.0 will only allow non-negative float, therefore future implementations must be non-negative float.<br /><br />In case of non-rate price, this field is the total price. In case of rate price, this field is the base price that is charged only once per trip (e.g., price for unlocking) in addition to `per_km_pricing` and/or `per_min_pricing`.
 \-&nbsp;`is_taxable` | Yes | Boolean | Will additional tax be added to the base price?<br /><br />`true` - Yes.<br />  `false` - No.  <br /><br />`false` may be used to indicate that tax is not charged or that tax is included in the base price.
 \-&nbsp;`description` | Yes | String | Customer-readable description of the pricing plan. This should include the duration, price, conditions, etc. that the publisher would like users to see.
 \-&nbsp;`per_km_pricing` | Optional | Array | Array of segments when the price is a function of distance travelled, displayed in kilometers.<br /><br />Total price is the addition of `price` and all segments in `per_km_pricing` and `per_min_pricing`. If this array is not provided, there are no variable prices based on distance.
@@ -590,7 +590,7 @@ Field Name | Required | Type | Defines
 &emsp;&emsp;\-&nbsp;`start` | Yes | Non-Negative Integer | Number of minutes that have to elapse before this segment starts applying.
 &emsp;&emsp;\-&nbsp;`rate` | Yes | Float | Rate that is charged for each minute `interval` after the `start`. Can be a negative number, which indicates that the traveller will receive a discount.
 &emsp;&emsp;\-&nbsp;`interval` | Yes | Non-Negative Integer | Interval in minutes at which the `rate` of this segment is either reapplied indefinitely, or if defined, up until (but not including) `end` minute.<br /><br />An interval of 0 indicates the rate is only charged once.
-&emsp;&emsp;\-&nbsp; `end` | Yes | Non-Negative Integer | The minute at which the rate will no longer apply.<br /><br />If this field is empty, the price issued for this segment is charged until the trip ends, in addition to following segments. 
+&emsp;&emsp;\-&nbsp; `end` | Optional | Non-Negative Integer | The minute at which the rate will no longer apply.<br /><br />If this field is empty, the price issued for this segment is charged until the trip ends, in addition to following segments. 
 \-&nbsp;`surge_pricing` | Optional | Boolean | Is there currently an increase in price in response to increased demand in this pricing plan? If this field is empty, it means these is no surge pricing in effect.<br /><br />`true` - Surge pricing is in effect.<br />  `false` - Surge pricing is not in effect. 
 
 
@@ -602,7 +602,6 @@ The user does not pay more than the base price for the first 10 km. After 10 km
 {
   "plans": {
     "plan_id": "plan2",
-    "vehicle_type_id": "bike1",
     "name": "One-Way",
     "currency": "USD",
     "price": 2,
@@ -636,7 +635,6 @@ This example demonstrates a pricing scheme that has a rate both by minute and by
 {
   "plans": {
     "plan_id": "plan3",
-    "vehicle_type_id": "scooter1",
     "name": "Simple Rate",
     "currency": "CAD",
     "price": 3,

From 8404726cb68ec93ef76c23c3eaead444013bb160 Mon Sep 17 00:00:00 2001
From: Sean Barbeau <sjbarbeau@gmail.com>
Date: Wed, 14 Oct 2020 16:46:31 -0400
Subject: [PATCH 12/12] Add version labels, change v3.0 "will"->"may", fix
 array

---
 gbfs.md | 47 ++++++++++++++++++++++++-----------------------
 1 file changed, 24 insertions(+), 23 deletions(-)

diff --git a/gbfs.md b/gbfs.md
index ed24d58d..51f32737 100644
--- a/gbfs.md
+++ b/gbfs.md
@@ -127,7 +127,7 @@ Example: `41.890169` for the Colosseum in Rome.
 Example: `12.492269` for the Colosseum in Rome.
 * Non-negative Integer - An integer greater than or equal to 0.
 * Non-negative Float - A 32-bit floating point number greater than or equal to 0.
-* Float - A 32-bit floating point number.
+* Float *(added in v2.1-RC2)* - A 32-bit floating point number.
 * Timezone - TZ timezone from the https://www.iana.org/time-zones. Timezone names never contain the space character but may contain an underscore. Refer to http://en.wikipedia.org/wiki/List_of_tz_zones for a list of valid values.
 Example: `Asia/Tokyo`, `America/Los_Angeles` or `Africa/Cairo`.
 * URI *(added in v1.1)* - A fully qualified URI that includes the scheme (e.g., `com.abcrental.android://`), and any special characters in the URI must be correctly escaped. See the following http://www.w3.org/Addressing/URL/4_URI_Recommentations.html for a description of how to create fully qualified URI values. Note that URIs may be URLs.
@@ -469,7 +469,7 @@ Field Name | Required | Type | Defines
 \- `vehicle_type_id` <br/>*(added in v2.1-RC)* | Conditionally Required | ID | The vehicle_type_id of this vehicle as described in [vehicle_types.json](#vehicle_typesjson-added-in-v21-rc). This field is required if the [vehicle_types.json](#vehicle_typesjson-added-in-v21-rc) is defined.
 \- `last_reported` <br/>*(added in v2.1-RC)* | Optional | Timestamp | The last time this vehicle reported its status to the operator's backend.
 \- `current_range_meters` <br/>*(added in v2.1-RC)* | Conditionally Required | Non-negative float | If the corresponding vehicle_type definition for this vehicle has a motor, then this field is required. This value represents the furthest distance in meters that the vehicle can travel without recharging or refueling with the vehicle's current charge or fuel.
-\- `pricing_plan_id` | Optional | ID | The `plan_id` of the pricing plan this vehicle is eligible for as described in [system_pricing_plans.json](#system_pricing_plans.json). 
+\- `pricing_plan_id` <br/>*(added in v2.1-RC2)* | Optional | ID | The `plan_id` of the pricing plan this vehicle is eligible for as described in [system_pricing_plans.json](#system_pricing_plans.json). 
 
 Example:
 
@@ -578,23 +578,24 @@ Field Name | Required | Type | Defines
 \-&nbsp;`url` | Optional | URL | URL where the customer can learn more about this pricing plan.
 \-&nbsp;`name` | Yes | String | Name of this pricing plan.
 \-&nbsp;`currency` | Yes | String | Currency used to pay the fare. <br /><br /> This pricing is in ISO 4217 code: http://en.wikipedia.org/wiki/ISO_4217 <br />(e.g. `CAD` for Canadian dollars, `EUR` for euros, or `JPY` for Japanese yen.)
-\-&nbsp;`price` | Yes | Non-Negative float OR String | Fare price, in the unit specified by currency. If string, must be in decimal monetary value. Note: v3.0 will only allow non-negative float, therefore future implementations must be non-negative float.<br /><br />In case of non-rate price, this field is the total price. In case of rate price, this field is the base price that is charged only once per trip (e.g., price for unlocking) in addition to `per_km_pricing` and/or `per_min_pricing`.
+\-&nbsp;`price` | Yes | Non-Negative float OR String | Fare price, in the unit specified by currency. If string, must be in decimal monetary value. <br/>*(added in v2.1-RC2)* Note: v3.0 may only allow non-negative float, therefore future implementations should be non-negative float.<br /><br />In case of non-rate price, this field is the total price. In case of rate price, this field is the base price that is charged only once per trip (e.g., price for unlocking) in addition to `per_km_pricing` and/or `per_min_pricing`.
 \-&nbsp;`is_taxable` | Yes | Boolean | Will additional tax be added to the base price?<br /><br />`true` - Yes.<br />  `false` - No.  <br /><br />`false` may be used to indicate that tax is not charged or that tax is included in the base price.
 \-&nbsp;`description` | Yes | String | Customer-readable description of the pricing plan. This should include the duration, price, conditions, etc. that the publisher would like users to see.
-\-&nbsp;`per_km_pricing` | Optional | Array | Array of segments when the price is a function of distance travelled, displayed in kilometers.<br /><br />Total price is the addition of `price` and all segments in `per_km_pricing` and `per_min_pricing`. If this array is not provided, there are no variable prices based on distance.
-&emsp;&emsp;\-&nbsp;`start` | Yes | Non-Negative Integer | Number of kilometers that have to elapse before this segment starts applying.
-&emsp;&emsp;\-&nbsp;`rate` | Yes | Float | Rate that is charged for each kilometer `interval` after the `start`. Can be a negative number, which indicates that the traveller will receive a discount.
-&emsp;&emsp;\-&nbsp;`interval` | Yes | Non-Negative Integer | Interval in kilometers at which the `rate` of this segment is either reapplied indefinitely, or if defined, up until (but not including) `end` kilometer.<br /><br />An interval of 0 indicates the rate is only charged once.
-&emsp;&emsp;\-&nbsp; `end` | Optional | Non-Negative Integer | The kilometer at which the rate will no longer apply.<br /><br /> If this field is empty, the price issued for this segment is charged until the trip ends, in addition to following segments.
-\-&nbsp;`per_min_pricing` | Optional | Array | Array of segments when the price is a function of time travelled, displayed in minutes.<br /><br />Total price is the addition of `price` and all segments in `per_km_pricing` and `per_min_pricing`. If this array is not provided, there are no variable prices based on time.
-&emsp;&emsp;\-&nbsp;`start` | Yes | Non-Negative Integer | Number of minutes that have to elapse before this segment starts applying.
-&emsp;&emsp;\-&nbsp;`rate` | Yes | Float | Rate that is charged for each minute `interval` after the `start`. Can be a negative number, which indicates that the traveller will receive a discount.
-&emsp;&emsp;\-&nbsp;`interval` | Yes | Non-Negative Integer | Interval in minutes at which the `rate` of this segment is either reapplied indefinitely, or if defined, up until (but not including) `end` minute.<br /><br />An interval of 0 indicates the rate is only charged once.
-&emsp;&emsp;\-&nbsp; `end` | Optional | Non-Negative Integer | The minute at which the rate will no longer apply.<br /><br />If this field is empty, the price issued for this segment is charged until the trip ends, in addition to following segments. 
-\-&nbsp;`surge_pricing` | Optional | Boolean | Is there currently an increase in price in response to increased demand in this pricing plan? If this field is empty, it means these is no surge pricing in effect.<br /><br />`true` - Surge pricing is in effect.<br />  `false` - Surge pricing is not in effect. 
-
-
-Example:
+\-&nbsp;`per_km_pricing` <br/>*(added in v2.1-RC2)* | Optional | Array | Array of segments when the price is a function of distance travelled, displayed in kilometers.<br /><br />Total price is the addition of `price` and all segments in `per_km_pricing` and `per_min_pricing`. If this array is not provided, there are no variable prices based on distance.
+&emsp;&emsp;\-&nbsp;`start` <br/>*(added in v2.1-RC2)* | Yes | Non-Negative Integer | Number of kilometers that have to elapse before this segment starts applying.
+&emsp;&emsp;\-&nbsp;`rate` <br/>*(added in v2.1-RC2)* | Yes | Float | Rate that is charged for each kilometer `interval` after the `start`. Can be a negative number, which indicates that the traveller will receive a discount.
+&emsp;&emsp;\-&nbsp;`interval` <br/>*(added in v2.1-RC2)* | Yes | Non-Negative Integer | Interval in kilometers at which the `rate` of this segment is either reapplied indefinitely, or if defined, up until (but not including) `end` kilometer.<br /><br />An interval of 0 indicates the rate is only charged once.
+&emsp;&emsp;\-&nbsp; `end` <br/>*(added in v2.1-RC2)* | Optional | Non-Negative Integer | The kilometer at which the rate will no longer apply.<br /><br /> If this field is empty, the price issued for this segment is charged until the trip ends, in addition to following segments.
+\-&nbsp;`per_min_pricing` <br/>*(added in v2.1-RC2)* | Optional | Array | Array of segments when the price is a function of time travelled, displayed in minutes.<br /><br />Total price is the addition of `price` and all segments in `per_km_pricing` and `per_min_pricing`. If this array is not provided, there are no variable prices based on time.
+&emsp;&emsp;\-&nbsp;`start` <br/>*(added in v2.1-RC2)* | Yes | Non-Negative Integer | Number of minutes that have to elapse before this segment starts applying.
+&emsp;&emsp;\-&nbsp;`rate` <br/>*(added in v2.1-RC2)* | Yes | Float | Rate that is charged for each minute `interval` after the `start`. Can be a negative number, which indicates that the traveller will receive a discount.
+&emsp;&emsp;\-&nbsp;`interval` <br/>*(added in v2.1-RC2)* | Yes | Non-Negative Integer | Interval in minutes at which the `rate` of this segment is either reapplied indefinitely, or if defined, up until (but not including) `end` minute.<br /><br />An interval of 0 indicates the rate is only charged once.
+&emsp;&emsp;\-&nbsp; `end` <br/>*(added in v2.1-RC2)* | Optional | Non-Negative Integer | The minute at which the rate will no longer apply.<br /><br />If this field is empty, the price issued for this segment is charged until the trip ends, in addition to following segments. 
+\-&nbsp;`surge_pricing` <br/>*(added in v2.1-RC2)* | Optional | Boolean | Is there currently an increase in price in response to increased demand in this pricing plan? If this field is empty, it means these is no surge pricing in effect.<br /><br />`true` - Surge pricing is in effect.<br />  `false` - Surge pricing is not in effect. 
+
+### Examples *(added in v2.1-RC2)*
+
+#### Example 1: 
 
 The user does not pay more than the base price for the first 10 km. After 10 km the user pays $1 per km. After 25 km the user pays $0.50 per km and an additional $3 every 5 km, the extension price, in addition to $0.50 per km. 
 
@@ -628,7 +629,7 @@ The user does not pay more than the base price for the first 10 km. After 10 km
   }
 }
 ```
-Example:
+#### Example 2:
 
 This example demonstrates a pricing scheme that has a rate both by minute and by km. The user is charged $0.25 per km as well as $0.50 per minute. Both of these rates happen concurrently and are not dependent on one another. 
 ```jsonc
@@ -640,16 +641,16 @@ This example demonstrates a pricing scheme that has a rate both by minute and by
     "price": 3,
     "is_taxable": true,
     "description": "$3 unlock fee, $0.25 per kilometer and 0.50 per minute.",
-    "per_km_pricing": {
+    "per_km_pricing": [{
       "start": 0,
       "rate": 0.25,
-      "interval": 1,
-    },
-    "per_min_pricing": {
+      "interval": 1
+    }],
+    "per_min_pricing": [{
       "start": 0,
       "rate": 0.50,
       "interval": 1
-    }
+    }]
   }
 }
 ```