Arbeitsablauf
Der Zweck der Emission Insight API ist die Berechnung der Emissionen aus einer Aktivität eines Fahrzeugs oder einer Maschine. Eine Aktivität eines Fahrzeugs kann nur aus Fahren, nur aus Arbeiten oder aus beidem bestehen.
Darüber hinaus kann es sich um eine vorläufige oder eine vollständige Berechnung handeln. Eine vorläufige Berechnung ist eine, bei der Daten fehlen. Es kann sich z. B. um eine Vorhersage/Vorkalkulation von Aktivitäten oder fehlende Daten der Maschine oder ihres Motors/ihrer Motoren handeln.
Wenn Informationen fehlen, kann es wünschenswert sein, eine Neuberechnung zu einem späteren Zeitpunkt durchzuführen. Wenn die fehlenden Informationen hinzugefügt werden, kann eine neue Berechnung mit den nun hinzugefügten Informationen durchgeführt werden, und der Berechnungsstatus wird auf abgeschlossen gesetzt.
Ein Beispiel für eine vollständige Berechnung ist eine Tätigkeit, für die die tatsächlichen Tätigkeitsdaten und alle technischen Informationen des Fahrzeugs bekannt sind.
Erforderliche Daten
Die angeforderten Informationen, die das Modell zur Berechnung der Emissionen benötigt, um eine Berechnung durchzuführen, basieren auf Informationen, die jedem Unternehmen oder Planungssystem zur Verfügung stehen.
Wenn die Daten von Fahrzeugen oder Maschinen jedoch unvollständig sind, können wir trotzdem Berechnungen anstellen. Dazu müssen wir Annahmen treffen, was die Genauigkeit der Berechnung beeinträchtigt. Aus diesem Grund hat Emission Insight seinen Emission Insight Accuracy Algorithm (EIAA) entwickelt.
Auf der Grundlage der Annahmen wird ein Genauigkeitswert ermittelt, der für jede einzelne Emission in die Berechnung einfließt. Die Punktzahl bestimmt die mögliche Abweichung von der tatsächlichen Emission, je niedriger die Punktzahl, desto größer kann die Abweichung sein. Anhand der Punktzahl können Sie entscheiden, was mit den Ausgabedaten geschehen soll. Falls erforderlich, können Sie zu einem späteren Zeitpunkt, wenn Ihnen alle Daten vorliegen, eine Neuberechnung durchführen.
Authentifizierung
Sie benötigen einen Abonnementschlüssel für den Zugriff auf die API. Nachdem Sie ein Konto im Entwicklerportal von Emission Insight erstellt haben, finden Sie Ihre Schlüssel in den Details Ihres Produktabonnements. Es ist wichtig, dass Sie Ihren Schlüssel vertraulich behandeln. Sie sollten den Schlüssel nicht in öffentlich zugänglichem Code platzieren.
API-Versionen
Die aktuelle Version der Emission Insight API ist v1, was bedeutet, dass alle Anfragepfade mit /v1/ beginnen.
Fehlerbehandlung
Fehler werden durch standardmäßige HTTP-Statuscodes angezeigt. Es ist wichtig, sicherzustellen, dass Ihre Anwendung Fehler in angemessener Weise behandelt. Zu diesem Zweck konsultieren Sie bitte die Liste der erwarteten Statuscode-Ergebnisse, die in der Dokumentation der einzelnen Endpunkte enthalten ist.
Besondere Sorgfalt sollte auf die ordnungsgemäße Handhabung gelegt werden:
- HTTP 429: zu viele Anfragen. Ihre Anwendung sollte so konfiguriert sein, dass sie die Anfrage nach einer gewissen Verzögerung erneut sendet, anstatt die Anfrage ständig neu zu senden. Wenn Sie 429-Fehler haben und Ihre Übersetzungsgeschwindigkeit erhöhen möchten, wenden Sie sich bitte an [email protected].
- HTTP 456: Quote überschritten.
- HTTP 422: Unverarbeitbare Entität. Bei Ihrer Eingabe fehlen erforderliche Informationen oder eines der Felder gehört nicht zu den angegebenen Optionen.
Zusätzliche Informationen können durch eine JSON-Antwort bereitgestellt werden, die weitere Einzelheiten über den Fehler enthält. In diesem Fall werden diese zusätzlichen Informationen im Schlüssel "message" enthalten sein.