Realtime data

Real time data is available in the GBFS format (General Bikeshare Feed Specification). More details are available on GitHub. The data is updated every 10 seconds.

Identification in header

All requests to our real time API should send the "Client-Identifier" header. This should contain a value that describes the application accessing the API. The value should contain your company/organization name, follwed by a dash and the application's name.

Examples

  mycompany-travelplanner
myname-citymonitor

Endpoints

Auto discovery

Auto-discovery file that links to all of the other files published by the system.

CURL request


  curl -H "Client-Identifier: IDENTIFIER" \
    http://gbfs.urbansharing.com/trondheimbysykkel.no/gbfs.json
                  

Response

{
  "data":{
    "nb":{
      "feeds":[
        {
          "url":"http://gbfs.urbansharing.com/trondheimbysykkel.no/system_information.json",
          "name":"system_information"
        },
        {
          "url":"http://gbfs.urbansharing.com/trondheimbysykkel.no/station_information.json",
          "name":"station_information"
        },
        {
          "url":"http://gbfs.urbansharing.com/trondheimbysykkel.no/station_status.json",
          "name":"station_status"
        }
      ]
    }
  },
  "ttl":10,
  "last_updated":1542035150
}

System

Machine readable basic information about Trondheim City Bike

CURL request


  curl -H "Client-Identifier: IDENTIFIER" \
    http://gbfs.urbansharing.com/trondheimbysykkel.no/system_information.json
                  

Response

{
  "last_updated": 1540218289,
  "ttl": 10,
  "data": {
    "system_id": "trondheim",
    "language": "nb",
    "name": "Trondheim City Bike",
    "operator": "UIP Trondheim Bysykkel AS",
    "timezone": "Europe/Oslo",
    "phone_number": "+4794858825",
    "email": "post@trondheimbysykkel.no"
  }
}

Stations

Information about all stations, including geolocation, addresses and descriptions

CURL request


  curl -H "Client-Identifier: IDENTIFIER" \
    http://gbfs.urbansharing.com/trondheimbysykkel.no/station_information.json
                  

Response

{
  "last_updated": 1540219057,
  "data": {
    "stations": [
      {
        "capacity": 15,
        "lat": 63.4304427209203,
        "address": "Kongensgate 15",
        "name": "Torvet I",
        "station_id": "175",
        "lon": 10.392744433633425
      },
      {
        "capacity": 13,
        "lat": 63.429289773431165,
        "address": "Illevollen",
        "name": "Ilaparken",
        "station_id": "47",
        "lon": 10.369248388233245
      },
      {
        "capacity": 13,
        "lat": 63.40575407332705,
        "address": "Sorgenfriveien 7",
        "name": "Sorgenfri",
        "station_id": "10",
        "lon": 10.399830937385559
      }
    ]
  }
}

Availability

Bike and dock availability

CURL request


  curl -H "Client-Identifier: IDENTIFIER" \
    http://gbfs.urbansharing.com/trondheimbysykkel.no/station_status.json
                  

Response

{
  "last_updated": 1540219230,
  "data": {
    "stations": [
      {
        "is_installed": 1,
        "is_renting": 1,
        "num_bikes_available": 7,
        "num_docks_available": 5,
        "last_reported": 1540219230,
        "is_returning": 1,
        "station_id": "175"
      },
      {
        "is_installed": 1,
        "is_renting": 1,
        "num_bikes_available": 4,
        "num_docks_available": 8,
        "last_reported": 1540219230,
        "is_returning": 1,
        "station_id": "47"
      },
      {
        "is_installed": 1,
        "is_renting": 1,
        "num_bikes_available": 4,
        "num_docks_available": 9,
        "last_reported": 1540219230,
        "is_returning": 1,
        "station_id": "10"
      }
    ]
  }
}

Historical data

You may also download anonymised trip records