osm

Documentation

Overview

Package osm extracts and manipulates OpenStreetMap (OSM) data. Refer to openstreetmap.org for more information about OSM data.

Index

• type Data
  • func ExtractFile(ctx context.Context, file string, keep KeepFunc) (*Data, error)
  • func ExtractPBF(ctx context.Context, rs io.ReadSeeker, keep KeepFunc) (*Data, error)
  • func ExtractTag(rs io.ReadSeeker, tag string, values ...string) (*Data, error)
  • func ExtractXML(ctx context.Context, rs io.ReadSeeker, keep KeepFunc) (*Data, error)
  • func (o *Data) Check() error
  • func (o *Data) CountTags() Tags
  • func (o *Data) Filter(keep KeepFunc) *Data
  • func (o *Data) Geom() ([]*GeomTags, error)
• type GeomTags
• type GeomType
  • func DominantType(gt []*GeomTags) (GeomType, error)
• type KeepFunc
  • func KeepBounds(b *geom.Bounds) KeepFunc
  • func KeepTags(tags map[string][]string) KeepFunc
• type ObjectType
• type TagCount
  • func (t *TagCount) DominantType() ObjectType
• type Tags
  • func CountTags(ctx context.Context, rs io.ReadSeeker) (Tags, error)
  • func (t *Tags) Filter(f func(*TagCount) bool) *Tags
  • func (t *Tags) Len() int
  • func (t *Tags) Less(i, j int) bool
  • func (t *Tags) Swap(i, j int)
  • func (t *Tags) Table() [][]string

Types

type Data

type Data struct {
	Nodes     map[osm.NodeID]*osm.Node
	Ways      map[osm.WayID]*osm.Way
	Relations map[osm.RelationID]*osm.Relation
	// contains filtered or unexported fields
}

Data holds OpenStreetMap data and relationships.

func ExtractFile

func ExtractFile(ctx context.Context, file string, keep KeepFunc) (*Data, error)

ExtractFile extracts OpenStreetMap data from the given file path, determining whether it is an XML or PBF file from the extension (.osm or .pbf, respectively). keep determines which records are included in the output.

func ExtractPBF

func ExtractPBF(ctx context.Context, rs io.ReadSeeker, keep KeepFunc) (*Data, error)

ExtractPBF extracts OpenStreetMap data from osm.pbf file rs. keep determines which records are included in the output.

func ExtractTag

func ExtractTag(rs io.ReadSeeker, tag string, values ...string) (*Data, error)

ExtractTag extracts OpenStreetMap data with the given tag set to one of the given values.

func ExtractXML

func ExtractXML(ctx context.Context, rs io.ReadSeeker, keep KeepFunc) (*Data, error)

ExtractXML extracts OpenStreetMap data from osm file rs. keep determines which records are included in the output.

func (*Data) Check

func (o *Data) Check() error

Check checks OSM data to ensure that all necessary components are present.

func (*Data) CountTags

func (o *Data) CountTags() Tags

CountTags returns the different tags in the receiver and the number of instances of each one.

func (*Data) Filter

func (o *Data) Filter(keep KeepFunc) *Data

Filter returns a copy of the receiver where only objects selected by keep are retained.

func (*Data) Geom

func (o *Data) Geom() ([]*GeomTags, error)

Geom converts the OSM data to geometry objects, keeping the tag information.

type GeomTags

type GeomTags struct {
	geom.Geom
	Tags map[string][]string
}

GeomTags holds a geometry object and the tags that apply to it.

type GeomType

type GeomType int

const (
	Point GeomType = iota
	Line
	Poly
	Collection
)

func DominantType

func DominantType(gt []*GeomTags) (GeomType, error)

DominantType returns the most frequently occurring type among the given features.

type KeepFunc

type KeepFunc func(d *Data, object interface{}) bool

KeepFunc is a function that determines whether an OSM object should be included in the output. The object may be either *osmpbf.Node, *osmpbf.Way, or *osmpbf.Relation

func KeepBounds

func KeepBounds(b *geom.Bounds) KeepFunc

KeepBounds keeps OSM objects that overlap with b. Using KeepBounds in combination with other KeepFuncs may result in unexpected results.

func KeepTags

func KeepTags(tags map[string][]string) KeepFunc

KeepTags keeps OSM objects that contain the given tag key with at least one of the given tag values, where the keys and values correspond to the keys and values of the 'tags' input. If no tag valuse are given, then all object with the given key will be kept.

type ObjectType

type ObjectType int

ObjectType specifies the valid OpenStreetMap types.

const (
	// Node is an OpenStreetMap node.
	Node ObjectType = iota
	// Way can be either open or closed.
	Way
	// ClosedWay is an OpenStreetMap way that is closed (i.e., a polygon).
	ClosedWay
	// OpenWay is an OpenStreetMap way that is open (i.e., a line string).
	OpenWay
	// Relation is an OpenStreetMap relation.
	Relation
)

type TagCount

type TagCount struct {
	Key, Value  string
	ObjectCount map[ObjectType]int
	TotalCount  int
}

TagCount hold information about the number of instances of the specified tag in a database.

func (*TagCount) DominantType

func (t *TagCount) DominantType() ObjectType

DominantType returns the most frequently occuring ObjectType for this tag.

type Tags

type Tags []*TagCount

Tags holds information about the tags that are in a database.

func CountTags

func CountTags(ctx context.Context, rs io.ReadSeeker) (Tags, error)

CountTags returns the different tags in the database and the number of instances of each one.

func (*Tags) Filter

func (t *Tags) Filter(f func(*TagCount) bool) *Tags

Filter applies function f to all records in the receiver and returns a copy of the receiver that only contains the records for which f returns true.

func (*Tags) Len

func (t *Tags) Len() int

Len returns the length of the receiver to implement the sort.Sort interface.

func (*Tags) Less

func (t *Tags) Less(i, j int) bool

Less returns whether item i is less than item j to implement the sort.Sort interface.

func (*Tags) Swap

func (t *Tags) Swap(i, j int)

Swap swaps elements i and j to implement the sort.Sort interface.

func (*Tags) Table

func (t *Tags) Table() [][]string

Table creates a table of the information held by the receiver.