GET BikePoint/box/{swLon}/{swLat}/{neLon}/{neLat}

Returns the current state of all shared bike points within a minimum bounding box. The minimum bounding box must be defined by 2 GPS coordinates south west and north east.

Parameters

Parameter Example value Description
swLon 6.10 GPS longitude float of south west minimum bounding box location
swLat 49.5 GPS latitude float of south west minimum bounding box location
neLon 6.11 GPS longitude float of north east minimum bounding box location
neLat 49.55 GPS latitude float of north east minimum bounding box location

Resource URL

https://api.tfl.lu/v1/BikePoint/box/{swLon}/{swLat}/{neLon}/{neLat}

Format

The response will be formatted as a GeoJSON Feature Collection.

Object properties

Key Type Possible values Description
id string {provider}:{number} id of the shared bike point (built from provider and id of provider)
open boolean - true
- false		 status of the shared bike point (open or closed)
name string {name} name of the shared bike point (often a POI next to the station or the street name)
city string - {city}
- NULL		 city in which shared bike point is located (can be null if not provided)
address string {address} street address of shared bike point
photo string - {photo}
- NULL		 photo of the shared bike point (only provided by velok for now)
docks integer {docks} total amount of docks
available_bikes integer {available_bikes} amount of available bikes which are of type manual
available_ebikes integer {available_ebikes} amount of available bikes which are of type electric
available_docks integer {available_docks} amount of free docks at shared bike point
last_update integer - {last_update}
- NULL		 last update of the data from the shared bike point in Unix time (milliseconds), NULL means realtime
dock_status array array of single dock statuses
dock_status.status string - 'free'
- 'occupied'		 status of specific dock, can be free or occupied
dock_status.bikeType string - 'manual'
- 'electric'
- NULL		 type of bike attached to dock, NULL if dock is free

Sample request & response

GET https://api.tfl.lu/v1/BikePoint/box/6.10/49.5/6.11/49.55

{
    "type": "FeatureCollection",
    "features": [{
        "type": "Feature",
        "geometry": {
            "type": "Point",
            "coordinates": [6.101875, 49.516036]
        },
        "properties": {
            "id": "velok:46",
            "open": true,
            "name": "Gare CFL Bettembourg",
            "city": "Bettembourg",
            "address": "Place de la Gare",
            "photo": "https://webservice.velok.lu/images/photos/46.jpg",
            "docks": 7,
            "available_bikes": 0,
            "available_ebikes": 1,
            "available_docks": 6,
            "last_update": null,
            "dock_status": [{
                "status": "free",
                "bikeType": null
            }, {
                "status": "free",
                "bikeType": null
            }, {
                "status": "free",
                "bikeType": null
            }, {
                "status": "occupied",
                "bikeType": "electric"
            }, {
                "status": "free",
                "bikeType": null
            }, {
                "status": "free",
                "bikeType": null
            }, {
                "status": "free",
                "bikeType": null
            }]
        }
    }, {
        "type": "Feature",
        "geometry": {
            "type": "Point",
            "coordinates": [6.108912, 49.517218]
        },
        "properties": {
            "id": "velok:47",
            "open": true,
            "name": "Reebou-Schoul",
            "city": "Bettembourg",
            "address": "Rue Marie Therèse",
            "photo": "https://webservice.velok.lu/images/photos/47.jpg",
            "docks": 5,
            "available_bikes": 0,
            "available_ebikes": 4,
            "available_docks": 1,
            "last_update": null,
            "dock_status": [{
                "status": "occupied",
                "bikeType": "electric"
            }, {
                "status": "free",
                "bikeType": null
            }, {
                "status": "occupied",
                "bikeType": "electric"
            }, {
                "status": "occupied",
                "bikeType": "electric"
            }, {
                "status": "occupied",
                "bikeType": "electric"
            }]
        }
    }]
}

License

Please refer to Bikepoint for information about the shared bike point data licensing.

Credits

Made by Daniel Duton & Thierry Degeling from ION Network Solutions.

Sponsored by Digital Lëtzebuerg.

results matching ""

    No results matching ""