using System;
using System.ComponentModel;
using System.Linq;
using NewLife.XCoder.Tools.Gps;
using Xunit;
namespace XCoder.App.Tests;
/// <summary>GPS 定位数据解析</summary>
public class GpsParserTests
{
/// <summary>按 NMEA 规则补上校验和</summary>
private static String Nmea(String body)
{
var sum = 0;
foreach (var c in body) sum ^= c;
return $"${body}*{sum:X2}";
}
[Fact]
[DisplayName("NMEA 度分格式转换为十进制度")]
public void ParseCoordinate_DegreeMinute()
{
// 31°12.3456' = 31 + 12.3456/60 ≈ 31.20576
var lat = GpsParser.ParseCoordinate("3112.3456", "N");
Assert.NotNull(lat);
Assert.Equal(31.20576, lat!.Value, 5);
}
[Fact]
[DisplayName("南纬与西经为负值")]
public void ParseCoordinate_SouthWest_IsNegative()
{
Assert.True(GpsParser.ParseCoordinate("3112.3456", "S") < 0);
Assert.True(GpsParser.ParseCoordinate("12130.6789", "W") < 0);
}
[Theory]
[DisplayName("非法度分输入返回空")]
[InlineData("")]
[InlineData("3112")]
[InlineData("3160.0000")] // 分达到 60
[InlineData("abc.def")]
public void ParseCoordinate_Invalid_ReturnsNull(String value)
{
Assert.Null(GpsParser.ParseCoordinate(value, "N"));
}
[Fact]
[DisplayName("度分输入为空时返回空")]
public void ParseCoordinate_Null_ReturnsNull()
{
Assert.Null(GpsParser.ParseCoordinate(null, "N"));
}
[Fact]
[DisplayName("校验和正确时通过,被篡改时拒绝")]
public void CheckSum_Works()
{
var line = Nmea("GPRMC,083559.00,A,3112.3456,N,12130.6789,E,0.004,77.52,091202,,,A");
Assert.True(GpsParser.CheckSum(line));
Assert.False(GpsParser.CheckSum(line[..^2] + "FF"));
Assert.False(GpsParser.CheckSum("GPRMC,123"));
}
[Fact]
[DisplayName("解析 RMC 语句得到坐标与时间")]
public void ParseNmea_Rmc()
{
var line = Nmea("GPRMC,083559.00,A,3112.3456,N,12130.6789,E,0.004,77.52,091202,,,A");
var fix = GpsParser.ParseNmea(line);
Assert.NotNull(fix);
Assert.Equal(31.20576, fix!.Latitude, 5);
Assert.Equal(121.511315, fix.Longitude, 5);
Assert.Equal("GPRMC", fix.Source);
Assert.NotNull(fix.Time);
Assert.Equal(8, fix.Time!.Value.Hour);
Assert.Equal(35, fix.Time.Value.Minute);
Assert.Equal(0.004, fix.SpeedKnots!.Value, 6);
}
[Fact]
[DisplayName("RMC 定位状态为 V 时视为无效")]
public void ParseNmea_RmcVoid_ReturnsNull()
{
var line = Nmea("GPRMC,083559.00,V,3112.3456,N,12130.6789,E,0.004,77.52,091202,,,A");
Assert.Null(GpsParser.ParseNmea(line));
}
[Fact]
[DisplayName("解析 GGA 语句得到卫星数与海拔")]
public void ParseNmea_Gga()
{
var line = Nmea("GPGGA,083559.00,3112.3456,N,12130.6789,E,1,08,0.9,32.5,M,46.9,M,,");
var fix = GpsParser.ParseNmea(line);
Assert.NotNull(fix);
Assert.Equal(8, fix!.Satellites);
Assert.Equal(32.5, fix.Altitude!.Value, 3);
Assert.Equal("GPGGA", fix.Source);
}
[Fact]
[DisplayName("GGA 定位质量为 0 时视为未定位")]
public void ParseNmea_GgaNoFix_ReturnsNull()
{
var line = Nmea("GPGGA,083559.00,,,,,0,00,99.9,,M,,M,,");
Assert.Null(GpsParser.ParseNmea(line));
}
[Fact]
[DisplayName("批量解析跳过空行、注释与非法语句")]
public void ParseNmeaBatch_FiltersInvalid()
{
var text = $"""
# 日志导出的示例
{Nmea("GPRMC,083559.00,A,3112.3456,N,12130.6789,E,0.004,77.52,091202,,,A")}
{Nmea("GPGGA,083600.00,3112.3500,N,12130.6800,E,1,08,0.9,32.5,M,46.9,M,,")}
$GPRMC,BAD,LINE
""";
var list = GpsParser.ParseNmeaBatch(text);
Assert.Equal(2, list.Count);
Assert.Equal("GPRMC", list[0].Source);
Assert.Equal("GPGGA", list[1].Source);
}
[Fact]
[DisplayName("没有语句时批量解析返回空清单")]
public void ParseNmeaBatch_Empty_ReturnsEmpty()
{
Assert.Empty(GpsParser.ParseNmeaBatch(null));
Assert.Empty(GpsParser.ParseNmeaBatch(" \r\n 没有语句 "));
}
[Fact]
[DisplayName("HEX 与单精度浮点可互相转换")]
public void HexAndSingle_RoundTrip()
{
var hex = GpsParser.SingleToHex(31.20576f);
Assert.Equal(8, hex.Length);
Assert.Equal(31.20576f, GpsParser.HexToSingle(hex), 4);
}
[Fact]
[DisplayName("十六进制长度不足或含非法字符时报参数错误")]
public void HexToSingle_Invalid_Throws()
{
Assert.Throws<ArgumentException>(() => GpsParser.HexToSingle("C3F5"));
Assert.Throws<ArgumentException>(() => GpsParser.HexToSingle("ZZZZZZZZ"));
Assert.Throws<ArgumentException>(() => GpsParser.HexToSingle(null));
}
[Fact]
[DisplayName("16 位合并坐标按前 8 后 8 拆分")]
public void TryParseCombined_Works()
{
var hex = GpsParser.SingleToHex(31.25f) + GpsParser.SingleToHex(121.5f);
Assert.True(GpsParser.TryParseCombined(hex, out var lat, out var lng));
Assert.Equal(31.25f, lat);
Assert.Equal(121.5f, lng);
}
[Fact]
[DisplayName("合并坐标长度不足时返回 false 而不抛异常")]
public void TryParseCombined_Short_ReturnsFalse()
{
Assert.False(GpsParser.TryParseCombined("C3F5", out _, out _));
Assert.False(GpsParser.TryParseCombined(null, out _, out _));
Assert.False(GpsParser.TryParseCombined("ZZZZZZZZZZZZZZZZ", out _, out _));
}
[Fact]
[DisplayName("同一点距离为零,纬度差 1 度约 111 公里")]
public void Distance_KnownValues()
{
Assert.Equal(0, GpsParser.Distance(31.2, 121.5, 31.2, 121.5), 3);
var d = GpsParser.Distance(0, 0, 1, 0);
Assert.InRange(d, 111_000, 111_400);
}
[Fact]
[DisplayName("轨迹里程为各段距离之和")]
public void TotalDistance_SumsSegments()
{
GpsFix[] points =
[
new(0, 0),
new(0, 1),
new(0, 2),
];
var total = GpsParser.TotalDistance(points);
Assert.InRange(total, 222_000, 222_800);
Assert.Equal(0, GpsParser.TotalDistance([points[0]]));
Assert.Equal(0, GpsParser.TotalDistance(null));
}
}
|