tessl/pypi-pynmea2

Python library for parsing and generating NMEA 0183 protocol messages used in GPS and marine navigation systems

1.11x

Overview

Eval results

Files

GPS Coordinate Formatter

Name: tessl/pypi-pynmea2
Rating: 0.77 (1 reviews)
Author: tessl

A utility that reads GPS position data from NMEA sentences and formats the coordinates in multiple representations.

Capabilities

Parse NMEA Position Sentences

Parse NMEA sentences containing GPS position data to extract coordinate information.

Given "$GPGGA,123519,4807.038,N,01131.000,E,1,08,0.9,545.4,M,46.9,M,,*47", extract latitude as 48.1173 and longitude as 11.5167 @test
Given "$GPRMC,123519,A,4807.038,N,01131.000,E,022.4,084.4,230394,003.1,W*6A", extract latitude as 48.1173 and longitude as 11.5167 @test
Given "$GPGLL,4807.038,N,01131.000,E,123519,A,*1E", extract latitude as 48.1173 and longitude as 11.5167 @test

Format Coordinates in Multiple Representations

Convert and format coordinates into different notations commonly used in GPS applications.

Given latitude 48.1173 and longitude 11.5167, format as "48.1173° N, 11.5167° E" @test
Given latitude 48.1173 and longitude 11.5167, format as "48° 7.038' N, 11° 31.002' E" @test
Given latitude -33.8688 and longitude 151.2093, format as "33° 52' 7.68" S, 151° 12' 33.48" E" @test

Handle Coordinate Directions

Properly handle and display coordinate direction indicators (N/S for latitude, E/W for longitude).

When formatting latitude 37.7749, display as "37.7749° N" (positive is North) @test
When formatting longitude -122.4194, display as "122.4194° W" (negative is West) @test

Implementation

@generates

API

def parse_position_sentence(nmea_sentence: str) -> dict:
    """
    Parse an NMEA sentence containing position data and return coordinate information.

    Args:
        nmea_sentence: A valid NMEA sentence string (GGA, RMC, or GLL)

    Returns:
        A dictionary containing:
        - 'latitude': float value in decimal degrees (negative for South)
        - 'longitude': float value in decimal degrees (negative for West)
        - 'sentence_type': the type of sentence parsed (e.g., 'GGA', 'RMC', 'GLL')

    Raises:
        ValueError: If the sentence cannot be parsed or doesn't contain position data
    """
    pass


def format_decimal_degrees(latitude: float, longitude: float) -> str:
    """
    Format coordinates as decimal degrees with direction indicators.

    Args:
        latitude: Latitude in decimal degrees
        longitude: Longitude in decimal degrees

    Returns:
        Formatted string in format: "DD.DDDD° N/S, DD.DDDD° E/W"
        Example: "37.7749° N, 122.4194° W"
    """
    pass


def format_degrees_minutes(latitude: float, longitude: float) -> str:
    """
    Format coordinates as degrees and decimal minutes with direction indicators.

    Args:
        latitude: Latitude in decimal degrees
        longitude: Longitude in decimal degrees

    Returns:
        Formatted string in format: "DD° MM.MMM' N/S, DD° MM.MMM' E/W"
        Example: "37° 46.494' N, 122° 25.164' W"
    """
    pass


def format_degrees_minutes_seconds(latitude: float, longitude: float) -> str:
    """
    Format coordinates as degrees, minutes, and seconds with direction indicators.

    Args:
        latitude: Latitude in decimal degrees
        longitude: Longitude in decimal degrees

    Returns:
        Formatted string in format: 'DD° MM\' SS" N/S, DD° MM\' SS" E/W'
        Example: "37° 46' 29.64\" N, 122° 25' 9.84\" W"
    """
    pass

Dependencies { .dependencies }

pynmea2 { .dependency }

Provides NMEA sentence parsing and coordinate conversion support.

Install with Tessl CLI

npx tessl i tessl/pypi-pynmea2