Routing-Einrichtung

Die Routenplanung für Karten benötigt einen Routing-Anbieter. Routing ist Bring-your-own-key: Sie stellen einen API-Schlüssel von OpenRouteService oder Mapbox bereit, und Avonni betreibt kein eigenes Routing-Backend. Aktivieren Sie es einmal pro Org, und jede routingfähige Karte in der Org kann es verwenden.

Bevor Sie beginnen

Sie benötigen:

• Einen Salesforce-Administrator mit der Anwendung anpassen Berechtigung. Nur ein solcher Benutzer kann die Routing-Einstellungen öffnen oder ändern.
• Einen API-Schlüssel von einem der beiden unterstützten Anbieter. Beide bieten eine kostenlose Stufe an — siehe Anbieter auswählen.

Öffnen Sie den Tab „Einstellungen“

Öffnen Sie im App Launcher die Avonni Experiences App und wählen Sie den Einstellungen Tab.

Die Routing Karte zeigt den aktuellen Status und die dafür verfügbaren Aktionen an.

Anbieter auswählen

Es ist immer nur ein Anbieter gleichzeitig aktiv. Wenn Sie einen aktivieren, wird der andere deaktiviert.

Anbieter	Einen Schlüssel erhalten	Hinweise
OpenRouteService	Erstellen Sie einen kostenlosen Schlüssel unter openrouteservice.org mit einem HeiGIT-Konto.	Es gelten die Grenzen des Standardtarifs — ungefähr 2.000 Routen pro Tag. Fügen Sie den Schlüssel genau so ein, wie er ausgegeben wurde; fügen Sie kein Bearer Präfix hinzu.
Mapbox	Erstellen Sie ein Zugriffstoken unter console.mapbox.com.	Ein öffentliches Token (beginnend mit pk.) reicht aus — die Directions- und Optimization-APIs benötigen keine zusätzlichen Scopes. Lassen Sie die URL-Beschränkungen leer, da serverseitige Callouts keinen Referrer senden.

Mapbox ist der einzige Anbieter, der Verkehr modelliert, daher ist er auch der einzige, bei dem das Routen-Panel eine Abfahrts- oder Ankunftszeit anbietet und Ankunftszeiten pro Stopp anzeigt. Er ist außerdem der einzige Anbieter, der die Stopp-Reihenfolge einer Route ermitteln kann: Optimieren fragt Mapbox nach der schnellsten Fahrreihenfolge für Routen mit bis zu zwölf Stopps an und ordnet die Stopps andernfalls nach Luftliniennähe. Beide Anbieter begrenzen eine Route auf 25 Stopps.

Routing aktivieren

1. Auf der Routing Karte, klicken Sie auf Routing aktivieren.
2. Wählen Sie den Routing-Anbieter.
3. Fügen Sie den API-Schlüssel ein und klicken Sie auf Routing aktivieren.

Der Schlüssel wird vor dem Speichern gegen den Anbieter validiert. Ein vom Anbieter abgelehnter Schlüssel wird niemals gespeichert.

Die Aktivierung läuft serverseitig ab: Der Status wechselt von Wird konfiguriert zu Verbunden. Sie können den Tab verlassen — der Zustand wird gespeichert, sodass das erneute Öffnen des Tabs genau dort fortfährt, wo er steht.

Wie lange das dauert, hängt vom Anbieter ab. Mapbox verbindet sich in wenigen Sekunden. OpenRouteService dauert in der Regel zwei bis drei Minuten, da seine Berechtigung als Metadaten in die Org bereitgestellt wird und das Setup wartet, bis diese Bereitstellung abgeschlossen ist, bevor der Schlüssel validiert wird. Ein Status, der auf Wird konfiguriert ein paar Minuten bleibt, ist für OpenRouteService normal und kein Anzeichen dafür, dass es hängen geblieben ist — siehe Fehlerbehebung wenn es dort deutlich länger bleibt.

Statuswerte

Status	Was es bedeutet
Nicht konfiguriert	Es ist kein Anbieter eingerichtet. Karten zeigen keinen Route Button, und der Bereich des Builders Route zeigt Anleitungen zur Aktivierung anstelle seiner Einstellung.
Wird konfiguriert	Der Schlüssel wird validiert und die Berechtigung eingerichtet. Vorübergehend.
Verbunden	Routing ist aktiv. Der Anbietername wird neben dem Status angezeigt.
Neuen Schlüssel überprüfen	Ein Ersatzschlüssel wird validiert. Der vorherige Schlüssel bleibt aktiv, bis der neue bestanden hat, sodass das Routing während einer Rotation nicht ausfällt.
Wird deaktiviert	Die Berechtigung wird entfernt. Vorübergehend.

Wenn ein Schlüssel abgelehnt wird, kehrt der Status zurück zu Nicht konfiguriert und der Grund des Anbieters wird darunter angezeigt. Es wird nichts gespeichert, daher bleibt der vorherige Zustand unverändert.

Routenstopp-Optimierung

Sobald Mapbox verbunden ist, enthält die Routing Karte einen Routenstopp-Optimierung Schalter. Er steuert, was der Optimieren Button im Routen-Panel einer Karte bewirkt:

