在 Amazon Location Service 中了解地理围栏 - Amazon Location Service

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

在 Amazon Location Service 中了解地理围栏

地理围栏集合资源允许您存储和管理地理围栏(地图上的虚拟边界)。您可以根据地理围栏集合资源评估位置,并在位置更新越过地理围栏集合中任何地理围栏的边界时收到通知。

下面显示如何创建和使用地理围栏集合资源:

Diagram showing steps: click to select, add to collection, and send to mobile device.
  1. 在您的 AWS 账户中创建地理围栏收集资源。

  2. 将地理围栏添加到该集合中。您可以通过使用亚马逊定位控制台上的地理围栏上传工具或使用亚马逊定位地理围栏来实现。API有关可用选项的更多信息,请参阅访问 Amazon Location

    地理围栏可以由多边形或圆形定义。使用多边形查找设备何时进入特定区域。使用圆圈查找设备何时到达距离某一点的特定距离(半径)以内。

  3. 您可以开始根据所有地理围栏评估位置。当位置更新跨越一个或多个地理围栏的边界时,您的地理围栏收集资源会在亚马逊上发出以下地理围栏事件类型之一: EventBridge

    • ENTER— 每个地理围栏都会生成一个事件,其中位置更新通过进入其边界来越过其边界。

    • EXIT— 为每个地理围栏生成一个事件,其中位置更新通过退出其边界而越过其边界。

    有关更多信息,请参阅 通过亚马逊对亚马逊定位服务事件做出反应 EventBridge。您还可以使用诸如Amazon CloudWatch 和之类的服务来集成监控 AWS CloudTrail。有关更多信息,请参阅、使用亚马逊监控 Amazon Location Service CloudWatch使用记录和监控 AWS CloudTrail

例如,如果您正在追踪一支卡车车队,并且希望在卡车进入任何仓库的特定区域时收到通知。您可以为每个仓库周围的区域创建地理围栏。然后,当卡车向您发送更新的位置时,您可以使用 Amazon Location Service 来评估这些位置,并查看卡车是否进入(或退出)了其中一个地理围栏区域。

注意

按您评估的地理围栏集合数量计费。您的计费不受每个集合中地理围栏数量的影响。由于每个地理围栏集合可能包含多达 50,000 个地理围栏,因此您可能需要尽可能将地理围栏合并成更少的集合,以降低地理围栏评估的成本。生成的事件将包括集合中各个地理围栏的 ID 以及该集合的 ID。

地理围栏事件

您正在监控的位置由名为 DeviceId 的 ID 引用(这些位置被称为设备位置)。您可以将要评估的设备位置列表直接发送到地理围栏集合资源,也可以使用跟踪器。有关跟踪器的更多信息,请参见下一部分。

只有当设备进入或退出地理围栏时,您才会收到事件(通过 Amazon EventBridge),而不是每次位置变化都会收到事件。这意味着您通常会收到事件,并且响应事件的频率要比每次设备位置更新的频率低得多。

注意

对于特定 DeviceID 的首次位置评估,假设该设备以前不在任何地理围栏中。因此,如果在集合中的地理围栏内,则第一次更新将生成一个 ENTER 事件,如果不是,则不会生成任何事件。

为了计算设备是进入还是退出地理围栏,Amazon Location Service 必须保持该设备的先前位置状态。此位置状态可存储 30 天。在设备未更新 30 天后,新的位置信息更新将被视为首次位置更新。

地理围栏术语

地理围栏集合

包含零或多个地理围栏。它能够在接到请求时发出“进入”和“退出”事件,从而根据其地理围栏评估设备的位置,从而进行地理围栏监控。

地理围栏

在地图上定义虚拟边界的多边形或圆形几何。

多边形几何

Amazon Location 地理围栏是地理区域的虚拟边界,以多边形几何或圆形表示。

圆是围绕一个点而具有一定距离的一组点的集合。如果您想在设备距离某个位置一定距离内时收到通知,请使用圆。

多边形是由一个或多个线性环组成的数组。如果要为设备通知定义特定边界,请使用多边形。线性环是由四个或更多顶点组成的数组,其中第一个和最后一个顶点相同,形成封闭边界。每个顶点都是形态的二维点 [longitude, latitude],其中经度和纬度的单位是度。必须按多边形周围的逆时针顺序列出顶点。

注意

Amazon Location Service 不支持带有多个环的多边形。这包括孔洞、岛屿或多面。Amazon Location 也不支持顺时针缠绕或穿过反子午线的多边形。

以下是单个线性外环的示例:

[ [ [-5.716667, -15.933333], [-14.416667, -7.933333], [-12.316667, -37.066667], [-5.716667, -15.933333] ] ]