Ein Feed des Typs "Geotab (LogRecord)" in ArcGIS Velocity fragt regelmäßig eine Geotab LogRecord-Datenbanktabelle nach Echtzeit-AVL-Daten (Automatic Vehicle Location, automatische Ortung von Fahrzeugen) ab, indem eine HTTP-Anforderung an eine angegebene URL gesendet wird. Der Feed-Typ "Geotab (LogRecord)" unterscheidet sich vom Feed-Typ Geotab (DeviceStatusInfo) durch die Abfrage von Daten aus der Tabelle "LogRecord" der Geotab-Datenbank. Die Tabelle "LogRecord" wird in der Regel häufiger aktualisiert als die Tabelle "DeviceStatusInfo" in der Geotab-Datenbank, obwohl sie weniger Attribute enthält als die DeviceStatusInfo-Tabelle. Dadurch kann ein Feed des Typs "Geotab (LogRecord)" häufiger Positionsaktualisierungen empfangen.
Weitere Informationen zu Geotab
Beispiele
Es folgen einige Beispiele für Anwendungsfälle für den Feed:
- Eine Stadt möchte ihre Flotte von Schneepflügen in der Wintersaison überwachen. Der Feed "Geotab (LogRecord)" wird verwendet, um den Standort jedes Fahrzeugs in Echtzeit zu beobachten und weitere Zusatzinformationen zu erfassen, zum Beispiel, ob der Schiebeschild in Arbeitsposition ist oder ob das Streusalz im Behälter am unteren Schwellenwert ist.
- Ein Abfallentsorgungsunternehmen möchte mit datengestützten Analysen die Effizienz seiner Flotte verbessern. Der Feed "Geotab (LogRecord)" wird verwendet, um für jedes Fahrzeug den Standort, den Fahrer, das Ladegewicht, die Leerlaufzeit und den Kraftstoffstand in Echtzeit zu erfassen.
Verwendungshinweise
Beachten Sie beim Arbeiten mit dem Feed Folgendes:
- Der Feed "Geotab (LogRecord)" erstellt Ereignisse unter Verwendung der Daten aus Tabellen in der Geotab-Datenbank. Zum Beispiel werden die Attribute für Position, Geschwindigkeit und Peilung aus der Tabelle "LogRecord" abgerufen. Die Tabelle "device" wird verwendet, um zusätzliche Attributinformationen abzurufen, wie zum Beispiel VIN, amtliches Kennzeichen usw. Gruppennamen und Gruppen-IDs zu jedem Gerät werden aus der Tabelle "group" abgerufen. Weitere Informationen finden Sie unten im Abschnitt "Schema".
- Die in Geotab enthaltenen Daten sind hochgradig normalisiert, sodass der Feed "Geotab (LogRecord)" standardmäßig einem festen Schema folgt. Der Feed legt automatisch die Position, Datum und Uhrzeit und die Track-ID fest. Das Track-ID-Feld kann geändert werden.
- Zusätzlich können Diagnose-IDs angegeben werden, um das Schema um zusätzliche Attributwerte zu erweitern. Wenn ein Fahrzeug mit einem Sensor zum Überwachen des gesamten Kraftstoffverbrauchs ausgestattet ist, führt die Angabe der Diagnose-ID DiagnosticDeviceTotalFuelId dazu, dass der Feed diese spezielle Information in einem neuen Attributfeld erfasst. Diagnosefelder werden in das Feed-Schema übernommen.
- Zusätzlich können Gruppen angegeben werden, um den Abruf der Gerätedaten aus dem Feed "Geotab (LogRecord)" auf einen bestimmten Typ zu beschränken.
- An das Standardschema des Feeds "Geotab (LogRecord)" können zusätzliche Felder mit Fahrerinformationen angehängt werden. Wählen Sie nur die Felder aus, die von Geotab bereitgestellte Werte enthalten. Wenn ein Feld unbekannt ist, kann der Wert NULL oder eine leere Zeichenfolge sein oder eine von Geotab vordefinierte Zeichenfolge enthalten. Weitere Informationen finden Sie unten im Abschnitt Zusätzliche Felder.
- Für die Abfrage von Geotab-Daten empfiehlt sich ein Intervall von mindestens 30 Sekunden.
Schema
In der folgenden Tabelle sind die Schemaattribute und ihre Datentypen für den Feed aufgeführt:
| Attribut | Datentyp |
|---|---|
| device_id | String |
| vehicleName | String |
| vehicleSerialNumber | String |
| vin | String |
| vehicleEngineType | String |
| vehicleLicensePlate | String |
| vehicleLicenseState | String |
| deviceType | String |
| dateTime | String |
| latitude | Float64 |
| longitude | Float64 |
| speed | Float64 |
| groupIds | String |
| groupNames | String |
Zusätzliche Felder
In der folgenden Tabelle sind die zusätzlichen Attributfelder und ihre Datentypen für den Feed aufgeführt:
| Attribut | Datentyp |
|---|---|
firstName | Zeichenfolge |
lastName | Zeichenfolge |
phoneNumber | Zeichenfolge |
phoneNumberExtension | Zeichenfolge |
employeeNo | Zeichenfolge |
id | Zeichenfolge |
name | Zeichenfolge |
companyName | Zeichenfolge |
Parameter
Nachfolgend werden die Parameter für den Feed beschrieben:
| Parameter | Beschreibung | Datentyp |
|---|---|---|
| URL | Die URL für die Authentifizierung bei Geotab, zum Beispiel https://[myserver].geotab.com/apiv1. | Zeichenfolge |
| Datenbank | Der Name der GeoTab-Datenbank. | Zeichenfolge |
| Benutzername | Der Benutzername für die Authentifizierung bei GeoTab. | Zeichenfolge |
| Kennwort | Das Kennwort für die Authentifizierung bei GeoTab. | Kennwort |
| Gruppen (optional) | Optionale Gruppennamen zum Filtern nach Entitätsmitgliedern. Zum Beispiel könnten Straßenkehrfahrzeuge zu einer Gruppe mit dem Namen Sweepers gehören. Für die Echtzeitverarbeitung werden nur Fahrzeuge abgerufen, die Entitätsmitglieder der Gruppe Sweepers sind. Hinweis:Wenn Sie mehrere Gruppen angeben, müssen Sie ein Semikolon (;) als Trennzeichen verwenden. | Zeichenfolge |
| Diagnose-IDs (optional) | Optionale Diagnose-IDs zum Abrufen von Diagnosewerten. Zum Beispiel ist DiagnosticDeviceTotalFuelId die Diagnose-ID zum Abrufen des gesamten Kraftstoffverbrauchs von Fahrzeugen, die mit dem richtigen Sensor ausgestattet sind. Für jede Diagnose-ID werden ein Feld für den Diagnosewert und ein Feld für den Zeitstempel hinzugefügt. Hinweis:Wenn Sie mehrere Diagnose-IDs angeben, dann müssen Sie ein Semikolon (;) als Trennzeichen verwenden. | Zeichenfolge |
| Zusätzliche Felder | Eine Liste zusätzlicher Felder, mit denen das Feed-Schema mit Informationen über den Fahrer angereichert werden kann. Hinweis:Wählen Sie nur die Felder aus, die von Geotab bereitgestellte Werte enthalten. Sonst kann der resultierende Wert der Felder NULL oder eine leere Zeichenfolge sein oder eine von Geotab vordefinierte Zeichenfolge enthalten. | Zeichenfolge |
| Zusätzliche Protokollierung (optional) | Gibt an, ob die Protokollierung von unverarbeiteten HTTP-Anforderungen und -Antworten, die von Velocity an die Geotab-API gesendet werden, aktiviert ist. Hinweis:Aktivieren Sie diesen Parameter zur Problembehandlung. Deaktivieren Sie ihn nach Beendigung der Problembehandlung wieder. Nach der Aktivierung starten Sie den Feed. Die Debug-Protokolle sind dann auf der Seite "Feed-Protokolle" verfügbar. Wenden Sie sich an den technischen Support von Esri, falls Sie Unterstützung bei der Problembehandlung benötigen. | Boolesch |
Überlegungen und Beschränkungen
- Bei jedem Abfrageintervall stellt Geotab die Daten bereit, die bei der letzten Abfrage zusammengestellt wurden; Daten die nach der Abfrage erstellt wurden, sind nicht enthalten. Die zurückgegebenen Daten können älter sein als der Zeitstempel der letzten Abfrage, die durch den Feed durchgeführt wurde.
- Diagnosewerte werden mit einer Rate aktualisiert, die sich von der bei anderen Gerätedaten unterscheidet. Aus diesem Grund gibt es zu jedem Diagnosefeld auch ein Zeitstempelfeld. Berücksichtigen Sie, ob Diagnosewerte vorübergehend für den letzten Zeitstempel der anderen Daten, die aus Geotab abgerufen wurden, relevant sind.
- Wenn Sie eindeutige Diagnose-IDs angeben, können Sie zuerst Gruppen verwenden, um nach dem Typ der Geräte zu filtern, die von Geotab zurückgegeben wurden. Jede Diagnose-ID erweitert das Schema für alle Fahrzeuge aus Geotab. Zum Beispiel wird eine Diagnose, die den Status des Schiebeschildes eines Schneepflugs erfasst, an alle Fahrzeugtypen aus Geotab angehängt, nicht nur an die Schneepflüge. Bei Fahrzeugen ohne Sensor lautet der Diagnosewert NULL. Wenn zuerst eine Gruppe der Schneepflüge definiert wurde, werden nur Schneepflüge aus Geotab abgerufen, und nur die Schneepflüge enthalten das benutzerdefinierte Diagnosefeld für den relevanten Status des Schiebeschildes eines Schneepflugs.
- Zusätzliche Felder enthalten nur Werte, wenn diese von Geotab in der Datenbank bereitgestellt werden. Berücksichtigen Sie die von den Geotab-Geräten der Organisation erfassten Informationen, bevor Sie zusätzliche Felder auswählen. Felder ohne einen Wert werden auf NULL oder eine leere Zeichenfolge festgelegt oder enthalten eine vordefinierte Zeichenfolge von Geotab.
- Wenn die Benutzeranmeldeinformationen ungültig sind, wird bis zu dreimal versucht, die Verbindung herzustellen. In den Protokollen werden Fehler durch ungültige Anmeldeinformationen angezeigt. Der Feed versucht nach einer auf dem Wiederholungszeitplan basierenden Verzögerung automatisch, den Vorgang erneut zu starten.