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 geschaffen. Tatsächlich hielt unsere Gründerin bereits 2016 einen TedX-Vortrag darüber, warum wir Reisende warnen müssen, um die Ausbreitung von Krankheiten zu verhindern. Daher war es keine Überraschung, dass wir von COVID-19 erfuhren, das Anfang Dezember 2019 als ungewöhnlicher Cluster von Lungenentzündungsfällen gemeldet wurde. Am 2. Januar 2020 entschied unser Gesundheitsteam, dass wir eine erste Warnung an unsere Reisenden und Geschäftspartner herausgeben mussten. Das war sogar einige Tage vor der Weltgesundheitsorganisation!

Während der unvermeidlichen Folgen hatten wir eine Erkenntnis. Die Krankheit verbreitete sich so schnell, dass uns klar war, dass die weltweite Reaktion bestenfalls chaotisch sein würde. Jedes Land würde seine eigenen Vorschriften und Regeln zur Eindämmung der Ausbreitung erlassen. Das würde unweigerlich weltweit Chaos anrichten und eine enorme Quelle der Verwirrung für diejenigen sein, die dennoch reisen wollten. Wir behielten recht und beschlossen, etwas dagegen zu tun. Sitata war eines der ersten Unternehmen weltweit, das eine dedizierte API und einen Service zur Nachverfolgung von Änderungen an Reisebeschränkungen und Einreisebestimmungen infolge von COVID-19 schuf. Dank eines fortschrittlichen Software-Systems zur Ereigniserkennung und einem Team spezialisierter Analysten hatten wir bereits alle Werkzeuge und Prozesse, um dies zu erreichen.

Seit dem Start dieses neuen Dienstes haben mehrere Organisationen die Daten zum Vorteil ihrer eigenen Kunden genutzt, darunter Eddy Travels, Flight Centre und Etihad Airways; weitere Ankündigungen folgen in Kürze! Um mehr reiseorientierten Organisationen zu helfen, dieses Angebot zu nutzen, haben wir unten detailliert eine Reihe von Beispielen aufgeschrieben, die erklären, wie die API für verschiedene Anwendungsfälle genutzt werden kann. Wir hoffen, dass diese Erklärungen Ihnen helfen, Ihre eigenen Initiativen zu starten.

Einreisebestimmungen

Die ersten Fragen, die sich ein Reisender zweifellos stellt, sind: “Kann ich dorthin reisen?” und “Muss ich in Quarantäne?”, daher ist dies ein guter Ausgangspunkt. Wir haben den Datensatz zu den Einreisebestimmungen geschaffen, um die kniffligen Ja/Nein-Fragen zur Einreise in ein Land oder eine Region zu beantworten.

Zum Zeitpunkt der Erstellung dieses Artikels umfasste dieser Datensatz die folgenden zehn separaten Kategorien:

• Darf ein Einwohner in das Land einreisen?
• Darf ein Ausländer in das Land einreisen?
• Ist Transit durch das Land erlaubt?
• Wird bei der Ankunft ein Test verlangt (bei Krankheitssymptomen)?
• Ist ein Testzertifikat erlaubt (bei Krankheitssymptomen)?
• Ist bei der Ankunft eine Quarantäne erforderlich (bei Krankheitssymptomen)?
• Ist eine Impfung erforderlich?
• Ist eine Versicherung erforderlich?
• Ist ein Testzertifikat erforderlich?
• Ist ein Registrierungsformular erforderlich? (Gesundheit oder anderes)

Jede Kategorie kann einen der folgenden Werte haben:

• Ja
• Ja, mit Ausnahmen
• Nein
• Nein, außer Ausnahmen

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

Eine Einreisebestimmung ist im Grunde ein Dokument, das einen Satz von Regeln festhält, die von einem Akteur gegenüber einem oder mehreren anderen Ländern oder Regionen auferlegt werden. Der Akteur kann in unserer Datenarchitektur ein Land, ein Bundesstaat oder sogar eine Gemeinde sein. Insgesamt deckt Sitata derzeit Daten auf Länderebene ab. Wir haben jedoch einige Einträge auf Bundesstaats-/Provinzebene für bestimmte Regionen, wie die USA und andere.

