==Karten Konfig==

Damit die Liste der darstellbaren Karten überschaubar bleibt, kann man diese konfigurieren. Aus der langen Liste der verfügbaren Karten werden nur diejenigen angeboten welche man auch wirklich braucht.

[[Image:KartenKonfiguration.png|KartenKonfiguration.png]]

'''Name''': Ein beliebiger Name für die Karte.

'''Map Provider''': Anbieter der Karte. Es steht eine lange Liste von Anbietern zur Verfügung. Aber nicht jeder Anbieter bietet Karten für die ganze Welt an. Google, Bing, etc. liefern Karten für die ganze Welt. Swiss Topo logischerweise nur für die Schweiz.

'''Overlay''': Über die Karte kann nichts, eine Schattierung oder Höhenlinien eingeblendet werden. Achtung: Die Schattierung und die Höhenlinien stehen nur von Italien bis zirka Mitte Norwegens zur Verfügung.

'''Gitter''': Wenn diese Option gesetzt ist, dann wird über die Karte und die Schattierung/Höhenlinien zusätzlich noch ein Kilometer Raster gezeichnet. Das Raster passt sich automatisch dem Zoom Level an und ist dann ein 100m, 1km, 10km oder 100km Raster.

'''Prefetch''': Gibt den Grad des Kartenausschnitt Prefetches (Vorladen) an. Wenn hier ein Wert grösser 0 eingegeben wird, dann werden im Hintergrund weitere Kartenausschnitte übers Internet herunter geladen. Diese stehen dann unmittelbar zur Verfügung wenn man den dargestellten Kartenbereich wechselt oder hinein oder hinaus zoomt. Die Menge an übertragenen Daten steigt damit aber massiv an und könnte damit viel schneller zu einer Sperrung beim Map Provider führen. Also nur mit Bedacht verwenden.

Mit den beiden Pfeilen am linken Rand kann die Reihenfolge geändert werden. Über die "Delete" Taste kann eine Karte gelöscht werden. Die in der GCRouter Datenbank gespeicherten Kartenausschnitte werden dabei NICHT mit gelöscht.

'''Maximales Alter der gespeicherten Kartenausschnitte''': Nach so vielen Tagen werden die Kartenausschnitte aus der GCRouter Datenbank gelöscht und bei der nächsten Verwendung dann wieder übers Internet herunter geladen.

'''Maximales Alter der Routen''': Dito für die in der GCRouter Datenbank gespeicherten Routen.

==Eigene Karten/Map Provider==

Seit Februar 2019 kann die bisher fixe Liste der Kartenanbieter vom Benutzer erweitert werden. Dazu ist im data Verzeichnis eine Textdatei mit dem Namen maps.txt zu erstellen.

Beispiel:

<nowiki>
[OpenTopoMap]
name=OpenTopoMap
type=tms
url=https://,b,c}.tile.opentopomap.org/{zoom}/{x}/{y}.png
referer-url=https://www.opentopomap.org
min-zoom=3
max_zoom=17

[Basel-Landschaft-2015]
name=Kanton Basel-Landschaft 10cm
type=tms
url=https://mapproxy.osm.ch/tiles/KTBASELLANDSCHAFT2015/EPSG900913/{zoom}/{x}/{y}.png?origin=nw
min-zoom=18
max-zoom=21
min-lat=47.337882
max-lat=47.564368
min-lon=7.325281
max-lon=7.961832</nowiki>

Jeder Map Provider beginnt mit einer Id welche in eckigen Klammern geschrieben wird.

Darunter kommen folgende Informationen zum Map Provider:

{|class="wikitable"
|'''Name''' || '''Beschreibung''' || '''Pflicht''' || '''Default-Wert'''
|-
|name || Der Name des Karten Anbieters. Dieser Name muss eindeutig sein.
||Pflicht
||
|-
|type
||Der Typ des Anbieters. Aktuell wird nur "tms" unterstützt.
||Optional
||tms
|-
|url
||Die URL des Anbieters. Kann Platzhalter enthalten.
||Pflicht
||
|-
|referer-url
||Ist manchmal nötig um die Karten korrekt runter laden zu können.
||Optional
||GCRouter
|-
|min-zoom, max-zoom
||Minimale und maximale Zoomstufe welche dere Anbieter unterstützt.
||Optional
||1 bis 17
|-
|min-lat, max-lat, min-lon, max-lon
||Unterstützter Bereich
||Optional
||Ganze Welt
|}

