https://github.com/roataway/examples

Exemple care demonstrează conectarea la server și recepționarea datelor telemetrice
https://github.com/roataway/examples

beginner moldova mqtt public-transport

Last synced: about 2 months ago
JSON representation

Exemple care demonstrează conectarea la server și recepționarea datelor telemetrice

• Host: GitHub
• URL: https://github.com/roataway/examples
• Owner: roataway
• License: agpl-3.0
• Created: 2019-12-27T21:44:30.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2023-10-11T21:04:55.000Z (about 1 year ago)
• Last Synced: 2024-06-21T05:58:38.946Z (7 months ago)
• Topics: beginner, moldova, mqtt, public-transport
• Language: JavaScript
• Homepage: https://roataway.md
• Size: 22.3 MB
• Stars: 4
• Watchers: 3
• Forks: 2
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Descriere

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.

# Lista exemplelor

- `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.

# Cum să contribui

Dacă vrei să incluzi în lista exemplelor un nou limbaj:

1. Adaugă o mapă cu denumirea limbajului și păstrează acolo fișierele necesare

2. Asigură-te că exemplul funcționează corect

3. Scrie un readme cu instrucțiuni care arată ce trebuie să facă un om, ca să lanseze exemplul

tău, *pornind de la zero*

4. 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

5. Comentează codul, astfel încât să fie clar ce se petrece în locurile-cheie a acestuia

6. Nu recurge la ”clever hacks” pe care nu le va înțelege un începător

7. 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

8. 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).