• Ein (die Standardeinstellung) — Optimize fragt Mapbox nach der schnellsten Fahrreihenfolge und verbraucht bei jedem Klick eines Benutzers eine Anbieteranfrage.
• Aus — Karten ordnen die Stopps selbst kostenlos. Die Reihenfolge ignoriert Straßen, Brücken und Verkehr, daher ist die Route in der Regel länger.

Schalten Sie es aus, wenn die Nutzung des Anbieters ein Problem darstellt; andernfalls lassen Sie es eingeschaltet. Die Einstellung gilt org-weit und wird bei der nächsten Route wirksam, ohne dass die Karten selbst angepasst werden müssen.

Der Schalter erscheint nur für einen Anbieter, der optimieren kann. OpenRouteService kann das nicht, daher ordnen Karten dort ihre Stopps immer selbst.

Benutzern Zugriff gewähren

Durch das Aktivieren von Routing wird ein Berechtigungssatz für den aktiven Anbieter erstellt:

• Avonni Route ORS-Zugriff — für OpenRouteService
• Avonni Route Mapbox-Zugriff — für Mapbox

Weisen Sie ihn allen zu, die auf einer Karte Routen berechnen müssen. Benutzer ohne ihn können das Routen-Panel öffnen, aber Route berechnen schlägt fehl.

Diese Berechtigungssätze werden erstellt wenn Routing aktiviert wird, nicht im Paket mitgeliefert. Sie erscheinen nicht in der Berechtigungssatzliste einer Neuinstallation, suchen Sie also erst nach der Aktivierung nach ihnen und nicht vorher.

Einen Schlüssel rotieren

Klicken Sie auf OpenRouteService-API-Schlüssel ändern (oder Mapbox-API-Schlüssel ändern, je nachdem, welcher Anbieter aktiv ist) auf der Routing Karte ein, fügen Sie den neuen Schlüssel ein und klicken Sie auf API-Schlüssel speichern. Der neue Schlüssel wird validiert, bevor er den alten ersetzt; wenn er fehlschlägt, funktioniert der vorhandene Schlüssel weiter.

Rotieren Sie einen Schlüssel immer dann, wenn der Anbieter ihn neu ausstellt oder wenn der vorherige Schlüssel möglicherweise offengelegt wurde.

Routing deaktivieren

Klicken Sie auf Deaktivieren und bestätigen Sie. Dadurch wird der gespeicherte Schlüssel entfernt, der Berechtigungssatz des Anbieters aufgehoben und das Routing für alle in der Org gestoppt — Karten berechnen erst wieder Wegbeschreibungen, wenn Routing erneut mit einem Schlüssel aktiviert wird.

Datenschutz und Nutzung

Wenn Routing aktiviert ist, werden beim Berechnen einer Route die Koordinaten der Stopps an den von Ihnen gewählten Anbieter gesendet, authentifiziert mit Ihrem eigenen API-Schlüssel. Die Nutzung wird auf die Tarifgrenzen dieses Anbieters angerechnet, und dessen Bedingungen regeln die Anfrage.

Der gespeicherte Schlüssel ist nur schreibbar. Sobald er gespeichert ist, kann er nicht mehr ausgelesen werden — weder aus diesem Tab noch aus Setup. Wenn ein Schlüssel verloren geht, stellen Sie beim Anbieter einen neuen aus und rotieren Sie ihn.

Fehlerbehebung

• Der Tab „Einstellungen“ fehlt in der App — der Tab ist über den Admin-Berechtigungssatz des Pakets sichtbar. Weisen Sie dem Benutzer diesen Berechtigungssatz zu oder machen Sie den Tab in seinem Profil sichtbar.
• Beim Öffnen des Tabs wird gemeldet, dass nur ein Administrator die Routing-Einstellungen ändern kann — dem Benutzer fehlt Anwendung anpassen. Routing-Einstellungen können nur von Administratoren gelesen und geschrieben werden.
• Die Aktivierung schlägt mit einem Metadata-API-Fehler fehl, der Lightning-Sitzungen erwähnt — die erstmalige Einrichtung der Berechtigung konnte nicht aus der Browsersitzung ausgeführt werden. Lassen Sie einen Administrator mit CLI- oder API-Zugriff die Berechtigung einmalig erstellen und kehren Sie dann hierher zurück, um den Schlüssel zu speichern.
• Der Status bleibt auf Wird konfiguriert — geben Sie OpenRouteService zwei bis drei Minuten; so lange dauert die Bereitstellung seiner Berechtigung. Laden Sie danach den Tab neu: Der Zustand wird serverseitig gespeichert, daher bedeutet eine hängende Abfrage nicht, dass die Einrichtung hängt. Wenn es nach einem Neuladen immer noch dort ist, prüfen Sie die Statusseite des Anbieters und versuchen Sie es erneut.
• Routen funktionieren für Administratoren, aber nicht für andere Benutzer — diesen Benutzern fehlt der Berechtigungssatz des aktiven Anbieters (siehe Benutzern Zugriff gewähren).