You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Change boolean values from 1/0 to true/false (#196)
Breaking change -- v2.0-RC
* Change boolean values from 1/0 to true/false
As per discussion on Issue #10#10
adding new field definition: boolean values to be JSON booleans, not strings
* Add "Beta (v2.0-RC)" note
…before "Boolean values must be JSON booleans"…
@@ -102,7 +101,7 @@ This section defines terms that are used throughout this document.
102
101
103
102
* Array - A JSON element consisting of an ordered sequence of zero or more values.
104
103
* Object - A JSON element consisting of key-value pairs (fields).
105
-
* Boolean - One of two possible values, 1= true and 0= false. Boolean values must be JSON booleans, not strings (i.e. true or false, not "true" or "false")
104
+
* Boolean - One of two possible values, `1`=true and `0`=false. *Beta (v2.0-RC): Boolean values must be JSON booleans, not strings (i.e. true or false, not `"true"` or `"false"`).
106
105
* Date - Service day in the YYYY-MM-DD format. Example: `2019-09-13` for September 13th, 2019.
* Enum (Enumerable values) - An option from a set of predefined constants in the "Defines" column.
@@ -256,8 +255,6 @@ The following fields are all attributes within the main "data" object for this f
256
255
| - `store_uri`*(beta)*| Conditionally Required | URI | URI where the rental iOS app can be downloaded from. Typically this will be a URI to an app store such as the Apple App Store. If the URI points to an app store such as the Apple App Store, the URI should follow iOS best practices so the viewing app can directly open the URI to the native app store app instead of a website. <br><br>If a `rental_uris`.`ios` field is populated then this field is required, otherwise it is optional. <br><br>See the [Analytics](#Analytics) section for how viewing apps can report the origin of the deep link to rental apps. <br><br>Example value: `https://apps.apple.com/app/apple-store/id123456789`|
257
256
| - `discovery_uri`*(beta)*| Conditionally Required | URI | URI that can be used to discover if the rental iOS app is installed on the device (e.g., using [`UIApplication canOpenURL:`](https://developer.apple.com/documentation/uikit/uiapplication/1622952-canopenurl?language=objc)). This intent is used by viewing apps prioritize rental apps for a particular user based on whether they already have a particular rental app installed. <br><br>This field is required if a `rental_uris`.`ios` field is populated, otherwise it is optional. <br><br>Example value: `com.abcrental.ios://`|
258
257
259
-
260
-
261
258
### station_information.json
262
259
All stations included in station_information.json are considered public (e.g., can be shown on a map for public use). If there are private stations (such as Capital Bikeshare’s White House station), these should not be included here.
263
260
@@ -291,8 +288,8 @@ Describes the capacity and rental availability of a station.
291
288
|\- `num_docks_available`| Yes<br/>*(beta v2.0-RC)* Conditionally required | Non-negative integer |*Current version:* Number of docks accepting bike returns. <br/>*Beta v2.0-RC:* Required except for stations that have unlimited docking capacity (e.g. virtual stations). Number of functional docks physically at the station. To know if the docks are accepting bike returns, see `is_returning`. |
292
289
|\- `num_docks_disabled`| Optional | Non-negative integer | Number of empty but disabled dock points at the station. |
293
290
|\- `is_installed`| Yes | Boolean | Is the station currently on the street? <br /><br />`1` - Station is installed on the street.<br />`0` - Station is not installed on the street. |
294
-
|\- `is_renting`| Yes | Boolean | Is the station currently renting bikes? <br /><br />`1` - Station is renting bikes.<br /> `0` - Station is not renting bikes.<br /><br /> Even if the station is empty, if it is set to allow rentals this value should be 1. |
295
-
|\- `is_returning`| Yes | Boolean | Is the station accepting bike returns? <br /><br />`1` - Station is accepting bike returns.<br /> `0` - Station is not accepting bike returns.<br /><br /> If a station is full but would allow a return if it was not full, then this value should be 1. |
291
+
|\- `is_renting`| Yes | Boolean | Is the station currently renting bikes? <br /><br />`1` - Station is renting bikes.Even if the station is empty, if it is set to allow rentals this value should be 1.<br /> `0` - Station is not renting bikes. |
292
+
|\- `is_returning`| Yes | Boolean | Is the station accepting bike returns? <br /><br />`1` - Station is accepting bike returns.If a station is full but would allow a return if it was not full, then this value should be 1.<br /> `0` - Station is not accepting bike returns. |
296
293
|\- `last_reported`| Yes | Timestamp | The last time this station reported its status. |
\- `is_disabled` | Yes | Boolean | Is the bike currently disabled (broken)? <br /><br /> `1` - Bike is currently disabled. <br /> `0` - Bike is not currently disabled.
309
306
\- `rental_uris`*(beta)* | Optional | Object | JSON object that contains rental URIs for Android, iOS, and web in the android, ios, and web fields. See [examples](#Examples) of how to use these fields and [supported analytics](#Analytics).
310
307
 \- `android` *(beta)* | Optional | URI | URI that can be passed to an Android app with an android.intent.action.VIEW Android intent to support Android Deep Links (https://developer.android.com/training/app-links/deep-linking). Please use Android App Links (https://developer.android.com/training/app-links) if possible so viewing apps don’t need to manually manage the redirect of the user to the app store if the user doesn’t have the application installed. <br><br>This URI should be a deep link specific to this bike, and should not be a general rental page that includes information for more than one bike. The deep link should take users directly to this bike, without any prompts, interstitial pages, or logins. Make sure that users can see this bike even if they never previously opened the application. <br><br>If this field is empty, it means deep linking isn’t supported in the native Android rental app. <br><br>Note that URIs do not necessarily include the bike_id for this bike - other identifiers can be used by the rental app within the URI to uniquely identify this bike. <br><br>See the [Analytics](#Analytics) section for how viewing apps can report the origin of the deep link to rental apps. <br><br>Android App Links example value: `https://www.abc.com/app?sid=1234567890&platform=android` <br><br>Deep Link (without App Links) example value: `com.abcrental.android://open.abc.app/app?sid=1234567890`
311
-
 \- ios *(beta)* | Optional | URI | URI that can be used on iOS to launch the rental app for this bike. More information on this iOS feature can be found here: https://developer.apple.com/documentation/uikit/core_app/allowing_apps_and_websites_to_link_to_your_content/communicating_with_other_apps_using_custom_urls?language=objc. Please use iOS Universal Links (https://developer.apple.com/ios/universal-links/) if possible so viewing apps don’t need to manually manage the redirect of the user to the app store if the user doesn’t have the application installed. <br><br>This URI should be a deep link specific to this bike, and should not be a general rental page that includes information for more than one bike. The deep link should take users directly to this bike, without any prompts, interstitial pages, or logins. Make sure that users can see this bike even if they never previously opened the application. <br><br>If this field is empty, it means deep linking isn’t supported in the native iOS rental app. <br><br>Note that the URI does not necessarily include the bike_id - other identifiers can be used by the rental app within the URL to uniquely identify this bike. <br><br>See the [Analytics](#Analytics) section for how viewing apps can report the origin of the deep link to rental apps. <br><br>iOS Universal Links example value: `https://www.abc.com/app?sid=1234567890&platform=ios` <br><br>Deep Link (without Universal Links) example value: `com.abcrental.ios://open.abc.app/app?sid=1234567890`
308
+
 \- ios *(beta)* | Optional | URI | URI that can be used on iOS to launch the rental app for this bike. More information on this iOS feature can be found here: https://developer.apple.com/documentation/uikit/core_app/allowing_apps_and_websites_to_link_to_your_content/communicating_with_other_apps_using_custom_urls?language=objc. Please use iOS Universal Links (https://developer.apple.com/ios/universal-links/) if possible so viewing apps don’t need to manually manage the redirect of the user to the app store if the user doesn’t have the application installed. <br><br>This URI should be a deep link specific to this bike, and should not be a general rental page that includes information for more than one bike. The deep link should take users directly to this bike, without any prompts, interstitial pages, or logins. Make sure that users can see this bike even if they never previously opened the application. <br><br>If this field is empty, it means deep linking isn’t supported in the native iOS rental app. <br><br>Note that the URI does not necessarily include the bike_id - other identifiers can be used by the rental app within the URL to uniquely identify this bike. <br><br>See the [Analytics](#Analytics) section for how viewing apps can report the origin of the deep link to rental apps. <br><br>iOS Universal Links example value: `https://www.abc.com/app?sid=1234567890&platform=ios` <br><br>Deep Link (without Universal Links) example value: `com.abcrental.ios://open.abc.app/app?sid=1234567890`
312
309
 \- `web`*(beta)* | Optional | URL | URL that can be used by a web browser to show more information about renting a vehicle at this bike. <br><br>This URL should be a deep link specific to this bike, and should not be a general rental page that includes information for more than one bike. The deep link should take users directly to this bike, without any prompts, interstitial pages, or logins. Make sure that users can see this bike even if they never previously opened the application. <br><br>If this field is empty, it means deep linking isn’t supported for web browsers. <br><br>Example value: https://www.abc.com/app?sid=1234567890
313
310
314
311
### system_hours.json
@@ -394,7 +391,6 @@ _`plans`_ | Yes | Array | Array of objects as d
394
391
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 />
395
392
Obsolete alerts should be removed so the client application can safely present to the end user everything present in the feed.
0 commit comments