AndroidAisMap/GPS_HYBRID_APPROACH.md

Гибридный GPS подход в AISMap

Проблема

Изначально приложение пыталось получать все GPS данные через NMEA сообщения, но столкнулось с нестабильностью получения RMC сообщений (курс, скорость). NMEA сообщения могут приходить нерегулярно или вообще не приходить, что делает невозможным получение критически важной навигационной информации.

Решение: Гибридный подход

Мы реализовали гибридный подход, который комбинирует два источника данных:

1. Android Location API (основной источник координат)

• Что получаем: Координаты (широта/долгота), точность, время фикса, качество фикса
• Преимущества: Стабильный, надежный, работает на всех устройствах
• Класс: GPSLocationListener

2. NMEA сообщения (дополнительные данные)

• Что получаем: Курс, скорость, количество спутников, DOP (PDOP/HDOP/VDOP), высота
• Преимущества: Детальная навигационная информация, стандарт морской навигации
• Класс: AndroidNMEAListener + NMEAParser

Архитектура

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   MainActivity  │    │  AppController   │    │   MapInterface  │
└─────────────────┘    └──────────────────┘    └─────────────────┘
         │                       │                       │
         │                       │                       │
         ▼                       ▼                       ▼
┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│ GPSLocation     │    │   NMEAParser     │    │   Карта         │
│ Listener        │    │   (гибридный)    │    │                 │
│ (координаты)    │    │   (курс, DOP)    │    │                 │
└─────────────────┘    └──────────────────┘    └─────────────────┘
         │                       │
         │                       │
         ▼                       ▼
┌─────────────────┐    ┌──────────────────┐
│ Android NMEA    │    │   UDP Listener   │
│ Listener        │    │   (AIS данные)   │
│ (NMEA сообщения)│    │                  │
└─────────────────┘    └──────────────────┘

Ключевые компоненты

GPSLocationListener

• Получает координаты через LocationManager.requestLocationUpdates()
• Отслеживает количество спутников через GnssStatus.Callback
• Предоставляет точность позиции в метрах
• Определяет качество фикса (GPS, DGPS, RTK)

NMEAParser (гибридный режим)

• В гибридном режиме НЕ обновляет координаты из NMEA
• Парсит только дополнительные данные:
  • GGA: количество спутников, высота
  • RMC: курс, скорость
  • VTG: курс, скорость (альтернативный источник)
  • GSA: DOP значения, активные спутники
  • GSV: спутники в поле зрения

AppController

• Координирует работу всех компонентов
• Объединяет данные из разных источников в единый объект Vessel
• Управляет жизненным циклом слушателей

Преимущества гибридного подхода

✅ Надежность

• Координаты всегда доступны через Location API
• Не зависит от стабильности NMEA сообщений

✅ Полнота данных

• Получаем все необходимые навигационные параметры
• DOP значения для оценки качества GPS

✅ Совместимость

• Работает на всех версиях Android
• Поддерживает как старый GPS API, так и новый GNSS API

✅ Производительность

• Location API оптимизирован системой
• NMEA парсинг только для дополнительных данных

Использование

Включение гибридного режима

// В AppController
nmeaParser.setHybridMode(true);
nmeaParser.setGPSLocationListener(gpsLocationListener);

// Запуск слушателей
appController.setGPSLocationEnabled(true);    // Для координат
appController.setAndroidNMEAEnabled(true);    // Для дополнительных данных

Получение данных

Vessel vessel = appController.getOwnVessel();

// Координаты (из Location API)
double lat = vessel.getLatitude();
double lon = vessel.getLongitude();
float accuracy = vessel.getAccuracy();

// Навигационные данные (из NMEA)
double course = vessel.getCourse();
double speed = vessel.getSpeed();
int satellites = vessel.getSatellites();

// Качество GPS (из NMEA + Location API)
double pdop = vessel.getPdop();
double hdop = vessel.getHdop();
double vdop = vessel.getVdop();
String quality = vessel.getGPSQualityDescription();

Тестирование

Для тестирования создан класс GPSHybridTest, который демонстрирует работу гибридного подхода:

GPSHybridTest test = new GPSHybridTest(context);
test.startTest();  // Запускает тест
test.stopTest();   // Останавливает тест
test.cleanup();    // Освобождает ресурсы

Логирование

Приложение ведет детальное логирование для отладки:

• 📍 - GPS Location данные
• 📡 - NMEA данные
• 📊 - DOP значения
• 🛰️ - Информация о спутниках
• 🚢 - Статус судна

Заключение

Гибридный подход решает проблему нестабильности NMEA сообщений, обеспечивая надежное получение координат через Location API и дополнительных навигационных данных через NMEA. Это дает нам лучшее из двух миров: надежность Android системы и богатство морских навигационных данных.