GeoService (Klarschiff-Backend 1.9.0 API)

java.lang.Object
- de.fraunhofer.igd.klarschiff.service.geo.GeoService

```
public class GeoService
extends Object
```
Der Service dient zum Halten von Konfigurationsparametern für die Darstellung von Karten in den Webseiten mit Hilfe von OpenLayers, zur Erstellung von URLs für die Darstellung der Position eines Vorganges in einem externen System als auch zur Ermittlung von Features mit geographischem Hintergrund für den Zuständigkeitsfinder, die über den WFS ermittelt werden. Bei der Ermittlung von Features mit geographischen Hintergrund wird ein zweistufiger Cache verwendet, um die Abfragen an den WFS zu reduzieren. Hierfür wird die Hilfsklasse GeoServiceWfs verwendet, da der Caching nur funktioniert, wenn der Funktionsaufruf nicht aus der gleichen Klasse erfolgt.

Author:

Stefan Audersch (Fraunhofer IGD), Marcus Kröller (Fraunhofer IGD)

See Also:

GeoServiceWfs

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class GeoService.WfsZufiExceptionHandling

Nested Classes
Modifier and Type	Class and Description
`static class`	`GeoService.WfsZufiExceptionHandling`

Field Summary

Fields
Modifier and Type	Field and Description
`(package private) String`	`adressensucheKey`
`(package private) String`	`adressensucheLocalisator`
`(package private) String`	`adressensucheUrl`
`(package private) org.geotools.data.DataStore`	`dataStore`
`(package private) org.opengis.filter.FilterFactory2`	`filterFactory`
`(package private) GeoServiceWfs`	`geoServiceWfs`
`private static org.apache.log4j.Logger`	`logger`
`(package private) String`	`mapExternExternUrl`
`(package private) String`	`mapExternName`
`(package private) String`	`mapExternProjection`
`(package private) String`	`mapExternUrl`
`(package private) String`	`mapLayersOneParams`
`(package private) String`	`mapLayersOneType`
`(package private) String`	`mapLayersPoiParams`
`(package private) String`	`mapLayersPoiType`
`(package private) String`	`mapLayersTwoParams`
`(package private) String`	`mapLayersTwoType`
`(package private) String`	`mapMaxExtent`
`(package private) Integer`	`mapOviMargin`
`(package private) String`	`mapProjection`
`(package private) String`	`mapResolutions`
`(package private) String`	`mapRestrictedExtent`
`(package private) String`	`mapUnits`
`(package private) SettingsService`	`settingsService`
`(package private) String`	`vorgangCoordinates`
`(package private) String`	`wfsVorgaengeFeatureNs`
`(package private) String`	`wfsVorgaengeFeaturePrefix`
`(package private) String`	`wfsVorgaengeFeatureType`
`(package private) String`	`wfsVorgaengeUrl`
`(package private) String`	`wfsZufiCapabilitiesUrl`
`(package private) GeoService.WfsZufiExceptionHandling`	`wfsZufiExceptionHandling`
`(package private) double`	`wfsZufiOviBuffer`

Constructor Summary

Constructors
Constructor and Description

GeoService()

