Wie man die Sitata-APIs nutzt, um Reisebeschränkungen für Reisende zu ermitteln

Viele von Ihnen wissen es vielleicht nicht, aber die ersten Grundlagen von Sitata wurden für die Früherkennung von Krankheiten gelegt. Unser Gründer hielt bereits 2016 einen TedX-Vortrag darüber, warum wir Reisende warnen müssen, um die Ausbreitung von Krankheiten zu verhindern. Es sollte daher nicht überraschen, dass wir von COVID-19 erfuhren, als Anfang Dezember 2019 über einen ungewöhnlichen Cluster von Lungenentzündungsfällen berichtet wurde. Am 2. Januar 2020 entschied unser Gesundheitsteam, dass wir unsere erste Warnung an unsere Reisenden und Geschäftspartner herausgeben mussten. Das war sogar Tage vor der Weltgesundheitsorganisation!

Während der unvermeidlichen Nachwirkungen hatten wir eine Erleuchtung. Die Krankheit breitete sich so schnell aus, dass uns klar war, dass die globale Reaktion bestenfalls chaotisch sein würde. Jedes Land würde seinen eigenen Satz von Vorschriften und Regeln zur Eindämmung der Ausbreitung erlassen. Dies würde unweigerlich das weltweite Reisen durcheinanderbringen und eine enorme Quelle der Verwirrung für diejenigen sein, die dennoch reisen wollten. Wir behielten recht und machten uns daran, etwas dagegen zu tun. Sitata war eines der ersten Unternehmen weltweit, das eine dedizierte API und einen Überwachungsdienst für Änderungen bei Reisebeschränkungen und Einreisebestimmungen als Folge von COVID-19 einrichtete. Mit einem fortschrittlichen Softwaresystem zur Ereigniserkennung und einem engagierten Team von Analysten hatten wir bereits alle richtigen Werkzeuge und Prozesse dafür.

Seit dem Start dieses neuen Dienstes haben eine Reihe von Organisationen die Daten zum Nutzen ihrer eigenen Kunden genutzt, darunter Eddy Travels, Flight Centre und Etihad Airways; und es werden bald weitere bekannt gegeben! Um mehr reisefokussierten Organisationen zu helfen, von diesem Angebot zu profitieren, haben wir unten eine Reihe von Beispielen detailliert beschrieben, um zu erklären, wie die API für verschiedene Anwendungsfälle genutzt werden kann. Ich hoffe, diese Erklärungen helfen Ihnen, Ihre eigenen Initiativen zu starten.

Einreisebestimmungen

Die ersten Fragen, die ein Reisender stellt, sind zweifellos “Kann ich dorthin reisen?” und “Werde ich unter Quarantäne gestellt?”, also ist dies ein guter Ausgangspunkt. Wir haben den Datensatz “Einreisebestimmungen” erstellt, um die harten “Ja/Nein”-Fragen bezüglich der Einreise in ein Land oder eine Region zu beantworten.

Zum Zeitpunkt der Erstellung dieses Artikels umfasste dieser Datensatz die folgenden 10 verschiedenen Kategorien:

• Kann ein Einwohner in das Land einreisen?
• Kann ein Ausländer in das Land einreisen?
• Ist Transit durch das Land erlaubt?
• Wird ein Test bei Ankunft erforderlich (Krankheitsausbruch)?
• Ist ein Testzertifikat erlaubt (Krankheitsausbruch)?
• Wird eine Quarantäne bei Ankunft erforderlich (Krankheitsausbruch)? Wird ein Impfnachweis erforderlich?
• Wird eine Versicherung erforderlich?
• Wird ein Testzertifikat erforderlich?
• Wird ein Registrierungsformular erforderlich? (Gesundheit oder anderes)

Jede Kategorie kann einen der folgenden Werte haben:

• Ja
• Ja, mit Ausnahmen
• Nein
• Nein, mit Ausnahmen

