Tel-o-Fun API – GetNearest

פונקציית get nearest מחזירה את התחנה הקרובה ביותר. בשלב הבא, גם החזרת מידע על התחנות, כולל מס’ האופניים ועמדות העגינה הזמינות.

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

http://telofun.strawjackal.org/api/getnearest?lat=xxx&lng=yyy

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

{
  “isactive”:1,
  “id”:368,
  “address”:”אלנבי 90 פינת מאזה”,
  “lat”:32.066918651,
  “lng”:34.771511391,
  “distance”: 0.45585337300967
}

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

lat – Latitude of current user position to search from, represented as a floating-point number. e.g. 32.070.
lng –
Longitude of current user position to search from, represented as a floating-point number. e.g. 34.768.
inactive –
(optional) include inactive bike stations. Values can be 1 or 0. Default is 0.

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

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.
address – Name/address of station, in Hebrew.
lat/lng – Latitude and Longitude of station.
distance – Distance between station and current position, in kilometers.

השירות זמין לשימוש חופשי, אבל אני אשמח לדעת אם אתם משתמשים בו באפליקציה שלכם, וכמובן, אשמח גם לקרדיט אצלכם באפליקציה.

Leave a Reply

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