Constructors
Constructor and Description
`GeoService()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`String`	`calculateAddress(com.vividsolutions.jts.geom.Point point)` Ermittlung der Adresse
`String[]`	`calculateAddressD3(com.vividsolutions.jts.geom.Point point)` Ermittlung der Adresse für d.3
`Double`	`calculateFeature(com.vividsolutions.jts.geom.Point ovi, Attribute attribute)` Ermitteln des FeatureWertes für ein Feature mit geographischem Hintergrund
`String`	`getAdressensucheKey()`
`String`	`getAdressensucheLocalisator()`
`String`	`getAdressensucheUrl()`
`org.geotools.data.DataStore`	`getDataStore()`
`protected List<GeoFeature>`	`getGeoFeatures(com.vividsolutions.jts.geom.Point ovi, double wfsZufiOviBuffer, String typeName, String geomPropertyName, String propertyName)` Ermittelt die angefragten WFS-Features zu einem gegebenen Punkt und dessen Umkreis, die den Umkreis schneiden.
`protected Double[]`	`getGeoFeatures(com.vividsolutions.jts.geom.Point ovi, double wfsZufiOviBuffer, String typeName, String geomPropertyName, String propertyName, String propertyValue)` Ermittelt die FeatureWerte mit geographischem Hintergrund für ein Feature.
`String`	`getMapExternExternUrl()`
`String`	`getMapExternExternUrl(Vorgang vorgang)` Erstellung der URL zur Darstellung des Ortes eines Vorganges in einem externen System (z.B. im Frontend).
`String`	`getMapExternName()`
`String`	`getMapExternProjection()`
`String`	`getMapExternUrl()`
`String`	`getMapExternUrl(Vorgang vorgang)` Erstellung der URL zur Darstellung des Ortes eines Vorganges in einem externen Web-Mapping-System Die URL kann über die Einstellungen konfiguriert werden und kann die folgenden Platzhalter beinhalten: `%xmin%`, `%ymin%`, `%xmax%`, `%ymax%`, `%x%`, `%y%`, `%id%`
`String`	`getMapLayersOneParams()`
`String`	`getMapLayersOneType()`
`String`	`getMapLayersPoiParams()`
`String`	`getMapLayersPoiType()`
`String`	`getMapLayersTwoParams()`
`String`	`getMapLayersTwoType()`
`String`	`getMapMaxExtent()`
`Integer`	`getMapOviMargin()`
`String`	`getMapProjection()`
`String`	`getMapResolutions()`
`String`	`getMapRestrictedExtent()`
`String`	`getMapUnits()`
`String`	`getVorgangCoordinates()`
`String`	`getVorgangCoordinates(Vorgang vorgang)` Erstellung der URL zur Darstellung des Ortes eines Vorganges in einem externen System (z.B. im Frontend).
`String`	`getWfsVorgaengeFeatureNs()`
`String`	`getWfsVorgaengeFeaturePrefix()`
`String`	`getWfsVorgaengeFeatureType()`
`String`	`getWfsVorgaengeUrl()`
`String`	`getWfsZufiCapabilitiesUrl()`
`GeoService.WfsZufiExceptionHandling`	`getWfsZufiExceptionHandling()`
`double`	`getWfsZufiOviBuffer()`
`void`	`init()` Initialisierung für die Nutzung des WFS und in diesem Zusammenhang ggf. das Setzen von Proxyparametern.
`String`	`searchAddress(String query)` Adressensuche
`void`	`setAdressensucheKey(String adressensucheKey)`
`void`	`setAdressensucheLocalisator(String adressensucheLocalisator)`
`void`	`setAdressensucheUrl(String adressensucheUrl)`
`void`	`setMapExternExternUrl(String mapExternExternUrl)`
`void`	`setMapExternName(String mapExternName)`
`void`	`setMapExternProjection(String mapExternProjection)`
`void`	`setMapExternUrl(String mapExternUrl)`
`void`	`setMapLayersOneParams(String mapLayersOneParams)`
`void`	`setMapLayersOneType(String mapLayersOneType)`
`void`	`setMapLayersPoiParams(String mapLayersPoiParams)`
`void`	`setMapLayersPoiType(String mapLayersPoiType)`
`void`	`setMapLayersTwoParams(String mapLayersTwoParams)`
`void`	`setMapLayersTwoType(String mapLayersTwoType)`
`void`	`setMapMaxExtent(String mapMaxExtent)`
`void`	`setMapOviMargin(Integer mapOviMargin)`
`void`	`setMapProjection(String mapProjection)`
`void`	`setMapResolutions(String mapResolutions)`
`void`	`setMapRestrictedExtent(String mapRestrictedExtent)`
`void`	`setMapUnits(String mapUnits)`
`void`	`setVorgangCoordinates(String vorgangCoordinates)`
`void`	`setWfsVorgaengeFeatureNs(String wfsVorgaengeFeatureNs)`
`void`	`setWfsVorgaengeFeaturePrefix(String wfsVorgaengeFeaturePrefix)`
`void`	`setWfsVorgaengeFeatureType(String wfsVorgaengeFeatureType)`
`void`	`setWfsVorgaengeUrl(String wfsVorgaengeUrl)`
`void`	`setWfsZufiCapabilitiesUrl(String wfsZufiCapabilitiesUrl)`
`void`	`setWfsZufiExceptionHandling(GeoService.WfsZufiExceptionHandling wfsZufiExceptionHandling)`
`void`	`setWfsZufiOviBuffer(double wfsZufiOviBuffer)`
`private com.vividsolutions.jts.geom.Point`	`transformMapProjectionToMapExternProjection(com.vividsolutions.jts.geom.Point point)` Koordinatentransformation von der internen Darstellung auf ein Koordinatensystem für die Darstellung des Ortes eines Vorganges in einem externen System.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

logger

private static final org.apache.log4j.Logger logger

geoServiceWfs
```
@Autowired
GeoServiceWfs geoServiceWfs
```

settingsService

@Autowired
SettingsService settingsService

mapProjection
```
String mapProjection
```

mapMaxExtent
```
String mapMaxExtent
```

mapRestrictedExtent
```
String mapRestrictedExtent
```

mapResolutions
```
String mapResolutions
```

mapUnits
```
String mapUnits
```

mapOviMargin
```
Integer mapOviMargin
```

mapLayersOneType
```
String mapLayersOneType
```

mapLayersOneParams
```
String mapLayersOneParams
```

mapLayersTwoType
```
String mapLayersTwoType
```

mapLayersTwoParams
```
String mapLayersTwoParams
```

mapLayersPoiType
```
String mapLayersPoiType
```

mapLayersPoiParams
```
String mapLayersPoiParams
```

mapExternProjection
```
String mapExternProjection
```

mapExternName
```
String mapExternName
```

mapExternUrl
```
String mapExternUrl
```

mapExternExternUrl
```
String mapExternExternUrl
```

vorgangCoordinates
```
String vorgangCoordinates
```

wfsVorgaengeUrl
```
String wfsVorgaengeUrl
```

wfsVorgaengeFeatureNs
```
String wfsVorgaengeFeatureNs
```

wfsVorgaengeFeaturePrefix
```
String wfsVorgaengeFeaturePrefix
```

wfsVorgaengeFeatureType
```
String wfsVorgaengeFeatureType
```

adressensucheUrl
```
String adressensucheUrl
```

adressensucheKey
```
String adressensucheKey
```

adressensucheLocalisator
```
String adressensucheLocalisator
```

wfsZufiExceptionHandling

GeoService.WfsZufiExceptionHandling wfsZufiExceptionHandling

wfsZufiCapabilitiesUrl
```
String wfsZufiCapabilitiesUrl
```

wfsZufiOviBuffer
```
double wfsZufiOviBuffer
```

dataStore
```
org.geotools.data.DataStore dataStore
```

filterFactory

org.opengis.filter.FilterFactory2 filterFactory

Constructor Detail
- GeoService
```
public GeoService()
```

Method Detail
- init
```
@PostConstruct
public void init()
```
  Initialisierung für die Nutzung des WFS und in diesem Zusammenhang ggf. das Setzen von Proxyparametern.
- transformMapProjectionToMapExternProjection
```
private com.vividsolutions.jts.geom.Point transformMapProjectionToMapExternProjection(com.vividsolutions.jts.geom.Point point)
```
  Koordinatentransformation von der internen Darstellung auf ein Koordinatensystem für die Darstellung des Ortes eines Vorganges in einem externen System.
  
  Parameters:
  
  point - Punktkoordinate, die transformiert werden soll
- getMapExternUrl
```
public String getMapExternUrl(Vorgang vorgang)
```
  Erstellung der URL zur Darstellung des Ortes eines Vorganges in einem externen Web-Mapping-System Die URL kann über die Einstellungen konfiguriert werden und kann die folgenden Platzhalter beinhalten: %xmin%, %ymin%, %xmax%, %ymax%, %x%, %y%, %id%
  
  Parameters:
  
  vorgang - Vorgang, für den die URL erzeugt werden soll
  
  Returns:
  
  URL für die externe Anzeige
  
  See Also:
  
  mapExternUrl
- searchAddress
```
public String searchAddress(String query)
```
  Adressensuche
  
  Parameters:
  
  query - Suchtext
  
  Returns:
  
  Adresse
- calculateAddress
```
public String calculateAddress(com.vividsolutions.jts.geom.Point point)
```
  Ermittlung der Adresse
  
  Parameters:
  
  point - Punktkoordinate, für die die Adresse ermittelt werden soll
  
  Returns:
  
  Adresse
- calculateAddressD3
```
public String[] calculateAddressD3(com.vividsolutions.jts.geom.Point point)
```
  Ermittlung der Adresse für d.3
  
  Parameters:
  
  point - Punktkoordinate, für die die Adresse ermittelt werden soll
  
  Returns:
  
  Adresse
- getMapExternExternUrl
```
public String getMapExternExternUrl(Vorgang vorgang)
```
  Erstellung der URL zur Darstellung des Ortes eines Vorganges in einem externen System (z.B. im Frontend). Die URL kann über die Einstellungen konfiguriert werden und kann die folgenden Platzhalter beinhalten: %x%, %y% und %id%,
  
  Parameters:
  
  vorgang - Vorgang, für den die URL erzeugt werden soll
  
  Returns:
  
  Url für die externe Anzeige
  
  See Also:
  
  mapExternExternUrl
- getVorgangCoordinates
```
public String getVorgangCoordinates(Vorgang vorgang)
```
  Erstellung der URL zur Darstellung des Ortes eines Vorganges in einem externen System (z.B. im Frontend). Die URL kann über die Einstellungen konfiguriert werden und kann die folgenden Platzhalter beinhalten: %x%, %y% und %id%,
  
  Parameters:
  
  vorgang - Vorgang, für den die Koordinaten ausgegeben werden sollen
  
  Returns:
  
  Koordinaten
- calculateFeature
```
public Double calculateFeature(com.vividsolutions.jts.geom.Point ovi,
                               Attribute attribute)
