Viele von Ihnen wissen das vielleicht nicht, aber Sitatas frühe Grundlagen wurden für die Früherkennung von Krankheiten geschaffen. Tatsächlich hat unser Gründer einen TedX-Vortrag aus dem Jahr 2016 über warum wir Reisende warnen müssen, um die Ausbreitung von Krankheiten zu verhindern. Es sollte daher nicht überraschen, dass wir auf COVID-19 aufmerksam wurden, als Anfang Dezember 2019 eine ungewöhnliche Häufung von Fällen von Lungenentzündung gemeldet wurde. Am 2. Januar 2020 entschied unser Gesundheitsteam, dass wir eine unsere erste Warnung an unsere Reisenden und Geschäftspartner. Das war noch Tage vor der Weltgesundheitsorganisation!

Während des unvermeidlichen Fallouts hatten wir eine Erleuchtung. Die Krankheit verbreitete sich so schnell, dass uns klar war, dass die globale Reaktion bestenfalls chaotisch sein würde. Jedes Land würde seine eigenen Vorschriften und Regeln erlassen, um die Ausbreitung zu kontrollieren. Dies würde unweigerlich zu einer Beeinträchtigung des weltweiten Reiseverkehrs führen und für diejenigen, die noch reisen wollten, eine große Verwirrung stiften. Wir hatten Recht und machten uns daran, etwas dagegen zu unternehmen. Sitata war eines der ersten Unternehmen weltweit, das eine spezielle API und einen Überwachungsdienst für die Änderungen der Reisebeschränkungen und Einreisebestimmungen als Folge von COVID-19 entwickelt hat. Mit einem fortschrittlichen Softwaresystem für die Erkennung von Ereignissen und einem engagierten Analystenteam verfügten wir bereits über die richtigen Werkzeuge und Prozesse, um dies zu tun.

Seit der Einführung dieses neuen Dienstes haben eine Reihe von Unternehmen die Daten zum Vorteil ihrer eigenen Kunden genutzt, darunter Eddy Travels, Flight Centre und Etihad Airways, und weitere werden in Kürze bekannt gegeben! Damit noch mehr Unternehmen, die sich auf Reisen spezialisiert haben, von diesem Angebot profitieren können, haben wir im Folgenden eine Reihe von Beispielen aufgeführt, die erklären, wie die API für eine Vielzahl von Anwendungsfällen genutzt werden kann. Ich hoffe, diese Erklärungen helfen Ihnen, Ihre eigenen Initiativen auf den Weg zu bringen.

Zugangsvoraussetzungen

Die ersten Fragen, die sich ein Reisender stellt, sind zweifellos "Kann ich dorthin reisen?" und "Werde ich unter Quarantäne gestellt". Wir haben den Datensatz "Einreisebestimmungen" erstellt, um die schwierigen "Ja/Nein"-Fragen zur Einreise in ein Land oder eine Region zu beantworten.

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

• Kann ein Gebietsansässiger in das Land einreisen?
• Darf ein Ausländer in das Land einreisen?
• Ist die Durchreise durch das Land erlaubt?
• Ist bei der Ankunft ein Test erforderlich (Ausbruch einer Krankheit)?
• Ist eine Prüfbescheinigung zulässig (Ausbruch einer Krankheit)?
• Ist bei der Ankunft eine Quarantäne erforderlich (Ausbruch einer Krankheit)? Ist eine Impfung erforderlich?
• Versicherung erforderlich?
• Prüfbescheinigung erforderlich?
• Anmeldeformular erforderlich (Gesundheit oder Sonstiges)

Jede Kategorie kann einen der folgenden Werte haben:

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

Während die große Mehrheit der Werte "ja" und "nein" lautet, ist die Situation vor Ort nicht immer so einfach. Manchmal gibt es wirklich seltsame und verrückte Regeln, die verschiedene Regierungen eingeführt haben und die die Wertetypen "mit Ausnahmen" erforderlich machen.

Eine Einreiseverpflichtung ist im Wesentlichen ein Datensatz, der eine Reihe von Regeln dokumentiert, die ein Akteur einem oder mehreren anderen Ländern oder Regionen auferlegt. Der Akteur kann in unserer Datenarchitektur ein Land, ein Staat oder sogar eine Gemeinde sein. Im Großen und Ganzen deckt Sitata derzeit Daten auf Länderebene ab. Wir verfügen jedoch über einige Datensätze zu Bundesstaaten/Provinzen für ausgewählte Regionen wie die Vereinigten Staaten und andere.

Jeder Datensatz, der einen Eintrag unter dem Feld herkunftsland_division_id oder herkunft_land_region_id entweder auf staatlicher oder kommunaler Ebene liegt. Wenn Sie detailliertere Daten wünschen, wenden Sie sich bitte an Kontaktieren Sie uns und wir können über Ihren Anwendungsfall sprechen.

Bitte nehmen Sie sich etwas Zeit, um sich mit der Datenstruktur der Zulassungsvoraussetzungen vertraut zu machen. Sehen Sie sich unsere API-Dokumente hier an.

