旅行者の渡航制限を判断するためのSitata API活用方法
多くの方はご存知ないかもしれませんが、Sitataの初期基盤は早期疾病検出のために構築されました。実際、創業者は2016年のTedXトークで「なぜ旅行者に警告して疾病拡散を防ぐ必要があるのか」について語っています。したがって、2019年12月初旬に異常な肺炎症例群として報告されたCOVID-19に私たちが早期に注目したことは驚くべきことではありません。2020年1月2日までに、私たちの医療チームは旅行者とビジネスパートナー向けに最初の警告を発出すべきと判断しました。これは世界保健機関よりも数日も早い対応でした。
避けられない混乱の中で、私たちはある洞察を得ました。疾病の拡散が非常に速く、世界の対応はせいぜい混乱を極めるだろうことが明らかでした。各国は感染拡大を制御するための独自の規制と規則を制定することになります。これは必然的に国際旅行に大混乱をもたらし、それでも旅行を希望する人々にとって大きな混乱の源となるでしょう。私たちの予測は的中し、この問題に対処することを決意しました。Sitataは、COVID-19に起因する渡航制限と入国要件の変化に対応する専用APIと監視サービスを世界で最初に開発した企業の一つです。イベント検出のための高度なソフトウェアシステムと専門の分析チームを既に有していたため、これらを実現するための適切なツールとプロセスがすべて整っていました。
この新サービスを開始して以来、Eddy Travels、Flight Centre、Etihad Airwaysなど、様々な組織が自社顧客の利益のためにこのデータを活用しています。さらに近日中に発表される予定のパートナーもいます！より多くの旅行関連組織がこの提供を活用できるよう、以下では様々なユースケースでAPIを活用する方法を説明する多数の例を詳細に記述しました。これらの説明が、皆様自身の取り組みを立ち上げる一助となれば幸いです。
入国要件
間違いなく、旅行者が最初に尋ねる質問は「そこに行けますか？」「隔離されますか？」です。したがって、ここから始めるのが適切です。私たちは、国や地域への入国に関する明確な「はい/いいえ」タイプの質問に答えるために、入国要件データセットを作成しました。
執筆時点で、このデータセットには以下の10の異なるカテゴリが含まれています：
- 居住者は入国できますか？
- 外国人は入国できますか？
- 通過（トランジット）は許可されていますか？
- 到着時の検査は必要ですか（疾病発生時）？
- 検査証明書は認められますか（疾病発生時）？
- 到着時の隔離は必要ですか（疾病発生時）？ワクチン接種は必要ですか？
- 保険は必要ですか？
- 検査証明書は必要ですか？
- 入国フォームは必要ですか？（健康関連またはその他）
各カテゴリは以下のいずれかの値を取ります：
- はい
- はい（例外あり）
- いいえ
- いいえ（例外あり）
値の大部分は「はい」と「いいえ」ですが、現地の状況は必ずしも単純ではありません。時として、各国政府が実施する非常に奇妙で異常な規則があり、これが「例外あり」という値タイプを必要とします。
入国要件は、基本的に、ある主体が他の1つまたは複数の国や地域に対して課した一連の規則を文書化した記録です。私たちのデータ構造では、主体は国、州、さらには自治体となる可能性があります。現在、Sitataは主に国レベルのデータをカバーしています。ただし、アメリカ合衆国などの特定地域については州/省レベルの記録も保持しています。
**origin_country_division_id** または **origin_country_region_id** フィールドにエントリがある記録は、それぞれ州レベルまたは自治体レベルのものです。より詳細なデータが必要な場合は、お問い合わせいただければ、ユースケースについてご相談できます。
APIドキュメントをご覧いただき、入国要件データ構造について理解を深める時間をぜひお取りください。
データ構造について少し混乱を招く可能性があるのは、「origin」という用語の使用です。開発者はしばしばoriginを出発地や出発点と考えるため、混乱が生じます。しかし、私たちがoriginで意味しているのは、実際には他者に課された規則の発信元です。つまり、制限を設けた国や地域を指します。
もう一つ重要な点は、影響を受ける国のリストの動作方法です。affected_countriesが空の場合、それはグローバルルールとして解釈すべきです。つまり、すべての国が影響を受けます。
いくつかの例
ドキュメントからお気づきかもしれませんが、APIからデータを取得する方法はいくつかあります。以下では、より一般的なユースケースのいくつかについて説明します。
2国間の要件を取得するには？
この種のリクエストを行う方法はいくつかあります。最もシンプルな方法は、**destination** と **departure** パラメータを使用することです。これらのパラメータは入力としてISO 3166-1 alpha-2コードを受け付けます。
GET https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination=INレスポンスには、出発国から出発し目的地国へ旅行する旅行者が理解するために必要なすべての要件（国レベルおよび州レベル）が含まれます。
州レベルのデータが必要な場合は？
Sitataは特定地域の州レベルデータも保持しています。特定のエントリが州レベルのものであるかは、origin_country_division フィールドに値があるかどうかで判断できます。また、**destination_country_division** パラメータを使用して州レベルのデータのみを取得するようにフィルタリングすることもできます。このパラメータはISO_3166-2値を期待します。例えば、アメリカ合衆国テキサス州の場合はUS-TXです。
GET https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination_country_division=IN-AP国でクエリを実行し、州データでフィルタリングしてそのようなデータが存在するか確認し、存在する場合はそれを使用する方が簡単かもしれません。
2空港間の要件を取得するには？
国と同様に、Sitata APIは2空港間の結果を返すことができます。departure_airport と destination_airport パラメータは、ICAOまたはIATAコードを使用して結果をフィルタリングします。レスポンスには、対応する出発国から出発し目的地国へ旅行する旅行者が理解するために必要なすべての制限（国レベルおよび州レベル）が含まれます。
GET https://www.sitata.com/api/v2/entry_requirements?departure_airport=MUC&destination_airport=BOMレスポンスには、出発国から出発し目的地国へ旅行する旅行者が理解するために必要なすべての制限（国レベルおよび州レベル）が含まれます。
都市情報しかない場合は？
Sitataは特定の都市名によるクエリに対応しないことを選択しました。なぜなら、それは競合や混乱を引き起こす可能性があるからです。代わりに、結果セットに曖昧さを生じさせない緯度経度座標によるAPIクエリに対応することを選択しました。パラメータは departure_lat、departure_lng、destination_lat、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都市を位置情報に解決し座標に基づいてクエリを実行すると、私たちのAPIは出発国から出発し目的地国へ旅行する旅行者が理解するために必要なすべての制限（国レベルおよび州レベル）で応答します。
追加データ
一部のタイプの入国要件には、extras と呼ばれるメタデータタイプのフィールドに追加の関連データが含まれる場合があります。このフィールドは、特定の要件に関する様々な追加情報のキー/値マッピングです。
隔離日数は？
このデータエントリは入国要件 タイプ5 に該当します。このエントリでは、**extras** マッピングに quarantine_days というフィールドが含まれ、課された隔離日数を示す整数が格納されます。
陰性のCOVID検査が有効な入国前時間（時間）は？
このデータエントリは入国要件 タイプ8 に該当します。このエントリでは、**extras** マッピングに entry_hours というフィールドが含まれ、陰性のCOVID検査が入国前に許可される時間数を示す整数が格納されます。
お知らせください
私たちは、旅行者が途中で遭遇する可能性のある状況を理解するためのニーズのすべてに対応できる、非常に堅牢なシステムを有していると考えています。もし私たちが対応していない特定のユースケースがあれば、ぜひお知らせください！
待ってください…まだあります！
この記事は、入国要件と渡航制限情報のためにSitata APIと対話する方法を説明する2部構成シリーズの第1部です。これまでに、国や地域に入国するために必要な明確なはい/いいえタイプの要件を概説する入国要件について説明してきましたが、国内で何が起こっているかについてはまだ話していません。国に入ることについて知ることは一つのことですが、国内を移動できるか、ビーチを訪れられるか、強制夜間外出禁止令があるかどうかを理解することはまた別のことです。
私たちの渡航制限データセットについて深く掘り下げる第2回の投稿にご期待ください。ヒント：ほぼ同じ構造なので、いつでもAPIドキュメントをご覧いただけます。
