قد لا يعرف الكثير منكم هذا، لكن الأسس المبكرة لشركة Sitata بُنيت للكشف المبكر عن الأمراض. في الواقع، لمؤسسنا حديث في تيدكس من عام 2016 عن لماذا نحتاج إلى تحذير المسافرين للمساعدة في منع انتشار المرض. ليس من المستغرب إذن أن نكون قد اكتشفنا كوفيد-19 عندما تم الإبلاغ عن مجموعة غير عادية من حالات الالتهاب الرئوي في أوائل ديسمبر 2019. وبحلول 2 يناير 2020، قرر فريقنا الصحي أنه يجب علينا إصدار تحذيرنا الأول للمسافرين وشركائنا في العمل. كان هذا قبل أيام حتى من منظمة الصحة العالمية!

خلال التداعيات الحتمية التي لا مفر منها كان لدينا عيد الغطاس. كان المرض ينتشر بسرعة كبيرة لدرجة أنه كان من الواضح لنا أن الاستجابة العالمية ستكون فوضوية في أفضل الأحوال. ستسن كل دولة مجموعة من اللوائح والقواعد الخاصة بها لكيفية السيطرة على انتشار المرض. سيؤدي ذلك حتمًا إلى إحداث فوضى في حركة السفر العالمية وسيكون مصدر ارتباك كبير لأولئك الذين ما زالوا يرغبون في السفر. كنا على حق وشرعنا في فعل شيء حيال ذلك. كانت Sitata واحدة من أوائل الشركات في العالم التي أنشأت واجهة برمجة تطبيقات مخصصة وخدمة مراقبة للتغييرات في قيود السفر ومتطلبات الدخول نتيجة لجائحة كوفيد-19. وبفضل نظام برمجيات متقدم للكشف عن الأحداث وفريق متخصص من المحللين، كان لدينا بالفعل جميع الأدوات والعمليات المناسبة للقيام بذلك.

منذ إطلاق هذه الخدمة الجديدة لدينا مجموعة متنوعة من المؤسسات التي تستفيد من البيانات لصالح عملائها، بما في ذلك شركة إيدي للسفريات، ومركز الرحلات، والاتحاد للطيران، وهناك المزيد من المؤسسات التي سيتم الإعلان عنها قريباً! من أجل مساعدة المزيد من المؤسسات التي تركز على السفر على الاستفادة من هذا العرض، قمنا بكتابة عدد من الأمثلة أدناه بالتفصيل للمساعدة في شرح كيفية استخدام واجهة برمجة التطبيقات لمجموعة متنوعة من حالات الاستخدام. آمل أن تساعدك هذه التوضيحات في إطلاق مبادراتك الخاصة.

متطلبات الدخول

لا شك أن أول الأسئلة التي يطرحها المسافر هي "هل يمكنني الذهاب إلى هناك؟" و"هل سأخضع للحجر الصحي"، لذا فإن هذا هو المكان المناسب للبدء. لقد أنشأنا مجموعة بيانات متطلبات الدخول للإجابة على أنواع الأسئلة الصعبة "نعم/لا" المتعلقة بدخول بلد أو منطقة ما.

في وقت كتابة هذا التقرير، تضمنت مجموعة البيانات هذه الفئات العشر المميزة التالية:

• هل يمكن للمقيم دخول البلد؟
• هل يمكن للأجنبي دخول البلاد؟
• هل يُسمح بالعبور عبر البلاد؟
• هل الفحص مطلوب عند الوصول (تفشي المرض)؟
• هل يُسمح بشهادة اختبار (تفشي المرض)؟
• هل الحجر الصحي مطلوب عند الوصول (تفشي المرض)؟ هل التطعيم مطلوب؟
• هل التأمين مطلوب؟
• هل شهادة الاختبار مطلوبة؟
• هل استمارة الدخول مطلوبة؟ (صحية أو غيرها)

يمكن أن يكون لكل فئة إحدى القيم التالية:

• نعم
• نعم، مع وجود استثناءات
• لا يوجد
• لا، مع وجود استثناءات

