Package nl.tudelft.simulation.dsol.animation.gis.map

Class GisMap

java.lang.Object

nl.tudelft.simulation.dsol.animation.gis.map.GisMap

All Implemented Interfaces:

GisMapInterface

public class GisMap
extends Object
implements GisMapInterface

Provides the implementation of a Map.

Copyright (c) 2020-2025 Delft University of Technology, Jaffalaan 5, 2628 BX Delft, the Netherlands. All rights reserved. See for project information DSOL Manual. The DSOL project is distributed under a three-clause BSD-style license, which can be found at DSOL License.

The dsol-animation-gis project is based on the gisbeans project that has been part of DSOL since 2002, originally by Peter Jacobs and Paul Jacobs.

Author:

Alexander Verbraeck

Field Summary

Fields inherited from interface nl.tudelft.simulation.dsol.animation.gis.GisMapInterface

AIRPHOTO, ANGLEDEG, ANGLERAD, CENTIMETER_PER_INCH, DD_TO_METER, FEET_TO_METER, IMAGE, INCH_TO_METER, KILOMETER_TO_METER, LINE, MILES_TO_METER, POINT, POLYGON, TEXT

Constructor Summary

Constructors

Constructor	Description
GisMap()	Construct a new Map, with WGS84 as the scale definition, with values for the equator.
GisMap(double metersPerUnitX, double metersPerUnitY)	Construct a new Map, defining the size of a map unit in meters.

Method Summary

Modifier and Type	Method	Description
void	addLayer(LayerInterface layer)
Graphics2D	drawMap(Graphics2D graphics)
org.djutils.immutablecollections.ImmutableList<LayerInterface>	getAllLayers()
org.djutils.draw.bounds.Bounds2d	getExtent()
MapImageInterface	getImage()
org.djutils.immutablecollections.ImmutableMap<String,LayerInterface>	getLayerMap()
MapUnits	getMapUnits()
double	getMetersPerUnitX()
double	getMetersPerUnitY()
String	getName()
double	getScaleX()
double	getScaleY()
org.djutils.immutablecollections.ImmutableList<LayerInterface>	getVisibleLayers()
void	hideLayer(String layerName)
void	hideLayer(LayerInterface layer)
boolean	isDrawBackground()
boolean	isSame()
void	setDrawBackground(boolean drawBackground)
void	setExtent(org.djutils.draw.bounds.Bounds2d extent)
void	setImage(MapImageInterface image)
void	setLayer(int index, LayerInterface layer)
void	setLayers(List<LayerInterface> layers)
void	setName(String name)
void	setUnits(MapUnits units)
void	showLayer(String layerName)
void	showLayer(LayerInterface layer)
void	zoom(double zoomFactor)
void	zoomPoint(Point2D pixelPosition, double zoomFactor)
void	zoomRectangle(Rectangle2D rectangle)

Methods inherited from class java.lang.Object

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

Methods inherited from interface nl.tudelft.simulation.dsol.animation.gis.GisMapInterface

getMetersPerPixelX, getMetersPerPixelY

Constructor Details

GisMap

public GisMap(double metersPerUnitX,
 double metersPerUnitY)

Construct a new Map, defining the size of a map unit in meters. The size of a map unit can then be used to draw scalable lines with a certain width, and to make certain features disappear if the meter-to-pixel ratio is passing a certain threshold. In WGS84 maps, typically the latitude is used, since it does not vary dependent on the location.

Parameters:

metersPerUnitX - the mapping of one map unit to the equivalent number of meters in the x-direction

metersPerUnitY - the mapping of one map unit to the equivalent number of meters in the y-direction

GisMap

public GisMap()

Construct a new Map, with WGS84 as the scale definition, with values for the equator. One degree of latitude is approximately 111,120 meters, while one degree of longitude varies from approximately 111,120 meters at the equator to 0 meters at the poles.

Method Details

addLayer

public void addLayer(LayerInterface layer)

Specified by:

addLayer in interface GisMapInterface

setLayers

public void setLayers(List<LayerInterface> layers)

Specified by:

setLayers in interface GisMapInterface

setLayer

public void setLayer(int index,
 LayerInterface layer)

Specified by:

setLayer in interface GisMapInterface

hideLayer

public void hideLayer(LayerInterface layer)

Specified by:

hideLayer in interface GisMapInterface

hideLayer

public void hideLayer(String layerName)

Specified by:

hideLayer in interface GisMapInterface

showLayer

public void showLayer(LayerInterface layer)

Specified by:

showLayer in interface GisMapInterface

showLayer

public void showLayer(String layerName)

Specified by:

showLayer in interface GisMapInterface

isSame

public boolean isSame()

Specified by:

isSame in interface GisMapInterface

drawMap

public Graphics2D drawMap(Graphics2D graphics)
                   throws DsolGisException

Specified by:

drawMap in interface GisMapInterface

Throws:

DsolGisException

getExtent

public org.djutils.draw.bounds.Bounds2d getExtent()

Specified by:

getExtent in interface GisMapInterface

getImage

public MapImageInterface getImage()

Specified by:

getImage in interface GisMapInterface

getAllLayers

public org.djutils.immutablecollections.ImmutableList<LayerInterface> getAllLayers()

Specified by:

getAllLayers in interface GisMapInterface

getVisibleLayers

public org.djutils.immutablecollections.ImmutableList<LayerInterface> getVisibleLayers()

Specified by:

getVisibleLayers in interface GisMapInterface

getLayerMap

public org.djutils.immutablecollections.ImmutableMap<String,LayerInterface> getLayerMap()

Specified by:

getLayerMap in interface GisMapInterface

getName

public String getName()

Specified by:

getName in interface GisMapInterface

getScaleX

public double getScaleX()

Specified by:

getScaleX in interface GisMapInterface

getScaleY

public double getScaleY()

Specified by:

getScaleY in interface GisMapInterface

getMetersPerUnitX

public double getMetersPerUnitX()

Specified by:

getMetersPerUnitX in interface GisMapInterface

getMetersPerUnitY

public double getMetersPerUnitY()

Specified by:

getMetersPerUnitY in interface GisMapInterface

getMapUnits

public MapUnits getMapUnits()

Specified by:

getMapUnits in interface GisMapInterface

setExtent

public void setExtent(org.djutils.draw.bounds.Bounds2d extent)

Specified by:

setExtent in interface GisMapInterface

setImage

public void setImage(MapImageInterface image)

Specified by:

setImage in interface GisMapInterface

setName

public void setName(String name)

Specified by:

setName in interface GisMapInterface

setUnits

public void setUnits(MapUnits units)

Specified by:

setUnits in interface GisMapInterface

zoom

public void zoom(double zoomFactor)

Specified by:

zoom in interface GisMapInterface

zoomPoint

public void zoomPoint(Point2D pixelPosition,
 double zoomFactor)

Specified by:

zoomPoint in interface GisMapInterface

zoomRectangle

public void zoomRectangle(Rectangle2D rectangle)

Specified by:

zoomRectangle in interface GisMapInterface

isDrawBackground

public boolean isDrawBackground()

Specified by:

isDrawBackground in interface GisMapInterface

setDrawBackground

public void setDrawBackground(boolean drawBackground)

Specified by:

setDrawBackground in interface GisMapInterface