[OSM-dev] [ANN] https://github.com/karlwettin/osm-common

[Karl Wettin]

I've implemented a Java lib for accessing OSM services, parsing and processing data. Thought that perhaps someone else is interested in it.

<https://github.com/karlwettin/osm-common>

Best documentation is found in test cases.

API mainly include support for Nominatim, Overpass, changeset stores and osm.xml-parsing.


/** RAM-store for keeping track of OSM objects */
se.kodapan.osm.domain:Root
#get(id):OsmObject
#add(osmObject)

se.kodapan.osm.domain:OsmObject 
#getId():long
#setTag(key, value)
#getTag(key) 

se.kodapan.osm.domain:Node extends OsmObject
se.kodapan.osm.domain:Way extends OsmObject
se.kodapan.osm.domain:Relation extends OsmObject

/** Create, update and delete OSM objects in a Root based on the content of an .osm.xml  */
se.kodapan.osm.data.planet.parser.xml.instantiated:InstantiatedOsmXmlParser
#setRoot(root)  
#read(xml)

/** Streaming API for processing those TB-sized osm.xml-files */
se.kodapan.osm.data.planet.parser.xml.streaming:StreamingOsmXmlParser
#read(xml)
#processParsedNode(node)
#processParsedWay(way)
#processParsedRelation(relation)


/** For processing http://download.geofabrik.de and what not */
se.kodapan.osm.data.planet.changesetstore:ChangesetStore
#setBaseUrl() 
#findFirstChangesetStateSince(timestamp) 
#findChangesetStatesSince(timestamp)

se.kodapan.osm.services.overpass:Overpass
se.kodapan.osm.services.overpass:FileSystemCachedOverpass
#execute(query):String

se.kodapan.osm.services.nominatim:Nominatim
se.kodapan.osm.services.nominatim:FileSystemCachedNominatim
#search(query):String

se.kodapan.osm.services.nominatim:NominatimJsonResponseParser
#setRoot(root)
#parse(nominatimJsonResponse):List<NominatimJsonResponseParser.Result>

se.kodapan.osm.services.nominatim:NominatimJsonResponseParser.Result
#getImportance():double
#getObject:OsmObject


se.kodapan.osm.services.nominatim:NominatimQueryBuilder
#build():String
#setBaseURL(url)
#setFormat(format)
#setQuery(query)
#addCountryCode(iso)
#setLimit(limit)
...


There is also a bit of tools surrounding this API such as filters to remove matching OsmObjects from a collection, minor distance metrics and such. 


I hope you find this useful.



					kalle