Benutzeranleitung SAMO Infra Tracker

Über SAMO Infra Tracker

SAMO Infra Tracker ist eine iOS-Anwendung zur GPS-basierten Verfolgung und Verwaltung von Infrastrukturelementen, insbesondere Gasleitungen. Die App ermöglicht es Benutzern, GPS-Tracks aufzuzeichnen, diese mit bestehenden Infrastrukturelementen zu verknüpfen und Schadensmeldungen zu erstellen.

Hauptfunktionen:

• GPS-Tracking: Aufzeichnung von GPS-Tracks entlang von Infrastrukturelementen
• Kartenintegration: Visualisierung von Gasleitungen und GPS-Tracks auf einer interaktiven Karte
• SAMO-Integration: Verbindung zu SAMO-Backends für Datenmanagement
• Schadensmeldung: Erfassung und Lokalisierung von Infrastrukturschäden
• Konfigurierbare Feature-Typen: Anpassung an verschiedene GIS-Datenstrukturen

Installation

Systemanforderungen

• iOS: Version 14.0 oder höher
• Gerät: iPhone oder iPad mit GPS-Funktionalität
• Speicher: Mindestens 50 MB freier Speicherplatz
• Netzwerk: Internetverbindung für SAMO-Backend-Zugriff

Installationsschritte

1. App Store Installation (falls verfügbar):
   • Öffnen Sie den App Store auf Ihrem iOS-Gerät
   • Suchen Sie nach "SAMO Infra Tracker"
   • Tippen Sie auf "Laden" und warten Sie, bis die Installation abgeschlossen ist
2. Enterprise/TestFlight Installation:
   • Folgen Sie den Anweisungen Ihres Administrators
   • Installieren Sie ggf. erforderliche Zertifikate
   • Laden Sie die App über den bereitgestellten Link herunter
3. Erste Einrichtung:
   • Öffnen Sie die App nach der Installation
   • Gewähren Sie die erforderlichen Berechtigungen:
     • Standort: "Immer" für GPS-Tracking
     • Netzwerk: Für SAMO-Backend-Verbindung

Erste Schritte

App-Start und Hauptbildschirm

• Kartenansicht: Zentrale Karte zur Visualisierung
• Infobox: Statusmeldungen am unteren Bildschirmrand
• Toolbar: Funktionsschaltflächen am oberen Rand
• Leitungsliste: Scrollbare Liste verfügbarer Gasleitungen

Navigation

• Konfiguration: Zahnrad-Symbol (⚙️) für Einstellungen
• GPS-Tracking: Globe-Symbol für GPS-Funktionen
• Selektion aufheben: Radiergummi-Symbol zum Zurücksetzen
• Neuer Track: Pfad-Symbol für neue Aufzeichnungen

Grundlegende Bedienung

1. Karte vergrößern/verkleinern: Pinch-Gesten verwenden
2. Karte verschieben: Mit einem Finger ziehen
3. Kartenhöhe anpassen: Grauen Balken unter der Karte ziehen
4. Gasleitung auswählen: Auf einen Eintrag in der Liste tippen

Konfiguration

Zugriff auf die Konfiguration

1. Tippen Sie auf das Zahnrad-Symbol (⚙️) in der oberen Toolbar
2. Die Konfigurationsseite öffnet sich mit verschiedenen Einstellungsbereichen

Verbindungseinstellungen

