generated from Grigo/AndroidTemplate
ОС Программист
143 lines
7.6 KiB
Markdown
143 lines
7.6 KiB
Markdown
# Гибридный 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 парсинг только для дополнительных данных
|
||
|
||
## Использование
|
||
|
||
### Включение гибридного режима
|
||
```java
|
||
// В AppController
|
||
nmeaParser.setHybridMode(true);
|
||
nmeaParser.setGPSLocationListener(gpsLocationListener);
|
||
|
||
// Запуск слушателей
|
||
appController.setGPSLocationEnabled(true); // Для координат
|
||
appController.setAndroidNMEAEnabled(true); // Для дополнительных данных
|
||
```
|
||
|
||
### Получение данных
|
||
```java
|
||
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`, который демонстрирует работу гибридного подхода:
|
||
|
||
```java
|
||
GPSHybridTest test = new GPSHybridTest(context);
|
||
test.startTest(); // Запускает тест
|
||
test.stopTest(); // Останавливает тест
|
||
test.cleanup(); // Освобождает ресурсы
|
||
```
|
||
|
||
## Логирование
|
||
|
||
Приложение ведет детальное логирование для отладки:
|
||
|
||
- `📍` - GPS Location данные
|
||
- `📡` - NMEA данные
|
||
- `📊` - DOP значения
|
||
- `🛰️` - Информация о спутниках
|
||
- `🚢` - Статус судна
|
||
|
||
## Заключение
|
||
|
||
Гибридный подход решает проблему нестабильности NMEA сообщений, обеспечивая надежное получение координат через Location API и дополнительных навигационных данных через NMEA. Это дает нам лучшее из двух миров: надежность Android системы и богатство морских навигационных данных.
|