Class Place

java.lang.Object

org.episteme.natural.earth.Place

All Implemented Interfaces:

Serializable, Commented, ComprehensiveIdentification, Identified<Identification>, Named, Positioned<EarthCoordinate>, Temporal<Temporal<?>>

Direct Known Subclasses:

City, Region, Settlement, Site, TimedPlace

public class Place
extends Object
implements ComprehensiveIdentification, Positioned<EarthCoordinate>, Temporal<Temporal<?>>

Base class for all geographical features and named locations. Uses geodetic coordinates for absolute positioning on Earth. Implements ComprehensiveIdentification to support dynamic traits and consistent identity. Modernized to use extensible PlaceType and PlacePrecision.

Since:

1.0

Author:

Silvere Martin-Michiellot, Gemini AI (Google DeepMind)

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected final Identification	id
protected final Map<String,Object>	traits

Constructor Summary

Constructors

Constructor	Description
Place(String name)
Place(String name, GeodeticCoordinate center, PlaceType type)
Place(String name, PlaceType type)

Method Summary

Modifier and Type	Method	Description
void	addBoundary(Boundary<EarthCoordinate> boundary)
void	addInhabitant(Individual individual)
void	clearBoundaries()
Quantity<Length>	distanceTo(Place other)
boolean	equals(Object o)
List<Boundary<EarthCoordinate>>	getBoundaries()	Returns the boundaries of this place.
GeodeticCoordinate	getCenter()
String	getHistoricalName()
Identification	getId()	Returns the unique identifier of this entity.
Set<Individual>	getInhabitants()
EarthCoordinate	getPosition()	Returns the position of this entity.
PlacePrecision	getPrecision()
String	getRegion()
Map<String,Object>	getTraits()	Returns the traits map for this entity.
PlaceType	getType()
Quantity<Length>	getUncertaintyRadius()
Temporal<?>	getWhen()	Returns the temporal position (when) of this entity.
static Place	greenwich()
int	hashCode()
static Place	of(String name, double lat, double lon, PlaceType type)
void	removeInhabitant(Individual individual)
void	setCenter(GeodeticCoordinate center)
void	setExistenceTime(Temporal<?> existenceTime)
void	setHistoricalName(String historicalName)
void	setPrecision(PlacePrecision precision)
void	setRegion(String region)
void	setType(PlaceType type)
void	setUncertaintyRadius(Quantity<Length> radius)
String	toString()

Methods inherited from class Object

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

Methods inherited from interface Commented

getComments, getTrait, setComments

Methods inherited from interface ComprehensiveIdentification

getName, getTrait, setName, setTrait

Field Details

id

protected final Identification id

traits

protected final Map<String,Object> traits

Constructor Details

Place

public Place(String name)

Place

public Place(String name,
 PlaceType type)

Place

public Place(String name,
 GeodeticCoordinate center,
 PlaceType type)

Method Details

getId

public Identification getId()

Description copied from interface: Identified

Returns the unique identifier of this entity.

Specified by:

getId in interface Identified<Identification>

Returns:

the identifier

getTraits

public Map<String,Object> getTraits()

Description copied from interface: ComprehensiveIdentification

Returns the traits map for this entity.

Specified by:

getTraits in interface Commented

Specified by:

getTraits in interface ComprehensiveIdentification

Returns:

the traits map

getType

public PlaceType getType()

setType

public void setType(PlaceType type)

getCenter

public GeodeticCoordinate getCenter()

setCenter

public void setCenter(GeodeticCoordinate center)

getPosition

public EarthCoordinate getPosition()

Description copied from interface: Positioned

Returns the position of this entity.

Specified by:

getPosition in interface Positioned<EarthCoordinate>

Returns:

the position.

getHistoricalName

public String getHistoricalName()

setHistoricalName

public void setHistoricalName(String historicalName)

getPrecision

public PlacePrecision getPrecision()

setPrecision

public void setPrecision(PlacePrecision precision)

getUncertaintyRadius

public Quantity<Length> getUncertaintyRadius()

setUncertaintyRadius

public void setUncertaintyRadius(Quantity<Length> radius)

getRegion

public String getRegion()

setRegion

public void setRegion(String region)

getBoundaries

public List<Boundary<EarthCoordinate>> getBoundaries()

Returns the boundaries of this place. Enclaves and exclaves should be modeled using CompositeBoundary2D if supported.

addBoundary

public void addBoundary(Boundary<EarthCoordinate> boundary)

clearBoundaries

public void clearBoundaries()

getWhen

public Temporal<?> getWhen()

Description copied from interface: Temporal

Returns the temporal position (when) of this entity.

Specified by:

getWhen in interface Temporal<Temporal<?>>

Returns:

the temporal position.

setExistenceTime

public void setExistenceTime(Temporal<?> existenceTime)

addInhabitant

public void addInhabitant(Individual individual)

removeInhabitant

public void removeInhabitant(Individual individual)

getInhabitants

public Set<Individual> getInhabitants()

distanceTo

public Quantity<Length> distanceTo(Place other)

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

of

public static Place of(String name,
 double lat,
 double lon,
 PlaceType type)

greenwich

public static Place greenwich()