de.westnordost.osmapi.map

Class MapDataDao

java.lang.Object

de.westnordost.osmapi.map.MapDataDao

public class MapDataDao
extends java.lang.Object

Get and upload changes to map data

Constructor Summary

Constructors

Constructor and Description
MapDataDao(OsmConnection osm)
MapDataDao(OsmConnection osm, MapDataFactory factory)

Method Summary

Modifier and Type	Method and Description
void	closeChangeset(long changesetId) Closes the given changeset.
void	getMap(BoundingBox bounds, MapDataHandler handler) Feeds map data to the given MapDataHandler.
Node	getNode(long id)
java.util.List<Node>	getNodes(java.util.Collection<java.lang.Long> nodeIds)
Relation	getRelation(long id)
void	getRelationComplete(long id, MapDataHandler handler) Queries the relation with the given id plus all it's members and all nodes of ways that are members of the relation.
java.util.List<Relation>	getRelations(java.util.Collection<java.lang.Long> relationIds)
java.util.List<Relation>	getRelationsForNode(long id)
java.util.List<Relation>	getRelationsForRelation(long id)
java.util.List<Relation>	getRelationsForWay(long id)
Way	getWay(long id)
void	getWayComplete(long id, MapDataHandler handler) Queries the way with the given id plus all nodes that are in referenced by it.
java.util.List<Way>	getWays(java.util.Collection<java.lang.Long> wayIds)
java.util.List<Way>	getWaysForNode(long id)
long	openChangeset(java.util.Map<java.lang.String,java.lang.String> tags) Open a new changeset with the given tags
void	updateChangeset(long changesetId, java.util.Map<java.lang.String,java.lang.String> tags) Set new the tags of a changeset (the old set of tags is deleted)
long	updateMap(java.util.Map<java.lang.String,java.lang.String> tags, java.lang.Iterable<Element> elements, Handler<DiffElement> handler) Opens a changeset, uploads the data, closes the changeset and subscribes the user to it.
long	updateMap(java.lang.String comment, java.lang.String source, java.lang.Iterable<Element> elements, Handler<DiffElement> handler)
void	uploadChanges(long changesetId, java.lang.Iterable<Element> elements, Handler<DiffElement> handler) Upload changes into an opened changeset.

Methods inherited from class java.lang.Object

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

Constructor Detail

MapDataDao

public MapDataDao(OsmConnection osm,
                  MapDataFactory factory)

MapDataDao

public MapDataDao(OsmConnection osm)

Method Detail

updateMap

public long updateMap(java.lang.String comment,
                      java.lang.String source,
                      java.lang.Iterable<Element> elements,
                      Handler<DiffElement> handler)

See Also:

updateMap(Map, Iterable, Handler)

updateMap

public long updateMap(java.util.Map<java.lang.String,java.lang.String> tags,
                      java.lang.Iterable<Element> elements,
                      Handler<DiffElement> handler)

Opens a changeset, uploads the data, closes the changeset and subscribes the user to it.

Parameters:

tags - tags of this changeset. Usually it is comment and source. See updateMap(String, String, Iterable, Handler)

elements - elements to upload. No special order required

handler - handler that processes the server's diffResult response. Optional.

Returns:

id of the changeset that was created

Throws:

OsmAuthorizationException - if the application does not have permission to edit the map (Permission.MODIFY_MAP)

uploadChanges

public void uploadChanges(long changesetId,
                          java.lang.Iterable<Element> elements,
                          Handler<DiffElement> handler)

Upload changes into an opened changeset.

Parameters:

elements - elements to upload. No special order required

handler - handler that processes the server's diffResult response. Optional.

Throws:

OsmNotFoundException - if the changeset does not exist (yet) or an element in the does not exist

OsmConflictException - if the changeset has already been closed, there is a conflict for the elements being uploaded or the user who created the changeset is not the same as the one uploading the change

openChangeset

public long openChangeset(java.util.Map<java.lang.String,java.lang.String> tags)

Open a new changeset with the given tags

Parameters:

tags - tags of this changeset. Usually it is comment and source.

updateChangeset

public void updateChangeset(long changesetId,
                            java.util.Map<java.lang.String,java.lang.String> tags)

Set new the tags of a changeset (the old set of tags is deleted)

Parameters:

tags - the new tags of this changeset

Throws:

OsmConflictException - if the changeset has already been closed

OsmNotFoundException - if the changeset does not exist (yet)

closeChangeset

public void closeChangeset(long changesetId)

Closes the given changeset.

Throws:

OsmConflictException - if the changeset has already been closed

OsmNotFoundException - if the changeset does not exist (yet)

getMap

public void getMap(BoundingBox bounds,
                   MapDataHandler handler)

Feeds map data to the given MapDataHandler.

Parameters:

bounds - rectangle in which to query map data. May not cross the 180th meridian. This is usually limited at 0.25 square degrees. Check the server capabilities.

handler - map data handler that is fed the map data

Throws:

OsmQueryTooBigException - if the bounds are is too large

java.lang.IllegalArgumentException - if the bounds cross the 180th meridian.

getWayComplete

public void getWayComplete(long id,
                           MapDataHandler handler)

Queries the way with the given id plus all nodes that are in referenced by it.

Parameters:

id - the way's id

handler - map data handler that is fed the map data

Throws:

OsmNotFoundException - if the way with the given id does not exist

getRelationComplete

public void getRelationComplete(long id,
                                MapDataHandler handler)

Queries the relation with the given id plus all it's members and all nodes of ways that are members of the relation.

Parameters:

id - the way's id

handler - map data handler that is fed the map data

Throws:

OsmNotFoundException - if the relation with the given id does not exist

getNode

public Node getNode(long id)

Returns:

the node with the given id or null if it does not exist

getWay

public Way getWay(long id)

Returns:

the way with the given id or null if it does not exist

getRelation

public Relation getRelation(long id)

Returns:

the relation with the given id or null if it does not exist

getNodes

public java.util.List<Node> getNodes(java.util.Collection<java.lang.Long> nodeIds)

Parameters:

nodeIds - a collection of node ids to return.

Returns:

a list of nodes.

Throws:

OsmNotFoundException - if any one of the given nodes does not exist

getWays

public java.util.List<Way> getWays(java.util.Collection<java.lang.Long> wayIds)

Parameters:

wayIds - a collection of way ids to return

Returns:

a list of ways.

Throws:

OsmNotFoundException - if any one of the given ways does not exist

getRelations

public java.util.List<Relation> getRelations(java.util.Collection<java.lang.Long> relationIds)

Parameters:

relationIds - a collection of relation ids to return

Returns:

a list of relations.

Throws:

OsmNotFoundException - if any one of the given relations does not exist

getWaysForNode

public java.util.List<Way> getWaysForNode(long id)

Returns:

all ways that reference the node with the given id. Empty if none.

getRelationsForNode

public java.util.List<Relation> getRelationsForNode(long id)

Returns:

all relations that reference the node with the given id. Empty if none.

getRelationsForWay

public java.util.List<Relation> getRelationsForWay(long id)

Returns:

all relations that reference the way with the given id. Empty if none.

getRelationsForRelation

public java.util.List<Relation> getRelationsForRelation(long id)

Returns:

all relations that reference the relation with the given id. Empty if none.