Obwohl die überwiegende Mehrheit der Werte “Ja” und “Nein” ist, ist die Lage vor Ort nicht immer so einfach. Manchmal gibt es wirklich seltsame und verrückte Regeln, die verschiedene Regierungen eingeführt haben und die die Arten von Werten “mit Ausnahmen” erfordern.

Eine Einreisebestimmung ist im Wesentlichen ein Datensatz, der einen Satz von Regeln dokumentiert, die von einem Akteur gegenüber einem oder mehreren Ländern oder Regionen auferlegt werden. Der Akteur könnte in unserer Datenarchitektur ein Land, ein Bundesstaat oder sogar eine Gemeinde sein. Im Allgemeinen deckt Sitata derzeit Daten auf Länderebene ab. Wir haben jedoch einige bundesstaatliche/provinziale Datensätze für ausgewählte Regionen wie die USA und andere.

Jeder Datensatz, der einen Eintrag unter dem Feld **origin_country_division_id** oder **origin_country_region_id** hat, ist einer auf Bundesstaats- bzw. Gemeindeebene. Wenn Sie granularere Daten wünschen, kontaktieren Sie uns bitte und wir können über Ihren Anwendungsfall sprechen.

Bitte nehmen Sie sich Zeit, um sich mit der Datenstruktur der Einreisebestimmungen vertraut zu machen, indem Sie einen Blick auf unsere API-Dokumente hier werfen.

Ein etwas verwirrender Teil der Datenstruktur ist unsere Verwendung des Begriffs “Ursprung”. Das ist verwirrend, weil Entwickler oft denken, der Ursprung sei der Herkunfts- oder Abflugsort. Was wir mit Ursprung meinen, ist jedoch tatsächlich der Ursprung der Regel, die anderen auferlegt wird, also das Land oder die Region, die die Beschränkung erlassen hat.

Ein weiterer wichtiger Punkt ist, wie unsere Liste der betroffenen Länder funktioniert. Wenn affected_countries leer ist, sollte dies als globale Regel interpretiert werden, d.h. alle Länder sind betroffen.

Einige Beispiele

Wie Sie in der Dokumentation gesehen haben, gibt es mehrere Möglichkeiten, Daten von der API abzurufen. Im Folgenden werden einige der häufigsten Anwendungsfälle betrachtet.

Wie erhalte ich die Anforderungen zwischen zwei Ländern?

Es gibt ein paar Möglichkeiten, eine solche Anfrage zu stellen. Die einfachste Version ist die Verwendung der Parameter **destination** und **departure**. Diese Parameter akzeptieren ISO 3166-1 alpha-2 Codes als Eingaben.

GET https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination=IN

Die Antwort enthält alle Anforderungen (auf Landes- und Bundesstaatenebene), die notwendig sind, um sie für den Reisenden zu verstehen, der aus dem Abflugsland abreist und in das Zielland reist.

Was ist, wenn ich Daten auf Bundesstaatenebene möchte?

Sitata hat Daten auf Bundesstaatenebene für bestimmte Regionen. Sie erkennen, dass ein bestimmter Eintrag für einen Bundesstaat ist, wenn das Feld origin_country_division_id einen Wert hat. Sie können auch filtern, um nur Daten auf Bundesstaatenebene abzurufen, indem Sie den Parameter **destination_country_division** verwenden. Er erwartet einen ISO_3166-2 Wert. Zum Beispiel US-TX für Texas, USA.

GET https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination_country_division=IN-AP

Beachten Sie, dass es einfacher sein könnte, eine Abfrage nach Land durchzuführen und dann nach den Bundesstaatsdaten zu filtern, um zu sehen, ob diese Daten existieren, und sie zu verwenden, wenn sie existieren.

Wie erhalte ich die Anforderungen zwischen zwei Flughäfen?

Ähnlich wie bei Ländern kann die Sitata-API auch Ergebnisse zwischen zwei Flughäfen zurückgeben. Die Parameter departure_airport und destination_airport verwenden ICAO oder IATA Flughafencodes, um die Ergebnisse zu filtern. Die Antwort enthält alle Beschränkungen (auf Landes- und Bundesstaatenebene), die notwendig sind, um sie für den Reisenden zu verstehen, der aus dem entsprechenden Abflugsland abreist und in das Zielland reist.

