org.openstreetmap.josm.data.osm

Class Node

java.lang.Object

org.openstreetmap.josm.data.osm.AbstractPrimitive

org.openstreetmap.josm.data.osm.OsmPrimitive

org.openstreetmap.josm.data.osm.Node

All Implemented Interfaces:

java.lang.Comparable<IPrimitive>, ILatLon, INode, IPrimitive, PrimitiveId, Stylable, Tagged, TemplateEngineDataProvider

public final class Node
extends OsmPrimitive
implements INode

One node data, consisting of one world coordinate waypoint.

Field Summary

Fields

Modifier and Type	Field and Description
private double	east
private java.lang.Object	eastNorthCacheKey The cache key to use for east and north.
private double	lat
private double	lon
private double	north

Fields inherited from class org.openstreetmap.josm.data.osm.OsmPrimitive

directionKeys

Fields inherited from class org.openstreetmap.josm.data.osm.AbstractPrimitive

changesetId, FLAG_ANNOTATED, FLAG_DELETED, FLAG_DIRECTION_REVERSED, FLAG_DISABLED, FLAG_DISABLED_TYPE, FLAG_HAS_DIRECTIONS, FLAG_HIDDEN_TYPE, FLAG_HIDE_IF_DISABLED, FLAG_HIGHLIGHTED, FLAG_INCOMPLETE, FLAG_MODIFIED, FLAG_PRESERVED, FLAG_TAGGED, FLAG_VISIBLE, flags, id, keys, timestamp, user, version

Fields inherited from interface org.openstreetmap.josm.data.osm.Tagged

MAX_TAG_LENGTH

Constructor Summary

Constructors

Modifier	Constructor and Description
	Node() Constructs a new local Node with id 0.
	Node(EastNorth eastNorth) Constructs a new Node with the given east/north with id 0.
	Node(LatLon latlon) Constructs a new Node with the given lat/lon with id 0.
	Node(long id) Constructs an incomplete Node object with the given id.
protected	Node(long id, boolean allowNegative)
	Node(long id, int version) Constructs a new Node with the given id and version.
	Node(Node clone) Constructs an identical clone of the argument (including the id).
	Node(Node clone, boolean clearMetadata) Constructs an identical clone of the argument.

Method Summary

Modifier and Type	Method and Description
void	accept(OsmPrimitiveVisitor visitor) Implementation of the visitor scheme.
void	accept(PrimitiveVisitor visitor) Makes the given visitor visit this primitive.
protected void	addToBBox(BBox box, java.util.Set<PrimitiveId> visited) If necessary, extend the bbox to contain this primitive
void	cloneFrom(OsmPrimitive osm) Get and write all attributes from the parameter.
boolean	concernsArea() Determines if this primitive semantically concerns an area.
BBox	getBBox() Fetches the bounding box of the primitive.
LatLon	getCoor() Returns lat/lon coordinates of this node, or null unless ILatLon.isLatLonKnown()
EastNorth	getEastNorth(Projecting projection) Replies the projected east/north coordinates.
java.util.List<Way>	getParentWays() Replies the set of referring ways.
OsmPrimitiveType	getType() Gets the type of object represented by this object.
private boolean	hasEqualCoordinates(Node other)
boolean	hasEqualSemanticAttributes(OsmPrimitive other, boolean testInterestingTagsOnly)
void	invalidateEastNorthCache() Invoke to invalidate the internal cache of projected east/north coordinates.
boolean	isConnectedTo(java.util.Collection<Node> otherNodes, int hops, java.util.function.Predicate<Node> predicate) Tests whether this node is connected to otherNode via at most hops nodes matching the predicate (which may be null to consider all nodes).
private boolean	isConnectedTo(java.util.Collection<Node> otherNodes, int hops, java.util.function.Predicate<Node> predicate, java.util.Set<Node> visited)
boolean	isDrawable() Determines if this object is drawable.
boolean	isOutsideDownloadArea() Tests if this primitive lies outside of the downloaded area of its DataSet.
boolean	isOutSideWorld() Determines if this node is outside of the world.
boolean	isReferredByWays(int n) Return true, if this primitive is referred by at least n ways
double	lat() Returns the latitude, i.e., the north-south position in degrees.
void	load(PrimitiveData data) Loads (clone) this primitive from provided PrimitiveData
double	lon() Returns the longitude, i.e., the east-west position in degrees.
void	mergeFrom(OsmPrimitive other) Merges the technical and semantical attributes from other onto this.
NodeData	save() Save parameters of this primitive to the transport object
void	setCoor(LatLon coor) Sets lat/lon coordinates of this node.
(package private) void	setCoorInternal(LatLon coor, EastNorth eastNorth) To be used only by Dataset.reindexNode
(package private) void	setDataset(DataSet dataSet) This method should never ever by called from somewhere else than Dataset.addPrimitive or removePrimitive methods
void	setEastNorth(EastNorth eastNorth) Sets east/north coordinates of this node.
java.lang.String	toString()
private void	updateCoor(LatLon coor, EastNorth eastNorth)
void	updatePosition() Called by Dataset to update cached position information of primitive (bbox, cached EarthNorth, ...)