على الرغم من أن الغالبية العظمى من القيم هي "نعم" و"لا"، إلا أن الوضع على أرض الواقع ليس دائمًا بهذه البساطة. في بعض الأحيان تكون هناك قواعد غريبة ومجنونة حقًا وضعتها حكومات مختلفة مما يستلزم أنواع القيم "مع وجود استثناءات".

متطلب الدخول هو في الأساس سجل يوثق مجموعة من القواعد التي يفرضها أحد الفاعلين على دولة أو عدة دول أو مناطق أخرى. يمكن أن يكون الفاعل دولة أو ولاية أو حتى بلدية في بنية بياناتنا. بشكل عام، تغطي Sitata البيانات على مستوى الدولة حاليًا. ومع ذلك، لدينا بعض سجلات الولايات/المقاطعات لمناطق مختارة مثل الولايات المتحدة وغيرها.

أي سجل يحتوي على إدخال تحت الحقل بلد_الأصل_بلد_المنشأ_معرف_التقسيم_المتوسط أو معرف_بلد_المنطقة_الأصلية إما على مستوى الولاية أو البلدية، على التوالي. إذا كنت ترغب في الحصول على بيانات أكثر تفصيلاً، يرجى اتصل بنا ويمكننا التحدث عن حالة استخدامك.

يرجى تخصيص بعض الوقت للتعرف على بنية بيانات متطلبات الدخول من خلال إلقاء نظرة على مستندات واجهة برمجة التطبيقات (API) الخاصة بنا هنا.

أحد الأجزاء المربكة قليلاً حول بنية البيانات هو استخدامنا لمصطلح "الأصل." وهذا أمر مربك لأن المطورين غالبًا ما يعتقدون أن الأصل هو مكان المنشأ أو مكان الانطلاق. غير أن ما نعنيه بالمنشأ هو في الواقع منشأ القاعدة المفروضة على الآخرين، أي البلد أو المنطقة التي أوجدت القيد.

نقطة أخرى مهمة يجب ملاحظتها هي كيفية عمل قائمة البلدان المتأثرة. إذا كانت قائمة البلدان المتأثرة فارغة، فينبغي تفسيرها على أنها قاعدة عالمية، أي أن جميع البلدان متأثرة.

بعض الأمثلة

كما رأيت من الوثائق، هناك عدد من الطرق لاسترداد البيانات من واجهة برمجة التطبيقات. فيما يلي سنستعرض بعض حالات الاستخدام الأكثر شيوعًا.

كيف يمكنني جلب المتطلبات بين دولتين؟

هناك طريقتان للقيام بهذا النوع من الطلبات. أبسط نسخة هي استخدام الإصدار الوجهة و المغادرة المعلمات. تقبل هذه المعلمات ISO 3166-1 ألفا-2 ISO 3166-1 alpha-2 الرموز كمدخلات.

احصل على https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination=IN

سيتضمن الرد جميع المتطلبات (على مستوى البلد والدولة) اللازمة لفهم المسافر المغادر من بلد المغادرة والسفر إلى بلد المقصد.

ماذا لو كنت أريد بيانات على مستوى الولاية؟

لدى Sitata بيانات على مستوى الولاية لمناطق معينة. ستعرف أن مدخلاً معيناً يخص ولاية معينة إذا كانت تقسيم_بلد_المنشأ له قيمة. يمكنك أيضًا التصفية لاسترجاع البيانات على مستوى الولاية فقط باستخدام الوجهة_تقسيم_البلد_المقصد معلمة. وتتوقع المعلمة ISO_3166-2 القيمة. على سبيل المثال، US-TX لتكساس، الولايات المتحدة.

احصل على https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination_country_division=IN-AP

لاحظ أنه قد يكون من الأسهل الاستعلام حسب البلد ثم التصفية حسب بيانات الولاية لمعرفة ما إذا كانت هذه البيانات موجودة، واستخدامها إذا كانت موجودة.

كيف يمكنني جلب المتطلبات بين مطارين؟

تماماً كما هو الحال مع البلدان، يمكن لواجهة برمجة تطبيقات Sitata إرجاع النتائج بين مطارين. المعلمات مطار_المغادرة_المغادرة و الوجهة_المطار استخدم إما منظمة الطيران المدني الدولي (ICAO) أو اتحاد النقل الجوي الدولي (IATA) الرموز لتصفية النتائج. ستتضمن الاستجابة جميع القيود (على مستوى البلد والولاية) اللازمة لفهم المسافر المغادر من بلد المغادرة المقابل والمسافر إلى بلد المقصد.