```
  Ermitteln des FeatureWertes für ein Feature mit geographischem Hintergrund
  
  Parameters:
  
  ovi - Punkt, für den das Feature ermittelt werden soll
  
  attribute - Feature, für den der Wert ermittelt werden soll
  
  Returns:
  
  Distanz bzw. Flächengröße entsprechend des Typs
  
  See Also:
  
  Attribute.GeoMeasure
- getGeoFeatures
```
protected Double[] getGeoFeatures(com.vividsolutions.jts.geom.Point ovi,
                                  double wfsZufiOviBuffer,
                                  String typeName,
                                  String geomPropertyName,
                                  String propertyName,
                                  String propertyValue)
```
  Ermittelt die FeatureWerte mit geographischem Hintergrund für ein Feature. Dabei werden die Werte für alle GeoMeasure (abstandInnerhalb, abstandAusserhalb, flaechenGroesse) berechnet. Durch den Aufruf der Funktion über die Funktion GeoServiceWfs.getGeoFeatures(Point, double, String, String, String, String) kann ein ggf. gecachtes Ergebnis der Funktion aufgerufen werden.
  
  Parameters:
  
  ovi - Punkt für den die Features berechnet werden sollen
  
  wfsZufiOviBuffer - Umkreis des Punktes der mit berücksichtigt werden soll
  
  typeName - Typ des Features beim WFS
  
  geomPropertyName - Name des Geometrieattributs beim WFS
  
  propertyName - PropertyName beim WFS
  
  propertyValue - PropertyValue beim WFS
  
  Returns:
  
  Featurwerte für den Punkt [0] abstandAusserhalb, [1] abstandInnerhalb und [2] flaechenGroesse
  
  See Also:
  
  GeoServiceWfs.getGeoFeatures(Point, double, String, String, String, String)
- getGeoFeatures
```
protected List<GeoFeature> getGeoFeatures(com.vividsolutions.jts.geom.Point ovi,
                                          double wfsZufiOviBuffer,
                                          String typeName,
                                          String geomPropertyName,
                                          String propertyName)
