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.

The data is published under the Norwegian Licence for Open Government Data (NLOD) 2.0

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, like mycompany-travelplanner or myname-citymonitor.

Endpoints

Auto discovery

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

Endpoint: gbfs.json (Documentation)

CURL request

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

Response

{
  "data":{
    "nb":{
      "feeds":[
        {
          "url":"https://gbfs.urbansharing.com/trondheimbysykkel.no/system_information.json",
          "name":"system_information"
        },
        {
          "url":"https://gbfs.urbansharing.com/trondheimbysykkel.no/station_information.json",
          "name":"station_information"
        },
        {
          "url":"https://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

Endpoint: system_information.json (Documentation)

CURL request

curl -H "Client-Identifier: IDENTIFIER" \
  https://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

Endpoint: station_information.json (Documentation)

CURL request

curl -H "Client-Identifier: IDENTIFIER" \
  https://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

Endpoint: station_status.json (Documentation)

CURL request

curl -H "Client-Identifier: IDENTIFIER" \
  https://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