Bike Hire Docking Station

Description

Many cities provide a bike hiring system for citizens. These can hire a bike base on different types of subscriptions. A bike hire docking station where subscribed users can hire and return a bike. It provides data about its main features and availability of bikes and free slots.

Data Model

A JSON Schema corresponding to this data model can be found here.

  • id : Unique identifier.

  • type : Entity type. It must be equal to BikeHireDockingStation.

  • dateCreated : Entity's creation timestamp.

  • dateModified : Last update timestamp of this entity.

  • location : Geolocation of the station represented by a GeoJSON (Multi)Polygon or Point.

  • address : Registered docking station site civic address.

  • name : Name given to the docking station.

  • description : Description about the bike hire docking station.

  • image : A URL containing a photo of this docking station.

  • totalSlotNumber : The total number of slots offered by this bike docking station.

    • Attribute type: Number
    • Allowed values: Any positive integer number or 0.
    • Optional
  • freeSlotNumber : The number of slots available for returning and parking bikes. It must lower or equal than totalSlotNumber.

    • Attribute type: Number
    • Allowed values: A positive integer number, including 0. It must lower or equal than totalSlotNumber.
    • Metadata:
      • timestamp : Timestamp of the last attribute update.
      • Type: DateTime
    • Optional
  • outOfServiceSlotNumber : The number of slots that are out of order and cannot be used to hire or park a bike. It must lower or equal than totalSlotNumber.

    • Attribute type: Number
    • Allowed values: A positive integer number, including 0.
    • Metadata:
      • timestamp : Timestamp of the last attribute update
      • Type: DateTime
    • Optional
  • availableBikeNumber : The number of bikes available in the bike hire docking station to be hired by users.

    • Attribute type: Number
    • Allowed values: A positive integer number, including 0.
    • Metadata:
      • timestamp : Timestamp of the last attribute update.
      • Type: DateTime
    • Optional
  • openingHours : Opening hours of the docking station.

  • status : Status of the bike hire docking station.

    • Attribute type: List of Text
    • Metadata:
      • timestamp : Timestamp of the last attribute update.
      • Type: DateTime
    • Allowed values:
      • (working, outOfService, withIncidence, full, almostFull, empty, almostEmpty)
      • Or any other application+specific.
    • Optional
  • areaServed : Area served by this docking station. Precise semantics can depend on the application or target city. For instance, it can be a neighbourhood, burough or district.

    • Attribute type: Text
    • Optional
  • owner : Bike hire docking station's owner.

    • Attribute type: Text
    • Optional
  • provider : Bike hire service provider.

  • contactPoint : Bike hire service contact point.

Note: JSON Schemas only capture the NGSI simplified representation, this means that to test the JSON schema examples with a FIWARE NGSI version 2 API implementation, you need to use the keyValues mode (options=keyValues).

Examples of use 1 (Normalized Format)

{
    "id": "Bcn-BikeHireDockingStation-1",
    "type": "BikeHireDockingStation",
    "status": {
        "value": "working"
    },
    "availableBikeNumber": {
        "value": 20,
        "metadata": {
            "timestamp": {
                "type": "DateTime",
                "value": "2018-09-25T12:00:00"
            }
        }
    },
    "freeSlotNumber": {
        "value": 10
    },
    "location": {
        "type": "geo:json",
        "value": {
            "type": "Point",
            "coordinates": [2.180042, 41.397952]
        }
    },
    "address": {
        "type": "PostalAddress",
        "value": {
            "addressCountry": "ES",
            "addressLocality": "Barcelona",
            "streetAddress": "Gran Via Corts Catalanes,760"
        }
    }
}

Examples of use 2 (?options=keyValues simplified representation for data consumers)

Bike hire docking station real time data in Malaga

{
   "id": "malaga-bici-7"
   "type": "BikeHireDockingStation",
   "name": "07-Diputacion",
   "location": {
     "coordinates": [-4.43573, 36.699694],
      "type": "Point"
   },
   "availableBikeNumber": 18,
   "freeSlotNumber": 10,
   "address": {
      "streetAddress": "Paseo Antonio Banderas (Diputación)",
      "addressLocality": "Malaga",
      "addressCountry": "España"
   },
   "description": "Punto de alquiler de bicicletas próximo a Diputación",
   "dateModified": "2017-05-09T09:25:55.00Z"
}

Use it with a real service

T.B.D.

Open Issues

Municipalities do not have a specific tariff or access requirements per station. Therefore, this information has not been specified in this model so far.