MAPBOX_ACCESS_TOKEN - Detailbeschreibung

Open

Überblick

Parameter:MAPBOX_ACCESS_TOKEN
Kategorie: OpenStreetMaps
Standardwert: leer (String.Empty)
Produkt: eTASK.Sonstige (OpenStreetMaps)

Was macht dieser Parameter?

Dieser Parameter enthält den Zugangsschlüssel für den Mapbox-Dienst, der für die Darstellung der Kartenkacheln (Map Tiles) in der OpenStreetMap-Integration des eTASK FM-Portals verantwortlich ist. Ohne diesen Schlüssel können keine Kartendarstellungen angezeigt werden.

Wofür wird dieser Parameter verwendet?

• Kartendarstellung im Gebäudeformular: Zeigt die geografische Lage von Gebäuden auf einer interaktiven Karte an

• Portfolio-Übersicht: Visualisiert alle Liegenschaften des Unternehmens auf einer Karte mit roten Markierungen

• Standortauswahl: Ermöglicht die interaktive Auswahl von Standorten auf der Karte

• Gebäude-Mapping: Stellt Gebäude und deren geografische Verteilung grafisch dar

• Karten-Navigation: Bereitstellung der Kartenkacheln für Zoom- und Bewegungsfunktionen

Technische Details (für Administratoren)

Format: Alphanumerischer Zugangsschlüssel (Access Token)
Standardwert: leer (String.Empty)

Wichtige Hinweise:

• Der Token wird vom Mapbox-Dienst bereitgestellt nach Registrierung unter www.mapbox.com/studio/signup/

• Kostenmodell: Der Mapbox-Service ist kostenlos für bis zu 50.000 Kartenaufrufe pro Monat

• Bei Überschreitung dieser Grenze wird der Dienst kostenpflichtig

• Ohne gültigen Token wird ein Hinweis angezeigt, dass die Kartendarstellung nicht verfügbar ist und die Konfiguration durch einen Administrator vorgenommen werden muss

Zusammenspiel mit anderen Parametern:

• MAPQUEST_APP_KEY: Wird für die Adresssuche und Geocoding (Umwandlung von Adressen in Koordinaten) benötigt. Beide Parameter müssen konfiguriert sein, damit die vollständige Kartenfunktion funktioniert

• MAPBOX_MAP_ID: Definiert das verwendete Karten-Design

• MAPBOX_STYLE: Legt den visuellen Stil der Kartendarstellung fest

Wann sollten Sie diesen Wert ändern?

Wert setzen (Token eintragen), wenn:

• Sie die Kartenfunktion im eTASK FM-Portal erstmals aktivieren möchten

• Die OpenStreetMap-Integration genutzt werden soll, um Gebäude geografisch darzustellen

• Benutzer Standorte auf einer Karte visualisieren sollen

• Nach Registrierung bei Mapbox ein neuer Access Token ausgestellt wurde

• Der vorhandene Token abgelaufen ist oder erneuert werden muss

Wert leer belassen (nicht setzen), wenn:

• Die Kartenfunktion nicht benötigt wird

• Keine geografische Visualisierung von Gebäuden erforderlich ist

• Sie sich bewusst gegen die Nutzung externer Kartendienste entscheiden

• Kosten für den Mapbox-Service vermieden werden sollen

Wichtige Hinweise

1. Registrierung erforderlich
   Um einen gültigen Access Token zu erhalten, müssen Sie sich zunächst bei Mapbox unter www.mapbox.com/studio/signup/ registrieren. Die Registrierung ist kostenlos.

2. Kostenkontrolle beachten
   Der Dienst ist nur bis 50.000 Kartenaufrufe pro Monat kostenlos. Überwachen Sie die Nutzung in Ihrem Mapbox-Dashboard, um unerwartete Kosten zu vermeiden. Bei größeren Installationen mit vielen Benutzern kann diese Grenze schnell erreicht werden.

3. Keine Karten ohne Token
   Wenn dieser Parameter leer oder ungültig ist, wird Benutzern ein Hinweis angezeigt, dass die Kartenfunktion nicht verfügbar ist, da die Konfiguration nicht vollständig ist. Sie werden aufgefordert, sich an ihren Administrator zu wenden.

4. Komplett-Konfiguration notwendig
   Für die vollständige Kartenfunktion benötigen Sie neben MAPBOX_ACCESS_TOKEN auch MAPQUEST_APP_KEY. Ohne beide Parameter funktioniert weder die Kartendarstellung noch die Adresssuche korrekt.

