Features

Installing

go get github.com/adrianmo/go-nmea

Staying up to date

Supported sentences

Examples

Built-in message parsing

package mainimport ("fmt""log""github.com/adrianmo/go-nmea")funcmain() {sentence:="$GPRMC,220516,A,5133.82,N,00042.24,W,173.8,231.8,130694,004.2,W*70"s,err:=nmea.Parse(sentence)iferr!=nil {log.Fatal(err)}ifs.DataType()==nmea.TypeRMC {m:=s.(nmea.RMC)fmt.Printf("Raw sentence: %v\n",m)fmt.Printf("Time: %s\n",m.Time)fmt.Printf("Validity: %s\n",m.Validity)fmt.Printf("Latitude GPS: %s\n",nmea.FormatGPS(m.Latitude))fmt.Printf("Latitude DMS: %s\n",nmea.FormatDMS(m.Latitude))fmt.Printf("Longitude GPS: %s\n",nmea.FormatGPS(m.Longitude))fmt.Printf("Longitude DMS: %s\n",nmea.FormatDMS(m.Longitude))fmt.Printf("Speed: %f\n",m.Speed)fmt.Printf("Course: %f\n",m.Course)fmt.Printf("Date: %s\n",m.Date)fmt.Printf("Variation: %f\n",m.Variation)}}

$ go run main/main.goRaw sentence: $GPRMC,220516,A,5133.82,N,00042.24,W,173.8,231.8,130694,004.2,W*70Time: 22:05:16.0000Validity: ALatitude GPS: 5133.8200Latitude DMS: 51° 33' 49.200000"Longitude GPS: 042.2400Longitude DMS: 0° 42' 14.400000"Speed: 173.800000Course: 231.800000Date: 13/06/94Variation: -4.200000

Customize sentence parser

p:= nmea.SentenceParser{CustomParsers:nil,ParsePrefix:nil,CheckCRC:nil,OnTagBlock:nil,}s,err:=p.Parse("$GPRMC,220516,A,5133.82,N,00042.24,W,173.8,231.8,130694,004.2,W*70")

TAG Blocks

package mainimport ("fmt""log""time""github.com/adrianmo/go-nmea")funcmain() {sentence:="\\s:Satelite_1,c:1553390539*62\\!AIVDM,1,1,,A,13M@ah0025QdPDTCOl`K6`nV00Sv,0*52"s,err:=nmea.Parse(sentence)iferr!=nil {log.Fatal(err)}parsed:=s.(nmea.VDMVDO)fmt.Printf("TAG Block timestamp: %v\n",time.Unix(parsed.TagBlock.Time,0))fmt.Printf("TAG Block source:    %v\n",parsed.TagBlock.Source)}

$  go run main/main.goTAG Block timestamp: 2019-03-24 14:22:19 +1300 NZDTTAG Block source:    Satelite_1

Custom message parsing

package mainimport ("fmt""github.com/adrianmo/go-nmea")// A type to hold the parsed recordtypeXYZTypestruct {nmea.BaseSentenceTime    nmea.TimeCounterint64LabelstringValuefloat64}funcmain() {// Do this once it will error if you register the same type multiple timeserr:=nmea.RegisterParser("XYZ",func(s nmea.BaseSentence) (nmea.Sentence,error) {// This example uses the package builtin parsing helpers// you can implement your own parsing logic alsop:=nmea.NewParser(s)returnXYZType{BaseSentence:s,Time:p.Time(0,"time"),Label:p.String(1,"label"),Counter:p.Int64(2,"counter"),Value:p.Float64(3,"value"),},p.Err()})iferr!=nil {panic(err)}sentence:="$00XYZ,220516,A,23,5133.82,W*42"s,err:=nmea.Parse(sentence)iferr!=nil {panic(err)}switchm:=s.(type) {caseXYZType:fmt.Printf("Raw sentence: %v\n",m)fmt.Printf("Time: %s\n",m.Time)fmt.Printf("Label: %s\n",m.Label)fmt.Printf("Counter: %d\n",m.Counter)fmt.Printf("Value: %f\n",m.Value)default:panic("Could not parse XYZ sentence")}}

$ go run main/main.goRaw sentence: $AAXYZ,220516,A,23,5133.82,W*42Time: 22:05:16.0000Label: ACounter: 23Value: 5133.820000

Message parsing with optional values

package mainimport ("fmt""github.com/adrianmo/go-nmea")// VTG represents track & speed data.// http://aprs.gids.nl/nmea/#vtgtypeVTGstruct {nmea.BaseSentenceTrueTrack        nmea.Float64MagneticTrack    nmea.Float64GroundSpeedKnots nmea.Float64GroundSpeedKPH   nmea.Float64}funcmain() {nmea.MustRegisterParser("VTG",func(s nmea.BaseSentence) (nmea.Sentence,error) {p:=nmea.NewParser(s)returnVTG{BaseSentence:s,TrueTrack:p.NullFloat64(0,"true track"),MagneticTrack:p.NullFloat64(2,"magnetic track"),GroundSpeedKnots:p.NullFloat64(4,"ground speed (knots)"),GroundSpeedKPH:p.NullFloat64(6,"ground speed (km/h)"),},p.Err()})sentence:="$GPVTG,140.88,T,,M,8.04,N,14.89,K,D*05"s,err:=nmea.Parse(sentence)iferr!=nil {panic(err)}m,ok:=s.(VTG)if!ok {panic("Could not parse VTG sentence")}fmt.Printf("Raw sentence: %v\n",m)fmt.Printf("TrueTrack: %v\n",m.TrueTrack)fmt.Printf("MagneticTrack: %v\n",m.MagneticTrack)fmt.Printf("GroundSpeedKnots: %v\n",m.GroundSpeedKnots)fmt.Printf("GroundSpeedKPH: %v\n",m.GroundSpeedKPH)}

$ go run main/main.goRaw sentence: $GPVTG,140.88,T,,M,8.04,N,14.89,K,D*05TrueTrack: {140.88 true}MagneticTrack: {0 false}GroundSpeedKnots: {8.04 true}GroundSpeedKPH: {14.89 true}

Contributing

License