Muchos de ustedes tal vez no lo sepan, pero los primeros cimientos de Sitata se construyeron para la detección temprana de enfermedades. De hecho, nuestro fundador tiene una charla de TedX a partir de 2016 sobre por qué necesitamos advertir a los viajeros para ayudar a prevenir la propagación de la enfermedad. Es ist daher nicht verwunderlich, dass wir in COVID-19 eintraten, als wir über eine ungewöhnliche Gruppe von Neugeborenenfällen im Dezember 2019 informiert wurden. El 2 de enero de 2020, nuestro equipo de salud determinó que debíamos emitir nuestra primera advertencia a nuestros viajeros y socios comerciales. So war es schon vor einigen Tagen, auch in der Weltgesundheitsorganisation (WHO)!
Während der unvermeidlichen radioaktiven Strahlung hatten wir eine Epifanerie. La enfermedad se estaba extendiendo tan rápido que teníamos claro que la respuesta global sería caótica en el mejor de los casos. Cada país promulgaría su propio conjunto de regulaciones y reglas para controlar la propagación. Esto inevitablemente causaría estragos en los viajes mundiales y sería una enorme fuente de confusión para aquellos que aún desean viajar. Teníamos razón y nos propusimos hacer algo al respecto. Sitata war eines der ersten Unternehmen der Welt, das eine spezielle API und einen Überwachungsservice für die Änderungen der Reisebeschränkungen und Einreisebestimmungen im Zuge der COVID-19 eingeführt hat. Mit einem hochmodernen Softwaresystem für die Ereigniserkennung und einem speziellen Analyseteam verfügten wir bereits über alle geeigneten Mittel und Verfahren, um dies zu bewerkstelligen.
Seit der Einführung dieses neuen Dienstes haben wir eine Vielzahl von Organisationen, die die Daten zum Nutzen ihrer eigenen Kunden nutzen, darunter Eddy Travels, Flight Centre und Etihad Airways; und es gibt noch mehr, die wir in Kürze ankündigen werden! Um dazu beizutragen, dass mehr Reiseveranstalter von diesem Angebot profitieren, haben wir in der Folge eine Reihe von Beispielen aufgeschrieben, um die Nutzung der API für verschiedene Anwendungsfälle zu erläutern. Ich hoffe, diese Erklärungen helfen Ihnen, Ihre eigenen Initiativen in Gang zu bringen.
Zulassungsvoraussetzungen
Sin duda, las primeras preguntas que un viajero hace son "¿puedo ir allí?" y "¿seré puesto en cuarentena?", así que este es un buen lugar para empezar. Wir haben das Datenpaket der Einreisevoraussetzungen erstellt, um die Fragen nach der Einreise in ein Land oder eine Region mit "ja/nein" zu beantworten.
En el momento de redactar el presente informe, este conjunto de datos incluía las siguientes 10 categorías distintas:
- ¿Puede un residente entrar en el país?
- ¿Puede un extranjero entrar en el país?
- ¿Se permite el tránsito por el país?
- ¿Se requiere una prueba a la llegada (brote de la enfermedad)?
- ¿Se permite un certificado de prueba (brote de una enfermedad)?
- ¿Se requiere una cuarentena a la llegada (brote de enfermedad)? ¿Se requiere una vacuna?
- ¿Se requiere un seguro?
- ¿Se requiere un certificado de prueba?
- ¿Se requiere un formulario de inscripción? (salud u otro)
Cada categoría puede tener uno de los siguientes valores:
- Sí
- Sí, con excepciones
- Nein
- Nein, mit Ausnahmen
Aunque la gran mayoría de los valores son "sí" y "no", la situación sobre el terreno no siempre es tan sencilla. A veces hay reglas realmente extrañas y locas que varios gobiernos han puesto en marcha que requieren los tipos de valores "con excepciones"
Eine Zugangsvoraussetzung ist vor allem ein Register, das eine Gesamtheit von Normen dokumentiert, die von einem Akteur gegenüber einem oder mehreren Ländern oder Regionen auferlegt wurden. El actor podría ser un país, estado o incluso municipio en nuestra arquitectura de datos. Im Allgemeinen erfasst Sitata die Daten auf Länderebene in der aktuellen Situation. Dennoch verfügen wir über einige Länder-/Provinzialregister für ausgewählte Regionen wie Estados Unidos und andere
Jedes Register, das einen Eintrag unter dem Feld hat herkunftsland_division_id
o herkunft_land_region_id
es uno que es de nivel estatal o municipal, respectivelyivamente. Si desea disponer de más datos granulares, por favor, póngase en contacto mit uns y podemos hablar de su caso de uso.
Por favor, tómese un tiempo para familiarizarse con la estructura de datos de los requisitos de entrada echando un vistazo a Unsere API-Dokumente finden Sie hier.
Ein etwas verwirrender Aspekt in Bezug auf die Struktur der Daten ist unsere Verwendung des Begriffs"Herkunft" Dies ist verwirrend, denn in der Regel glauben die Entwickler, dass der Ursprung der Ort ist, an dem sie entstanden sind oder von dem sie sich getrennt haben. Sin embargo, lo queemos decir con origen es en realidad el origen de la regla impuesta a otros, es decir, el país o la región que ha creado la restricción.
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.
Einige Exemplare
Wie Sie in der Dokumentation gesehen haben, gibt es verschiedene Möglichkeiten, Daten aus der API zurückzugewinnen. A continuación veremos algunos de los casos de uso más comunes.
¿Cómo puedo obtener los requisitos entre dos países?
Es gibt eine Reihe von Möglichkeiten, diese Art von Antrag zu stellen. Die einfachste Variante ist die Verwendung der destino
y salida
Parametern. Diese Parameter akzeptieren die Codes ISO 3166-1 alfa-2 in Form von Einträgen
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.
¿Y si quiero datos a nivel estatal?
Sitata verfügt über Daten auf Landesebene für bestimmte Regionen. Sie wissen, dass ein bestimmter Eintrag für einen Staat ist, wenn der división_país_original
Der Platz hat einen Wert. Sie können auch filtern, um nur die Statusdaten zu erhalten, indem Sie die división_país_destino
parámetro. Espera un valor ISO_3166-2. Zum Beispiel: US-TX für Texas, Estados Unidos.
GET https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination_country_division=IN-AP
Obsérvese que podría sercillo hacer una consulta por país y luego filtrar por los datos de los estados para ver si esos datos existen, y utilizarlos if existens.
¿Cómo puedo obtener los requisitos entre dos aeropuertos?
Genauso wie im Falle von Ländern kann die API von Sitata Ergebnisse zwischen zwei Fluggesellschaften liefern. Los parámetros Flughafen von Salida
y Zielflughafen
utilizar los códigos de la OACI o de la IATA um die Ergebnisse zu filtern. Die Antwort enthält alle Einschränkungen (auf der Ebene des Landes und des Staates), die erforderlich sind, um einen Reisenden zu erfassen, der aus dem entsprechenden Herkunftsland ausreist 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 Einschränkungen (auf der Ebene des Landes und des Staates), die für den Reisenden, der aus dem Herkunftsland in das Bestimmungsland reist, erforderlich sind.
¿Y si sólo tengo información de la ciudad?
Sitata entschied sich dafür, die Abfragen nicht nach einem bestimmten Städtenamen durchzuführen, da dies zu Konflikten und Unklarheiten führen könnte. Stattdessen haben wir uns dafür entschieden, die Abfrage in unserer API nach Breiten- und Längengraden auszurichten, was in unserem Ergebniskonvolut zu keinerlei Unklarheiten führt. Die Parameter sind Abflug_lat
, abfahrt_lng
, Ziel_lat
...y.. 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 auf der Grundlage der Koordinaten abfragen, antwortet unsere API mit allen Einschränkungen (auf Länder- und Staatsebene), die für den Reisenden erforderlich sind, der vom Ausgangsland ins Zielland reist.
Zusätzliche Daten
Für einige Arten von Zulassungsvoraussetzungen können zusätzliche Daten in einem Metadatenfeld mit der Bezeichnung Extras
. Dieser Bereich ist eine Übersichtskarte/ein Wert mit mehreren zusätzlichen Informationen für eine bestimmte Anforderung.
¿Cuál es el número de días de cuarentena?
Diese Dateneingabe unterliegt der Eintragungsvoraussetzung tipo 5. In diesem Eintrag wird die Extras
Die Karte enthält ein Feld mit dem Namen días_de_cuarentena
que contendrá un número entero para el número de días de cuarentena impuestos.
¿Cuál es el número de horas antes de la entrada para una prueba de covidio negativa?
Diese Dateneingabe unterliegt der Eintragungsvoraussetzung tipo 8. In diesem Eintrag wird die Extras
Die Karte enthält ein Feld mit dem Namen eintrag_stunden
que contendrá un número entero para el número de horas que se permite una prueba covid negativa antes de la entrada.
Háganos saber
Wir glauben, dass wir eine sehr robuste Version haben, die wahrscheinlich alle Ihre Bedürfnisse erfüllt, um Ihren Reisenden zu helfen, das zu verstehen, was Sie wahrscheinlich auf Ihrem Weg finden werden. Si usted tiene un caso de uso particular que no estamos abordando, Por favor háganoslo saber!
Espera... ¡hay más!
Dieser Eintrag ist Teil einer zweiteiligen Serie, die die Interaktion mit der API von Sitata für Einreisevoraussetzungen und Informationen über Reisebeschränkungen erläutert. Bis jetzt haben wir über die Einreisebedingungen gesprochen, die die wichtigsten Voraussetzungen für die Einreise in ein Land oder eine Region sind, aber wir haben nicht darüber gesprochen, was im Land selbst passiert. Eine Sache ist es, sich über die Einreise in ein Land zu informieren, und eine andere ist es, zu wissen, ob es möglich ist, sich durch das Land zu bewegen oder die Spielplätze zu besuchen, oder ob es eine obligatorische Einreisegenehmigung gibt.
Manténgase en sintonía para el segundo post que se sumergirá en nuestro conjunto de datos de Restricción de Viaje. Pista - es casi idéntico, así que siempre puedes echar un vistazo a nuestra Dokumentierung de la API mientras tanto.