Ein etwas verwirrender Teil der Datenstruktur ist unsere Verwendung des Begriffs "Herkunft." Dies ist verwirrend, weil die Entwickler bei dem Begriff "Ursprung" oft an den Herkunftsort oder den Ort des Beginns denken. Was wir jedoch mit Ursprung meinen, ist eigentlich der Ursprung der Regel, die anderen auferlegt wird, d. h. das Land oder die Region, die die Beschränkung geschaffen hat.

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

Ein paar Beispiele

Wie Sie vielleicht aus der Dokumentation ersehen haben, gibt es eine Reihe von Möglichkeiten, Daten von der API abzurufen. Im Folgenden gehen wir einige der häufigsten Anwendungsfälle durch.

Wie kann ich die Anforderungen zwischen zwei Ländern abrufen?

Es gibt mehrere Möglichkeiten, diese Art von Anfrage zu stellen. Die einfachste Variante ist die Verwendung der Zielort und Abreise Parameter. 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 Länder- und Staatsebene), die für den Reisenden, der aus dem Abgangsland abreist und in das Zielland reist, zu verstehen sind.

Was ist, wenn ich Daten auf Länderebene benötige?

Sitata verfügt über Daten auf Bundeslandebene für bestimmte Regionen. Sie erkennen, dass ein bestimmter Eintrag für ein Bundesland ist, wenn die herkunft_land_division Feld einen Wert hat. Sie können auch filtern, um nur Daten auf Staatsebene abzurufen, indem Sie die ziel_land_division Parameter. Er erwartet eine ISO_3166-2 Wert. Zum Beispiel, US-TX für Texas, Vereinigte Staaten.

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

Es könnte einfacher sein, eine Abfrage nach Land zu machen und dann nach den Daten des Staates zu filtern, um zu sehen, ob solche Daten vorhanden sind, und sie zu verwenden, wenn sie vorhanden sind.

Wie kann ich die Anforderungen zwischen zwei Flughäfen abrufen?

Genau wie bei Ländern kann die Sitata-API Ergebnisse zwischen zwei Flughäfen liefern. Die Parameter abflug_flughafen und ziel_flughafen verwenden Sie entweder ICAO oder IATA Codes, um die Ergebnisse zu filtern. Die Antwort enthält alle Beschränkungen (auf Länder- und Staatsebene), die für den Reisenden, der aus dem entsprechenden Abreiseland abreist und in das Zielland reist, notwendig sind.

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

Die Antwort enthält alle Beschränkungen (auf Länder- und Staatsebene), die für den Reisenden, der aus dem Abreiseland abreist und in das Zielland reist, zu verstehen sind.

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

Sitata hat sich entschieden, keine Abfragen nach einem bestimmten Städtenamen zuzulassen, da dies zu Konflikten und Verwirrung führen könnte. Stattdessen haben wir uns dafür entschieden, unsere API nach Längen- und Breitengraden abzufragen, was zu keiner Mehrdeutigkeit in unserer Ergebnismenge führt. Die Parameter sind Abflug_lat, abfahrt_lng, Ziel_latund ziel_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 in Orte auflösen und auf der Grundlage von Koordinaten abfragen, antwortet unsere API mit allen Beschränkungen (auf Länder- und Staatsebene), die notwendig sind, um den Reisenden zu verstehen, der vom Abfahrtsland abfährt und in das Zielland reist.

Zusätzliche Daten

Für einige Arten von Zugangsvoraussetzungen können zusätzliche Daten in einem Metadatenfeld namens Extras. Dieses Feld ist eine Schlüssel/Wert-Zuordnung verschiedener zusätzlicher Informationen für eine bestimmte Anforderung.

Wie viele Tage beträgt die Quarantäne?

Diese Dateneingabe fällt unter die Eingabepflicht Typ 5. In diesem Eintrag wird die Extras Mapping enthält ein Feld namens Quarantäne_Tage die eine ganze Zahl für die Anzahl der Tage der Quarantäne enthält.

Wie viele Stunden vor der Einreise muss ein negativer Covid-Test vorliegen?

Diese Dateneingabe fällt unter die Eingabepflicht Typ 8. In diesem Eintrag wird die Extras Mapping enthält ein Feld namens eintrag_stunden die eine ganze Zahl für die Anzahl der Stunden enthält, die ein negativer Covid-Test vor der Einreise zulässig ist.

Informieren Sie uns

Wir sind der Meinung, dass wir eine sehr robuste Lösung haben, die wahrscheinlich alle Ihre Bedürfnisse abdeckt, um Ihren Reisenden zu helfen, zu verstehen, was sie wahrscheinlich auf ihrem Weg antreffen werden. Wenn Sie einen bestimmten Anwendungsfall haben, den wir nicht abdecken, bitte informieren Sie uns!

Warte... da ist noch mehr!

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

Bleiben Sie dran für den zweiten Beitrag, in dem wir unseren Datensatz zu den Reisebeschränkungen genauer unter die Lupe nehmen werden. Hinweis - er ist fast identisch, also können Sie immer einen Blick auf unsere API-Dokumentation in der Zwischenzeit.

Bitte folgen Sie uns und mögen Sie uns: