MAPQUEST_APP_KEY - Detailbeschreibung

Open

Überblick

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

Was macht dieser Parameter?

Dieser Parameter enthält den Zugangsschlüssel (App Key) für den MapQuest-Geocoding-Dienst. Er ermöglicht die Umwandlung von eingegebenen Adressen in geografische Koordinaten (Längen- und Breitengrad), die dann für die Kartendarstellung im eTASK FM-Portal verwendet werden. Ohne diesen Schlüssel können Adressen nicht automatisch auf der Karte positioniert werden.

Wofür wird dieser Parameter verwendet?

• Adresssuche und Geocoding: Umwandlung eingegebener Adressen in Koordinaten

• Gebäudeplatzierung auf Karten: Automatische Positionierung von Gebäuden basierend auf der Adresse

• Koordinatenermittlung: Findet Längen- und Breitengrade zu eingegebenen Standorten

• Adressvalidierung: Prüfung und Vervollständigung von Adresseingaben

• Interaktive Kartenfunktionen: Ermöglicht Adresssuche in Kartenansichten

Technische Details (für Administratoren)

Format: Alphanumerischer Zugangsschlüssel (App Key)
Standardwert: leer (String.Empty)

Wichtige Hinweise:

• Der App Key wird von MapQuest nach Registrierung unter https://developer.mapquest.com/ bereitgestellt

• Kostenmodell: Der MapQuest-Geocoding-Service ist kostenlos für eine bestimmte Anzahl von Anfragen pro Monat

• Bei Überschreitung der kostenlosen Nutzungsgrenze wird der Dienst kostenpflichtig

• Ohne gültigen App Key wird ein Hinweis angezeigt, dass die Adresssuche nicht verfügbar ist

• Der Parameter arbeitet eng mit MAPBOX_ACCESS_TOKEN zusammen

Zusammenspiel mit anderen Parametern:

• MAPBOX_ACCESS_TOKEN: Erforderlich für die Kartendarstellung; beide Parameter müssen konfiguriert sein für vollständige Kartenfunktion

• MAPBOX_MAP_ID / MAPBOX_STYLE: Bestimmen das visuelle Erscheinungsbild der Karte nach erfolgreicher Geocodierung

Wann sollten Sie diesen Wert ändern?

Wert setzen (App Key eintragen), wenn:

• Sie die Adresssuche und automatische Koordinatenermittlung aktivieren möchten

• Benutzer Gebäude durch Adresseingabe auf der Karte finden sollen

• Die vollständige OpenStreetMap-Integration genutzt werden soll

• Nach Registrierung bei MapQuest ein neuer App Key ausgestellt wurde

• Der vorhandene Key abgelaufen ist oder erneuert werden muss

Wert leer belassen (nicht setzen), wenn:

• Die Adresssuche und Geocoding-Funktion nicht benötigt wird

• Koordinaten manuell eingegeben werden

• Sie sich bewusst gegen die Nutzung des MapQuest-Dienstes entscheiden

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

Wichtige Hinweise

1. Registrierung erforderlich
   Um einen gültigen App Key zu erhalten, müssen Sie sich zunächst bei MapQuest unter https://developer.mapquest.com/ registrieren. Die Registrierung ist kostenlos.

2. Kostenkontrolle beachten
   Der Dienst ist nur bis zu einer bestimmten Anzahl von Anfragen pro Monat kostenlos. Überwachen Sie die Nutzung in Ihrem MapQuest-Dashboard, um unerwartete Kosten zu vermeiden. Bei größeren Installationen mit häufigen Adresssuchen kann die Grenze schnell erreicht werden.

3. Keine Adresssuche ohne Key
   Wenn dieser Parameter leer oder ungültig ist, wird Benutzern ein Hinweis angezeigt, dass die Adresssuche nicht verfügbar ist und die Konfiguration durch einen Administrator vorgenommen werden muss. Koordinaten müssen dann manuell eingegeben werden.

