Aici găsești exemple simple, care ilustrează cum să te conectezi la server și să primești datele telemetrice de la transportul public din Chișinău, prin sistemul Roataway.
Obiectivul principal este de a oferi un start rapid, o temelie, deasupra căreia poți construi ceva propriu.
Fiecare mapă conține un exemplu minimalist, scris într-un anumit limbaj de programare. Tot acolo vei găsi un readme cu instrucțiuni specifice, dacă e necesar.
javascript-websocket- o pagină HTML cu JavaScript, care se conectează la server prin MQTT over websockets, și afișează mesajele telemetrice.javascript-websocket-leaflet- o versiune mai elaborată a exemplului precedent, care vizualizează vehiculele pe hartă.javascript-websocket-smoothie- construcția unui grafic care arată variația în timp real a direcției de deplasare a unui vehicul.python- conexiune prin MQTT over TCP, cu afișarea pe ecran a mesajelor recepționate.ios-swift-moscapsule- exemplu simplu pe iOS cu utilizarea limbajului Swift și librăriei Moscapsule.ruby- analog a exemplului Python.golang- conexiune MQTT prin TCP + formarea unei structuri de date din mesajele JSON.elixir- conexiune MQTT prin TCP + decodarea mesajului JSON intr-o mapa si afisarea lui.
Dacă vrei să incluzi în lista exemplelor un nou limbaj:
- Adaugă o mapă cu denumirea limbajului și păstrează acolo fișierele necesare
- Asigură-te că exemplul funcționează corect
- Scrie un readme cu instrucțiuni care arată ce trebuie să facă un om, ca să lanseze exemplul tău, pornind de la zero
- Asigură-te că exemplul e minimalist, elimină totul ce nu e necesar; ține cont de faptul că publicul țintă e alcătuit din începători
- Comentează codul, astfel încât să fie clar ce se petrece în locurile-cheie a acestuia
- Nu recurge la ”clever hacks” pe care nu le va înțelege un începător
- Nu folosi ”über-enterprise patterns” care prind bine când codul e scris pentru companii cu sute de angajați, dar care prind nu_bine când codul îl citește un puști care abia învată programarea
- Include în readme o secțiune cu referințe la materiale adiționale (screencasts, articole, cărți, etc.), ca începătorii să-și poată dezvolta deprinderi bune
Când e gata, deschide un pull-request (PR).