SAMO Infra Tracker ユーザーガイド

SAMO Infra Tracker について

SAMO Infra Tracker は、インフラ要素 (特にガス管) を GPS ベースで追跡・管理する iOS アプリです。GPS トラックを記録し、既存インフラ要素に関連付け、損傷報告を作成できます。

主な機能:

• GPS トラッキング: インフラ要素に沿った GPS トラックの記録
• 地図統合: ガス管と GPS トラックをインタラクティブ地図で表示
• SAMO 連携: データ管理のため SAMO バックエンドへ接続
• 損傷報告: インフラ損傷の記録と位置特定
• 設定可能な feature type: 異なる GIS データ構造への対応

インストール

システム要件

• iOS: 14.0 以上
• 端末: GPS 機能付き iPhone または iPad
• 空き容量: 最低 50 MB
• ネットワーク: SAMO バックエンド接続用インターネット

インストール手順

1. App Store インストール (利用可能な場合):
   • iOS 端末で App Store を開く
   • "SAMO Infra Tracker" を検索
   • "入手" をタップしてインストール完了まで待つ
2. Enterprise/TestFlight インストール:
   • 管理者の指示に従う
   • 必要に応じて証明書をインストール
   • 提供されたリンクからアプリをダウンロード
3. 初期設定:
   • インストール後にアプリを起動
   • 必要な権限を許可:
     • 位置情報: GPS トラッキングのため "常に"
     • ネットワーク: SAMO バックエンド接続用

はじめに

アプリ起動とメイン画面

• 地図表示: 可視化の中心となる地図
• インフォボックス: 画面下部のステータスメッセージ
• ツールバー: 上部の機能ボタン
• 管路リスト: 利用可能なガス管のスクロール一覧

ナビゲーション

• 設定: 歯車アイコン (⚙️)
• GPS トラッキング: 地球儀アイコン
• 選択解除: 消しゴムアイコン
• 新規トラック: パスアイコン

基本操作

1. 地図の拡大/縮小: ピンチ操作
2. 地図の移動: 1 本指でドラッグ
3. 地図高さ調整: 地図下の灰色バーをドラッグ
4. ガス管選択: 一覧の項目をタップ

設定

設定画面へのアクセス

1. 上部ツールバーの歯車アイコン (⚙️) をタップ
2. 複数の設定エリアを含む設定ページが開く

接続設定