5. Token-Sicherheit
   Behandeln Sie den Access Token vertraulich und teilen Sie ihn nicht öffentlich. Im Mapbox-Dashboard können Sie bei Bedarf Tokens sperren und neu erstellen.

Sicherheit

Hat eine Änderung dieses Parameters Auswirkungen auf die Sicherheit?

Ja, die Konfiguration dieses Parameters hat geringe, aber relevante Sicherheitsaspekte.

Positive Aspekte:

• Der Token ist projektspezifisch und kann bei Kompromittierung einfach zurückgezogen und ersetzt werden

• Mapbox bietet Mechanismen zur Nutzungskontrolle und -begrenzung

• Die Kartendaten selbst sind öffentlich verfügbar (OpenStreetMap), sodass keine sensiblen Daten über den Dienst übertragen werden

Zu beachten:

• Der Access Token sollte nicht in öffentlich zugänglichen Bereichen gespeichert oder weitergegeben werden

• Bei Missbrauch könnte ein kompromittierter Token zu unerwünschten Kosten führen, wenn die kostenlose Nutzungsgrenze überschritten wird

• Die Nutzung externer Dienste bedeutet, dass Standortdaten (Koordinaten) an Mapbox übermittelt werden

• Prüfen Sie, ob die Nutzung des Mapbox-Dienstes mit Ihren Datenschutzrichtlinien vereinbar ist

Datenschutzrechtliche Bewertung:

• Bei der Nutzung werden Geodaten und eventuell IP-Adressen an den Mapbox-Dienst übertragen

• Informieren Sie Ihre Nutzer gegebenenfalls über die Nutzung externer Kartendienste

• Prüfen Sie die Datenschutzbedingungen von Mapbox im Hinblick auf DSGVO-Konformität

Praktisches Beispiel

Ausgangssituation: Ein Facility-Management-Team möchte die Kartenfunktion im eTASK FM-Portal nutzen, um ihre 45 Gebäude geografisch zu visualisieren. Aktuell ist die Kartenfunktion nicht aktiviert, und beim Aufruf der Gebäudekarte wird ein Hinweis angezeigt, dass die Konfiguration nicht vollständig ist.

Konfiguration: Der Administrator registriert sich bei Mapbox (www.mapbox.com/studio/signup/), erhält einen Access Token und trägt diesen in die Systemkonfiguration ein:

Zusätzlich wird der MAPQUEST_APP_KEY konfiguriert, um auch die Adresssuche zu ermöglichen.

Nach der Änderung:

• Im Gebäudeformular erscheint eine interaktive Karte mit der geografischen Lage

• In der Portfolio-Übersicht werden alle 45 Gebäude mit roten Markierungen auf der Karte angezeigt

• Benutzer können auf der Karte zoomen, sich bewegen und Standorte auswählen

• Die Adresseingabe funktioniert mit automatischer Koordinatensuche

• Das Team hat einen besseren geografischen Überblick über sein Immobilienportfolio

Ergebnis: Die Kartenfunktion ist vollständig einsatzbereit. Das Team nutzt die Visualisierung für Planungen, Präsentationen und räumliche Analysen. Die monatliche Nutzung liegt bei ca. 12.000 Kartenaufrufen und bleibt damit deutlich unter der kostenlosen Grenze von 50.000 Aufrufen.

Empfohlene Einstellung

Für Standard-Installationen:Registrierten Mapbox Access Token eintragen

Begründung:

• Die Kartenfunktion ist ein wertvolles Feature für die geografische Visualisierung von Gebäuden und Liegenschaften

• Die Kosten sind für normale Installationen durch die kostenlose Nutzungsgrenze von 50.000 Aufrufen pro Monat überschaubar

• Die Kartendarstellung verbessert die Benutzerfreundlichkeit erheblich und ermöglicht bessere räumliche Planungen

• Die Registrierung bei Mapbox ist einfach und kostenlos

• In Kombination mit MAPQUEST_APP_KEY erhalten Sie eine vollständige Kartenlösung für Ihr FM-Portal

Bei sehr kleinen Installationen oder wenn die Kartenfunktion nicht benötigt wird, kann der Parameter leer bleiben. Beachten Sie jedoch, dass Benutzer dann die Kartendarstellung nicht nutzen können.

IC0000