de.westnordost.osmapi.map

Class MapDataHistoryApi

java.lang.Object

de.westnordost.osmapi.map.MapDataHistoryApi

public class MapDataHistoryApi
extends java.lang.Object

Get old versions of map data. Note that the (complete) history of certain elements in the OSM database can be extremely large and may take minutes to load.

Constructor Summary

Constructors

Constructor and Description
MapDataHistoryApi(de.westnordost.osmapi.OsmConnection osm)
MapDataHistoryApi(de.westnordost.osmapi.OsmConnection osm, MapDataFactory factory)

Method Summary

Modifier and Type	Method and Description
void	getNodeHistory(long id, de.westnordost.osmapi.common.Handler<Node> handler) Feeds all versions of the given node to the handler.
Node	getNodeVersion(long id, int version) Note that if not logged in, the Changeset for each returned element will be null
void	getRelationHistory(long id, de.westnordost.osmapi.common.Handler<Relation> handler) Feeds all versions of the given relation to the handler.
Relation	getRelationVersion(long id, int version) Note that if not logged in, the Changeset for each returned element will be null
void	getWayHistory(long id, de.westnordost.osmapi.common.Handler<Way> handler) Feeds all versions of the given way to the handler.
Way	getWayVersion(long id, int version) Note that if not logged in, the Changeset for each returned element will be null

Methods inherited from class java.lang.Object

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

Constructor Detail

MapDataHistoryApi

public MapDataHistoryApi(de.westnordost.osmapi.OsmConnection osm,
                         MapDataFactory factory)

MapDataHistoryApi

public MapDataHistoryApi(de.westnordost.osmapi.OsmConnection osm)

Method Detail

getNodeHistory

public void getNodeHistory(long id,
                           de.westnordost.osmapi.common.Handler<Node> handler)

Feeds all versions of the given node to the handler. The elements are sorted by version, the oldest version is the first, the newest version is the last element.
If not logged in, the Changeset for each returned element will be null

Parameters:

id - the id of the node

handler - the handler to which to feed the data to

Throws:

de.westnordost.osmapi.common.errors.OsmNotFoundException - if the node has not been found.

getWayHistory

public void getWayHistory(long id,
                          de.westnordost.osmapi.common.Handler<Way> handler)

Feeds all versions of the given way to the handler. The elements are sorted by version, the oldest version is the first, the newest version is the last element.
If not logged in, the Changeset for each returned element will be null

Parameters:

id - the id of the way

handler - the handler to which to feed the data to

Throws:

de.westnordost.osmapi.common.errors.OsmNotFoundException - if the node has not been found.

getRelationHistory

public void getRelationHistory(long id,
                               de.westnordost.osmapi.common.Handler<Relation> handler)

Feeds all versions of the given relation to the handler. The elements are sorted by version, the oldest version is the first, the newest version is the last element.
If not logged in, the Changeset for each returned element will be null

Parameters:

id - the id of the relation

handler - the handler to which to feed the data to

Throws:

de.westnordost.osmapi.common.errors.OsmNotFoundException - if the node has not been found.

getNodeVersion

public Node getNodeVersion(long id,
                           int version)

Note that if not logged in, the Changeset for each returned element will be null

Parameters:

id - the id of the node

version - the version of the node to retrieve

Returns:

the given version of the given element or null if either the node or given the version of the node does not exist (anymore).

getWayVersion

public Way getWayVersion(long id,
                         int version)

Note that if not logged in, the Changeset for each returned element will be null

Parameters:

id - the id of the way

version - the version of the way to retrieve

Returns:

the given version of the given element or null if either the node or given the version of the node does not exist (anymore).

getRelationVersion

public Relation getRelationVersion(long id,
                                   int version)

Note that if not logged in, the Changeset for each returned element will be null

Parameters:

id - the id of the relation

version - the version of the relation to retrieve

Returns:

the given version of the given element or null if either the node or given the version of the node does not exist (anymore).