• SAMO URL: SAMO バックエンドの完全 URL (例: https://samo.asseco-berit.ch/EZL)
• ユーザー: SAMO ユーザー名
• パスワード: SAMO パスワード (安全に保存)

オブジェクトタイプ設定

• ラインオブジェクト名: 線要素の名称 (既定: "Gasleitung")
• ポイントオブジェクト名: 点要素の名称 (既定: "Schaden")

SAMO Infra Tracker 設定

• GPS Track: GPS 記録用 feature type (例: ft_g_alg_tracking)
• GPS Relation: GPS 関連付け用 relation type (例: as_r_GAS_LEITUNG_TRACKING)
• GPS Role: relation 内の role (例: rt_tracking)
• Line (Gas pipeline) Type: ガス管用 feature type (例: ft_30015)
• Point (Damage) Type: 損傷報告用 feature type (例: ft_g_alg_damagereport)
• Point Relation: 損傷報告用 relation type
• Point Role: relation 内の損傷 role

設定の保存

• 変更後に "Konfiguration speichern" をタップ
• アプリ切替時にも設定は自動保存
• 再起動で保存済み設定を読み込み

GPS トラッキングと記録

1. ガス管を選択: 一覧からガス管を選択
2. GPS を開始: "GPS einschalten" をタップ
3. 自動追従: "Position automatisch aktualisieren" を有効化

• 管路なしトラック: 管路未選択でも新しいトラックを開始可能
• 連続記録: GPS ポイントを自動収集
• バックグラウンド記録: 画面ロック中も動作
• 高精度: 利用可能な最高 GPS 精度を使用
• バッテリー: 長時間記録向けに最適化
• 現在トラック: 地図上でポリラインとしてリアルタイム表示
• トラック状態: ボタンが "GPS einschalten" / "GPS ausschalten" で切替
• トラック情報: 距離と座標を計算
• 一時保存: トラックデータをローカル保存

新機能 (2026年5月)

最近の拡張機能

• 関連付けなしトラック: 管路未選択でもトラック作成とアップロードが可能
• "Position automatisch aktualisieren" オプション: 現在 GPS 位置に地図を追従可能
• アクティブトラック上の損傷記録: 実行中トラックに損傷を関連付け可能
• 設定画面で接続確認: HTTP ステータスを直接表示 (例: 401)
• 地図/feature 表示の安定化: 状態・エラーメッセージの視認性向上

GPS トラックの関連付けと管理

1. 自動関連付け: トラックは選択中のガス管に自動関連付け
2. SAMO へアップロード: トラックを SAMO バックエンドへ送信
3. トラックをリセット: "neuer Track" をタップ
4. トラック履歴: 記録済みトラックは保持
5. 状態監視: インフォボックスと視覚確認
6. 関連付けの問題対応: 問題時のヒントを表示

注: 管路未選択トラックは管路 relation なしで保存されます。それでも後で損傷記録の文脈として利用できます。

損傷報告

1. 損傷を記録: 前提条件、位置特定、説明、保存
2. 損傷情報: 座標、スイス座標、関連付け、アップロード
3. 損傷一覧と管理: 地図表示、バックエンド同期

• 管路アクティブ時: 選択中管路に損傷を関連付け
• 管路非アクティブ時: アクティブトラック ID に損傷を関連付け
• 前提: 実行中または作成済み GPS トラックが必要
• 入力: "Schaden beschreiben ..." に入力し、"Schaden erfassen" で送信

写真添付による損傷レポート

損傷レポートを記録する際に、写真を添付ファイルとしてアップロードできます。

ステップバイステップの手順:

1. 損傷記録ボタン: マップビューで「損傷を記録」ボタンをタップします
2. 損傷記録シートが開く: 次のフィールドを含むフォームが表示されます:
   • 現在の座標（GPS位置およびスイス座標）が自動的に表示されます
   • 損傷説明用のテキストフィールド
   • 写真を追加するためのボタン
3. 説明を入力: 損傷の意味のある説明を入力します（必須）
4. 写真を追加（オプション）:
   • 「写真を撮る」をタップして、カメラで新しい写真を撮ります
   • または「ライブラリから写真」をタップして、既存の写真を選択します
   • 選択した写真がプレビューに表示されます
5. 保存してアップロード: 「保存」をタップ
   • 損傷は最初にSAMO APIに転送されます
   • 写真が選択された場合、その後添付ファイルとしてアップロードされます
   • 確認メッセージが表示されます

重要なお知らせ:

• 権限: アプリはカメラとフォトライブラリへのアクセスが必要です。初回起動時またはiOS設定でこれらの権限を付与してください
• 写真要件:
  • サポート形式: JPEG、PNG
  • 最大サイズ: サーバーに依存（通常は最大10 MB）
  • 推奨解像度: 良好な品質のため少なくとも640x480ピクセル
• アップロード状態: 情報ボックスに、損傷と写真が正常にアップロードされたかどうかが表示されます
• 写真なし: 写真なしで損傷を記録することもできます。写真はオプションです
• トラブルシューティング:
  • 写真がアップロードされない場合: インターネット接続とSAMOサーバー構成を確認してください
  • カメラが機能しない場合: iOS設定でアプリがカメラにアクセスできることを確認してください
  • 権限がない場合: iOS → SAMO Infra Tracker → 権限でアプリ設定を開きます

地図機能

• ベースマップ: 道路と地形を含む標準地図
• ズーム: ピンチズームとダブルタップ
• 位置表示: 現在 GPS 位置 (青点)
• オーバーレイ/注釈: 管路、GPS トラック、損傷、クロスヘア
• 地図操作: タップ、高さ調整、自動追従

注意点とヒント

• GPS 精度: 屋外で使用し、安定した信号を待つ
• バッテリー管理: 他アプリを閉じ、省電力モードを利用
• データ接続: インターネット接続を確認。トラックはローカル保存も可能
• プライバシーと安全性: ローカル保存、パスワード保護、GPS データはセッション中のみ
• パフォーマンス最適化: アプリ再起動、地図キャッシュ利用、feature 上限に注意

サポートとトラブルシューティング

• 接続問題: SAMO URL、ユーザー名、パスワードを確認
• GPS 問題: 位置情報サービスを有効化、アプリ再起動
• トラックアップロード問題: ネット接続と設定を確認
• エラーメッセージ: 代表的なメッセージの案内を確認
• 連絡先: IT 管理者または SAMO システム管理者へ連絡
• 要件確認: iOS バージョン、空き容量、位置情報サービス

既知のメッセージ

• "Server antwortet, aber Fehler: Status 401": サーバー応答はあるが認証情報または権限が無効。ユーザー、パスワード、バックエンド権限を確認。
• "Fehler beim Laden der Features: typeMismatch... Expected to decode Double but found an array": バックエンドの geometry 座標形式が想定外。SAMO 側の feature type と geometry schema を確認。
• "Bitte zuerst einen GPS Track starten": 損傷報告の前に GPS トラック開始が必要。

動画: SAMO Infra Tracker プレビュー

付録

• 技術仕様: 対応座標系、GPS 精度、データ形式、オフライン機能
• バージョン情報: iOS 設定内のアプリ情報を参照

このガイドは SAMO Infra Tracker 用に作成されました。質問や問題がある場合はシステム管理者へ連絡してください。