GET https://www.sitata.com/api/v2/entry_requirements?departure_airport=MUC&destination_airport=BOM

Die Antwort enthält alle Beschränkungen (auf Landes- und Bundesstaatenebene), die notwendig sind, um sie für den Reisenden zu verstehen, der aus dem Abflugsland abreist und in das Zielland reist.

Was ist, wenn ich nur Stadtinformationen habe?

Sitata hat sich entschieden, Abfragen nach einem bestimmten Stadtnamen nicht zu berücksichtigen, da dies zu Konflikten und Verwirrung führen könnte. Stattdessen haben wir uns entschieden, Abfragen an unsere API über Breiten- und Längengradkoordinaten zu ermöglichen, was keine Mehrdeutigkeit in unserem Ergebnissatz erzeugt. Die Parameter sind departure_lat, departure_lng, destination_lat und destination_lng.

GET https://www.sitata.com/api/v2/entry_requirements?departure_lat=48.13743&departure_lng=11.57549&destination_lat=19.0760&destination_lng=72.8777

Wenn Sie Ihre Städte zu Standorten auflösen und basierend auf den Koordinaten abfragen, antwortet unsere API mit allen Beschränkungen (auf Landes- und Bundesstaatenebene), die notwendig sind, um sie für den Reisenden zu verstehen, der aus dem Abflugsland abreist und in das Zielland reist.

Zusätzliche Daten

Für einige Arten von Einreisebestimmungen können zusätzliche Daten in einem Metadatentyp-Feld namens extras vorhanden sein. Dieses Feld ist eine Schlüssel/Wert-Zuordnung verschiedener zusätzlicher Informationsbits für eine bestimmte Anforderung.

Wie viele Tage Quarantäne?

Dieser Dateneintrag unterliegt der Einreisebestimmung Typ 5. In diesem Eintrag enthält die **extras**-Zuordnung ein Feld namens quarantine_days, das eine Ganzzahl für die Anzahl der auferlegten Quarantänetage enthält.

Wie viele Stunden vor der Einreise für einen negativen Covid-Test?

Dieser Dateneintrag unterliegt der Einreisebestimmung Typ 8. In diesem Eintrag enthält die **extras**-Zuordnung ein Feld namens entry_hours, das eine Ganzzahl für die Anzahl der Stunden enthält, die ein negativer Covid-Test vor der Einreise gültig ist.

Lassen Sie es uns wissen

Wir glauben, dass wir eine sehr robuste Lösung haben, die wahrscheinlich alle Ihre Bedürfnisse erfüllt, um Ihren Reisenden zu helfen zu verstehen, was sie unterwegs wahrscheinlich erwartet. Wenn Sie einen besonderen Anwendungsfall haben, den wir nicht abdecken, teilen Sie uns dies bitte mit!

Warten Sie… es gibt mehr!

Dieser Beitrag ist Teil einer zweiteiligen Serie, die erklärt, wie man mit der Sitata-API für Einreisebestimmungen und Reisebeschränkungsinformationen interagiert. Bisher haben wir über Einreisebestimmungen gesprochen, die die harten Ja/Nein-Arten von Anforderungen für die Einreise in ein Land oder eine Region umreißen, aber wir haben noch nicht darüber gesprochen, was innerhalb des Landes passiert. Es ist eine Sache, über die Einreise in ein Land Bescheid zu wissen, und eine andere zu verstehen, ob man sich im Land bewegen oder Strände besuchen kann oder ob eine Ausgangssperre verhängt ist.

Bleiben Sie dran für den zweiten Beitrag, der sich mit unserem Reisebeschränkungs-Datensatz befassen wird. Hinweis - er ist fast identisch, also können Sie in der Zwischenzeit immer einen Blick in unsere API-Dokumentation werfen.