https://github.com/thomersch/gosmparse

Processing OpenStreetMap PBF files at speed with Go
https://github.com/thomersch/gosmparse

go golang openstreetmap osm parser pbf protobuf

Last synced: about 2 months ago
JSON representation

Processing OpenStreetMap PBF files at speed with Go

• Host: GitHub
• URL: https://github.com/thomersch/gosmparse
• Owner: thomersch
• License: mit
• Created: 2015-11-06T21:03:49.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2024-03-13T21:28:30.000Z (10 months ago)
• Last Synced: 2024-06-18T20:22:46.739Z (7 months ago)
• Topics: go, golang, openstreetmap, osm, parser, pbf, protobuf
• Language: Go
• Homepage:
• Size: 351 KB
• Stars: 60
• Watchers: 8
• Forks: 7
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# OpenStreetMap PBF Parser in Go

[![GoDoc](https://godoc.org/github.com/thomersch/gosmparse?status.svg)](https://godoc.org/github.com/thomersch/gosmparse)

gosmparse uses a callback driven API, which is stable ([Documentation](https://godoc.org/github.com/thomersch/gosmparse)).

It has been designed with performance and maximum usage convenience in mind; on an Intel Core i7-6820HQ with NVMe flash it is able to process ~75 MB/s, so a planet file can be processed in under 10 minutes. If you find possible speed-ups or other improvements, let me know.

## Characteristics

* fast

* tested with different files from different sources/generators

* more than 85% test coverage and benchmarks for all hot spots

* one dependency only: [protobuf package](google.golang.org/protobuf) (a few more are used by tests and are included in the module)

* can read from any io.Reader (e.g. for parsing during download)

* supports history files

### Non-Features

* Does not build geometries

* No element cache

## Install

```

go get -u github.com/thomersch/gosmparse

```

## Example Usage

```go

// Implement the gosmparser.OSMReader interface here.

// Streaming data will call those functions.

type dataHandler struct{}

func (d *dataHandler) ReadNode(n gosmparse.Node)         {}

func (d *dataHandler) ReadWay(w gosmparse.Way)           {}

func (d *dataHandler) ReadRelation(r gosmparse.Relation) {}

func ExampleNewDecoder() {

	r, err := os.Open("filename.pbf")

	if err != nil {

		panic(err)

	}

	dec := gosmparse.NewDecoder(r)

	// Parse will block until it is done or an error occurs.

	err = dec.Parse(&dataHandler{})

	if err != nil {

		panic(err)

	}

}

```

## Download & Parse

It is possible to parse during download, so you don't have to wait for a download to finish to be able to start the parsing/processing. You can simply use the standard Go `net/http` package and pass `resp.Body` to the decoder.

```go

resp, err := http.Get("http://download.geofabrik.de/europe/germany/bremen-latest.osm.pbf")

if err != nil {

	panic(err)

}

defer resp.Body.Close()

dec := gosmparse.NewDecoder(resp.Body)

err = dec.Parse(&dataHandler{})

if err != nil {

	panic(err)

}

```

## Did it break?

If you found a case, where gosmparse broke, please report it and provide the file that caused the failure.