글로벌 설명: 표준 GBFS 2.2에 따라 스테이션의 용량 및 대여 가능 여부를 설명합니다.
버전: 0.0.1
[*] 속성에 유형이 없는 것은 여러 유형 또는 다른 형식/패턴을 가질 수 있기 때문입니다.
data[object]
: 아래에 정의된 대로 스테이션당 하나의 오브젝트를 포함하는 배열입니다.stations
:
id[*]
: 엔티티의 고유 식별자last_updated[integer]
: 피드의 데이터가 마지막으로 업데이트된 시간은 POSIX 시간입니다.ttl[integer]
: 피드의 데이터가 다시 업데이트되기까지의 시간(초)(데이터를 항상 새로 고쳐야 하는 경우 0)입니다.type[string]
: NGSI 엔티티 유형입니다. 스테이션_상태여야 합니다.version[string]
: 버전 관리 프레임워크에 따라 피드가 준수하는 GBFS 버전 번호(v1.1에 추가됨).
필수 속성
data
id
last_updated
ttl
type
version
표준 매핑 GBFS 2.2
알파벳순으로 정렬(자세한 내용을 보려면 클릭)
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
다음은 키-값으로 JSON-LD 형식의 스테이션 상태의 예입니다. 이는 옵션=키값
을 사용할 때 NGSI-v2와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다.
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
}
]
}
]
}
}
다음은 정규화된 JSON-LD 형식의 스테이션 상태 예시입니다. 이는 옵션을 사용하지 않을 때 NGSI-v2와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다.
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
}
]
}
]
}
}
}
다음은 키-값으로 JSON-LD 형식의 스테이션 상태 예시입니다. 이는 옵션=키값
을 사용할 때 NGSI-LD와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다.
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"
]
}
다음은 정규화된 JSON-LD 형식의 스테이션 상태 예시입니다. 이는 옵션을 사용하지 않을 때 NGSI-LD와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다.
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"
]
}
FAQ 10을 참조하여 규모 단위를 다루는 방법에 대한 답변을 확인하세요.