Skip to content

Latest commit

 

History

History
154 lines (122 loc) · 6.18 KB

mapset.md

File metadata and controls

154 lines (122 loc) · 6.18 KB
Raw

Hauptmenü

Verwaltung der Kartensätze

Hinweis: Wenn das Addon als reines Proxy-Addon konfiguriert ist, ist die Verwaltung der Kartensätze ausgeblendet.

Kartensätze basieren auf einer oder mehreren Karten, die per Kartenanbieter-URLs bereitgestellt werden. Jede URL bietet Zugriff auf einen Kartentyp, der auf der Karte als Layer erscheint. Beispiel: Standardkarte, Satellitenbild, Kombination aus beidem.

URLs / Karten / Layer werden im Bereich Karte verwaltet.

Auch wenn nachstehend Beispiele für PHP- und JS-Scripte stehen: meist werden die Daten im Hintergrund benutzt. Details und weitere Beispiele finden sich in den Entwicklerseiten.

Auflistung der Kartensätze

Über die Auswahlliste werden die Karten verwaltet.

Konfiguration

  • Kartensatz anlegen Plus(+)-Symbol in der Kopfzeile der ersten Spalte legt einen neuen Kartensatz an und öffnet ein leeres Formular zur Erfassung der Daten.

  • Kartensatz bearbeiten Klick auf das Tabellen-Symbol in der linken Spalte oder auf den Button "editieren" erlaubt die Bearbeitung des Eintrags im Formular.

  • Kartensatz löschen Klick auf den Button "löschen" entfernt den Kartensatz. Die Daten dürfen nicht gelöscht werden, wenn der Kartensatz in Benutzung ist.

  • Kartensatz löschen Klick auf den Button "Cache löschen" leert den Karten-Cache für alle Karten/Layer in diesen Kartensatz.

Kartensätze zusammenstellen/ändern

Konfiguration

  • Name

    Der Name wird in späteren Versionen evtl. genutzt für JS-Klassen. Er muss schon heute angegeben und eindeutig sein.

  • Titel
    Der Titel dient in der Kartensatz-Übersicht oder in Auswahlboxen für Kartensätze als prägnante Unterscheidung. Er muss angegeben und eindeutig sein.

  • Basiskarten / Overlay-Karten
    Die Unterscheidung von Basiskarten und Overlay-Karten reflektiert das Leaflet-Konzept. Wird Geolocation als Proxy für Karten eines anderen JS-Umfeldes genutzt, ist die Unterscheidung möglicherweise hinfällig. Nur wenn hier mehrere Karten ausgewählt sind, steht auch das Layer-Control zur Kartenauswahl in der Leaflet-Map zur Verfügung.

    In einer Leaflet-Map kann immer nur ein Basiskarten-Layer aktiv sein. Im Unterschied dazu können mehrere Overlay-Karten auf dem aktuellen Basis-Layer übergeblendet werden.

    Das Widget ermöglicht die Auswahl von Basiskarten bzw. Overlay-Karten und deren Anordnung (Reihenfolge). In genau der Reihenfolge würden die Layer im auf der Leaflet-Map bzw. Layer-Control bereitgestellt.

    Der zuerst aktive Basis-Layer bzw. die auf dem Basislayer ab Start anzuzeigenden Overlay-Karten können durch Klick auf die jeweilige Zeile aktiviert werden. Entsprechend kann per Button (rechts in der Zeile) die reihenfolge verändert oder eine zeile gelöscht werden.

    Der Plus-Button rechts im Widget öffnet ein Overlay zur Auswahl und Übernahme von Karten in den Kartensatz.

    Deaktivierte Karten/Layer können in den Kartensatz übernommen werden, sind aber nicht in der Karte verfügbar.

    // Mapset abrufen (::get(id) bzw. ::take())
$mapset = \FriendsOfRedaxo\Geolocation\Mapset::get( $mapsetId );
// Kartendaten (Layer) abrufen
$layerset = $mapset->getLayerset();

    Die Layer ($layerset) werden als Array bereitgestellt. Hier ein Beispiel:

    array:3 [▼
    0 => array:4 [▼
        "layer" => "1"
        "label" => "Karte"
        "type" => "b"
        "attribution" => "Map Tiles &copy; 2020 <a href="http://developer.here.com">HERE</a>"
        "active" => true
    ]
    1 => array:4 [▼
        "layer" => "2"
        "label" => "Satelit"
        "type" => "b"
        "attribution" => "Map Tiles &copy; 2020 <a href="http://developer.here.com">HERE</a>"
        "active" => false
    ]
    2 => array:4 [▼
        "layer" => "3"
        "label" => "Hybrid"
        "type" => "b"
        "attribution" => "Map Tiles &copy; 2020 <a href="http://developer.here.com">HERE</a>"
        "active" => false
    ]
]

  • Kartenoptionen
    Die von Geolocation erzeugten Karten können mit unterschiedlichen Zusatzfunktionen versehen werden. Die Standardwerte für alle Karten sind in den allgemeinen Einstellungen vorbelegt.

    Hier kommt eine zusätzliche Checkbox "Default; Werte aus Einstellungen" in´s Spiel. Damit kann ausdrücklich die Grundeinstellung aktiviert werden; ändert sich die Grundeinstellung gilt es auch für diesen Kartensatz.

    // Mapset abrufen (::get(id) bzw. ::take())
$mapset = \FriendsOfRedaxo\Geolocation\Mapset::take();
// Liste der Optionen abrufen ('|fullscreen|gestureHandling|locateControl|')
$mapOptions = $mapset->getMapOptions();

  • Ausgabe-Fragment
    PHP-seitig verfügt Geolocation über einfach zu nutzende Methoden, das Karten-HTML zu generieren. Dabei wird i.d.R. das hier für diesen Kartensatz angegebene Fragment genutzt. Bleibt das Feld leer wird statt dessen das in den allgemeinen Einstellungen hinterlegte Standard-Fragment genutzt.

    Der Name muss auf .php enden.

    // Mapset abrufen (::get(id) bzw. ::take())
$mapset = \FriendsOfRedaxo\Geolocation\Mapset::take( $mapsetId );
// Ausgabe-Fragment abrufen inkl. Fallback
$outFragment = $mapset->getOutFragment();

Cache löschen

Der rote Button "Cache löschen" oben rechts in den Abbildungen ist i.R. nur für Administratoren freigegeben. Klick auf den Button löscht alle Caches und hat damit Performance-Auswirkungen.