Pobieranie danych z aplikacji

[slawekstu]

Co muszę zrobić by otrzymać dostęp do danych z aplikacji?

• Napisać mail na credodetector[at]credo.science, w wiadomości należy opisać, dlaczego chcesz uzyskać dostęp i co zamierzasz zrobić z danymi. Należy też podać swoją nazwę użytkownika. Wiadomość powinna być wysłana z adresu e-mail użytego podczas rejestracji.

• Jeśli w/w wymogi zostaną spełnione, mail zostanie przekazany do administratorów odpowiadających za dostęp do danych. W przeciwnym wypadku otrzymamy wiadomość z uwagą by poprawić zgłoszenie.

• Na podstawie danych podanych w wiadomości zostaje przydzielony dostęp do danych, o czym zostaniemy poinformowani mailowo.

Mam dostęp do danych, ale nie wiem jak je pobrać

• By móc pobierać dane należy mieć zainstalowany Python3 i bibliotekę requests oraz pobrany plik credo-data-exporter.py który umieścimy w nowym folderze

• Dane pobieramy z poziomu terminala/konsoli (włączamy terminal w folderze z w/w skryptem) poleceniem:
  ./credo-data-exporter.py --user nazwa_użytkownika --password haslo_uzytkownika
  (najłatwiej się to robi na systemie Linux,na innych systemach też się da)

• Przy pierwszym pobieraniu, może się okazać, że będzie trzeba nadać odpowiednie prawa dla wykonywanego pliku tj.:
  chmod +x credo-data-exporter.py

Jak pobrać listę użytkowników, urządzeń, zespołów?

Można to zrobić poprzez dodanie odpowiedniej frazy np:

• ./credo-data-exporter.py --user nazwa_użytkownika --password haslo_uzytkownika --mapping-type 'user'
  za user można dać team lub device

• lub pobrać wszystkie "mappingi":
  ./credo-data-exporter.py --user nazwa_użytkownika --password haslo_uzytkownika --mapping-type 'all'

Jakie informacje zawiera pojedyncza detekcja w pliku i co one oznaczają?

Zawiera następujące wartości:

• "user_id": ID użytkownika,

• "latitude": szerokość geograficzna,

• "timestamp": czas w systemie UNIX,

• "altitude": wysokosc geograficzna,

• "visible": widzialnosc detekcji na stronie ("True","False"),

• "longitude": dlugość geograficzna,

• "height": wysokość,

• "frame_content": 10tys znakow zakodowanych w Base64, odkodowanie tworzy obraz detekcji,

• "width": Szerokość czujnika urządzenia,

• "team_id": ID zespołu,

• "provider": dostawca lokalizacji (zazwyczaj GPS),

• "y": Współrzędna Y zdarzenia,

• "x": Współrzędna X zdarzenia,

• "device_id": ID urządzenia,

• "time_received": czas dostarczenia,

• "accuracy": dokładność lokalizacji

Gdzie znajdę pełną dokumentacje o danych z aplikacji?

Na Githubie, link:

• https://github.com/credo-science/credo- ... credoapiv2

Gdzie można gdzieś znaleźć przykładowe skrypty do analizy danych?

Pracujemy nad tym, będzie to stopniowo dodawane na:

• Forum w zakładce skrypty : viewforum.php?f=9

oraz

• na Githubie projektu: https://github.com/credo-science