Merge pull request #934 from RideReport/dev

Conditionally Require Fields in MDS Stops Endpoint Related to Station Based Program/SLA Metrics

Author: schnuerle

data-types.md

@@ -182,10 +182,10 @@ Stops describe vehicle trip start and end locations in a pre-designated physical
 | `post_code`              | String                                                | Optional | Postal code (e.g. `10036`) |
 | `rental_methods`         | [Enum[]][gbfs-station-info]                           | Optional | List of payment methods accepted at stop, see [GBFS Rental Methods][gbfs-station-info] |
 | `cross_street`           | String                                                | Optional | Cross street of where the station is located. |
-| `num_places_available`   | {vehicle_type: number}                                | Optional | How many places are free to be populated with vehicles at this stop? |
-| `num_places_disabled`    | {vehicle_type: number}                                | Optional | How many places are disabled and unable to accept vehicles at this stop? |
+| `num_places_available`   | {vehicle_type: number}                                | Conditionally Required | How many places are free to be populated with vehicles at this stop? Required if the program has station based availability requirements or service level agreements pertaining to stations.|
+| `num_places_disabled`    | {vehicle_type: number}                                | Conditionally Required | How many places are disabled and unable to accept vehicles at this stop? Required if the program has station based availability requirements or service level agreements pertaining to stations.|
 | `parent_stop`            | UUID                                                  | Optional | Describe a basic hierarchy of stops (e.g.a stop inside of a greater stop) |
-| `devices`                | UUID[]                                                | Optional | List of device_ids for vehicles which are currently at this stop |
+| `devices`                | UUID[]                                                | Conditionally Required | List of device_ids for vehicles which are currently at this stop. Required if the program has station based availability requirements or service level agreements pertaining to stations. |
 | `image_url`              | URL                                                   | Optional | Link to an image, photo, or diagram of the stop. Could be used by providers to help riders find or use the stop. |
 
 [Top][toc]