documento generato automaticamente
Descrizione globale: Descrive la capacità e la disponibilità di noleggio della stazione secondo lo standard GBFS 2.2.
versione: 0.0.1
[*] Se non c'è un tipo in un attributo è perché potrebbe avere diversi tipi o diversi formati/modelli.
-
data[object]
: Array che contiene un oggetto per ogni stazione, come definito di seguito. -
id[*]
: Identificatore univoco dell'entità -
last_updated[integer]
: Ultima volta che i dati del feed sono stati aggiornati in tempo POSIX. -
ttl[integer]
: Numero di secondi prima che i dati del feed vengano nuovamente aggiornati (0 se i dati devono essere sempre aggiornati). -
type[string]
: Tipo di entità NGSI. Deve essere station_status -
version[string]
: Numero di versione di GBFS a cui il feed è conforme, secondo il framework di versioning (aggiunto nella v1.1).
Proprietà richieste
data
id
last_updated
ttl
type
version
Mappatura dello standard GBFS 2.2
Ordinati in ordine alfabetico (clicca per i dettagli)
full yaml details
station_status:
description: Describes the capacity and rental availability of the station According to the Standard GBFS 2.2
properties:
data:
description: Array that contains one object per station as defined below.
properties:
stations:
items:
properties:
is_installed:
description: 'Is the station currently on the street?'
type: boolean
is_renting:
description: 'Is the station currently renting vehicles?'
type: boolean
is_returning:
description: 'Is the station accepting vehicle returns?'
type: boolean
last_reported:
description: The last time this station reported its status to the operator's backend in POSIX time.
minimum: 1450155600
type: number
num_bikes_available:
description: Number of vehicles of any type physically available for rental at the station.
minimum: 0
type: number
num_bikes_disabled:
description: Number of disabled vehicles of any type at the station.
minimum: 0
type: number
num_docks_available:
description: Number of functional docks physically at the station.
minimum: 0
type: number
num_docks_disabled:
description: Number of empty but disabled docks at the station.
minimum: 0
type: number
station_id:
description: Identifier of a station.
type: string
vehicle_docks_available:
dependencies:
vehicle_docks_available:
- vehicle_type_ids
- count
description: Object displaying available docks by vehicle type (added in v2.1-RC).
items:
properties:
count:
description: A number representing the total number of available docks for the defined vehicle type (added in v2.1-RC).
minimum: 0
type: number
vehicle_type_ids:
description: An array of strings where each string represents a vehicle_type_id that is able to use a particular type of dock at the station (added in v2.1-RC).
items:
type: string
type: array
type: object
type: array
vehicles:
description: Array of objects containing data about a specific vehicle that is present at the docking station (added in v2.1-RC).
items:
properties:
bike_id:
description: Rotated identifier of a vehicle (added in v2.1-RC).
type: string
current_range_meters:
description: The furthest distance in meters that the vehicle can travel without recharging or refueling with the vehicle's current charge or fuel (added in v2.1-RC).
minimum: 0
type: number
is_disabled:
description: 'Is the vehicle currently disabled (broken)? (added in v2.1-RC)'
type: boolean
is_reserved:
description: 'Is the vehicle currently reserved for someone else? (added in v2.1-RC)'
type: boolean
vehicle_type_id:
description: The vehicle_type_id of this vehicle as described in vehicle_types.json (added in v2.1-RC).
type: string
type: object
required:
- bike_id
- is_reserved
- is_disabled
- vehicle_type_id
type: array
vehicles_types_available:
description: Array of objects displaying the total number of each vehicle type at the station (added in v2.1-RC).
items:
properties:
count:
description: A number representing the total amount of this vehicle type at the station (added in v2.1-RC).
minimum: 0
type: number
vehicle_type_id:
description: The vehicle_type_id of vehicle at the station (added in v2.1-RC).
type: string
type: object
type: array
type: object
required:
- station_id
- num_bikes_available
- is_installed
- is_renting
- is_returning
- last_reported
type: array
required:
- stations
type: object
x-ngsi:
type: Property
id:
anyOf:
- description: Identifier format of any NGSI entity
maxLength: 256
minLength: 1
pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$
type: string
x-ngsi:
type: Property
- description: Identifier format of any NGSI entity
format: uri
type: string
x-ngsi:
type: Property
description: Unique identifier of the entity
x-ngsi:
type: Property
last_updated:
description: Last time the data in the feed was updated in POSIX time.
minimum: 1450155600
type: integer
x-ngsi:
type: Property
ttl:
description: Number of seconds before the data in the feed will be updated again (0 if the data should always be refreshed).
minimum: 0
type: integer
x-ngsi:
type: Property
type:
description: NGSI entity type. It has to be station_status
enum:
- station_status
type: string
x-ngsi:
type: Property
version:
description: 'GBFS version number to which the feed conforms, according to the versioning framework (added in v1.1).'
enum:
- 2.1-RC2
- 2.1
- 2.2
- 3.0
type: string
x-ngsi:
type: Property
required:
- data
- id
- last_updated
- ttl
- type
- version
type: object
x-derived-from: https://github.com/NABSA/gbfs/blob/v2.2/gbfs.md
x-disclaimer: 'Redistribution and use in source and binary forms, with or without modification, are permitted provided that the license conditions are met. Copyleft (c) 2022 Contributors to Smart Data Models Program'
x-license-url: https://github.com/smart-data-models/dataModel.GBFS/blob/master/station_status/LICENSE.md
x-model-schema: https://smart-data-models.github.io/dataModel.GBFS/station_status/schema.json
x-model-tags: GBFS
x-version: 0.0.1
Ecco un esempio di station_status in formato JSON-LD come valori-chiave. Questo è compatibile con NGSI-v2 quando si usa options=keyValues
e restituisce i dati di contesto di una singola entità.
show/hide example
{
"id": "urn:ngsi-ld:station_status:id:FNNO:60592292",
"type": "station_status",
"last_updated": 1609866247,
"ttl": 0,
"version": "3.0",
"data": {
"stations": [
{
"station_id": "station1",
"is_installed": true,
"is_renting": true,
"is_returning": true,
"last_reported": 1609866125,
"num_docks_available": 3,
"vehicle_docks_available": [
{
"vehicle_type_ids": [
"abc123"
],
"count": 2
},
{
"vehicle_type_ids": [
"def456"
],
"count": 1
}
],
"num_bikes_available": 1,
"vehicle_types_available": [
{
"vehicle_type_id": "abc123",
"count": 1
},
{
"vehicle_type_id": "def456",
"count": 0
}
]
},
{
"station_id": "station2",
"is_installed": true,
"is_renting": true,
"is_returning": true,
"last_reported": 1609866106,
"num_docks_available": 8,
"vehicle_docks_available": [
{
"vehicle_type_ids": [
"abc123"
],
"count": 6
},
{
"vehicle_type_ids": [
"def456"
],
"count": 2
}
],
"num_bikes_available": 6,
"vehicle_types_available": [
{
"vehicle_type_id": "abc123",
"count": 2
},
{
"vehicle_type_id": "def456",
"count": 4
}
]
}
]
}
}
Ecco un esempio di station_status in formato JSON-LD normalizzato. Questo è compatibile con NGSI-v2 quando non si utilizzano le opzioni e restituisce i dati di contesto di una singola entità.
show/hide example
{
"id": "urn:ngsi-ld:station_status:id:FNNO:60592292",
"type": "station_status",
"last_updated": {
"type": "Number",
"value": 1609866247
},
"ttl": {
"type": "Boolean",
"value": false
},
"version": {
"type": "Text",
"value": "3.0"
},
"data": {
"type": "StructuredValue",
"value": {
"stations": [
{
"station_id": "station1",
"is_installed": true,
"is_renting": true,
"is_returning": true,
"last_reported": 1609866125,
"num_docks_available": 3,
"vehicle_docks_available": [
{
"vehicle_type_ids": [
"abc123"
],
"count": 2
},
{
"vehicle_type_ids": [
"def456"
],
"count": 1
}
],
"num_bikes_available": 1,
"vehicle_types_available": [
{
"vehicle_type_id": "abc123",
"count": 1
},
{
"vehicle_type_id": "def456",
"count": 0
}
]
},
{
"station_id": "station2",
"is_installed": true,
"is_renting": true,
"is_returning": true,
"last_reported": 1609866106,
"num_docks_available": 8,
"vehicle_docks_available": [
{
"vehicle_type_ids": [
"abc123"
],
"count": 6
},
{
"vehicle_type_ids": [
"def456"
],
"count": 2
}
],
"num_bikes_available": 6,
"vehicle_types_available": [
{
"vehicle_type_id": "abc123",
"count": 2
},
{
"vehicle_type_id": "def456",
"count": 4
}
]
}
]
}
}
}
Ecco un esempio di station_status in formato JSON-LD come valori-chiave. Questo è compatibile con NGSI-LD quando si usa options=keyValues
e restituisce i dati di contesto di una singola entità.
show/hide example
{
"id": "urn:ngsi-ld:station_status:id:FNNO:60592292",
"type": "station_status",
"last_updated": 1609866247,
"ttl": 0,
"version": "3.0",
"data": {
"stations": [
{
"station_id": "station1",
"is_installed": true,
"is_renting": true,
"is_returning": true,
"last_reported": 1609866125,
"num_docks_available": 3,
"vehicle_docks_available": [
{
"vehicle_type_ids": [
"abc123"
],
"count": 2
},
{
"vehicle_type_ids": [
"def456"
],
"count": 1
}
],
"num_bikes_available": 1,
"vehicle_types_available": [
{
"vehicle_type_id": "abc123",
"count": 1
},
{
"vehicle_type_id": "def456",
"count": 0
}
]
},
{
"station_id": "station2",
"is_installed": true,
"is_renting": true,
"is_returning": true,
"last_reported": 1609866106,
"num_docks_available": 8,
"vehicle_docks_available": [
{
"vehicle_type_ids": [
"abc123"
],
"count": 6
},
{
"vehicle_type_ids": [
"def456"
],
"count": 2
}
],
"num_bikes_available": 6,
"vehicle_types_available": [
{
"vehicle_type_id": "abc123",
"count": 2
},
{
"vehicle_type_id": "def456",
"count": 4
}
]
}
]
},
"@context": [
"https://smartdatamodels.org/context.jsonld",
"https://raw.githubusercontent.com/smart-data-models/dataModel.GBFS/master/context.jsonld"
]
}
Ecco un esempio di station_status in formato JSON-LD normalizzato. Questo è compatibile con NGSI-LD quando non si usano le opzioni e restituisce i dati di contesto di una singola entità.
show/hide example
{
"id": "urn:ngsi-ld:station_status:id:FNNO:60592292",
"type": "station_status",
"last_updated": {
"type": "Property",
"value": 1609866247
},
"ttl": {
"type": "Property",
"value": 0
},
"version": {
"type": "Property",
"value": "3.0"
},
"data": {
"type": "Property",
"value": {
"stations": [
{
"station_id": "station1",
"is_installed": true,
"is_renting": true,
"is_returning": true,
"last_reported": 1609866125,
"num_docks_available": 3,
"vehicle_docks_available": [
{
"vehicle_type_ids": [
"abc123"
],
"count": 2
},
{
"vehicle_type_ids": [
"def456"
],
"count": 1
}
],
"num_bikes_available": 1,
"vehicle_types_available": [
{
"vehicle_type_id": "abc123",
"count": 1
},
{
"vehicle_type_id": "def456",
"count": 0
}
]
},
{
"station_id": "station2",
"is_installed": true,
"is_renting": true,
"is_returning": true,
"last_reported": 1609866106,
"num_docks_available": 8,
"vehicle_docks_available": [
{
"vehicle_type_ids": [
"abc123"
],
"count": 6
},
{
"vehicle_type_ids": [
"def456"
],
"count": 2
}
],
"num_bikes_available": 6,
"vehicle_types_available": [
{
"vehicle_type_id": "abc123",
"count": 2
},
{
"vehicle_type_id": "def456",
"count": 4
}
]
}
]
}
},
"@context": [
"https://smartdatamodels.org/context.jsonld",
"https://raw.githubusercontent.com/smart-data-models/dataModel.GBFS/master/context.jsonld"
]
}
Vedere FAQ 10 per ottenere una risposta su come gestire le unità di grandezza.