Methods inherited from class org.openstreetmap.josm.data.osm.OsmPrimitive

addReferrer, checkDataset, checkDatasetNotReadOnly, clearOsmMetadata, declareCachedStyleUpToDate, equals, evaluateCondition, getCachedStyle, getDataSet, getDisabledType, getFlagsAsString, getHiddenType, getParentRelations, getReferrer, getReferrers, getReferrers, getTemplateKeys, getTemplateValue, hasAreaTags, hasDirectionKeys, hasEqualSemanticAttributes, hasEqualSemanticFlags, hasEqualTechnicalAttributes, hashCode, isAnnotated, isCachedStyleUpToDate, isDisabled, isDisabledAndHidden, isHighlighted, isMemberOfSelected, isNodeReferredByWays, isOuterMemberOfSelected, isPreserved, isSelectable, isSelected, isTagged, keysChangedImpl, put, referrers, remove, removeAll, removeReferrer, reversedDirection, saveCommonAttributes, setCachedStyle, setChangesetId, setDeleted, setDisabledState, setDisabledType, setHiddenType, setHighlighted, setIncomplete, setKeys, setKeys, setModified, setOsmId, setPreserved, setTimestamp, setUser, setVisible, unsetDisabledState, updateFlags, visitReferrers, visitReferrers, writeLock, writeUnlock

Methods inherited from class org.openstreetmap.josm.data.osm.AbstractPrimitive

advanceUniqueId, cloneFrom, currentUniqueId, doGet, generateUniqueId, get, getChangesetId, getDiscardableKeys, getId, getIgnoreCase, getInterestingTags, getKeys, getNumKeys, getRawTimestamp, getTimestamp, getUninterestingKeys, getUniqueId, getUser, getVersion, getWorkInProgressKeys, hasKey, hasKey, hasKeys, isDeleted, isIncomplete, isModified, isNew, isNewOrUndeleted, isTimestampEmpty, isUndeleted, isUninterestingKey, isUsable, isVisible, keySet, setRawTimestamp, visitKeys

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.openstreetmap.josm.data.osm.INode

compareTo, getDisplayName, getEastNorth, isConnectionNode

Methods inherited from interface org.openstreetmap.josm.data.osm.IPrimitive

getChangesetId, getDataSet, getDisplayType, getId, getInterestingTags, getLocalName, getName, getOsmId, getOsmPrimitiveId, getPrimitiveId, getRawTimestamp, getReferrers, getReferrers, getTimestamp, getUser, getVersion, hasDirectionKeys, hasSameInterestingTags, isAnnotated, isDeleted, isDisabled, isDisabledAndHidden, isHighlighted, isIncomplete, isMemberOfSelected, isModified, isMultipolygon, isNewOrUndeleted, isOuterMemberOfSelected, isPreserved, isSelectable, isSelected, isTagged, isTimestampEmpty, isUndeleted, isUsable, isVisible, reversedDirection, setChangesetId, setDeleted, setHighlighted, setModified, setOsmId, setRawTimestamp, setTimestamp, setUser, setVisible, visitReferrers

Methods inherited from interface org.openstreetmap.josm.data.osm.Tagged

get, getKeys, getNumKeys, hasKey, hasKeys, hasTag, hasTag, hasTag, hasTag, hasTagDifferent, hasTagDifferent, hasTagDifferent, isKeyFalse, isKeyTrue, keySet, put, put, remove, removeAll, setKeys, visitKeys

Methods inherited from interface org.openstreetmap.josm.data.osm.PrimitiveId

getUniqueId, isNew

Methods inherited from interface org.openstreetmap.josm.data.osm.Stylable

clearCachedStyle, declareCachedStyleUpToDate, getCachedStyle, isCachedStyleUpToDate, setCachedStyle

Methods inherited from interface org.openstreetmap.josm.data.coor.ILatLon

isLatLonKnown

Field Detail

lat

private double lat

lon

private double lon

east

private double east

north

