Realtime data

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