eu.slipo.athenarc.triplegeo.osm

Class OSMRecordBuilder

java.lang.Object

eu.slipo.athenarc.triplegeo.osm.OSMRecordBuilder

public class OSMRecordBuilder
extends java.lang.Object

Creates OSM record objects that contain all geospatial and thematic information from OSM elements (nodes, ways, relations).

Version:

2.0

Author:

Kostas Patroumpas

Field Summary

Fields

Modifier and Type	Field and Description
static java.util.List<OSMFilter>	filters
private com.vividsolutions.jts.geom.GeometryFactory	geometryFactory
java.util.List<OSMRelation>	incompleteRelations
OSMIndex	nodeIndex
OSMIndex	relationIndex
OSMIndex	wayIndex

Constructor Summary

Constructors

Constructor and Description
OSMRecordBuilder(java.util.List<OSMFilter> tagFilters)

Method Summary

Modifier and Type	Method and Description
OSMRecord	createOSMRecord(OSMNode n) Constructs an OSMRecord object from a parsed OSM node.
OSMRecord	createOSMRecord(OSMRelation r) Constructs an OSMRecord object from a parsed OSM relation.
OSMRecord	createOSMRecord(OSMWay w) Constructs an OSMRecord object from a parsed OSM way.
private static java.lang.String	getCategory(java.util.Map<java.lang.String,java.lang.String> tags) Assign a category to a OSM feature (node, way, or relation) based on its tags.
private static java.lang.String	getCategoryRecursive(OSMFilter filter, java.util.Map<java.lang.String,java.lang.String> tags, java.lang.String key) Recursively search in the classification hierarchy to match the given tag (key).
private int	rearrangeRings(com.vividsolutions.jts.geom.LineString[] ways, int numWays, com.vividsolutions.jts.geom.LinearRing[] rings, int numRings) Examines all OSM way objects and checks whether they can construct a new ring (closed polyline) or update an existing one.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

filters

public static java.util.List<OSMFilter> filters

geometryFactory

private com.vividsolutions.jts.geom.GeometryFactory geometryFactory

nodeIndex

public OSMIndex nodeIndex

wayIndex

public OSMIndex wayIndex

relationIndex

public OSMIndex relationIndex

incompleteRelations

public java.util.List<OSMRelation> incompleteRelations

Constructor Detail

OSMRecordBuilder

public OSMRecordBuilder(java.util.List<OSMFilter> tagFilters)

Method Detail

getCategory

private static java.lang.String getCategory(java.util.Map<java.lang.String,java.lang.String> tags)

Assign a category to a OSM feature (node, way, or relation) based on its tags.

Parameters:

tags - Key-value pairs for OSM tags and their respective values for a given feature.

Returns:

A category according to the classification scheme based on OSM tags.

getCategoryRecursive

private static java.lang.String getCategoryRecursive(OSMFilter filter,
                                                     java.util.Map<java.lang.String,java.lang.String> tags,
                                                     java.lang.String key)

Recursively search in the classification hierarchy to match the given tag (key).

Parameters:

filter - Correspondence of OSM tags into categories.

tags - Key-value pairs for OSM tags and their respective values for a given feature.

key - Tag at any level in the classification hierarchy.

Returns:

The name of the corresponding category.

createOSMRecord

public OSMRecord createOSMRecord(OSMNode n)

Constructs an OSMRecord object from a parsed OSM node.

Parameters:

n - A parsed OSM node.

Returns:

An OSMRecord object as a record with specific attributes extracted from the OSM node.

createOSMRecord

public OSMRecord createOSMRecord(OSMWay w)

Constructs an OSMRecord object from a parsed OSM way.

Parameters:

w - A parsed OSM way.

Returns:

An OSMRecord object as a record with specific attributes extracted from the OSM way.

rearrangeRings

private int rearrangeRings(com.vividsolutions.jts.geom.LineString[] ways,
                           int numWays,
                           com.vividsolutions.jts.geom.LinearRing[] rings,
                           int numRings)

Examines all OSM way objects and checks whether they can construct a new ring (closed polyline) or update an existing one.

Parameters:

ways - Array of all the OSM ways identified in the feature.

numWays - Number of OSM ways identified.

rings - Array of all linear rings identified in the feature.

numRings - Number of linear rings identified.

Returns:

The amount of rings (internal or external, depending on call) identified in the given feature.

createOSMRecord

public OSMRecord createOSMRecord(OSMRelation r)

Constructs an OSMRecord object from a parsed OSM relation. CAUTION! Sometimes, this process may yield topologically invalid geometries, because of irregularities (e.g., self-intersections) tolerated by OSM!

Parameters:

r - A parsed OSM relation.

Returns:

An OSMRecord object as a record with specific attributes extracted from the OSM relation.