Jeder Eintrag mit einem Wert im Feld **origin_country_division_id** oder **origin_country_region_id** ist eine Ebene, die sich auf Bundesstaats- bzw. Gemeindeebene befindet. Wenn Sie granularere Daten wünschen, kontaktieren Sie uns bitte, und wir können Ihren Anwendungsfall besprechen.

Bitte nehmen Sie sich die Zeit, sich mit der Datenstruktur der Einreisebestimmungen vertraut zu machen, indem Sie unsere API-Dokumentation hier einsehen.

Ein Teil der Datenstruktur ist etwas verwirrend, nämlich unsere Verwendung des Begriffs “Ursprung”. Diese Verwirrung rührt daher, dass Entwickler den Ursprung oft als den Herkunftsort oder Abflugort betrachten. Was wir jedoch mit “Ursprung” meinen, ist 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 aus der API abzurufen. Im Folgenden gehen wir einige der häufigsten Anwendungsfälle durch.

Wie erhalte ich die Anforderungen zwischen zwei Ländern?

Es gibt mehrere 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 umfasst alle Anforderungen (auf Landes- und Bundesstaatebene), die ein Reisender verstehen muss, der aus dem Abflugsland abreist und in das Zielland reist.

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

Sitata verfügt für einige Regionen über Daten auf Bundesstaatebene. Sie erkennen, dass ein bestimmter Eintrag für einen Bundesstaat gilt, wenn origin_country_division einen Wert hat. Sie können auch filtern, um nur Daten auf Bundesstaatebene 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 Suche nach Land durchzuführen und dann die Daten nach Bundesstaat zu filtern, um zu sehen, ob diese Daten existieren, und sie zu verwenden, falls ja.

Wie erhalte ich die Anforderungen zwischen zwei Flughäfen?

Genau wie bei Ländern kann die Sitata-API Ergebnisse zwischen zwei Flughäfen zurückgeben. Die Parameter departure_airport und destination_airport verwenden ICAO- oder IATA-Codes, um die Ergebnisse zu filtern. Die Antwort umfasst alle Beschränkungen (auf Landes- und Bundesstaatebene), die ein Reisender verstehen muss, 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 umfasst alle Beschränkungen (auf Landes- und Bundesstaatebene), die ein Reisender verstehen muss, der aus dem Abflugsland abreist und in das Zielland reist.

Was ist, wenn ich nur Informationen über die Stadt habe?

Sitata hat sich entschieden, Anfragen mit einem bestimmten Stadtnamen nicht zu beantworten, da dies zu Konflikten und Verwirrung führen könnte. Stattdessen haben wir uns entschieden, Anfragen an unsere API über Breiten- und Längengradkoordinaten zu akzeptieren, 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 anhand von Standorten auflösen und Anfragen anhand von Koordinaten stellen, antwortet unsere API mit allen Beschränkungen (auf Landes- und Bundesstaatebene), die ein Reisender verstehen muss, der aus dem Abflugsland abreist und in das Zielland reist.

Zusätzliche Informationen

Für bestimmte Arten von Einreisebestimmungen können im Metadatenfeld extras zusätzliche Daten hinterlegt sein. Dieses Feld ist eine Schlüssel/Wert-Zuordnung verschiedener zusätzlicher Informationspunkte für eine bestimmte Anforderung.

Wie viele Quarantänetage sind es?

Dieser Dateneintrag fällt unter die 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 gilt ein negativer Covid-Test?

Dieser Dateneintrag fällt unter die 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 ein sehr robustes Werkzeug haben, das wahrscheinlich alle Ihre Anforderungen erfüllt, um Ihren Reisenden zu helfen zu verstehen, was ihnen unterwegs wahrscheinlich begegnet. Wenn Sie einen speziellen Anwendungsfall haben, den wir nicht abdecken, teilen Sie uns dies bitte mit!

Warten Sie… es gibt mehr!

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

Bleiben Sie gespannt auf den zweiten Artikel, der sich eingehender mit unserem Datensatz zu Reisebeschränkungen befassen wird. Tipp: Er ist fast identisch, also können Sie in der Zwischenzeit immer noch unsere API-Dokumentation konsultieren.