Die Syntax der URL ist an diejenige von JOSM angelehnt.

Beispiele für Karten Anbieter zusammen mit den entsprechenden Infos findest du hier: https://josm.openstreetmap.de/wiki/Maps

2019-01-27T13:11:07Z

Admin: /* Interna */

=='''Installation von GCRouter'''==

GCRouter ist ein Programm für Windows ab der Version Windows 8.
Seit der Version 1.20 (2019.01.24) von GCRouter wird nur noch Windows 64bit unterstützt. Falls du noch eine 32bit Version
benötigst, dann melde dich bei mir.

GCRouter benötigt die .NET Laufzeitumgebung ab der Version 4. Diese ist ab Windows 8 mit dabei. Falls sie
aus irgend welchen Gründen doch fehlt, dann muss sie separat von der [https://www.microsoft.com/de-ch/download/details.aspx?id=17718 Microsoft Web Seite] runter geladen und installiert werden.

===Installation GCRouter===

* Download GCRouter
* Für 64bit Windows: [https://gc.bubendorf.net/dl/GCRouterSetup20190125x64.exe GCRouterSetup20190125x64.exe]
* Doppelklick auf GCRouterSetupXXXXXXXX.exe

Bitte beachte die [[Release%20Notes|Release Notes]] und vor allem auch das Kapitel über die
[[Fehler%20Behandlung|Fehler Behandlung]]!

Ach ja: Anstatt ellenlangem juristischem BlaBla sage ich nur "Verwendung auf eigene Gefahr".

===Interna===

GCRouter speichert alle übers Internet herunter geladenen Daten in lokalen Datenbanken. Diese stehen bei späteren Starts von GCRouter zur Verfügung. Die Daten müssen dann nicht mehr herunter geladen werden.

Diese Datenbanken werden im Ordner 'data' angelegt. Dieser Ordner wird beim ersten Start von GCRouter an einem von zwei Orten auf der Harddisk angelegt:

Entweder im Verzeichnis wo GCRouter installierte wurde. In der Regel ist dies das Verzeichnis C:\Programme\GCRouter. Die Datenbanken liegen dann im Verzeichnis C:\Programe\GCRouter\data.

Oder aber die Datenbanken werden im "Gemeinsamen Applikationsdaten Verzeichnis" von Windows abgelegt. Das ist in der Regel das Verzeichnis C:\ProgramData\GCRouter. Die Datenbanken befinden sich dann also im Verzeichnis C:\ProgramData\GCRouter\data.

Den genauen Daten Pfad findest du über Hilfe - Über GCRouter:

[[Image:About.png|350x427px]]

====Dateien und Ordner im data Ordner====

'''keys.txt''': Die Zugangsschlüssel für die diversen Karten- und Routenanbieter. Siehe dazu auch [[ApiKey]].

'''Cache\TileDBv5\de\Data.gmdb''': Alle heruntergeladenen Karten Kacheln landen in dieser Datei. Nach einer gewissen Zeit werden die Kacheln aus der Datei gelöscht. Die Zeitspanne kann über Optionen-Karten... konfiguriert werden.

'''Cache\Elevation.db3''': Daten über die Höhe über Meer.

'''Cache\RouteDBV3.db3''': Einzelne Routen zwischen zwei Orten. Auch die Routen werden nach einer gewissen Zeit aus dieser Datenbank entfernt.

'''dem\*.hgt''': Dateien mit den Höhen über Meer im 30m oder 90m Raster. Diese Dateien müssen selber herunter geladen werden. Stehen sie zur Verfügung zeigt GCRouter die Höhe über Meer des Punktes unter der Maus an.

'''GCRouter.ini''': Hier speichert GCRouter all seine Einstellungen.

'''*.wpe''': Waypoints Extensions!

'''*.gpx''': Wegpunkte welche im Kontext Menü der Karte erscheinen.

'''GCRouter Portable'''

GCRouter kann auch als portable Version auf einem Memory Stick oder einer externen Festplatte installiert werden. Die Einstellungen, die Daten und die Caches landen dann auch auf dieser externen Festplatte und stehen daher auf einem anderen Computer sofort zur Verfügung.
Wenn man GCRouter bereits auf dem Computer als nicht portable Variante installiert hat, muss man lediglich den ganzen Programmordner auf die externe Harddisk kopieren:

- Kopieren von z.B. c:\Programme\GCRouter nach E:\GCRouter

- Anschliessend kopiert man die Daten, Einstellungen und Caches:

- Kopieren von z.B. C:\ProgramData\GCRouter nach E:\GCRouter\data

- GCRouter kann nun über GCRouter.exe gestartet werden.

'''Wichtig:'''

Der Ordner "data" muss genau so heissen (Also data) und muss sich im gleichen Ordner wie GCRouter.exe befinden.

ApiKey

2019-01-27T13:08:17Z

Admin:

GCRouter verwendet diverse Anbieter um Karten runter zu laden, um Routen zu berechnen oder um Ort und Koordinaten zu suchen. Die meisten Anbieter bieten diese Dienste nur beschränkt an.

Meistens gibt es zwar eine Gratis-Variante des Dienstes. Diese Gratis-Variante erlaubt nur eine beschränkte Anzahl von Anfragen pro Zeiteinheit, meistens pro Tag manchmal auch pro Monat.
Für die Zuordnung der Anfrage an eine Applikation bzw. an einen Benutzer werden Schlüssel/Keys verwendet: Jedee Applikation oder jeder Benutzer erhält vom Anbieter einen solchen Schlüssel.

GCRouter verwendet intern jeweils einen solchen Schlüssel. Dieser ist aber für alle Benutzer von GCRouter der gleiche. Wenn nun zuviele Benutzer GCRouter mit diesem Schlüssel verwenden kann die Limite für einen Dienst überschritten werden. Anfragen an Google, Bing oder GraphHopper schlagen dann fehl und sind erst nach Ablauf der Zeiteinheit wieder möglich.

Um diese Einschränkung zu umgehen bzw. zu minimieren kann jeder Benutzer seinen eigenen Schlüssel erstellen und in GCRouter verwenden. Die Anfragen zählen dann auf das eigene Konto und nicht mehr auf das gemeinsame GCRouter Konto. Die Wahrscheinlichkeit die Limite zu überschreiten ist viel kleiner womit alle profitieren.

Es ist zwar nicht nötig. Es wird aber dringend empfohlen für die Verwendung von GCRouter jeweils pro Anbieter einen solchen Schlüssel zu lösen.

Die Tabelle führt ein paar der von GCRouter verwendeten Anbieter auf. Aufgelistet werden neben dem Namen und der Verwendung die möglichen Beschränkungen und vor allem die Adresse über welche man einen eigenen Schlüssel erzeugen kann.

Dieser Schlüssel muss dann in die Datei keys.txt eingetragen werden. Dies ist eine normale Textdatei welche mit Nodepad oder Ähnlichem bearbeitet werden kann. Du findest die Datei nach dem ersten Start von GCRouter im Daten Verzeichnis von GCRouter. Siehe dazu auch [[Installation]].

Hinweise: Der Google Api Key kann auch gleich für GSAK verwendet werden. Oder falls man für GSAK bereits einen Api Key gelöst hat, dann kann dieser auch für GCRouter verwendet werden. Siehe dazu auch hier http://gsak.net/board/index.php?showtopic=31473&st=0&&do=findComment&comment=236002.

{|class="wikitable"
! | Anbieter
! Wird verwendet für
! Beschränkungen
!Schlüssel/Key
|-
|BRouter / bubendorf.net
|Wander-, Velo- und PKW-Routen, Schweizer Karten inkl. Wander- und Velowegen
|Momentan keine (Ausser einem alten, langsamen Server
|Ab und zu ein Bier an den Betreiber bubendorf!
|-
|Google
|Weltweite Karten, Routen, Ortsbestimmung
|Maximal 25'000 Kartenkacheln pro Tag
|https://developers.google.com/maps/documentation/javascript/get-api-key
|-
|Bing
|Weltweite Karten, Routen
|Maximal 10'000 Abfragen pro Tag
|https://docs.microsoft.com/en-us/bingmaps/getting-started/bing-maps-dev-center-help/getting-a-bing-maps-key
|-
|GraphHopper
|Wander-, Velo- und PKW-Routen
|Maximal 500 Abfragen pro Tag
|https://graphhopper.com/api/1/docs/
|}

Wenn alles korrekt funktioniert hat, dann steht in Hilfe - Über GCRouter hinter dem ApiKey drei Mal "Yes".

[[Image:About.png|350x427px]]