很多人可能不知道，Sitata 的早期基础是为早期疾病检测而建立的。事实上，我们的创始人曾在2016年的TedX演讲中讲述过 为什么我们需要警告旅行者以帮助防止疾病传播？.因此，2019 年 12 月初，当 COVID-19 被报告为不寻常的肺炎病例群时，我们发现了它也就不足为奇了。到 2020 年 1 月 2 日，我们的健康团队决定应发布 我们首先向旅客和商业伙伴发出警告。 这甚至比世界卫生组织还要早几天！

在不可避免的余波中，我们顿悟了。这种疾病的传播速度如此之快，以至于我们清楚地意识到，全球的应对措施充其量只能是混乱的。每个国家都将制定自己的一套法规和规则来控制传播。这将不可避免地对全球旅行造成严重破坏，并给那些仍然希望旅行的人们带来巨大困惑。我们的判断是正确的，因此我们开始着手解决这一问题。Sitata 是世界上首批针对 COVID-19 引起的旅行限制和入境要求变化创建专用 API 和监控服务的公司之一。凭借先进的事件检测软件系统和专业的分析师团队，我们已经拥有了所有合适的工具和流程。

自推出这一新服务以来，我们已经有多家机构利用这些数据为自己的客户谋福利，其中包括 Eddy Travels、Flight Centre 和阿提哈德航空公司；不久还将有更多机构宣布使用这些数据！为了帮助更多专注于旅游的机构从这一产品中获益，我们在下文中详细介绍了一些示例，以帮助解释如何在各种用例中使用 API。希望这些说明能帮助您启动自己的计划。

入学要求

毫无疑问，旅行者首先会问 "我能去那里吗？"和 "我会被隔离吗？"，因此这是一个很好的开始。我们创建了 "入境要求 "数据集，以回答有关进入某个国家或地区的 "是/否 "类型的难题。

在撰写本报告时，该数据集包括以下 10 个不同类别：

• 居民可以入境吗？
• 外国人可以入境吗？
• 是否允许过境？
• 抵达时是否需要进行检测（疾病爆发）？
• 是否允许提供检验证书（疾病爆发）？
• 抵达时是否需要隔离（疾病爆发）？是否需要接种疫苗？
• 需要保险吗？
• 需要测试证书吗？
• 是否需要参赛表格？

每个类别可有以下一个值：

• 是
• 是，但有例外
• 没有
• 否，但有例外

虽然绝大多数值都是 "是 "和 "否"，但实际情况并不总是那么简单。有时，各国政府会制定一些非常奇怪和疯狂的规则，这就需要 "有例外 "的价值类型。

入境要求本质上是一条记录，记录了行为体针对一个或多个其他国家或地区实施的一系列规则。在我们的数据架构中，行为体可以是国家、州，甚至是市。总体而言，Sitata 目前涵盖国家级数据。不过，我们也有一些州/省的记录，用于美国等特定地区。

字段下有条目的任何记录 原籍国分区代码 或 原籍国地区代码 分别是州或市一级的数据。如果您希望获得更详细的数据，请 联系我们 我们可以讨论您的使用案例。

请花些时间熟悉参赛要求数据结构，方法如下 点击此处查看我们的 API 文档。

关于数据结构，有一个稍稍令人困惑的地方，就是我们使用的"...... "一词。产地."这是一个令人困惑的问题，因为开发人员通常认为 "原产地 "是指起源地或出发地。然而，我们所说的 "原产地 "实际上是指强加给他人的规则的原产地，即设立限制的国家或地区。

另一个需要注意的要点是受影响国家列表的工作方式。如果 affected_countries 为空，则应将其解释为全局规则，即所有国家都受影响。

几个例子

正如您从文档中看到的，有许多方法可以从 API 中检索数据。下面我们将介绍几种更常见的使用情况。

如何获取两个国家之间的要求？

有几种方法可以完成这类请求。最简单的是使用 目的地 和 离职 参数。这些参数接受 ISO 3166-1 alpha-2 代码作为输入。

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

答复将包括从出发国出发并前往目的地国的旅客所需的所有要求（国家和州一级）。

如果我想要州一级的数据怎么办？

Sitata 确实为某些地区提供了州一级的数据。如果某个条目中的 原籍国分区 字段有一个值。您还可以使用 目的地国家分区 参数。它期望一个 ISO_3166-2 值。例如，US-TX 表示美国得克萨斯州。

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

请注意，更简单的方法可能是先按国家查询，然后按州数据过滤，看看是否存在此类数据，如果存在，就使用它。

如何获取两个机场之间的要求？

与国家一样，Sitata API 也可以返回两个机场之间的结果。参数 出发机场 和 目的地机场 任选其一 国际民航组织 或 国际航空运输协会 代码来筛选结果。回复将包括所有必要的限制（国家和州一级），以便了解从相应出发国出发并前往目的地国的旅客的情况。

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

答复将包括所有必要的限制（国家和州一级），以便了解从出发国出发并前往目的地国的旅客的情况。

如果我只有城市信息怎么办？

Sitata 选择不支持通过特定城市名称进行查询，因为这可能会导致冲突和混淆。相反，我们选择通过经纬度坐标来查询我们的应用程序接口，这不会在我们的结果集中产生任何歧义。参数如下 出发时间, 离境, 目的地地平线和 目的地_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 将响应所有必要的限制（国家和州一级），以了解从出发国出发并前往目的地国的旅客的情况。

额外数据

对于某些类型的 "输入要求"，元数据类型字段中可能会有额外的相关数据，该字段称 为 "输入要求"。 杂费.该字段是一个键/值映射，包含了特定需求的各种额外信息。

隔离的天数是多少？

该数据输入属于输入要求 第五类.在此条目中， 杂费 映射将包含一个名为 隔离天数 将包含一个整数，表示实施隔离的天数。

阴性科维德检测的入境时间是多少小时？

该数据输入属于输入要求 第八类.在此条目中， 杂费 映射将包含一个名为 工作时间 中将包含一个整数，表示在输入前允许进行阴性 covid 检测的小时数。

让我们知道

我们认为我们有一个非常强大的工具，可以满足您的所有需求，帮助您的旅行者了解他们在旅途中可能遇到的情况。如果您有我们没有解决的特殊用例、 请告诉我们！

等等......还有更多！

本条目是两部分系列的一部分，介绍如何与 Sitata API 交互以获取入境要求和旅行限制信息。到目前为止，我们已经讨论了入境要求，它概述了进入一个国家或地区所需的 "是/否 "类型的硬性要求，但我们还没有讨论该国境内发生了什么。了解进入一个国家的情况是一回事，而了解是否可以在这个国家自由行动、游览海滩或是否有强制宵禁则是另一回事。

敬请期待第二篇文章，我们将深入探讨旅行限制数据集。提示--几乎完全相同，因此您可以随时查看我们的 API 文档 与此同时