本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 建立追蹤器 建立追蹤器資源，以從您的裝置存放和處理位置更新。您可以使用 Amazon Location Service 主控台 AWS CLI、 或 Amazon Location 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 秒，則每個唯一裝置 ID 每 30 秒只會存放一次更新。 **注意** 在決定您的篩選方法和位置更新的頻率時，請注意追蹤應用程式的成本。系統會針對每個位置更新向您收費，並針對每個連結的地理圍欄集合評估位置更新向您收費一次。例如，使用以時間為基礎的篩選時，如果您的追蹤器連結至兩個地理圍欄集合，則每個位置更新都會計為一個位置更新請求和兩個地理圍欄集合評估。如果您要每 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. 開啟位於 https：//[https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home) 的 Amazon Location Service 主控台。 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 Location APIs 建立追蹤器** 從 Amazon Location Trackers 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 組態**。