Tabelle 3.5. Die Properties für die Provider Setups
| Property-Name | Wert-Typ | Default-Wert | Beschreibung |
|---|---|---|---|
Provider
|
string
|
N/A
| Bestimmt den Typ des Providers am Kopf der Provider-Kette. |
SetupName
|
string
|
N/A
| Bestimmt den Namen des aktiven Setups. |
SetupNames
|
comma separated string list
|
N/A
| Bestimmt die Liste der verfügbaren Setup-Namen. Falls dies angegeben ist und mehr als einen Eintrag enthält, so aktiviert dies die Toolbar-Schaltfläche zum Umschalten zwischen den Setups. |
Tabelle 3.6. Die Properties für die caching Provider
| Property-Name | Wert-Typ | Default-Wert | Beschreibung |
|---|---|---|---|
CacheFile.AllowUpdate
|
boolean
|
true
| Bestimmt, ob der Datei-Cache mit frisch heruntergeladenen Kachelbildern aktualisiert wird. Dies kann verwendet werden, um das Ändern der gecachten Dateien zu verhindern, auch wenn Kacheln manuell forciert aufgefrischt werden. Dies kann nützlich sein, sofern das Cache-Verzeichnis nur lesbar ist oder der ausführende Benutzer keine Schreibrechte darin besitzt. |
CacheFile.Directory
|
string
|
N/A
| Bestimmt den Pfad des Verzeichnises, worin die gecachten Kachelbilder gesucht und gespeichert werden sollen. Dieses Property unterstützt einfache Variablen-Expansion mit spezieller Unterstützung für die DYN_* Dateivariablen, welche mit den Einstellungen der FileHandler-Datei gefüllt werden. Dies erlaubt es, das Cache-Verzeichnis relativ zu dieser Datei zu halten. Aber es ist auch möglich, hier einfach einen absoluten Pfad anzugeben. |
CacheFile.Format
|
string
|
jpg
| Bestimmt das Format, in welchem die lokalen Kachelbilder gespeichert werden
sollen. Dies ist mit Absicht unabhängig vom Dateiformat, welches vom Internet-Dienst
erhalten wurde, um weitere Komprimierung zu unterstützen (viele Provider liefern
.PNG-Dateien aus, welche noch signifikant komprimiert werden können, wenn hier
.JPG verwendet wird). Der angegebene String muss eines der von
javax.imageio unterstützten Bildformate sein, also z.B. "png",
"jpg", etc.. |
CacheFile.MaxAge
|
Dauer
|
0-00:00:00.000
| Bestimmt das maximale Alter, nach welchem auf der Festplatte gecachte Kartenkacheln als nicht mehr aktuell behandelt werden sollen. Solche Kacheln werden dann beim nächsten Zugriff vom darunterliegenden Provider erneut angefordert. Falls dies Null ist (der Default), so behalten gecachte Kacheln ihre Gültigkeit ohne Limit und die einzige Möglichkeit zum Auffrischen besteht in einem manuell forciertem Neuladen. |
CacheFile.Provider
|
string
|
N/A
| Bestimmt den den Typ des Kachel-Providers, welcher für noch nicht im Cache-Verzeichnis vorliegende Kacheln konsultiert werden soll. |
CacheMemory.MaxAge
|
Dauer
|
0-00:00:00.000
| Bestimmt das maximale Alter, nach welchem im Arbeitsspeicher gecachte Kartenkacheln als nicht mehr aktuell behandelt werden sollen. Solche Kacheln werden dann beim nächsten Zugriff vom darunterliegenden Provider erneut angefordert. Falls dies Null ist (der Default), so behalten gecachte Kacheln ihre Gültigkeit ohne Limit und die einzige Möglichkeit zum Auffrischen besteht in einem manuell forciertem Neuladen. |
CacheMemory.Provider
|
string
|
N/A
| Bestimmt den den Typ des Kachel-Providers, welcher für noch nicht im Arbeitsspeicher vorliegende Kacheln konsultiert werden soll. |
CacheMemory.SizeLimit
|
int
|
16
| Bestimmt die maximale Anzahl von Kacheln, welche im Arbeitsspeicher vorgehalten werden dürfen. |
Die beiden Dauer-Properties oben müssen exakt im folgenden Format angegeben werden:
Anzahl Tage als nicht-negativer Integerwert
Ein einzelner Dash: "-"
Anzahl Stunden mit exakt zwei Ziffern
Ein einzelner Doppelpunkt: ":"
Anzahl Minuten mit exakt zwei Ziffern
Ein einzelner Doppelpunkt: ":"
Anzahl Sekunden mit exakt zwei Ziffern
Ein einzelner Punkt: ":"
Anzahl Millisekunden mit exakt drei Ziffern
Tabelle 3.7. Die Properties für die Provider mit einem Netzwerk-Backend
| Property-Name | Wert-Typ | Default-Wert | Beschreibung |
|---|---|---|---|
ArcGIS.URL
|
string
|
siehe unten
| Bestimmt die Template-Kachel-URL für diesen Provider. |
BingMaps.URL
|
string
|
siehe unten
| Bestimmt die Template-Kachel-URL für diesen Provider. |
GoogleMaps.URL
|
string
|
siehe unten
| Bestimmt die Template-Kachel-URL für diesen Provider. |
OpenStreetMap.Copyright
|
string
|
(leer)
| Erlaubt das Übersteuern des Default-Copyright-Hinweistextes für diesen Provider. Da einige Kachel-Server die Kacheln gemäss der Vorgabe von OpenStreetMap ausliefern, jedoch dahinter ihre eigenen Daten stehen, gilt für diese ein anderes Copyright. Falls dies leer oder nicht angegeben ist, so wird das Standard-Copyright von OpenStreetMap angezeigt von diesem Provider. |
OpenStreetMap.MaxZoom
|
integer
|
18
| Bestimmt den maximalen Zool-Level für diesen Provider. Dies kann justiert werden, da verschiedene OpenStreetMap Kachel-Server unterschiedliche solche Limiten haben können. |
OpenStreetMap.URL
|
string
|
siehe unten
| Bestimmt die Template-Kachel-URL für diesen Provider. |
WebMapService.Copyright
|
string
|
(leer)
| Erlaubt die Anzeige eines Copyright-Hinweistextes für diesen Provider, da die meisten dieser Kartendienste ihre Daten gemäss spezifischer Nutzungsbedingungen ausliefern. Falls dies leer oder nicht angegeben ist, so wird kein Copyright angezeigt von diesem Provider. |
WebMapService.MaxZoom
|
integer
|
18
| Bestimmt den maximalen Zool-Level für diesen Provider. Dies kann justiert werden, da verschiedene Karten-Server unterschiedliche solche Limiten haben können. |
WebMapService.MinZoom
|
integer
|
0
| Bestimmt den minimalen Zool-Level für diesen Provider. Dies kann justiert werden, da verschiedene Karten-Server unterschiedliche solche Limiten haben können. |
WebMapService.URL
|
string
|
siehe unten
| Bestimmt die Template-Kachel-URL für diesen Provider. |
WebMapService.BasicAuth.Username
|
string
|
(leer)
| Bestimmt einen Benutzernamen für HTTP BasicAuth. Dies wird nur verwendet wenn sowohl Benutzername als auch Password angegeben wurden. |
WebMapService.BasicAuth.Password
|
string
|
(leer)
| Bestimmt ein Passwort für HTTP BasicAuth. |
YandexMaps.URL
|
string
|
siehe unten
| Bestimmt die Template-Kachel-URL für diesen Provider. |
Die URLs für die verschiedenen Provider oben können weggelassen werden, falls sie sich nicht von den folgenden Default-Werten unterscheiden:
ArcGIS.URL:
http://services.arcgisonline.com/ArcGIS/rest/services/World_Topo_Map/MapServer/tile/${MapTile.Zoom}/${MapTile.Y}/${MapTile.X}.png
Zu beachten ist hier die umgekehrte Reihenfolge der Variablen
MapTile.X und MapTile.Y im Pfad im Vergleich zum
OpenStreetMap Provider ...
BingMaps.URL:
http://t0.tiles.virtualearth.net/tiles/a${MapTile.QuadKey}.jpeg?g=1&mkt=en-US
Hier ist zu beachten, dass die MapTile.QuadKey Variable nur von diesem
Provider definiert wird!
GoogleMaps.URL:
https://mt0.google.com/vt?lyrs=m,t&scale=${MapTile.Scale}&z=${MapTile.Zoom}&x=${MapTile.X}&y=${MapTile.Y}&hl=loc
Hier ist zu beachten, dass der Parameter lyrs die Art der Karte wie
folgt bestimmt:
m: Strassenkarte
t: Terrainkarte
p: Politisch: Terrain mit Ländergrenzen
s: Satellit
h: Hybrid: nur transparente Strassenkarte
r: Raw: Leere Karte
y: Satellit mit überblendeter Strassenkarte
OpenStreetMap.URL:
http://tile.openstreetmap.org/${MapTile.Zoom}/${MapTile.X}/${MapTile.Y}.png
WebMapService.URL:
ACHTUNG: Für diesen Provider gibt es keine Default-URL, weshalb sie immer konfiguriert werden muss.
Folgende Variablen werden zur Expansion unterstützt beim Kachel-Zugriff:
MapTile.TileSize. die Kachelgrösse in Pixel
MapTile.MinLon. der minimale Längengrad der Kachel
MapTile.MinLat. der minimale Breitengrad der Kachel
MapTile.MaxLon. der maximale Längengrad der Kachel
MapTile.MaxLat. der maximale Breitengrad der Kachel
Eine Beispiel-URL für den Zugriff auf SwissTopo-Karten könnte folgendermassen aussehen:
https://wms.swisstopo.admin.ch/wss/httpauth/swisstopowms/?LAYERS=ch.swisstopo.landeskarte-farbe-10&TRANSPARENT=false&FORMAT=image/png&SERVICE=WMS&VERSION=1.3.0&REQUEST=GetMap&STYLES=&EXCEPTIONS=INIMAGE&CRS=CRS:84&BBOX=${MapTile.MinLon},${MapTile.MinLat},${MapTile.MaxLon},${MapTile.MaxLat}&WIDTH=${MapTile.TileSize}&HEIGHT=${MapTile.TileSize}
YandexMaps.URL:
http://vec04.maps.yandex.net/tiles?l=map&z=${MapTile.Zoom}&x=${MapTile.X}&y=${MapTile.Y}&lang=en-US
MapTile.Scale
MapTile.X
MapTile.Y
MapTile.Zoom
Tabelle 3.8. Die Properties für den speziellen Offline Provider
| Property-Name | Wert-Typ | Default-Wert | Beschreibung |
|---|---|---|---|
Offline.Background
|
color
|
89,89,89
| Bestimmt die Hintergrundfarbe für nicht verfügbare Kacheln. |
Offline.Text
|
string
|
[Nicht verfügbar weil offline]
| Bestimmt eine Meldung zur Anzeige in der Kachelmitte. |
Offline.TextColor
|
color
|
200,0,0
| Bestimmt die Textfarbe für die Kachel-Meldung. |
Offline.TextFont
|
string
|
Dialog-ITALIC-14
| Bestimmt den Schriftnamen für die Kachel-Meldung. |
Offline.Copyright
|
string
|
(leer)
| Erlaubt die Anzeige eines Copyright-Hinweistextes für diesen Provider. Falls dies leer oder nicht angegeben ist, so wird kein Copyright angezeigt von diesem Provider. |
Offline.MaxScale
|
integer
|
10
| Bestimmt die maximale Skalierung dieses Providers. |
Offline.MaxZoom
|
integer
|
20
| Bestimmt den maximalen Zoom-Level dieses Providers. |
Offline.MinScale
|
integer
|
0
| Bestimmt die minimale Skalierung dieses Providers. |
Offline.MinZoom
|
integer
|
0
| Bestimmt den minimalen Zoom-Level dieses Providers. |
Offline.TileSize
|
integer
|
256
| Bestimmt Kachelgrösse dieses Providers. |
Dieser Provider kann als Backend für einen der Caching Provider verwendet werden, falls sichergestellt werden soll, dass kein Netzwerkverkehr stattfinden darf. In einem solchen Fall sollten die Minima und Maxima für Skalierung und Zoom-Level so konfiguriert werden, dass sie den verfügbaren Kacheln im (Datei-)Cache entsprechen.