```
  Ermittelt die angefragten WFS-Features zu einem gegebenen Punkt und dessen Umkreis, die den Umkreis schneiden. Durch den Aufruf der Funktion über die Funktion GeoServiceWfs.getGeoFeatures(Point, double, String, String, String) kann ein ggf. gecachtes Ergebnis der Funktion aufgerufen werden.
  
  Parameters:
  
  ovi - Punkt für den die WFS-Features ermittelt werden sollen
  
  wfsZufiOviBuffer - Umkreis um den Punkt, der berücksichtigt werden soll
  
  typeName - Typ des Features beim WFS
  
  geomPropertyName - Name des Geometrieattributs beim WFS
  
  propertyName - PropertyName beim WFS
  
  Returns:
  
  Liste von GeoFeatures
  
  See Also:
  
  GeoServiceWfs.getGeoFeatures(Point, double, String, String, String), GeoFeature
- getMapProjection
```
public String getMapProjection()
```
- setMapProjection
```
public void setMapProjection(String mapProjection)
```
- getMapMaxExtent
```
public String getMapMaxExtent()
```
- setMapMaxExtent
```
public void setMapMaxExtent(String mapMaxExtent)
```
- getMapRestrictedExtent
```
public String getMapRestrictedExtent()
```
- setMapRestrictedExtent
```
public void setMapRestrictedExtent(String mapRestrictedExtent)
```
- getMapResolutions
```
public String getMapResolutions()
```
- setMapResolutions
```
public void setMapResolutions(String mapResolutions)
```
- getMapUnits
```
public String getMapUnits()
```
- setMapUnits
```
public void setMapUnits(String mapUnits)
```
- getMapOviMargin
```
public Integer getMapOviMargin()
```
- setMapOviMargin
```
public void setMapOviMargin(Integer mapOviMargin)
```
- getMapLayersOneType
```
public String getMapLayersOneType()
```
- setMapLayersOneType
```
public void setMapLayersOneType(String mapLayersOneType)
```
- getMapLayersOneParams
```
public String getMapLayersOneParams()
```
- setMapLayersOneParams
```
public void setMapLayersOneParams(String mapLayersOneParams)
```
- getMapLayersTwoType
```
public String getMapLayersTwoType()
```
- setMapLayersTwoType
```
public void setMapLayersTwoType(String mapLayersTwoType)
```
- getMapLayersTwoParams
```
public String getMapLayersTwoParams()
```
- setMapLayersTwoParams
```
public void setMapLayersTwoParams(String mapLayersTwoParams)
```
- getMapLayersPoiType
```
public String getMapLayersPoiType()
```
- setMapLayersPoiType
```
public void setMapLayersPoiType(String mapLayersPoiType)
```
- getMapLayersPoiParams
```
public String getMapLayersPoiParams()
```
- setMapLayersPoiParams
```
public void setMapLayersPoiParams(String mapLayersPoiParams)
```
- getMapExternProjection
```
public String getMapExternProjection()
```
- setMapExternProjection
```
public void setMapExternProjection(String mapExternProjection)
```
- getMapExternName
```
public String getMapExternName()
```
- setMapExternName
```
public void setMapExternName(String mapExternName)
```
- getMapExternUrl
```
public String getMapExternUrl()
```
- setMapExternUrl
```
public void setMapExternUrl(String mapExternUrl)
```
- getMapExternExternUrl
```
public String getMapExternExternUrl()
```
- setMapExternExternUrl
```
public void setMapExternExternUrl(String mapExternExternUrl)
```
- getVorgangCoordinates
```
public String getVorgangCoordinates()
```
- setVorgangCoordinates
```
public void setVorgangCoordinates(String vorgangCoordinates)
```
- getWfsZufiCapabilitiesUrl
```
public String getWfsZufiCapabilitiesUrl()
```
- setWfsZufiCapabilitiesUrl
```
public void setWfsZufiCapabilitiesUrl(String wfsZufiCapabilitiesUrl)
```
- getWfsZufiOviBuffer
```
public double getWfsZufiOviBuffer()
```
- setWfsZufiOviBuffer
```
public void setWfsZufiOviBuffer(double wfsZufiOviBuffer)
```
- getWfsZufiExceptionHandling
```
public GeoService.WfsZufiExceptionHandling getWfsZufiExceptionHandling()
```
- setWfsZufiExceptionHandling
```
public void setWfsZufiExceptionHandling(GeoService.WfsZufiExceptionHandling wfsZufiExceptionHandling)
```
- getWfsVorgaengeUrl
```
public String getWfsVorgaengeUrl()
```
- setWfsVorgaengeUrl
```
public void setWfsVorgaengeUrl(String wfsVorgaengeUrl)
```
- getWfsVorgaengeFeatureNs
```
public String getWfsVorgaengeFeatureNs()
```
- setWfsVorgaengeFeatureNs
```
public void setWfsVorgaengeFeatureNs(String wfsVorgaengeFeatureNs)
```
- getWfsVorgaengeFeaturePrefix
```
public String getWfsVorgaengeFeaturePrefix()
```
- setWfsVorgaengeFeaturePrefix
```
public void setWfsVorgaengeFeaturePrefix(String wfsVorgaengeFeaturePrefix)
```
- getWfsVorgaengeFeatureType
```
public String getWfsVorgaengeFeatureType()
```
- setWfsVorgaengeFeatureType
```
public void setWfsVorgaengeFeatureType(String wfsVorgaengeFeatureType)
```
- getAdressensucheUrl
```
public String getAdressensucheUrl()
```
- setAdressensucheUrl
```
public void setAdressensucheUrl(String adressensucheUrl)
```
- getAdressensucheKey
```
public String getAdressensucheKey()
```
- setAdressensucheKey
```
public void setAdressensucheKey(String adressensucheKey)
```
- getAdressensucheLocalisator
```
public String getAdressensucheLocalisator()
```
- setAdressensucheLocalisator
```
public void setAdressensucheLocalisator(String adressensucheLocalisator)
```
- getDataStore
```
public org.geotools.data.DataStore getDataStore()
```

Class GeoService

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

logger

geoServiceWfs

settingsService

mapProjection

mapMaxExtent

mapRestrictedExtent

mapResolutions

mapUnits

mapOviMargin

mapLayersOneType

mapLayersOneParams

mapLayersTwoType

mapLayersTwoParams

mapLayersPoiType

mapLayersPoiParams

mapExternProjection

mapExternName

mapExternUrl

mapExternExternUrl

vorgangCoordinates

wfsVorgaengeUrl

wfsVorgaengeFeatureNs

wfsVorgaengeFeaturePrefix

wfsVorgaengeFeatureType

adressensucheUrl

adressensucheKey

adressensucheLocalisator

wfsZufiExceptionHandling

wfsZufiCapabilitiesUrl

wfsZufiOviBuffer

dataStore

filterFactory

Constructor Detail

GeoService

Method Detail

init

transformMapProjectionToMapExternProjection

getMapExternUrl

searchAddress

calculateAddress

calculateAddressD3

getMapExternExternUrl

getVorgangCoordinates

calculateFeature

getGeoFeatures

getGeoFeatures

getMapProjection

setMapProjection

getMapMaxExtent

setMapMaxExtent

getMapRestrictedExtent

setMapRestrictedExtent

getMapResolutions

setMapResolutions

getMapUnits

setMapUnits

getMapOviMargin

setMapOviMargin

getMapLayersOneType

setMapLayersOneType

getMapLayersOneParams

setMapLayersOneParams

getMapLayersTwoType

setMapLayersTwoType

getMapLayersTwoParams

setMapLayersTwoParams

getMapLayersPoiType

setMapLayersPoiType

getMapLayersPoiParams

setMapLayersPoiParams

getMapExternProjection

setMapExternProjection

getMapExternName