OpenStreetMap einrichten

  OpenStreetMap ist eine kostenlose, weltweite Karte, die im eTASK FM-Portal zur Visualisierung deiner Gebäude und Standorte verwendet wird. Die Karte zeigt die Immobilien mit roten Pins an und ermöglicht eine übersichtliche geografische Darstellung des Portfolios.

 Wo finde ich die Kartenfunktion?

Nach erfolgreicher Einrichtung finden Sie die Kartenfunktion an zwei Stellen:

1. Portfolio Map - Übersichtskarte aller Gebäude  

   Navigation: Portfolio (BIM) > Portfolio Map

2. Gebäude-Kartenansicht - Einzelansicht pro Gebäude  

   Im jeweiligen Gebäudeformular im Bereich "Kartenansicht"

Schritt-für-Schritt-Anleitung zur Einrichtung

 Schritt 1: MapBox-Konto erstellen

OpenStreetMap benötigt einen kostenlosen MapBox-Account zur Darstellung der Karten.

1. Öffne die Website: https://www.mapbox.com/signup/

2. Registriere dich mit deiner Firmen-E-Mail-Adresse.

3. Bestätige deine E-Mail-Adresse über den Link in der Bestätigungs-E-Mail.

4. Melde dich im MapBox-Dashboard an.

Schritt 2: Zugangsschlüssel (Access Token) abrufen

 Nach der Anmeldung benötigst du einen sogenannten "Access Token" (Zugangsschlüssel), um die Karten nutzen zu können. 

1. Klicke im MapBox-Dashboard auf Access Tokens.

2. Kopiere den Default public token (beginnt mit `pk.`)

3. Speichere den Token vorläufig in einer Textdatei.

Alternative: Eigenen Token erstellen

Du kannst auch einen eigenen Token erstellen:

Klicke auf Create a token.

Vergib einen Namen wie "eTASK-Portal

Wähle die Berechtigungen:

styles:read

fonts:read

Klicke auf Create token.

Schritt 3: Access Token in eTASK hinterlegen

Der Access Token muss jetzt in Ihrem eTASK FM-Portal konfiguriert werden. Hierfür benötigst du Administrator-Rechte.

 Melde dich als Administrator im eTASK-Portal an.

1. Navigiere zu: Systemsteuerung > Portal-Optionen > Portal-Konfiguration

2. Öffne den Konfigurationsparameter MAPBOX_ACCESS_TOKEN. Gib im Feld Konfigurationswert den Token aus der Registrierung ein.

3. Klicke in der Arbeitsleiste auf Speichern. Schließe den Konfigurationsparameter.

4. Öffne den Konfigurationsparameter MAPQUEST_APP_KEY. Gib im Feld Konfigurationswert den Token aus der Registrierung ein.

5. Klicke in der Arbeitsleiste auf Speichern. Schließe de Konfigurationsparameter.

6. Falls du die Darstellung der Karte anpassen möchtest, öffne die Konfigurationsparameter MAPBOX_MAP_ID und MAPBOX_STYLE. MapBox bietet einige bereits fertige Darstellungsvarianten an. Hier kannst du entscheiden, welche du nutzen möchtest und entsprechend als Konfigurationswert hinterlegen.

7. Falls du eTASK.Serviceticket nutzt: Bei der Erstellung eines Serviceticktes gibt es die Möglichkeit, einen Außenbereich zu hinterlegen. Dieser wird über die Standortermittlung gesetzt. Falls diese deaktiviert ist oder aus irgendeinem Grund nicht funktioniert, wird ein festgelegter Standard-Ort angezeigt. Diesen Standard-Ort kannst du im Konfigurationsparameter SELECTOR_FALLBACK hinterlegen. Der Ort wird im JSON-Format hinterlegt. Weitere Hinweise findest du dazu im Konfigurationshinweis.

 Klicke auf Speichern.

Schritt 4: Gebäudeadressen und Koordinaten pflegen

 Damit deine Gebäude auf der Karte angezeigt werden, müssen sie über Adressdaten und Koordinaten verfügen.

 Vollständige Adressen eingeben

1. Öffne ein Gebäudeformular

2. Stelle sicher, dass folgende Felder ausgefüllt sind:

• Straße und Hausnummer

• Postleitzahl

• Ort

3. Speichere das Gebäude

Wenn du eine vollständige Adresse eingibst, ermittelt das System automatisch die geografischen Koordinaten (Längen- und Breitengrad). Dies wird als "Geocoding" bezeichnet.

 Koordinaten manuell korrigieren (falls nötig)

Wenn die automatisch ermittelten Koordinaten ungenau sind, kannst du diese manuell anpassen:

1. Öffne das Gebäudeformular

2. Wechsele zum Bereich Kartenansicht.

3. Klicke auf den Kreuz-Button oben rechts (Koordinaten zurücksetzen).

4. Gib die korrekten Koordinaten ein:

• **Latitude (Breitengrad)**: z.B. `50.9375`

• **Longitude (Längengrad)**: z.B. `6.9603`

5. Speichere das Gebäude.

Tipp:  Du kannst Koordinaten auch über Google Maps ermitteln:

          Suche nach deiner Gebäudeadresse

        Rechtsklick auf den Standort → Was ist hier?

         Die Koordinaten werden unten angezeigt und können kopiert werden.

Schritt 5: Berechtigungen einrichten

Damit Benutzer die Portfolio Map sehen können, müssen ihnen die entsprechenden Rechte zugewiesen werden.

1. Navigiere zu: Systemsteuerung > Benutzerverwaltung > Rollen

2. Wähle die gewünschte Rolle aus (z.B. "FM-Leitung")

3. Suche nach dem Recht Portfolio Map.

4. Aktiviere das Kontrollkästchen für Lese-Zugriff.

5. Speichere die Änderungen.

 Achtung: Ohne die entsprechenden Rechte wird der Menüpunkt "Portfolio Map" für Benutzer nicht sichtbar sein. Stellen Sie sicher, dass alle relevanten Rollen berechtigt sind.

Schritt 6: Funktion testen

Nach Abschluss der Einrichtung solltest du die Kartenfunktion testen:

 Portfolio Map testen

• Melden Sie sich als berechtigter Benutzer an

• Navigieren Sie zu: Portfolio (BIM) > Portfolio Map

• Die Karte sollte laden und alle Gebäude mit roten Pins anzeigen

• Klicken Sie auf einen Pin, um Gebäudeinformationen zu sehen

Gebäude-Kartenansicht testen

• Öffnen Sie ein beliebiges Gebäudeformular

• Wechseln Sie zum Bereich "Kartenansicht"

• Das Gebäude sollte mit einem Pin auf der Karte markiert sein

Interaktionsfunktionen prüfen

• Zoomen: Mausrad oder +/- Buttons

• Verschieben: Linke Maustaste gedrückt halten und ziehen

• Drehen: Rechte Maustaste gedrückt halten und ziehen

• Ansicht wechseln: Button links oben (Karte ↔ Satellit

Nach erfolgreicher Einrichtung kannst du systematisch durch das Portfolio und gehen und sicherstellen, dass alle Gebäude vollständige Adressen haben.