API-Datenzuordnung
Die Integration von Web-Servicedaten mit MapForce ist eine bewährte und beliebte Strategie, um aktuelle Informationen für Analysen oder die Erstellung benutzerfreundlicher Berichte zu gewinnen. In einem früheren Beitrag haben wir die Zuordnung von API-Daten in 5-Tage-Wettervorhersagen für stark frequentierte Häfen gezeigt, indem wir Web-Servicedaten im JSON-Format gelesen und in reich formatierte Excel-Tabellen umgewandelt haben. Die Wetter-API, die wir verwendet haben, wird von OpenWeather bereitgestellt, einem Anbieter von historischen, aktuellen und zukünftigen Wetterdaten.
Die Integration von Daten aus einer beliebigen API ist keine einmalige Aufgabe. Wenn Sie eine Lösung auf Basis externer Daten entwickeln, müssen Sie schnell reagieren, wenn sich die Datenstruktur ändert. In unserem ursprünglichen Integrationsprojekt hat OpenWeather die Daten, die über ihre API bereitgestellt werden, überarbeitet. Die API enthält nun Vorhersagen für Windböen in einer separaten JSON-Eigenschaft, getrennt von der Windgeschwindigkeit. Da Windböen als mögliche Ursache für die jüngsten Behinderungen im Suezkanal vermutet werden, sind die neuen Daten für unsere Anwendung sehr relevant! Glücklicherweise lassen sich sowohl die Datenzuordnungen in MapForce als auch die Excel-Tabelle problemlos anpassen, um die neuen Daten zu integrieren.
Bevor wir die Zuordnung der API-Daten ändern können, müssen wir die Änderungen im neuen Excel-Ausgabefehnster verstehen. Der neue Hauptbereich der Tabelle für die 5-Tage-Vorhersage ist hier dargestellt:
Der Ersteller der Tabelle hat eine neue Spalte zwischen "Windgeschwindigkeit" und "Windrichtung" eingefügt, um die vorhergesagten Windböen für jede Wettervorhersage anzuzeigen.
Mehrere Änderungen sind auch im Kopfbereich der Tabelle zu finden. In der Windkarte wurde eine Zeile hinzugefügt, die die Sturmbegleitung anzeigt, die geografischen Koordinaten des Hafens wurden hinzugefügt, und die maximale Sturmbegleitung über den 5-Tage-Vorhersagezeitraum wird angegeben.
Ein neuer, anklickbarer Button in der Arbeitsblattansicht mit der Bezeichnung "Aktuelle Hafenaktivität anzeigen" öffnet eine Webseite. Alle Handelsschiffe sind mit Transpondern für das automatische Identifikationssystem (AIS) ausgestattet, das kontinuierlich die Position des Schiffes überträgt, um Kollisionen zu vermeiden und Seekarten zu erstellen. MyShipTracking.com ist eine von vielen Webseiten und Unternehmen, die die AIS-Technologie nutzen, um Echtzeit-AIS-Daten zu liefern und ein besseres Verständnis dafür zu ermöglichen, wie Schiffe sich auf der ganzen Welt bewegen.
Durch Klicken auf den Button in der Tabelle wird eine Seite auf myshiptracking.com geöffnet, die Aktivitäten in der Nähe des ermittelten geografischen Standorts anzeigt:
Wir benötigen nur wenige Anpassungen bei der Datenzuordnung, um diese Verbesserungen der Zielausgabe zu ermöglichen: Wir müssen die Windböen-Daten an der richtigen Stelle in der Tabelle einfügen und die Geokoordinaten zuordnen.
Zunächst haben wir die Wetter-API manuell in einem Browserfenster aufgerufen, um eine neue Antwort zu erhalten, die auch Daten zu Windböen enthält. Anschließend haben wir in XMLSpy ein neues JSON-Schema für das Ergebnis der API erstellt. Durch das Speichern des neuen JSON-Schemas unter dem ursprünglichen Dateinamen wird automatisch der Begriff "Windböe" zur Antwort im Datenmapping der API hinzugefügt.
Die auf den ursprünglichen Koordinaten der kartierten Daten angebrachten Beschriftungen erleichtern es, die richtige Stelle zu finden, an der die neue "Gust"-Spalte in der Excel-Tabelle eingefügt werden kann:
Durch die Auswahl von "Zelle vor Einfügen" im Kontextmenü wird ein Dialogfenster geöffnet, in dem Sie die Details für die neue Zelle eingeben können:
MapForce verwaltet die Zuordnungen für die Spalten K und L, sodass wir lediglich die Verbindung für Spalte J herstellen müssen.
Die neuen geografischen Koordinaten für Breite und Länge in der Tabelle befinden sich in den Zellen G5 und I5. Die Koordinaten für jeden Hafen sind bereits in der ursprünglichen Liste der Häfen enthalten, da wir sie verwenden, um Wetterdaten von der API anzufordern. Wir haben diese Zelladressen am Ende der Ziel-Liste hinzugefügt.
Hier ist eine Ansicht der überarbeiteten Zuordnung im Bereich "Zuordnung" von MapForce, wobei die neue Verbindung für Windgeschwindigkeitsvorhersagen hervorgehoben ist:
Für eine letzte Verbesserung haben wir der Anfrage-Liste weitere Häfen hinzugefügt, darunter den Suezkanal und mehrere große Seehäfen in Europa. Wir haben die neuen Häfen hinzugefügt, indem wir die ursprüngliche JSON-Datei mit der Anfrage-Liste in XMLSpy bearbeitet haben. Hier ist die neue JSON-Datei mit den Hafenanfragen, die als Eingabe für die API-Datenzuordnung verwendet wird und in angezeigt wird XMLSpy-Rasteransicht:
Durch Klicken auf die Schaltfläche "Ausgabe" am unteren Rand des Mapping-Bereichs wird das Mapping ausgeführt und die Ansicht "Ausgabe" geöffnet, die die erste Ausgabedatei anzeigt. Wenn auf dem System Excel 2007 oder eine neuere Version installiert ist, öffnet MapForce Excel automatisch, um das Ergebnis anzuzeigen:
Für jeden Port in der Quellliste wurden Ergebnisse generiert. Wir können jede beliebige Excel-Datei zur Vorschau auswählen:
Das Anklicken der Schaltfläche "Aktuelle Portaktivität anzeigen" im Vorschaufenster funktioniert genau wie beim direkten Öffnen der Datei in Excel:
Das Ergebnis basiert auf der geografischen Breite und Länge des Hafens:
Jeder Punkt auf der Karte repräsentiert ein Schiff, das über einen AIS-Transponder in Echtzeit Daten übermittelt. Um unsere Ergebnisse weiter zu überprüfen, können wir jede andere Ausgabedatei einsehen und den Link für einen anderen Hafen überprüfen. Hier ist die Karte für Hamburg, Deutschland:
Die roten Punkte repräsentieren Tanker, und die grünen Punkte stehen für Frachtschiffe. Wir können auf jeden Punkt klicken, um detaillierte Informationen über das jeweilige Schiff zu erhalten:
Informieren Sie sich über den ursprünglichen Beitrag zur Integration von Webdiensten, sehen Sie sich eine kurze Video-Demonstration von MapForce an oder laden Sie eine kostenlose Testversion herunter, die Tutorials, Hilfestellungen und viele weitere Beispiele enthält, um mit Ihrem eigenen Projekt für die Datenzuordnung von APIs oder anderen Aufgaben zur Datenintegration, -konvertierung und -transformation zu beginnen!