private double north

eastNorthCacheKey

private java.lang.Object eastNorthCacheKey

The cache key to use for east and north.

Constructor Detail

Node

protected Node(long id,
               boolean allowNegative)

Node

public Node()

Constructs a new local Node with id 0.

Node

public Node(long id)

Constructs an incomplete Node object with the given id.

Parameters:

id - The id. Must be >= 0

Throws:

java.lang.IllegalArgumentException - if id < 0

Node

public Node(long id,
            int version)

Constructs a new Node with the given id and version.

Parameters:

id - The id. Must be >= 0

version - The version

Throws:

java.lang.IllegalArgumentException - if id < 0

Node

public Node(Node clone,
            boolean clearMetadata)

Constructs an identical clone of the argument.

Parameters:

clone - The node to clone

clearMetadata - If true, clears the OSM id and other metadata as defined by OsmPrimitive.clearOsmMetadata(). If false, does nothing

Node

public Node(Node clone)

Constructs an identical clone of the argument (including the id).

Parameters:

clone - The node to clone, including its id

Node

public Node(LatLon latlon)

Constructs a new Node with the given lat/lon with id 0.

Parameters:

latlon - The LatLon coordinates

Node

public Node(EastNorth eastNorth)

Constructs a new Node with the given east/north with id 0.

Parameters:

eastNorth - The EastNorth coordinates

Method Detail

setCoor

public void setCoor(LatLon coor)

Description copied from interface: INode

Sets lat/lon coordinates of this node.

Specified by:

setCoor in interface INode

Parameters:

coor - lat/lon coordinates of this node

setEastNorth

public void setEastNorth(EastNorth eastNorth)

Description copied from interface: INode

Sets east/north coordinates of this node.

Specified by:

setEastNorth in interface INode

Parameters:

eastNorth - east/north coordinates of this node

updateCoor

private void updateCoor(LatLon coor,
                        EastNorth eastNorth)

getCoor

public LatLon getCoor()

Returns lat/lon coordinates of this node, or null unless ILatLon.isLatLonKnown()

Specified by:

getCoor in interface INode

Returns:

lat/lon coordinates of this node, or null unless ILatLon.isLatLonKnown()

lat

public double lat()

Description copied from interface: ILatLon

Returns the latitude, i.e., the north-south position in degrees.

Specified by:

lat in interface ILatLon

Returns:

the latitude or NaN if ILatLon.isLatLonKnown() returns false

lon

public double lon()

Description copied from interface: ILatLon

Returns the longitude, i.e., the east-west position in degrees.

Specified by:

lon in interface ILatLon

Returns:

the longitude or NaN if ILatLon.isLatLonKnown() returns false

getEastNorth

public EastNorth getEastNorth(Projecting projection)

Description copied from interface: ILatLon

Replies the projected east/north coordinates.

The result of the last conversion may be cached. Null is returned in case this object is invalid.

Specified by:

getEastNorth in interface ILatLon

Parameters:

projection - The projection to use.

Returns:

The projected east/north coordinates

setCoorInternal

void setCoorInternal(LatLon coor,
                     EastNorth eastNorth)

To be used only by Dataset.reindexNode

Parameters:

coor - lat/lon

eastNorth - east/north

setDataset

void setDataset(DataSet dataSet)

Description copied from class: OsmPrimitive

This method should never ever by called from somewhere else than Dataset.addPrimitive or removePrimitive methods

Overrides:

setDataset in class OsmPrimitive

Parameters:

dataSet - the parent dataset

accept

public void accept(OsmPrimitiveVisitor visitor)

Description copied from class: OsmPrimitive

Implementation of the visitor scheme. Subclasses have to call the correct visitor function.

Specified by:

accept in class OsmPrimitive

Parameters:

visitor - The visitor from which the visit() function must be called.

accept

public void accept(PrimitiveVisitor visitor)

Description copied from interface: IPrimitive

Makes the given visitor visit this primitive.

Specified by:

accept in interface IPrimitive

Parameters:

visitor - visitor

cloneFrom

public void cloneFrom(OsmPrimitive osm)

Description copied from class: OsmPrimitive

Get and write all attributes from the parameter. Does not fire any listener, so use this only in the data initializing phase

Overrides:

cloneFrom in class OsmPrimitive

Parameters:

osm - other primitive

mergeFrom

public void mergeFrom(OsmPrimitive other)

Merges the technical and semantical attributes from other onto this. Both this and other must be new, or both must be assigned an OSM ID. If both this and other have an assigend OSM id, the IDs have to be the same.

Overrides:

