Tel-o-Fun API – Details

פונקציית details מחזירה מידע על אודות תחנת אופניים ספציפית, בהנתן מספר הזיהוי שלה. המידע כולל את שם התחנה ומיקומה (lat/lng), מספר זוגות האופניים הזמינים ומספר עמודי העגינה הפנויים, כמו גם את שלושת התחנות הקרובות ביותר. כל המידע נשלף בזמן אמת מאתר העירייה.

ה-API ממומש כ-web service פשוט, מבוסס HTTP GET. השירות אינו דורש הזדהות, וה-endpoint הוא:

http://telofun.strawjackal.org/api/details?id=XXX

והוא מחזיר תוצאות בפורמט JSON:

{
  “id”: 368,
  “name”: “אלנבי 90 פינת מאזה””,
  “lat”: 32.066918651,
  “lng”: 34.771511391,
  “isactive”: 1,
  “available_bikes”: 5,
  “available_docks”: 15,
  “nearby_stations”:
  [
    {
      “id”: 364,
      “name”: “תחנה גינת שינקין-י נפחא מול 1″
    },
    {
      “id”: 369,
      “name”: “תחנה רוטשילד 11 פינת הרצלœ”
    },
    {
      “id: 375,
      “name”: “תחנה יהודה הלוי 43 פינת אלנבי”
    }
  ]
}

הפרמטרים לשירות הם:

id – Unique bike station identifier as defined by the Tel-O-Fun website, so it should be identical in all apps/APIs

הערכים המוחזרים הם:

id – Unique bike station identifier, as defined by the Tel-O-Fun website, so it should be identical in all apps/APIs.
isactive –
Whether the station is currently active. 0 = false.
name – Name/address of station, in Hebrew.
lat/lng – Latitude and Longitude of station.
available_bikes – Number of bikes waiting to be rented.
available_docks – Number of bike docks/posts free.
nearby_stations – The three nearest stations, including ID and name. Note: these nearby stations are not necessarily active!

Leave a Reply

Your email address will not be published. Required fields are marked *