Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Use RFC3339 for Timestamp #522

Merged
merged 4 commits into from
Nov 2, 2023
Merged

Use RFC3339 for Timestamp #522

Changes from 2 commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
c9c325c
Use RFC3339 for Timestamp
leonardehrenfried Jul 17, 2023
2cbc94d
Remove timezone restriction, update examples
leonardehrenfried Jul 19, 2023
3489296
Use correct offset for 'end' properties
leonardehrenfried Jul 19, 2023
5a92b6b
As of v3.0-RC2
richfab Nov 2, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
66 changes: 33 additions & 33 deletions gbfs.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -221,7 +221,7 @@ Example: The `rental_methods` field contains values `creditcard`, `paypass`, etc
* Phone Number *as of v3.0-RC* - Phone number in [E.164](https://www.itu.int/rec/T-REC-E.164-201011-I/en) format. The phone number MUST start with a "+". The characters following the "+" MUST be integers and MUST NOT contain any hyphens, spaces or parentheses.
* String - Can only contain text. Strings MUST NOT contain any formatting codes (including HTML) other than newlines.
* Time - Service time in the HH:MM:SS format for the time zone indicated in `system_information.json` (00:00:00 - 47:59:59). Time can stretch up to one additional day in the future to accommodate situations where, for example, a system was open from 11:30pm - 11pm the next day (23:30:00-47:00:00).
* Timestamp - Timestamp fields MUST be represented as integers in POSIX time (representing the number of seconds since January 1st 1970 00:00:00 UTC).
* Timestamp - Timestamp fields MUST be represented as strings in [RFC3339 format](https://www.rfc-editor.org/rfc/rfc3339), for example `2023-07-17T13:34:13+02:00`.
richfab marked this conversation as resolved.
Show resolved Hide resolved
* 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 https://en.wikipedia.org/wiki/List_of_tz_zones for a list of valid values.
Example: `Asia/Tokyo`, `America/Los_Angeles` or `Africa/Cairo`.
* URI - A fully qualified URI that includes the scheme (for example, `com.example.android://`). Any special characters in the URI MUST be correctly escaped. See the following https://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.
Expand Down Expand Up @@ -254,7 +254,7 @@ Field Name | REQUIRED | Type | Defines

```json
{
"last_updated": 1640887163,
"last_updated": "2023-07-17T13:34:13+02:00",
"ttl": 3600,
"version": "3.0-RC",
"data": {
Expand All @@ -280,7 +280,7 @@ Field Name | REQUIRED | Type | Defines

```json
{
"last_updated": 1640887163,
"last_updated": "2023-07-17T13:34:13+02:00",
"ttl": 0,
"version": "3.0-RC",
"data": {
Expand Down Expand Up @@ -316,7 +316,7 @@ Field Name | REQUIRED | Type | Defines
**Example:**
```json
{
"last_updated":1667004473,
"last_updated": "2023-07-17T13:34:13+02:00",
"ttl":0,
"version":"3.0-RC",
"data":{
Expand Down Expand Up @@ -367,7 +367,7 @@ Field Name | REQUIRED | Type | Defines

```json
{
"last_updated": 1640887163,
"last_updated": "2023-07-17T13:34:13+02:00",
"ttl": 0,
"version": "3.0-RC",
"data": {
Expand Down Expand Up @@ -431,7 +431,7 @@ Field Name | REQUIRED | Type | Defines

```json
{
"last_updated": 1640887163,
"last_updated": "2023-07-17T13:34:13+02:00",
"ttl": 1800,
"version": "3.0-RC",
"data": {
Expand Down Expand Up @@ -543,7 +543,7 @@ Field Name | REQUIRED | Type | Defines

```json
{
"last_updated": 1640887163,
"last_updated": "2023-07-17T13:34:13+02:00",
"ttl": 0,
"version": "3.0-RC",
"data": {
Expand Down Expand Up @@ -726,7 +726,7 @@ Field Name | REQUIRED | Type | Defines

```json
{
"last_updated": 1640887163,
"last_updated": "2023-07-17T13:34:13+02:00",
"ttl": 0,
"version": "3.0-RC",
"data": {
Expand Down Expand Up @@ -766,7 +766,7 @@ Field Name | REQUIRED | Type | Defines

```json
{
"last_updated": 1640887163,
"last_updated": "2023-07-17T13:34:13+02:00",
"ttl": 0,
"version": "3.0-RC",
"data": {
Expand Down Expand Up @@ -857,7 +857,7 @@ Field Name | REQUIRED | Type | Defines

```json
{
"last_updated": 1640887163,
"last_updated": "2023-07-17T13:34:13+02:00",
"ttl": 0,
"version": "3.0-RC",
"data": {
Expand All @@ -867,7 +867,7 @@ Field Name | REQUIRED | Type | Defines
"is_installed": true,
"is_renting": true,
"is_returning": true,
"last_reported": 1609866125,
"last_reported": "2023-07-17T13:34:13+02:00",
"num_docks_available": 3,
"num_docks_disabled" : 1,
"vehicle_docks_available": [
Expand Down Expand Up @@ -898,7 +898,7 @@ Field Name | REQUIRED | Type | Defines
"is_installed": true,
"is_renting": true,
"is_returning": true,
"last_reported": 1609866106,
"last_reported": "2023-07-17T13:34:13+02:00",
"num_docks_available": 8,
"num_docks_disabled" : 1,
"vehicle_docks_available": [
Expand Down Expand Up @@ -960,14 +960,14 @@ Field Name | REQUIRED | Type | Defines

```json
{
"last_updated":1640887163,
"last_updated": "2023-07-17T13:34:13+02:00",
"ttl":0,
"version":"3.0-RC",
"data":{
"vehicles":[
{
"vehicle_id":"973a5c94-c288-4a2b-afa6-de8aeb6ae2e5",
"last_reported":1609866109,
"last_reported": "2023-07-17T13:34:13+02:00",
"lat":12.345678,
"lon":56.789012,
"is_reserved":false,
Expand All @@ -980,7 +980,7 @@ Field Name | REQUIRED | Type | Defines
},
{
"vehicle_id":"987fd100-b822-4347-86a4-b3eef8ca8b53",
"last_reported":1609866204,
"last_reported": "2023-07-17T13:34:13+02:00",
"is_reserved":false,
"is_disabled":false,
"vehicle_type_id":"def456",
Expand All @@ -998,14 +998,14 @@ Field Name | REQUIRED | Type | Defines
```json

{
"last_updated": 1640887163,
"last_updated": "2023-07-17T13:34:13+02:00",
"ttl":0,
"version":"3.0-RC",
"data":{
"vehicles":[
{
"vehicle_id":"45bd3fb7-a2d5-4def-9de1-c645844ba962",
"last_reported":1609866109,
"last_reported": "2023-07-17T13:34:13+02:00",
"lat":12.345678,
"lon":56.789012,
"is_reserved":false,
Expand All @@ -1021,7 +1021,7 @@ Field Name | REQUIRED | Type | Defines
},
{
"vehicle_id":"d4521def-7922-4e46-8e1d-8ac397239bd0",
"last_reported":1609866204,
"last_reported": "2023-07-17T13:34:13+02:00",
"is_reserved":false,
"is_disabled":false,
"vehicle_type_id":"def456",
Expand Down Expand Up @@ -1061,7 +1061,7 @@ Field Name | REQUIRED | Type | Defines

```json
{
"last_updated": 1640887163,
"last_updated": "2023-07-17T13:34:13+02:00",
"ttl": 86400,
"version": "3.0-RC",
"data": {
Expand Down Expand Up @@ -1141,7 +1141,7 @@ The user does not pay more than the base price for the first 10 km. After 10 km

```json
{
"last_updated": 1640887163,
"last_updated": "2023-07-17T13:34:13+02:00",
"ttl": 0,
"version": "3.0-RC",
"data": {
Expand Down Expand Up @@ -1194,7 +1194,7 @@ This example demonstrates a pricing scheme that has a rate both by minute and by

```json
{
"last_updated": 1640887163,
"last_updated": "2023-07-17T13:34:13+02:00",
"ttl": 0,
"version": "3.0-RC",
"data": {
Expand Down Expand Up @@ -1260,7 +1260,7 @@ Field Name | REQUIRED | Type | Defines

```json
{
"last_updated": 1604519393,
"last_updated": "2023-07-17T13:34:13+02:00",
"ttl": 60,
"version": "3.0-RC",
"data": {
Expand All @@ -1275,8 +1275,8 @@ Field Name | REQUIRED | Type | Defines
],
"times": [
{
"start": 1604448000,
"end": 1604674800
"start": "2023-07-17T13:34:13+02:00",
"end": "2023-07-18T13:34:13Z"
leonardehrenfried marked this conversation as resolved.
Show resolved Hide resolved
}
],
"url": [
Expand All @@ -1297,7 +1297,7 @@ Field Name | REQUIRED | Type | Defines
"language": "en"
}
],
"last_updated": 1604198100
"last_updated": "2023-07-17T13:34:13+02:00",
}
]
}
Expand Down Expand Up @@ -1357,7 +1357,7 @@ See examples below.

```json
{
"last_updated": 1640887163,
"last_updated": "2023-07-17T13:34:13+02:00",
"ttl": 60,
"version": "3.0-RC",
"data": {
Expand Down Expand Up @@ -1426,8 +1426,8 @@ See examples below.
"language": "en"
}
],
"start": 1593878400,
"end": 1593907260,
"start": "2023-07-17T13:34:13+02:00",
"end": "2024-07-17T13:34:13Z",
leonardehrenfried marked this conversation as resolved.
Show resolved Hide resolved
"rules": [
{
"vehicle_type_id": [
Expand Down Expand Up @@ -1643,7 +1643,7 @@ Other supported parameters include:

```json
{
"last_updated": 1640887163,
"last_updated": "2023-07-17T13:34:13+02:00",
"ttl": 60,
"version": "3.0-RC",
"data": {
Expand All @@ -1667,7 +1667,7 @@ Other supported parameters include:

```json
{
"last_updated": 1640887163,
"last_updated": "2023-07-17T13:34:13+02:00",
"ttl": 60,
"version": "3.0-RC",
"data": {
Expand Down Expand Up @@ -1695,7 +1695,7 @@ Note that the Android URI and iOS Universal Link URLs do not necessarily use the

```json
{
"last_updated": 1572447999,
"last_updated": "2023-07-17T13:34:13+02:00",
"ttl": 60,
"version": "3.0-RC",
"data": {
Expand All @@ -1721,7 +1721,7 @@ Note that the Android URI and iOS Universal Link URLs do not necessarily use the

```json
{
"last_updated": 1609866247,
"last_updated": "2023-07-17T13:34:13+02:00",
"ttl": 60,
"version": "3.0-RC",
"data": {
Expand All @@ -1747,7 +1747,7 @@ Note that the Android URI and iOS Universal Link URLs do not necessarily use the

```json
{
"last_updated": 1609866247,
"last_updated": "2023-07-17T13:34:13+02:00",
"ttl": 60,
"version": "3.0-RC",
"data": {
Expand Down