mergeFrom in class OsmPrimitive

Parameters:

other - the other primitive. Must not be null.

Throws:

java.lang.IllegalArgumentException - if other is null.

DataIntegrityProblemException - if either this is new and other is not, or other is new and this is not

DataIntegrityProblemException - if other is new and other.getId() != this.getId()

load

public void load(PrimitiveData data)

Description copied from class: OsmPrimitive

Loads (clone) this primitive from provided PrimitiveData

Overrides:

load in class OsmPrimitive

Parameters:

data - The object which should be cloned

save

public NodeData save()

Description copied from class: OsmPrimitive

Save parameters of this primitive to the transport object

Specified by:

save in class OsmPrimitive

Returns:

The saved object data

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

hasEqualSemanticAttributes

public boolean hasEqualSemanticAttributes(OsmPrimitive other,
                                          boolean testInterestingTagsOnly)

Overrides:

hasEqualSemanticAttributes in class OsmPrimitive

hasEqualCoordinates

private boolean hasEqualCoordinates(Node other)

getType

public OsmPrimitiveType getType()

Description copied from interface: PrimitiveId

Gets the type of object represented by this object.

Specified by:

getType in interface PrimitiveId

Returns:

the object type

See Also:

Node, Way, Relation

getBBox

public BBox getBBox()

Description copied from interface: IPrimitive

Fetches the bounding box of the primitive.

Specified by:

getBBox in interface IPrimitive

Returns:

Bounding box of the object

addToBBox

protected void addToBBox(BBox box,
                         java.util.Set<PrimitiveId> visited)

Description copied from class: OsmPrimitive

If necessary, extend the bbox to contain this primitive

Specified by:

addToBBox in class OsmPrimitive

Parameters:

box - a bbox instance

visited - a set of visited members or null

updatePosition

public void updatePosition()

Description copied from class: OsmPrimitive

Called by Dataset to update cached position information of primitive (bbox, cached EarthNorth, ...)

Specified by:

updatePosition in class OsmPrimitive

isDrawable

public boolean isDrawable()

Description copied from interface: IPrimitive

Determines if this object is drawable.

A primitive is drawable if all conditions are met:

• type and id is known
• tags are known
• it is not deleted
• it is not hidden by a filter
• for nodes: lat/lon are known
• for ways: all nodes are known and complete
• for relations: all members are known and complete

Specified by:

isDrawable in interface IPrimitive

Overrides:

isDrawable in class OsmPrimitive

Returns:

true if this object is drawable

isReferredByWays

public boolean isReferredByWays(int n)

Description copied from interface: INode

Return true, if this primitive is referred by at least n ways

Specified by:

isReferredByWays in interface INode

Parameters:

n - Minimal number of ways to return true. Must be positive

Returns:

true if this primitive is referred by at least n ways

invalidateEastNorthCache

public void invalidateEastNorthCache()

Invoke to invalidate the internal cache of projected east/north coordinates. Coordinates are reprojected on demand when the INode.getEastNorth() is invoked next time.

concernsArea

public boolean concernsArea()

Description copied from class: OsmPrimitive

Determines if this primitive semantically concerns an area.

Specified by:

concernsArea in class OsmPrimitive

Returns:

true if this primitive semantically concerns an area, according to its type, geometry and tags, false otherwise.

isConnectedTo

public boolean isConnectedTo(java.util.Collection<Node> otherNodes,
                             int hops,
                             java.util.function.Predicate<Node> predicate)

Tests whether this node is connected to otherNode via at most hops nodes matching the predicate (which may be null to consider all nodes).

Parameters:

otherNodes - other nodes

hops - number of hops

predicate - predicate to match

Returns:

true if this node mets the conditions

isConnectedTo

private boolean isConnectedTo(java.util.Collection<Node> otherNodes,
                              int hops,
                              java.util.function.Predicate<Node> predicate,
                              java.util.Set<Node> visited)

isOutsideDownloadArea

public boolean isOutsideDownloadArea()

Description copied from class: OsmPrimitive

Tests if this primitive lies outside of the downloaded area of its DataSet.

Specified by:

isOutsideDownloadArea in class OsmPrimitive

Returns:

true if this primitive lies outside of the downloaded area

getParentWays

public java.util.List<Way> getParentWays()

Replies the set of referring ways.

Returns:

the set of referring ways

Since:

12031

isOutSideWorld

public boolean isOutSideWorld()

Determines if this node is outside of the world. See also #13538.

Returns:

true, if the coordinate is outside the world, compared by using lat/lon and east/north

Since:

14960