• SAMO URL: Vollständige URL zum SAMO-Backend (z.B. https://samo.asseco-berit.ch/EZL)
• Benutzer: Ihr SAMO-Benutzername
• Passwort: Ihr SAMO-Passwort (wird sicher gespeichert)

Objekttypen-Konfiguration

• Name Linienobjekt: Bezeichnung für Linieneremente (Standard: "Gasleitung")
• Name Punktobjekt: Bezeichnung für Punktobjekte (Standard: "Schaden")

SAMO Infra Tracker Konfiguration

• GPS Track: Feature-Typ für GPS-Aufzeichnungen (z.B. ft_g_alg_tracking)
• GPS Relation: Relationstyp für GPS-Verknüpfungen (z.B. as_r_GAS_LEITUNG_TRACKING)
• GPS Role: Rolle in der Relation (z.B. rt_tracking)
• Linie (Gasleitung) Typ: Feature-Typ für Gasleitungen (z.B. ft_30015)
• Punkt (Schaden) Typ: Feature-Typ für Schadensmeldungen (z.B. ft_g_alg_damagereport)
• Punkt Relation: Relationstyp für Schadensmeldungen
• Punkt Role: Rolle des Schadens in der Relation

Konfiguration speichern

• Tippen Sie auf "Konfiguration speichern" nach Änderungen
• Die Einstellungen werden automatisch beim App-Wechsel gespeichert
• Ein Neustart der App lädt die gespeicherte Konfiguration

GPS-Tracking und Aufzeichnung

1. Gasleitung auswählen: Wählen Sie eine Gasleitung aus der Liste
2. GPS-Tracking starten: Tippen Sie auf "GPS einschalten"
3. Automatische Positionsverfolgung: Toggle "Position automatisch aktualisieren" aktivieren

• Track ohne Leitung: Wenn keine Gasleitung ausgewählt ist, kann trotzdem ein neuer Track gestartet werden
• Kontinuierliche Aufzeichnung: GPS-Punkte werden automatisch gesammelt
• Hintergrundaufzeichnung: Funktioniert auch bei gesperrtem Bildschirm
• Hohe Genauigkeit: Verwendet bestmögliche GPS-Genauigkeit
• Batterieverbrauch: Optimiert für längere Aufzeichnungen
• Aktueller Track: Wird live auf der Karte als Polyline angezeigt
• Trackstatus: Schaltfläche wechselt zwischen "GPS einschalten" und "GPS ausschalten"
• Track-Information: Länge und Koordinaten werden berechnet
• Zwischenspeicherung: Track-Daten werden lokal gespeichert

Neue Funktionen (Mai 2026)

Überblick über die jüngsten Erweiterungen

• Track ohne Verknüpfung: GPS-Track kann ohne ausgewählte Leitung erstellt und hochgeladen werden
• Option "Position automatisch aktualisieren": Karte folgt auf Wunsch der aktuellen GPS-Position
• Schadenserfassung am aktiven Track: Schaden kann mit dem laufenden Track verknüpft werden
• Verbindungsprüfung in der Konfiguration: HTTP-Status wird direkt als Meldung angezeigt (z.B. 401)
• Stabilere Karten-/Featureanzeige: Status- und Fehlermeldungen sind in der Oberfläche klarer sichtbar

Verknüpfung und Verwaltung von GPS-Tracks

1. Automatische Verknüpfung: Tracks werden automatisch mit der ausgewählten Gasleitung verknüpft
2. Upload zu SAMO: Tracks werden an das SAMO-Backend übertragen
3. Track zurücksetzen: Tippen Sie auf "neuer Track"
4. Track-Historie: Bereits aufgezeichnete Tracks bleiben erhalten
5. Track-Status überwachen: Infobox-Meldungen und visuelle Bestätigung
6. Fehlerbehebung bei der Verknüpfung: Hinweise bei Problemen

Hinweis: Bei einem Track ohne gewählte Leitung erfolgt die Speicherung ohne Leitungsrelation. Der Track kann dennoch später als Kontext für Schadenserfassungen genutzt werden.

Schadensmeldungen

1. Schaden erfassen: Voraussetzungen, Lokalisierung, Beschreibung, Speichern
2. Schadeninformationen: Koordinaten, Swiss-Koordinaten, Verknüpfung, Upload
3. Schadensliste und -verwaltung: Kartenanzeigen, Backend-Synchronisation

• Mit aktiver Leitung: Schaden wird mit der selektierten Leitung verknüpft
• Ohne aktive Leitung: Schaden wird mit der aktiven Track-ID verknüpft
• Voraussetzung: Es muss ein laufender oder bereits angelegter GPS-Track vorhanden sein
• Eingabe: Beschreibung im Feld "Schaden beschreiben ..." erfassen und mit "Schaden erfassen" senden

Schadenserfassung mit Foto-Anhang

Sie können beim Erfassen eines Schadens auch ein Foto als Anhang hochladen.

Schritt-für-Schritt Anleitung:

1. Schaden erfassen Button: Tippen Sie auf den Button "Schaden erfassen" in der Kartensicht
2. Schadenserfassung-Sheet öffnet sich: Ein Formular mit den folgenden Feldern erscheint:
   • Aktuelle Koordinaten (GPS-Position und Swiss-Koordinaten) werden automatisch angezeigt
   • Textfeld zur Beschreibung des Schadens
   • Schaltflächen zum Hinzufügen eines Fotos
3. Beschreibung eingeben: Geben Sie eine aussagekräftige Beschreibung des Schadens ein (erforderlich)
4. Foto hinzufügen (optional):
   • Tippen Sie auf "Foto aufnehmen", um ein neues Foto mit der Kamera zu machen
   • Oder tippen Sie auf "Foto aus Bibliothek", um ein bestehendes Foto auszuwählen
   • Das ausgewählte Foto wird in der Vorschau angezeigt
5. Speichern und hochladen: Tippen Sie auf "Speichern"
   • Der Schaden wird zuerst zur SAMO-API übertragen
   • Wenn ein Foto ausgewählt wurde, wird es anschließend als Anhang hochgeladen
   • Eine Bestätigungsmeldung wird angezeigt

Wichtige Hinweise:

• Berechtigungen: Die App benötigt Zugriff auf Kamera und Fotobibliothek. Gewähren Sie diese Berechtigungen beim ersten Start oder in den iOS-Einstellungen
• Foto-Anforderungen:
  • Unterstützte Formate: JPEG, PNG
  • Maximale Größe: Abhängig vom Server (üblicherweise bis 10 MB)
  • Empfohlene Auflösung: Mindestens 640x480 Pixel für gute Qualität
• Upload-Status: Die Infobox zeigt an, ob der Schaden und das Foto erfolgreich hochgeladen wurden
• Ohne Foto: Sie können auch Schäden ohne Foto erfassen – das Foto ist optional
• Fehlerbehebung:
  • Falls das Foto nicht hochgeladen wird: Überprüfen Sie die Internetverbindung und die SAMO-Server-Konfiguration
  • Falls die Kamera nicht funktioniert: Überprüfen Sie in den iOS-Einstellungen, dass die App Kamerazugriff hat
  • Falls Berechtigungen fehlen: Öffnen Sie die App-Einstellungen unter iOS → SAMO Infra Tracker → Berechtigungen

Kartenfunktionen

• Basiskarte: Standard-Kartenansicht mit Straßen und Gelände
• Zoomfunktionen: Pinch-to-Zoom und Doppeltipp
• Positionsanzeige: Aktuelle GPS-Position (blauer Punkt)
• Overlays und Annotations: Gasleitungen, GPS-Tracks, Schäden, Crosshair
• Karteninteraktion: Tap-Gesten, Höhenanpassung, automatisches Folgen

Hinweise und Tipps

• GPS-Genauigkeit: App im Freien verwenden, auf Signal warten
• Batterieverwaltung: Andere Apps schließen, Energiesparmodus nutzen
• Datenverbindung: Internetverbindung sicherstellen, Tracks werden lokal gespeichert
• Datenschutz und Sicherheit: Lokale Speicherung, Passwort-Sicherheit, GPS-Daten nur während Sessions
• Leistungsoptimierung: App neu starten, Karten-Cache nutzen, Feature-Limits beachten

Support und Fehlerbehebung

• Verbindungsprobleme: SAMO URL, Benutzername, Passwort prüfen
• GPS-Probleme: Standortdienste aktivieren, App neu starten
• Track-Upload-Probleme: Internetverbindung und Konfiguration prüfen
• Fehlermeldungen: Hinweise zu typischen Meldungen
• Kontakt und weitere Hilfe: IT-Administrator oder SAMO-Systemverwalter kontaktieren
• Systemanforderungen überprüfen: iOS-Version, Speicherplatz, Standortdienste

Bekannte Meldungen

• "Server antwortet, aber Fehler: Status 401": Verbindung zum Server steht, aber Anmeldedaten oder Berechtigung sind ungültig. Benutzer, Passwort und Rollen im Backend prüfen.
• "Fehler beim Laden der Features: typeMismatch... Expected to decode Double but found an array": Die Backend-Antwort enthält Geometrie-Koordinaten in einem unerwarteten Format. In diesem Fall Feature-Typ und Geometrieschema im SAMO-System prüfen.
• "Bitte zuerst einen GPS Track starten": Vor einer Schadenserfassung muss zuerst ein Track gestartet werden.

Video: SAMO Infra Tracker Vorschau

Anhang

• Technische Spezifikationen: Unterstützte Koordinatensysteme, GPS-Genauigkeit, Datenformate, Offline-Funktionen
• Versionsinformationen: Siehe App-Info in iOS-Einstellungen

Diese Anleitung wurde für SAMO Infra Tracker erstellt. Bei Fragen oder Problemen wenden Sie sich an Ihren Systemadministrator.