翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # トラッカーを作成する トラッカーリソースを作成して、デバイスからの位置の更新を保存して処理します。Amazon Location Service コンソール、 AWS CLI、または Amazon Location APIsを使用できます。 トラッカーリソースに保存される位置の更新はそれぞれ、位置精度の測定値と、位置またはデバイスに関するメタデータで保存したいものを最大 3 つ含めることができます。メタデータはキーと値がペアとして保存されており、速度、方向、タイヤ空気圧、エンジン温度などの情報を保存できます。 トラッカーは、位置の更新を受信するとフィルタリングします。これにより、*ジッター*と呼ばれるデバイス経路の視覚的なノイズが減り、誤ったジオフェンスへの出入りイベントの数が減ります。そして、ジオフェンス評価が開始される数も減り、コストを管理できます。 トラッカーには 3 つの位置フィルターオプションがあります。コスト管理と位置情報の更新におけるジッターの軽減に役立ちます。 + **精度ベース** — 精度測定が可能なあらゆるデバイスで使用できます。精度測定は、ほとんどのモバイル機器で提供されます。各位置測定の精度は、GPS 衛星の受信状況、地形、Wi-Fi デバイスや Bluetooth デバイスまでの距離など、さまざまな環境要因の影響を受けます。モバイル機器を含むほとんどのデバイスでは、測定と同時にその精度も推定できます。`AccuracyBased` フィルタリングでは、デバイスの移動距離が測定精度より少ない場合、Amazon Location は位置の更新を無視します。例えば、デバイスから 2 つの連続した更新を受信し、その精度が 5 m と 10 m だった場合、デバイスの移動距離が 15 m 未満であれば 2 回目の更新は無視されます。Amazon Location は、無視した更新をジオフェンスと比較して評価したり、保存したりしません。 精度が提供されない場合はゼロとして扱われ、測定値は完全に正確であると見なされます。 **注記** 精度ベースのフィルタリングを使用してすべてのフィルタリングを削除することもできます。精度ベースのフィルタリングを選択したものの、すべての精度データをゼロに上書きしたり、精度を完全に無視した場合、Amazon Location は更新をフィルタリングしません。 + **距離ベース** — *使用しているデバイスでは正確な測定値が得られないが、フィルタリングを活用してジッターを減らし、コストを管理する場合に使用します。*`DistanceBased` フィルタリングでは、デバイスの移動が 30 m (98.4 フィート) 未満の場合、ロケーションの更新は無視されます。`DistanceBased` 位置フィルターを使用すると、Amazon Location は無視した更新をジオフェンスと比較して評価したり、保存したりしません。 iOS および Android デバイスの平均精度を含め、ほとんどのモバイル機器の精度は 15m 以内です。ほとんどのアプリケーションでは、`DistanceBased` フィルタリングを使用することで、デバイスの軌跡を地図上に表示するときに位置が不正確になることによる影響や、デバイスがジオフェンスの境界近くにあるときに複数の連続した出入りイベントによるバウンス効果を減らすことができます。また、リンクされたジオフェンスと比較して評価するリクエストや、デバイスの位置を取得するリクエストが減るので、アプリケーションのコスト削減にも役立ちます。 + **時間ベース** — (デフォルト) *デバイスが位置の更新を非常に頻繁に (30 秒に 1 回以上) 送信し、すべての更新を保存せずにほぼリアルタイムでジオフェンスの評価を行いたい場合に使用します。*`TimeBased` フィルタリングでは、位置の更新ごとに、リンクされたジオフェンスコレクションと比較して評価しますが、すべてが保存されるわけではありません。更新頻度が 30 秒を超える場合、一意のデバイス ID ごとに 30 秒あたり 1 つの更新のみが保存されます。 **注記** フィルタリング方法や位置更新の頻度を決める際には、トラッキングアプリケーションのコストに留意してください。位置の更新ごとに請求され、リンクされた各ジオフェンスコレクションと比較して評価する際にも 1 回請求されます。例えば、時間ベースのフィルタリングを使用する場合で、トラッカーが 2 つのジオフェンスコレクションにリンクされている場合は、位置の更新ごとに 1 回の位置更新リクエストと 2 回のジオフェンスコレクション評価としてカウントされます。デバイスの位置更新を 5 秒ごとに報告し、時間ベースのフィルタリングを使用している場合は、デバイスごとに 1 時間あたり 720 回の位置更新リクエストと 1,440 回のジオフェンス評価について課金されます。 請求額は、各コレクション内のジオフェンスの数に影響されません。各ジオフェンスコレクションには最大 50,000 のジオフェンスを含めることができるため、ジオフェンスの評価コストを削減するために、ジオフェンスをできるだけ少ないコレクションにまとめることをお勧めします。 デフォルトでは、追跡対象デバイスがリンクされたジオフェンスに出入りするたびに、EventBridge イベントが発生します。詳細については、「[トラッカーをジオフェンスコレクションにリンクする](associate-consumer.md)」を参照してください。 トラッカーリソースのすべてのフィルターされた位置更新のイベントを有効にできます。詳細については、「[トラッカーの更新イベントを有効にする](location-events.md#enable-update-events)」を参照してください。 **注記** 独自の AWS KMS カスタマーマネージドキーを使用してデータを暗号化する場合、バウンディングポリゴンクエリ機能はデフォルトで無効になります。これは、このバウンディングポリゴンクエリ機能を使用すると、デバイスの位置の表現が AWS KMS マネージドキーを使用して暗号化されないためです。ただし、デバイスの正確な位置は引き続きカスタマーマネージドキーを使用して暗号化されます。 Bounding Polygon Queries 機能を使用するには、トラッカーを作成または更新するときに `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) を含めることができます。 + ****説明**** – 任意の説明を入力します。 1. [**位置フィルター**] で、トラッカーリソースの使用目的に最も適したオプションを選択します。**[位置のフィルタリング]** を設定しない場合、デフォルト設定は `TimeBased` となります。詳細については、このガイドの「[Amazon Location Service トラッカー](trackers.md)」と「Amazon Location Service トラッカー API リファレンス」の「`[PositionFiltering](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_CreateTracker.html#location-WaypointTracking_CreateTracker-request-PositionFiltering)`」を参照してください。 1. (オプショナル) **タグ**に、タグの**キー**と**値**を入力します。これにより、新しいジオフェンスコレクションにタグが追加されます。詳細については、「[タグの使用方法](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 API を使用してトラッカーを作成するには** Amazon Location Trackers API の `[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 マネージドキーを使用してデータを暗号化しながら、境界ポリゴンクエリ機能を使用できます。 Bounding Polygon Queries 機能の使用方法については、「[デバイスの位置のリストを表示する](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 マネージドキーを使用してデータを暗号化しながら、境界ポリゴンクエリ機能を使用できます。 Bounding Polygon Queries 機能の使用方法については、「[デバイスの位置のリストを表示する](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 の設定**] を編集できます。