parseLatitudeOrLongitudeValue static method

num? parseLatitudeOrLongitudeValue(
  1. String? s, [
  2. bool onlyWithCardinals = false
])

Parses a latitude or longitude value, such as 10.5N, 10.5°S, -20.25, 20,25W or 123.

  • The cardinals S and W negate the value; N and E keep it.
  • An explicit sign wins over the cardinal.
  • Both . and , are accepted as decimal separator (10,5 is 10.5).
  • An unknown cardinal letter is ignored.
  • If onlyWithCardinals is true, a value with an explicit sign, without a cardinal or with an unknown cardinal returns null.

Returns null if s is null or the whole (trimmed) s doesn't match geolocationFormat (it never throws).

Implementation

static num? parseLatitudeOrLongitudeValue(
  String? s, [
  bool onlyWithCardinals = false,
]) {
  if (s == null) return null;

  var match = _geolocationFormatFull.firstMatch(s.trim());
  if (match == null) return null;

  var signal = match.group(1)!;
  var number = match.group(2)!.replaceFirst(',', '.');
  var cardinal = match.group(3)!.toUpperCase();

  var value = double.tryParse(number);
  if (value == null) return null;

  if (signal.isNotEmpty) {
    if (onlyWithCardinals) return null;
    return signal == '-' ? -value : value;
  }

  switch (cardinal) {
    case 'N':
    case 'E':
      return value;
    case 'S':
    case 'W':
      return -value;
  }

  if (onlyWithCardinals) return null;
  return value;
}