4. Komplett-Konfiguration erforderlich
   Für die vollständige Kartenfunktion benötigen Sie sowohl MAPQUEST_APP_KEY (für Geocoding) als auch MAPBOX_ACCESS_TOKEN (für Kartendarstellung). Ohne beide Parameter ist die Kartenfunktion nur eingeschränkt nutzbar.

5. Key-Sicherheit
   Behandeln Sie den App Key vertraulich und teilen Sie ihn nicht öffentlich. Im MapQuest-Dashboard können Sie bei Bedarf Keys 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 Key ist projektspezifisch und kann bei Kompromittierung einfach zurückgezogen und ersetzt werden

• MapQuest bietet Mechanismen zur Nutzungskontrolle und -begrenzung

• Die übertragenen Adressdaten sind in der Regel nicht hochsensibel

Zu beachten:

• Der App Key sollte nicht in öffentlich zugänglichen Bereichen gespeichert oder weitergegeben werden

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

• Die Nutzung externer Dienste bedeutet, dass Adressdaten an MapQuest übermittelt werden

• Prüfen Sie, ob die Übermittlung von Standortdaten an MapQuest mit Ihren Datenschutzrichtlinien vereinbar ist

Datenschutzrechtliche Bewertung:

• Bei der Nutzung werden Adressdaten und eventuell IP-Adressen an den MapQuest-Dienst übertragen

• Informieren Sie Ihre Nutzer gegebenenfalls über die Nutzung externer Geocoding-Dienste

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

• Erwägen Sie, ob alternative Geocoding-Dienste mit strengeren Datenschutzrichtlinien verfügbar sind

Praktisches Beispiel

Ausgangssituation: Ein Facility-Management-Unternehmen hat bereits MAPBOX_ACCESS_TOKEN konfiguriert und Karten werden angezeigt. Allerdings müssen Mitarbeiter bei jedem neuen Gebäude die Koordinaten manuell ermitteln und eingeben, was zeitaufwändig und fehleranfällig ist. Die Adresseingabe im Gebäudeformular funktioniert nicht automatisch – es erscheint ein Hinweis, dass die Geocoding-Funktion nicht konfiguriert ist.

Konfiguration: Der Administrator registriert sich bei MapQuest (https://developer.mapquest.com/), erhält einen App Key und trägt diesen in die Systemkonfiguration ein:

Nach der Änderung:

• Mitarbeiter können im Gebäudeformular einfach die Adresse eingeben

• Das System ermittelt automatisch die geografischen Koordinaten

• Das Gebäude wird sofort korrekt auf der Karte positioniert

• Die Fehlerquote bei der Standorteingabe sinkt deutlich

• Die Zeitersparnis beträgt ca. 2-3 Minuten pro neuem Gebäude

Ergebnis: Die Adresssuche funktioniert zuverlässig. Mitarbeiter schätzen die deutlich vereinfachte Gebäudeanlage. Die Datenqualität verbessert sich, da keine manuellen Koordinatenfehler mehr auftreten. Die monatliche Nutzung liegt bei ca. 400 Geocoding-Anfragen und bleibt damit im kostenlosen Kontingent.

Empfohlene Einstellung

Für Standard-Installationen:Registrierten MapQuest App Key eintragen

Begründung:

• Die Adresssuche und automatische Koordinatenermittlung ist ein wertvolles Feature

• Deutliche Zeitersparnis bei der Gebäudeanlage

• Reduzierung von Eingabefehlern bei Koordinaten

• Die Kosten sind für normale Installationen durch die kostenlose Nutzungsgrenze überschaubar

• Die Registrierung bei MapQuest ist einfach und kostenlos

• In Kombination mit MAPBOX_ACCESS_TOKEN erhalten Sie eine vollständige Kartenlösung

Bei sehr kleinen Installationen oder wenn die Geocoding-Funktion nicht benötigt wird, kann der Parameter leer bleiben. Beachten Sie jedoch, dass Benutzer dann Koordinaten manuell eingeben müssen und die Adresssuche nicht verfügbar ist.

IC0000