احصل على https://www.sitata.com/api/v2/entry_requirements?departure_airport=MUC&destination_airport=BOM

سيتضمن الرد جميع القيود (على مستوى البلد والدولة) اللازمة لفهم المسافر المغادر من بلد المغادرة والسفر إلى بلد المقصد.

ماذا لو كانت لدي معلومات المدينة فقط؟

اختارت سيتاتا عدم استيعاب الاستعلامات حسب اسم مدينة معينة لأن ذلك قد يؤدي إلى تضارب وارتباك. بدلاً من ذلك، اخترنا بدلاً من ذلك استيعاب الاستعلام عن واجهة برمجة التطبيقات الخاصة بنا عن طريق إحداثيات خطوط الطول والعرض، وهو ما لا ينتج عنه أي غموض في مجموعة النتائج. المعلمات هي المغادرة_مغادرة_لات, المغادرة_لنغ, الوجهة_للاتو الوجهة_لنغ.

احصل على https://www.sitata.com/api/v2/entry_requirements?departure_lat=48.13743&departure_lng=11.57549&destination_lat=19.0760&destination_lng=72.8777

إذا قمت بتحديد مدنك إلى مواقع واستفسرت عن المواقع بناءً على الإحداثيات، فستستجيب واجهة برمجة التطبيقات الخاصة بنا مع جميع القيود (على مستوى البلد والولاية) اللازمة لفهم المسافر المغادر من بلد المغادرة والمسافر إلى بلد الوجهة.

بيانات إضافية

بالنسبة لبعض أنواع متطلبات الإدخال، قد تكون هناك بيانات إضافية مرتبطة في حقل نوع البيانات الوصفية يسمى الإضافات. هذا الحقل عبارة عن تعيين مفتاح/قيمة لمختلف أجزاء المعلومات الإضافية لمتطلب معين.

ما هو عدد أيام الحجر الصحي؟

يندرج إدخال البيانات هذا تحت شرط الإدخال النوع 5. في هذا المدخل، فإن الإضافات سيحتوي التعيين على حقل يسمى أيام_الحجر_الصحي والذي سيحتوي على عدد صحيح لعدد أيام الحجر الصحي المفروضة.

ما هو عدد الساعات التي تسبق دخول اختبار كوفيد السلبي؟

يندرج إدخال البيانات هذا تحت شرط الإدخال النوع 8. في هذا المدخل، فإن الإضافات سيحتوي التعيين على حقل يسمى ساعات_الدخول والتي ستحتوي على عدد صحيح لعدد الساعات المسموح بها لاختبار كوفيد السلبي قبل الدخول.

دعنا نعرف

نحن نعتقد أن لدينا نظاماً قوياً جداً من المحتمل أن يلبي جميع احتياجاتك لمساعدة المسافرين على فهم ما قد يواجهونه على طول الطريق. إذا كانت لديك حالة استخدام معينة لا نعالجها, يرجى إعلامنا بذلك!

انتظر... هناك المزيد!

هذه المدخلة جزء من سلسلة من جزأين تشرح كيفية التفاعل مع واجهة برمجة تطبيقات Sitata لمتطلبات الدخول ومعلومات قيود السفر. لقد تحدثنا حتى الآن عن متطلبات الدخول التي تحدد أنواع المتطلبات الصعبة بنعم/لا اللازمة لدخول بلد أو منطقة ما، ولكننا لم نتحدث عن ما يحدث داخل البلد أيضًا. إن معرفة الدخول إلى بلد ما شيء، وفهم ما إذا كان من الممكن التنقل في البلد أو زيارة الشواطئ أو إذا كان هناك حظر تجول إلزامي شيء آخر.

ترقبوا المنشور الثاني الذي سيتعمق في مجموعة بيانات قيود السفر الخاصة بنا. تلميح - إنها متطابقة تقريبًا، لذا يمكنك دائمًا إلقاء نظرة على وثائق واجهة برمجة التطبيقات (API) في هذه الأثناء