OpenSource4School/Geocaching/Mixare

Mixare ist ein Open Source Augmented Reality Engine, welches beispielsweise im Rahmen von Geocachings Anwendung finden kann.

Screenshot von Mixare (mit Datenpunkten aus https://melanie-platz.github.io/Mixare/Demo-Data_Siegen.json)

Mixare: Erstellen eigener Datenquellen

Zum Erstellen eigener Datenquellen benötigen Sie:

• Einen Computer mit Internetverbindung,
• Einen Texteditor auf dem Computer,
• ein Smartphone oder Tablet mit Kamera und Internetverbindung und
• Mixare als App auf dem Smartphone/ Tablet.

Schritt 1: Homepage erstellen

1. Legen Sie einen Account unter GitHub an: https://github.com/github (eine Einführung zum Einrichten von GitHub ist unter folgendem Link verfügbar: https://guides.github.com/features/pages/)
2. Kopieren Sie das folgende Repository in GitHub über "Fork": https://github.com/melanie-platz/Mixare - Das Repository enthält eine JSON-Datei in der die geographischen Datenpunkte enthalten sind.
3. Richten Sie Ihre Homepage ein (über Settings > GitHub Pages > Choose a theme > Select theme).

Schritt 2: Datenpunkte festlegen

1. Längen- und Breitengrad: https://maps.google.com/ (für Siegen: http://icgis.kdz-ws.net:81/tourismus/)
2. Höhe über dem Meeresspiegel: http://www.autospur.de/Staumeldungen/wie-hoch.html
3. Längen- und Breitengrade sowie die Höhe über dem Meeresspiegel können auch direkt mit dem Smartphone über die App "GPS Status & Toolbox" bestimmt werden.
4. Zusatzinformationen zu den Datenpunkten festlegen (Inhalte, auf die verlinkt werden soll, festlegen; URLs festlegen, auf die verwiesen werden soll, z.B. selbst erstellte html-Seiten in GitHub oder selbst erstellte Seiten auf Wikiversity).

Schritt 3: Json-File mit Datenpunkten erstellen

1. Um eigene Datenpunkte zu erzeugen, muss zunächst ein json-file mit Hilfe eines Texteditors erstellt werden.
2. Diese Datei kann dann mit der Endung ".json" gespeichert werden. Alternativ kann man die Datenpunkte auch mit Mixare4JSON erstellen, indem man die Daten in das Formular eingibt und anschließend das json-File durch "Save Mixare" speichert.

Beispiel:

{
"status": "OK", "num_results": 2, 
"results":
  [ 
   { 
     "id": "1", 
     "lat": "50.875906", 
     "lng": "8.019509", 
     "elevation": "240", 
     "title": "Universität Siegen, Herrengarten", 
     "has_detail_page": "1", 
     "webpage": "https://www.uni-siegen.de/start/kontakt/anfahrt_und_lageplaene/herrengarten.html" 
   },{ 
     "id": "2", 
     "lat": "50.873871", 
     "lng": "8.020273", 
     "elevation": "250", 
     "title": "Martinikirche", 
     "has_detail_page": "1", 
      "webpage": "http://www.martini-siegen.de/" }
  ]
}

Schritt 4: Hochladen des Dokuments auf einen Server

1. Dieses Dokument muss dann auf einem Server gespeichert werden, laden Sie dazu die entstandene Datei in GitHub hoch, z.B. https://melanie-platz.github.io/Mixare/Demo-Data_Siegen.json

Schritt 5: Zugriff auf die Datenpunkte in Mixare

Mixare: Öffnen des Menüs und Einfügen eigener Datenquellen

1. In Mixare kann nun folgendermaßen auf die erzeugte Datenquelle zugegriffen werden: Menü (langes Drücken der "Zurück-Taste") > Datenquelle > Menü (langes Drücken der "Zurück-Taste") > Add data source
   
2. Hier kann nun die URL eingegeben werden, unter der die neue Datenquelle gespeichert ist.
3. Unter "Data source" muss "Mixare" ausgewählt werden.
4. Wenn man nun die neue Datenquelle auswählt, kann man sich die selbst erstellten Punkte in Mixare anzeigen lassen.

Quellen

• Ein Tutorial zum Erstellen eigener Datenquellen (d.h. eigener Geo-Koordinaten) ist unter diesem Link verfügbar: https://code.google.com/p/mixare/wiki/DisplayYourOwnData
• https://en.wikiversity.org/wiki/Augmented_Reality/Tutorial#See_Mixare_at_Work