本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 创建跟踪器 创建跟踪器资源以存储和处理来自您设备的位置更新。您可以使用 Amazon Location Service 控制台 AWS CLI、或亚马逊位置 APIs。 存储在您的跟踪器资源中的每个位置更新都可能包括一个位置精度指标，以及最多三个与您要存储的位置或设备相关的元数据字段。元数据以键值对的形式存储，可以存储速度、方向、轮胎压力或发动机温度等信息。 跟踪器在收到的位置更新时对其进行过滤。这可以减少设备路径中的视觉噪音（称为*抖动*），并减少错误的地理围栏进入和退出事件的数量。这还可以减少启动的地理围栏评估的数量，从而帮助管理成本。 跟踪器提供三种位置筛选选项，以帮助管理成本并减少位置更新中的抖动。 + **基于精度**——*与任何提供精度测量的设备一起使用。大多数移动设备都提供此信息。*每次位置测量的准确性受许多环境因素的影响，包括 GPS 卫星接收、场景以及 Wi-Fi 和蓝牙设备的距离。大多数设备，包括大多数移动设备，都可以提供测量精度的估计值以及测量结果。通过 `AccuracyBased` 筛选，如果设备移动小于测量的精度，Amazon Location 将忽略位置更新。例如，如果一个设备两次连续更新的精度范围分别为 5 米和 10 米，则该设备的移动距离小于 15 米时 Amazon Location 忽略第二次更新。Amazon Location 既不会根据地理围栏评估被忽略的更新，也不会存储这些更新。 如果未提供精度，则将其视为零，并且测量结果被视为完全准确。 **注意** 您也可以使用基于精度的筛选来移除所有筛选。如果您选择基于精度的筛选，但将所有精度数据覆盖为零，或者完全省略准确性，那么 Amazon Location 将不会筛选出任何更新。 + **基于距离**——*当您的设备不提供精度测量值，但您仍希望利用筛选功能来减少抖动并管理成本时使用*。`DistanceBased` 筛选忽略设备移动小于 30 米（98.4 英尺）的位置更新。当您使用 `DistanceBased` 位置筛选时，Amazon Location 既不会根据地理围栏评估这些被忽略的更新，也不会存储更新。 大多数移动设备的精度，包括 iOS 和 Android 设备的平均精度，都在 15 米以内。在大多数应用程序中，`DistanceBased` 筛选可以减少在地图上显示设备轨迹时位置不准确的影响，以及设备靠近地理围栏边界时连续多次进入和退出事件的反弹效果。它还可以减少对照链接的地理围栏进行评估或检索设备位置的调用，从而帮助降低应用程序的成本。 + **基于时间**——（默认）*当您的设备非常频繁地发送位置更新（每 30 秒钟超过一次），并且您希望在不存储每个更新的情况下实现近乎实时的地理围栏评估时使用*。在 `TimeBased` 筛选中，每个位置更新根据链接的地理围栏集合进行评估，但并非每个位置更新都会存储。如果更新频率超过 30 秒，则每 30 秒仅为每个唯一的设备 ID 存储一次更新。 **注意** 在决定筛选方法和位置更新的频率时，请注意追踪应用程序的成本。您需要为每次位置更新付费，并根据每个链接的地理围栏集合评估位置更新一次付费。例如，使用基于时间的筛选时，如果您的跟踪链接到两个地理围栏集合，则每次位置更新都将计为一个位置更新请求和两次地理围栏收集评估。如果您报告设备每 5 秒更新一次位置并使用基于时间的筛选，则每台设备将按每小时 720 次位置更新和 1,440 次地理围栏评估计费。 您的计费不受每个集合中地理围栏数量的影响。由于每个地理围栏集合可能包含多达 50,000 个地理围栏，因此您可能需要尽可能将地理围栏合并成更少的集合，以降低地理围栏评估的成本。 默认情况下，每次被跟踪的设备进入或退出关联的地理围栏时，您都会收到 EventBridge 事件。有关更多信息，请参阅 [将跟踪器关联到地理围栏集合](associate-consumer.md)。 您可以为跟踪器资源的所有筛选位置更新启用事件。有关更多信息，请参阅 [为跟踪器启用更新事件](location-events.md#enable-update-events)。 **注意** 如果您希望使用自己的 AWS KMS 客户托管密钥加密数据，则默认情况下将禁用 “边界多边形查询” 功能。这是因为使用此边界多边形查询功能，您的设备位置表示不会使用您的 AWS KMS 托管密钥进行加密。但是，设备的确切位置仍使用您的托管密钥进行加密。 在创建或更新跟踪器时，您可以通过将 `KmsKeyEnableGeospatialQueries` 参数设置为 true 来选择使用“边界多边形查询”功能。 ------ #### [ Console ] **使用 Amazon Location 控制台创建跟踪器** 1. 打开 Amazon Location Service 控制台，网址为[https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home)。 1. 在左侧导航窗格中，选择**跟踪器**。 1. 选择**创建跟踪器**。 1. 填写以下字段： + ****名称****——输入唯一名称。例如 *ExampleTracker*。最多 100 个字符。有效条目包括：字母数字字符、连字符、句号和下划线。 + ****描述****——输入可选描述。 1. 在**位置筛选**下，选择最适合您打算如何使用跟踪器资源的选项。如果未设置**位置筛选**，则默认设置为 `TimeBased`。想要了解更多信息，请参阅本指南 [Amazon Location Service 跟踪器](trackers.md) 和 Amazon Location Service Trackers API 参考中的 `[PositionFiltering](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_CreateTracker.html#location-WaypointTracking_CreateTracker-request-PositionFiltering)`。 1. （可选）在 **Tags (标签)** 下，输入标签 **Key (键)** 和 **Value (值)**。这会为您的新地理围栏集合添加一个标签。有关更多信息，请参阅 [如何使用标签](manage-resources.md#manage-resources_how-to)。 1. （可选）在“**客户托管密钥加密**”下，您可以选择**添加客户托管密钥**。这会添加一个对称的客户托管密钥，您可以通过默认 AWS 拥有的加密来创建、拥有和管理该密钥。想要了解更多信息，请参阅[加密静态数据](encryption-at-rest.md)。 1. （可选）在下方 **KmsKeyEnableGeospatialQueries**，您可以选择启用**地理空间查询**。这允许您使用边界多边形查询功能，同时使用客户 AWS KMS 托管密钥对数据进行加密。 **注意** 当您使用边界多边形查询功能时，您的设备位置表示不会使用您的 AWS KMS 托管密钥进行加密。但是，设备的确切位置仍使用您的托管密钥进行加密。 1. （可选）在**EventBridge 配置**下，您可以选择为筛选的职位更新启用 EventBridge 事件。每当该跟踪器中设备的位置更新符合位置筛选评估时，都会发送一个事件。 1. 选择**创建跟踪器**。 ------ #### [ API ] **使用 Amazon 位置创建追踪器 APIs** 使用 Amazon 位置追踪器 APIs中的`[CreateTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_CreateTracker.html)`操作。 以下示例使用 API 请求创建名为的跟踪器*ExampleTracker*。跟踪器资源与[客户管理的 AWS KMS 密钥相关联，用于加密客户数据](encryption-at-rest.md)，并且不[在中启用位置更新 EventBridge](location-events.md#enable-update-events)。 ``` POST /tracking/v0/trackers Content-type: application/json { "TrackerName": "ExampleTracker", "Description": "string", "KmsKeyEnableGeospatialQueries": false, "EventBridgeEnabled": false, "KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "PositionFiltering": "AccuracyBased", "Tags": { "string" : "string" } } ``` **在 `KmsKeyEnableGeospatialQueries` 启用状态下创建跟踪器** 以下示例将参数 `KmsKeyEnableGeospatialQueries` 设置为 true。这允许您使用边界多边形查询功能，同时使用客户 AWS KMS 管理的密钥对数据进行加密。 有关使用“边界面查询”功能的信息，请参阅 [列出您的设备位置](list-device-positions.md) **注意** 当您使用边界多边形查询功能时，您的设备位置表示不会使用您的 AWS KMS 托管密钥进行加密。但是，设备的确切位置仍使用您的托管密钥进行加密。 ``` POST /tracking/v0/trackers Content-type: application/json { "TrackerName": "ExampleTracker", "Description": "string", "KmsKeyEnableGeospatialQueries": true, "EventBridgeEnabled": false, "KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "PositionFiltering": "AccuracyBased", "Tags": { "string" : "string" } } ``` ------ #### [ AWS CLI ] **使用 AWS CLI 命令创建跟踪器** 使用 `[create-tracker](https://docs.aws.amazon.com/cli/latest/reference/location/create-tracker.html)` 命令。 以下示例使用创建名 AWS CLI 为的跟踪器*ExampleTracker*。跟踪器资源与[客户管理的 AWS KMS 密钥相关联，用于加密客户数据](encryption-at-rest.md)，并且不[在中启用位置更新 EventBridge](location-events.md#enable-update-events)。 ``` aws location \ create-tracker \ --tracker-name "ExampleTracker" \ --position-filtering "AccuracyBased" \ --event-bridge-enabled false \ --kms-key-enable-geospatial-queries false \ --kms-key-id "1234abcd-12ab-34cd-56ef-1234567890ab" ``` **在 `KmsKeyEnableGeospatialQueries` 启用状态下创建跟踪器** 以下示例将参数 `KmsKeyEnableGeospatialQueries` 设置为 true。这允许您使用边界多边形查询功能，同时使用客户 AWS KMS 管理的密钥对数据进行加密。 有关使用“边界面查询”功能的信息，请参阅 [列出您的设备位置](list-device-positions.md) **注意** 当您使用边界多边形查询功能时，您的设备位置表示不会使用您的 AWS KMS 托管密钥进行加密。但是，设备的确切位置仍使用您的托管密钥进行加密。 ``` aws location \ create-tracker \ --tracker-name "ExampleTracker" \ --position-filtering "AccuracyBased" \ --event-bridge-enabled false \ --kms-key-enable-geospatial-queries true \ --kms-key-id "1234abcd-12ab-34cd-56ef-1234567890ab" ``` ------ **注意** 计费取决于您的使用情况。您可能会因为使用其他 AWS 服务而产生费用。想要了解更多信息，请参阅 [Amazon Location Service 定价](https://aws.amazon.com/location/pricing/)。 创建跟踪链接后，您可以通过选择编辑跟踪链接来**编辑****描述**、**位置筛选**和**EventBridge 配置**。