翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # Amazon Location Service トラッカー ![\[この図は、トラッカーリソースを作成および使用する方法を示します。\]](http://docs.aws.amazon.com/ja_jp/location/latest/developerguide/images/illustration-trackers.PNG) **注記** トラッカーストレージは、AWS が所有するキーを使用して自動的に暗号化されます。管理する KMS キーを使用して別の暗号化レイヤーを追加して、自分だけがデータにアクセスできるようにすることができます。詳細については、「[Amazon Location Service の保管中のデータ暗号化](encryption-at-rest.md)」を参照してください。 トラッカーは、複数のデバイスの位置更新情報を保存します。トラッカーを使用して、デバイスの現在位置や位置履歴を照会できます。更新情報を保存しますが、保存する前に位置をフィルタリングすることで、ストレージスペースを減らし、視覚的なノイズを減らします。 トラッカーリソースに保存される各位置更新には、位置精度の測定値と、保存したい位置またはデバイスに関する最大 3 つのフィールドのメタデータを含めることができます。メタデータはキーと値がペアとして保存されており、速度、方向、タイヤ空気圧、エンジン温度などの情報を保存できます。 トラッカーの位置のフィルタリングとクエリはそれだけでも便利ですが、トラッカーはジオフェンスと組み合わせると特に便利です。トラッカーは 1 つ以上のジオフェンスコレクションリソースにリンクでき、位置の更新はそれらのコレクション内のジオフェンスと照合して自動的に評価されます。フィルタリングを適切に使用すれば、ジオフェンスの評価コストも大幅に削減できます。 1. まず、AWS アカウントにトラッカーリソースを作成します。 1. 次に、位置情報の更新をトラッカーリソースに送信する方法を決定します。[AWSSDK](dev-sdks.md) を使用して追跡機能をモバイルアプリケーションに統合します。また、「[MQTT を使ったトラッキング](tracking-using-mqtt.md) の手順を追って説明されている MQTT」を使用することもできます。 1. トラッカーリソースを使用してロケーション履歴を記録し、地図上に視覚化できるようになりました。 1. トラッカーリソースを 1 つ以上のジオフェンスコレクションにリンクして、トラッカーリソースに送信されるすべての位置更新が、リンクされているすべてのジオフェンスコレクション内のすべてのジオフェンスに対して自動的に評価されるようにすることもできます。Amazon Location コンソールのトラッカーリソース詳細ページでリソースをリンクするか、Amazon Location Trackers API を使用してリソースをリンクできます。 1. その後、Amazon CloudWatch や AWS CloudTrail などのサービスを使用して、モニタリングを統合できます。詳細については、「[Amazon CloudWatch で   を監視する](cloudwatch.md)」および「[によるモニタリングとログ記録 AWS CloudTrail](cloudtrail.md)」を参照してください。 ## 機能 + **位置のフィルタリング** – トラッカーは、送信されたポジションを自動的にフィルタリングできます。デバイスのロケーションの更新の一部を除外するのには、いくつかの理由があります。1 分おきにしかレポートを送信しないシステムの場合は、デバイスを時間でフィルタリングし、30 秒ごとに位置の保存と評価のみを行いたいと思うかもしれません。より頻繁に監視している場合でも、位置の更新をフィルタリングして GPS ハードウェアと位置の報告に関連付けられている固有の雑音を取り除く必要がある場合があります。その精度は 100% 完璧ではないため、静止しているデバイスでも少し動き回っているように見えます。低速では、デバイスがジオフェンスのエッジの近くにあると、この*ジッター*によって視覚的に乱雑になり、誤った入退室イベントが発生する可能性があります。 位置フィルタリングは、位置の更新をトラッカーが受信すると同時に機能するため、デバイスパス内の視覚的なノイズ (ジッター) が減り、ジオフェンスの誤った入退イベントの数が減ります。また、位置更新の保存回数やジオフェンス評価のトリガー回数が減るため、コスト管理に役立ちます。 トラッカーには 3 つの位置フィルターオプションがあります。コスト管理と位置情報の更新におけるジッターの軽減に役立ちます。 + **精度ベース** — *精度測定が可能なあらゆるデバイスで使用できます。ほとんどの GPS やモバイル機器がこの情報を提供します。* 各位置測定の精度は、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 回のジオフェンス評価について課金されます。 ## Amazon Location Service トラッカーのユースケース Amazon Location Service トラッカーの一般的な用途を以下に示します。 **ジオフェンスでのトラッカーの使用** トラッカーをジオフェンスと組み合わせると、さらに機能が追加されます。Amazon Location コンソールまたは API を使用してトラッカーをジオフェンスコレクションに関連付けて、トラッカーロケーションを自動的に評価します。トラッカーが更新された位置を受信するたびに、その位置はコレクション内の各ジオフェンスに対して評価され、適切な `ENTER` イベントおよび `EXIT` イベントが Amazon EventBridge で生成されます。トラッカーにフィルタリングを適用することもでき、フィルタリングによっては、意味のある位置の更新のみを評価することでジオフェンスの評価コストを削減できます。 位置の更新をすでに受信した後でトラッカーをジオフェンスコレクションに関連付けると、関連付け後の最初の位置更新は、ジオフェンス評価の初期更新として扱われます。ジオフェンス内にある場合は、`ENTER` イベントを受信します。どのジオフェンス内にもない場合は、以前の状態に関係なく `EXIT` イベントは受信されません。 **フィールドサービスオペレーションの改善 ** リアルタイム追跡でモバイルワークフォースを正確に把握します。お客様のサイトとサービスエリアの周囲にジオフェンスを設定し、スタッフが到着および出発したときにアラートを受信します。位置情報データを使用してスケジューリングを最適化し、最も近い技術者を派遣して、応答時間を短縮します。カスタマーエクスペリエンスを向上させながら、フィールドチーム (水道や HVAC 修理ビジネスなど) がより効率的に作業できるようにします。 **重要なアセットのモニタリングと制御** Amazon Location Service を使用して、貴重な機器、インベントリ、その他のモバイルアセットのリアルタイムの場所とステータスを追跡します。ジオフェンスを設定して、不正な移動や削除に関するアラートを受信し、セキュリティとコンプライアンスを強化します。この場所の可視性を使用して、アセット使用率を向上させ、メンテナンススケジュールを最適化し、重要なリソースが常に考慮されるようにします。重機、IT ハードウェア、小売りインベントリを常に正確にモニタリングし、損失を減らして、より多くの情報に基づいた運用上の意思決定を行います。 **サプライチェーンの可視性を強化する** Amazon Location Service を活用して、サプライチェーン全体の出荷と配送を追跡します。配送センター、ストア、その他の主要な施設を中心にジオフェンスを定義して、インベントリとアセットの動きをモニタリングします。リアルタイムの位置情報データを使用して、インベントリ管理を改善し、物流計画を最適化し、優れたカスタマーエクスペリエンスを実現します。サプライチェーンの運用をエンドツーエンドで可視化し、ボトルネックを特定して、効率と応答性を促進するデータ駆動型の意思決定を行います。 **ロケーションベースのマーケティング** 位置情報データの能力を活用して、ジオマーケティングの取り組みを強化します。Amazon Location Service を使用して、競合の場所、イベント、トラフィックの多いエリアの周囲に仮想境界を設定します。お客様がこれらのジオフェンスゾーンに入ると、パーソナライズされた広告、オファー、通知がトリガーされます。人の往来パターンを分析して広告配置を最適化し、新しいビジネスロケーションの主要サイトを発見します。独自のジオフェンススペース内のお客様の動きをモニタリングして、ブラウジング動作と購入するためのパスに関するより深いインサイトを得ることができます。リアルタイムの位置追跡と正確なジオフェンシングを組み合わせることにより、ハイパーターゲットのコンテキストに応じたエンゲージメントを実現し、物理世界の売上とロイヤルティを促進します。 # トラッカーの概念 このセクションでは、一般的なトラッカーの概念について詳しく説明します。 ## Amazon Location Service トラッカーの一般的な用語 **トラッカーリソース** デバイスから位置情報の更新を受信する AWS リソース。トラッカーリソースは、現在および過去のデバイスの位置情報などの位置情報クエリをサポートします。トラッカーリソースをジオフェンスコレクションにリンクすると、リンクされたジオフェンスコレクション内のすべてのジオフェンスに対して位置情報の更新が自動的に評価されます。 **位置データのトラッキング** トラッカーリソースは、時間の経過と共にデバイスに関する情報を保存します。この情報には一連の位置更新が含まれ、各更新には位置情報、時刻、およびオプションのメタデータが含まれます。メタデータには、位置の精度に加え、追跡対象車両の速度、方向、タイヤ空気圧、燃料残量、エンジン温度など、各位置に関する重要な情報を追跡するのに役立つ最大 3 つのキーと値のペアを含めることができます。トラッカーは、デバイスの位置履歴を 30 日間保持します。 **位置フィルタリング** 位置フィルタリングは、貴重な情報を提供しない位置の更新を、その更新が保存されるか、ジオフェンスに対して評価される前に除外することで、コストを管理し、追跡アプリケーションの品質を向上させるのに役立ちます。 `AccuracyBased`、`DistanceBased`、または `TimeBased` のフィルタリングを選択できます。デフォルトでは、位置フィルタリングは `TimeBased` に設定されています。 トラッカーリソースを作成または更新するとき、位置フィルタリングを設定できます。 **RFC 3339 タイムスタンプフォーマット ** Amazon Location Service トラッカーは、日付と時刻に関しては[国際標準化機構 (ISO) 8601](https://www.iso.org/iso-8601-date-and-time-format.html) 形式に従う [RFC 3339](https://tools.ietf.org/html/rfc3339) 形式を使用しています。 形式は「YYYY-MM-DDThh:mm:ss.sssZ\$100:00」です。 + `YYYY-MM-DD`— 日付形式を表します。 + `T`— 時刻の値もそれに続くことを示します。 + `hh:mm:ss.sss`— 24 時間形式の時刻を表します。 + `Z`— 使用されているタイムゾーンが UTC であることを示します。UTC タイムゾーンとは異なる場合もあります。 + `+00:00`— オプションで UTC タイムゾーンからの逸脱を示します。例えば、\$1 01:00 は UTC \$1 1 時間であることを示します。 **例** 2020 年 7 月 2 日の午後 12 時 15 分 20 分については、UTC タイムゾーンに合わせて 1 時間が追加されます。 ``` 2020-07-02T12:15:20.000Z+01:00 ``` # Amazon Location Service トラッカーの使用を開始する このセクションでは、Amazon Location でトラッカーを作成および使用するための包括的なガイドを提供します。トラッカーを使用すると、位置の更新をフィルタリングしながらデバイスの位置を保存、処理、評価して、ノイズを減らし、コストを管理できます。高度な位置フィルタリングオプション、リンクされたジオフェンスコレクションのサポート、EventBridge や IoT Core などの AWS サービスとの統合により、トラッカーは特定のニーズに合わせてカスタマイズされた正確なリアルタイム追跡およびジオフェンシングアプリケーションを可能にします。 **Topics** + [トラッカーを作成する](start-create-tracker.md) + [リクエストを認証する](tracking-identity-pool.md) + [トラッカーをデバイスの位置で更新する](send-location-updates.md) + [トラッカーからデバイスの位置履歴を取得する](get-location-history.md) + [デバイスの位置のリストを表示する](list-device-positions.md) # トラッカーを作成する トラッカーリソースを作成して、デバイスからの位置の更新を保存して処理します。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 の設定**] を編集できます。 # リクエストを認証する トラッカーリソースを作成し、ジオフェンスに対してデバイス位置の評価を始める準備ができたら、リクエストの認証方法を選択します。 + サービスにアクセスする方法については、「[Amazon Location Service を使用して認証する](access.md)」を参照してください。 + 認証されていないリクエストでデバイスの位置をパブリッシュしたい場合は、Amazon Cognito を使用するとよいでしょう。 **例** 次の例では、[AWS JavaScript SDK v3](https://aws.amazon.com/sdk-for-javascript/) および Amazon Location [Web](how-to-auth-helper.md#loc-sdk-auth-web) から、Amazon Cognito アイデンティティプールを使用して認可を行う方法を示しています。 ``` import { LocationClient, BatchUpdateDevicePositionCommand } from "@aws-sdk/client-location"; import { withIdentityPoolId } from "@aws/amazon-location-utilities-auth-helper"; // Unauthenticated identity pool you created const identityPoolId = "us-east-1:1234abcd-5678-9012-abcd-sample-id"; // Create an authentication helper instance using credentials from Cognito const authHelper = await withIdentityPoolId(identityPoolId); const client = new LocationClient({ region: "us-east-1", // The region containing both the identity pool and tracker resource ...authHelper.getLocationClientConfig(), // Provides configuration required to make requests to Amazon Location }); const input = { TrackerName: "ExampleTracker", Updates: [ { DeviceId: "ExampleDevice-1", Position: [-123.4567, 45.6789], SampleTime: new Date("2020-10-02T19:09:07.327Z"), }, { DeviceId: "ExampleDevice-2", Position: [-123.123, 45.123], SampleTime: new Date("2020-10-02T19:10:32Z"), }, ], }; const command = new BatchUpdateDevicePositionCommand(input); // Send device position updates const response = await client.send(command); ``` # トラッカーをデバイスの位置で更新する デバイスを追跡するには、デバイスの位置の更新をトラッカーに送信します。これらのデバイス位置やデバイス位置履歴は、後でトラッカーリソースから取得できます。 位置の更新には、デバイス ID、タイムスタンプ、位置が含まれている必要があります。他にも、精度や、キーと値がペアとなったメタデータを最大 3 つまで含めることもできます。 トラッカーが 1 つ以上のジオフェンスコレクションにリンクされている場合、(トラッカーに指定したフィルタリングルールに従って) それらのジオフェンスに対して更新が評価されます。デバイスがジオフェンスエリアに出入りした際は、EventBridge でイベントを受信します。これらの `ENTER` や `EXIT` のイベントには、デバイス ID、タイムスタンプ、関連するメタデータなどの位置の更新詳細が含まれます。 **注記** 位置フィルターの詳細については、「[トラッカーを作成する](start-create-tracker.md)」を参照してください。 ジオフェンスイベントの詳細については、「[Amazon EventBridge を使用して Amazon Location Service イベントに対応する](location-events.md)」を参照してください。 デバイスの更新を送信するには、以下のいずれかの方法を使用してください。 + [MQTT 更新](tracking-using-mqtt.md)を AWS IoT Core リソースに送信し、トラッカーリソースにリンクします。 + Amazon Location Trackers API、 AWS CLI、または Amazon Location API を使用して位置情報の更新を送信する。[AWS SDK](dev-sdks.md) を使用して、iOS または Android アプリケーションから API を呼び出すことができます。 ------ #### [ API ] **Amazon Location API を使用して位置更新を送信するには** Amazon Location Trackers API の `[BatchUpdateDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchUpdateDevicePosition.html)` オペレーションを使用してください。 次の例では、API リクエストを使用して *ExampleDevice *のデバイス位置更新を、*ExampleTracker* というトラッカーに送信します。 ``` POST /tracking/v0/trackers/ExampleTracker/positions Content-type: application/json { "Updates": [ { "DeviceId": "1", "Position": [ -123.12245146162303, 49.27521118043802 ], "SampleTime": "2022-10-24T19:09:07.327Z", "PositionProperties": { "name" : "device1" }, "Accuracy": { "Horizontal": 10 } }, { "DeviceId": "2", "Position": [ -123.1230104928471, 49.27752402723152 ], "SampleTime": "2022-10-02T19:09:07.327Z" }, { "DeviceId": "3", "Position": [ -123.12325592118916, 49.27340530543111 ], "SampleTime": "2022-10-02T19:09:07.327Z" }, { "DeviceId": "4", "Position": [ -123.11958813096311, 49.27774641063121 ], "SampleTime": "2022-10-02T19:09:07.327Z" }, { "DeviceId": "5", "Position": [ -123.1277418058896, 49.2765989015285 ], "SampleTime": "2022-10-02T19:09:07.327Z" }, { "DeviceId": "6", "Position": [ -123.11964267059481, 49.274188155916534 ], "SampleTime": "2022-10-02T19:09:07.327Z" } ] } ``` ------ #### [ AWS CLI ] ** AWS CLI コマンドを使用して位置更新を送信するには** `[batch-update-device-position](https://docs.aws.amazon.com/cli/latest/reference/location/batch-update-device-position.html)` コマンドを使用します。 次の例では AWS CLI 、 を使用して *ExampleDevice-1* と *ExampleDevice-2* のデバイス位置の更新をトラッカー *ExampleTracker* に投稿します。 ``` aws location batch-update-device-position \ --tracker-name ExampleTracker \ --updates '[{"DeviceId":"ExampleDevice-1","Position":[-123.123,47.123],"SampleTime":"2021-11-30T21:47:25.149Z"},{"DeviceId":"ExampleDevice-2","Position":[-123.123,47.123],"SampleTime":"2021-11-30T21:47:25.149Z","Accuracy":{"Horizontal":10.30},"PositionProperties":{"field1":"value1","field2":"value2"}}]' ``` ------ # トラッカーからデバイスの位置履歴を取得する Amazon Location トラッカーリソースは、追跡対象のすべてのデバイスの位置履歴を 30 日間保持します。トラッカーリソースから、関連するすべてのメタデータを含むデバイスの位置履歴を取得できます。次の例では AWS CLI、、または Amazon Location APIsを使用します。 ------ #### [ API ] **Amazon Location API を使用してトラッカーからデバイスの位置履歴を取得するには** Amazon Location Trackers API の `[GetDevicePositionHistory](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_GetDevicePositionHistory.html)` オペレーションを使用してください。 次の例では、API URI リクエストを使用して、*ExampleDevice* のデバイス位置履歴を *ExampleTracker* というトラッカーから取得します。対象期間は、`2020–10–02` の `19:05:07` (この時間を含む) から `19:20:07` (この時間を含まない) です。 ``` POST /tracking/v0/trackers/ExampleTracker/devices/ExampleDevice/list-positions Content-type: application/json { "StartTimeInclusive": "2020-10-02T19:05:07.327Z", "EndTimeExclusive": "2020-10-02T19:20:07.327Z" } ``` ------ #### [ AWS CLI ] ** AWS CLI コマンドを使用してトラッカーからデバイスの位置履歴を取得するには** `[get-device-position-history](https://docs.aws.amazon.com/cli/latest/reference/location/get-device-position-history.html)` コマンドを使用します。 次の例では AWS CLI 、 を使用して、ExampleTracker というトラッカーから *ExampleDevice* のデバイス位置履歴を取得します。最初は `19:05:07` (包括的) で、最後に で `19:20:07` (排他的) です`2020–10–02`。 *ExampleTracker* ``` aws location \ get-device-position-history \ --device-id "ExampleDevice" \ --start-time-inclusive "2020-10-02T19:05:07.327Z" \ --end-time-exclusive "2020-10-02T19:20:07.327Z" \ --tracker-name "ExampleTracker" ``` ------ # デバイスの位置のリストを表示する トラッカーのデバイス位置のリストは AWS CLI、APIs を使用して、または Amazon Location API を使用して表示できます。 ListDevicePositions ListDevicePositions API を呼び出すと、特定のトラッカーにリンクされているすべてのデバイスの最新の位置のリストが返されます。デフォルトでは、この API は特定のトラッカーの最新のデバイス位置を結果ページごとに 100 件返します。特定の地域内のデバイスのみを返したい場合は、`FilterGeometry` パラメータを使用して Bounding Polygon Query を作成します。これで、ListDevicePositions を呼び出すと、ポリゴン内のデバイスのみが返されます。 **注記** 独自の AWS KMS カスタマーマネージドキーを使用してデータを暗号化する場合、バウンディングポリゴンクエリ機能はデフォルトで無効になります。これは、この機能を使用すると、デバイスの位置の表現が AWS KMS マネージドキーを使用して暗号化されないためです。ただし、デバイスの正確な位置は引き続き顧客管理キーを使用して暗号化されます。 Bounding Polygon Queries 機能の使用を選択することもできます。その場合は、トラッカーを作成または更新するときに `KmsKeyEnableGeospatialQueries` パラメータを true に設定します。 ------ #### [ API ] Amazon Location Trackers API の `[ListDevicePositions](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListDevicePositions.html)` オペレーションを使用してください。 以下の例は、オプションのパラメータ `[FilterGeometry](https://docs.aws.amazon.com/)` を使用して多角形エリア内のデバイス位置のリストを取得するための API リクエストです。この例では、`Polygon` 配列で定義されたエリア内に存在する 3 つのデバイス位置が返されます。 ``` POST /tracking/v0/trackers/TrackerName/list-positions HTTP/1.1 Content-type: application/json { "FilterGeometry": { "Polygon": [ [ [ -123.12003339442259, 49.27425121147397 ], [ -123.1176984148229, 49.277063620879744 ], [ -123.12389509145294, 49.277954183760926 ], [ -123.12755921328647, 49.27554025235713 ], [ -123.12330236586217, 49.27211836076236 ], [ -123.12003339442259, 49.27425121147397 ] ] ] }, "MaxResults": 3, "NextToken": "1234-5678-9012" } ``` 以下に、`[ListDevicePositions](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListDevicePositions.html)` のレスポンスの例を示します。 ``` { "Entries": [ { "DeviceId": "1", "SampleTime": "2022-10-24T19:09:07.327Z", "Position": [ -123.12245146162303, 49.27521118043802 ], "Accuracy": { "Horizontal": 10 }, "PositionProperties": { "name": "device1" } }, { "DeviceId": "3", "SampleTime": "2022-10-02T19:09:07.327Z", "Position": [ -123.12325592118916, 49.27340530543111 ] }, { "DeviceId": "2", "SampleTime": "2022-10-02T19:09:07.327Z", "Position": [ -123.1230104928471, 49.27752402723152 ] } ], "NextToken": "1234-5678-9012" } ``` ------ #### [ CLI ] `[list-trackers](https://docs.aws.amazon.com/cli/latest/reference/location/list-trackers.html)` コマンドを使用します。 次の例は、多角形領域内のデバイスのリストを取得 AWS CLI するための です。 ``` aws location list-device-positions TODO: add arguments add props for filter geo ``` ------ # Amazon Location Service トラッカーを使用する方法 このセクションでは、Amazon Location トラッカーを使用する手順について説明します。AWS IoT と MQTT を使用して、デバイスの位置を確認し、トラッカーをジオフェンスコレクションにリンクして、位置を追跡する方法について説明します。さらに、トラッカーを効果的に管理してロケーションベースのアプリケーションをサポートし、正確でリアルタイムの追跡を確保する方法について説明します。 **Topics** + [デバイスの位置を確認する](verify-device-positions.md) + [トラッカーをジオフェンスコレクションにリンクする](associate-consumer.md) + [Amazon Location Service により AWS IoT と MQTT を使ってトラッキングする](tracking-using-mqtt.md) + [Amazon Location Service トラッカーを管理する](managing-trackers.md) # デバイスの位置を確認する デバイスの位置の整合性を確認するには、[VerifyDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_VerifyDevicePosition.html) API を使用します。この API は、デバイスの携帯電話信号、Wi-Fi アクセスポイント、Ipv4 アドレス、プロキシの使用の有無などのプロパティを評価することで、デバイスの位置の整合性に関する情報を返します。 ## 前提条件 デバイス検証用の上記 API を使用する前に、以下の前提条件を満たしていることを確認してください。 + 確認するデバイスのトラッカーを作成済みであること。詳細については、「[Amazon Location Service トラッカーの使用を開始する](start-tracking.md)」を参照してください。 以下の例では、Amazon Location [VerifyDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_VerifyDevicePosition.html) API へのリクエストを示しています。 ------ #### [ API ] **Amazon Location API を使用してデバイスの位置を確認するには** Amazon Location Tracking API の `[VerifyDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_VerifyDevicePosition.html)` オペレーションを使用してください。 以下の例では、デバイスの位置の整合性を評価する API リクエストを示しています。これらの値を実際のデバイス ID に置き換えます。 ``` POST /tracking/v0/trackers/TrackerName/positions/verify HTTP/1.1 Content-type: application/json { "DeviceState": { "Accuracy": { "Horizontal": number }, "CellSignals": { "LteCellDetails": [ { "CellId": number, "LocalId": { "Earfcn": number, "Pci": number }, "Mcc": number, "Mnc": number, "NetworkMeasurements": [ { "CellId": number, "Earfcn": number, "Pci": number, "Rsrp": number, "Rsrq": number } ], "NrCapable": boolean, "Rsrp": number, "Rsrq": number, "Tac": number, "TimingAdvance": number } ] }, "DeviceId": "ExampleDevice", "Ipv4Address": "string", "Position": [ number ], "SampleTime": "string", "WiFiAccessPoints": [ { "MacAddress": "string", "Rss": number } ] }, "DistanceUnit": "string" } ``` ------ **注記** **Integrity SDK** は、デバイス検証に関する拡張機能を提供しており、リクエストに応じて使用できます。SDK にアクセスするには、[セールスサポート](https://aws.amazon.com/contact-us/sales-support/?pg=locationprice&cta=herobtn)にお問い合わせください。 # トラッカーをジオフェンスコレクションにリンクする ジオフェンスコレクションとトラッカーを作成したので、これらをリンクして、位置情報の更新がすべてのジオフェンスに対して自動的に評価されるようにします。位置情報の更新をすべて評価したくない場合や、一部の位置情報をトラッカーリソースに保存していない場合は、オンデマンドで[ジオフェンスに対してデバイス位置を評価](https://docs.aws.amazon.com/location/latest/developerguide/evaluate-geofences.html)することができます。 ジオフェンスに対してデバイス位置を評価すると、イベントが生成されます。これらのイベントにはアクションを設定できます。ジオフェンスイベントに設定できるアクションの詳細については、「[Amazon EventBridge による Amazon Location Service イベントへの対応](https://docs.aws.amazon.com/location/latest/developerguide/location-events.html)」を参照してください。 Amazon Location イベントには、そのイベントを生成するデバイス位置更新の属性と、出入りしたジオフェンスの属性の一部が含まれます。ジオフェンスイベントに含まれるデータについては、「[Amazon Location Service 用の Amazon EventBridge イベントの例](location-events.md#example-event)」を参照してください。 次の例では、 コンソール、、 AWS CLIまたは Amazon Location APIs。 ------ #### [ Console ] **Amazon Location Service コンソールを使用してトラッカーリソースをジオフェンスコレクションにリンクするには** 1. Amazon Location Service コンソール ([https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home)) を開きます。 1. 左のナビゲーションペインから、**[トラッカー]** を選択します。 1. [**デバイストラッカー**] で、対象トラッカーの名前リンクを選択します。 1. [**リンクされたジオフェンスコレクション**] で [**ジオフェンスコレクションをリンク**] を選択します。 1. [**リンクされたジオフェンスコレクション**] ウィンドウのドロップダウンメニューからジオフェンスコレクションを選択します。 1. [**Link (リンク)**] を選択します。 トラッカーリソースをリンクすると、そのリソースには[**アクティブ**] ステータスが割り当てられます。 ------ #### [ API ] **Amazon Location API を使用してトラッカーリソースをジオフェンスコレクションにリンクするには** Amazon Location Trackers API の `[AsssociateTrackerConsumer](https://docs.aws.amazon.com/location-trackers/latest/APIReference/API_AssociateTrackerConsumer.html)` オペレーションを使用してください。 以下は、[Amazon リソースネーム](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) (ARN) を使用して *ExampleTracker* をジオフェンスコレクションにリンクする API リクエストの例です。 ``` POST /tracking/v0/trackers/ExampleTracker/consumers Content-type: application/json { "ConsumerArn": "arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleGeofenceCollection" } ``` ------ #### [ AWS CLI ] ** AWS CLI コマンドを使用してトラッカーリソースをジオフェンスコレクションにリンクするには** `[associate-tracker-consumer](https://docs.aws.amazon.com/cli/latest/reference/location/associate-tracker-consumer.html)` コマンドを使用します。 次の例では AWS CLI 、 を使用して *ExampleGeofenceCollection* というジオフェンスコレクションを作成します。 ``` aws location \ associate-tracker-consumer \ --consumer-arn "arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleGeofenceCollection" \ --tracker-name "ExampleTracker" ``` ------ # Amazon Location Service により AWS IoT と MQTT を使ってトラッキングする [MQTT](http://mqtt.org/) は、制約のあるデバイス用に設計され、軽量で広く採用されているメッセージングプロトコルです。AWS IoT Core は、MQTT プロトコルと MQTT over WebSocket Secure (WSS) プロトコルを使用するデバイス接続をサポートしています。 [AWS IoT Core](https://aws.amazon.com/iot-core/) はデバイスをAWSに接続し、デバイス間でメッセージの送受信を可能にする。AWS IoT Core ルールエンジンは、デバイスのメッセージトピックに関するクエリを保存し、Amazon Location Service などの他の AWS サービスにメッセージを送信するためのアクションを定義できるようにします。位置を座標として認識するデバイスは、ルールエンジンを通じて Amazon Location に位置情報を転送できます。 **注記** デバイスは内蔵の GPS などを通じて自分の位置を知ることができます。AWS IoT はサードパーティのデバイスの位置追跡もサポートしています。詳細については、AWS IoT 開発者ガイド (デベロッパーガイド) の「[AWS IoT コアデバイスのデータ](https://docs.aws.amazon.com/iot/latest/developerguide/device-location.html)」を参照してください。 以下のウォークスルーでは、AWS IoT Core ルールを使ったトラッキングについて説明します。Amazon Location に送信する前に処理する必要がある場合は、デバイス情報を独自の AWS Lambda 機能に送信することもできます。Lambda を使用してデバイスの位置を処理する方法の詳細については、「[MQTT AWS Lambda で を使用する](tracking-using-mqtt-with-lambda.md)」を参照してください。 **Topics** + [前提条件](#mqtt-prerequisite) + [AWS IoT Core ルールを作成します](#mqtt-create-iot-rule) + [コンソールで AWS IoT Core ルールをテストする](#mqtt-test-iot-rule) + [MQTT AWS Lambda で を使用する](tracking-using-mqtt-with-lambda.md) ## 前提条件 追跡を開始する前に、以下の前提条件を完了する必要があります。 + デバイスの位置データを送信する[トラッカーリソースを作成します](start-create-tracker.md)。 + トラッカーへの AWS IoT Core アクセスを許可する [IAM ロールを作成します](https://docs.aws.amazon.com/iot/latest/developerguide/iot-create-role.html)。 これらの手順を実行するときは、以下のポリシーを使用してトラッカーへのアクセスを許可してください。 ``` { "Version": "2012-10-17", "Statement": [ { "Sid": "WriteDevicePosition", "Effect": "Allow", "Action": "geo:BatchUpdateDevicePosition", "Resource": "arn:aws:geo:*:*:tracker/*" } ] } ``` ## AWS IoT Core ルールを作成します 次に、デバイスの位置テレメトリを Amazon Location Service に転送する AWS IoT Core ルールを作成します。Lambda 関数 URL の詳細については、AWS IoT Core デベロッパーガイドの以下のトピックを参照してください。 + 「[AWS IoT ルールの作成](https://docs.aws.amazon.com/iot/latest/developerguide/iot-create-rule.html)」には、新しいルールの作成に関する情報が記載されています。 + Amazon Location に公開するためのルール作成に固有の[ロケーションアクション](https://docs.aws.amazon.com/iot/latest/developerguide/location-rule-action.html) ## コンソールで AWS IoT Core ルールをテストする 現在位置情報を含むテレメトリを公開しているデバイスがない場合は、AWS IoT Core コンソールを使用してルールをテストすることができます。コンソールにはテストクライアントがあり、サンプルメッセージを公開してソリューションの結果を検証することができます。 1. AWS IoT Core コンソール ([https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/home)) にサインインします。 1. 左側のナビゲーションメニューの **[テスト]** で、**[MQTT テストクライアント]** を選択します。 1. **トピックに公開**で、**トピック名**を *iot/topic* (異なる場合は AWS IoT Core ルールで設定したトピックの名前) に設定し、**メッセージペイロード**には次のように入力します。タイムスタンプ *1604940328* を過去 30 日以内の有効なタイムスタンプに置き換えます (30 日を超えるタイムスタンプは Amazon Location Service ストラッカーによって無視されます)。 ``` { "payload": { "deviceid": "thing123", "timestamp": 1604940328, "location": { "lat": 49.2819, "long": -123.1187 }, "accuracy": { "Horizontal": 20.5 }, "positionProperties": { "field1": "value1", "field2": "value2" } } } ``` 1. テストメッセージを送信するには、**[発行]** を選択します。 1. メッセージが Amazon Location Service によって受信されたことを確認するには、次の AWS CLI コマンドを使用します。セットアップ中に変更した場合は、トラッカー名を使用していたものに置き換えてください。 ``` aws location batch-get-device-position --tracker-name MyTracker --device-ids thing123 ``` # MQTT AWS Lambda で を使用する 追跡のために Amazon Location にデバイスロケーションデータを送信するときに を使用する必要がなくなりました AWS Lambda が、場合によっては Lambda を使用することをお勧めします。例えば、デバイスの位置情報データを Amazon Location に送信する前に、ご自身で処理したい場合などです。以下のトピックでは、トラッカーに送信する前に、Lambda を使用してメッセージを処理する方法について説明します。このパターンの詳細については、[リファレンスアーキテクチャ](https://d1.awsstatic.com/architecture-diagrams/ArchitectureDiagrams/amazon-location-service-ra.pdf)をご覧ください。 **Topics** + [前提条件](#mqtt-prerequisite-with-lambda) + [Lambda 関数を作成する](#mqtt-with-lambda-create-lambda) + [AWS IoT Core ルールを作成する](#mqtt-create-iot-rule-with-lambda) + [コンソールで AWS IoT Core ルールをテストする](#mqtt-test-iot-rule-with-lambda) ## 前提条件 トラッキングを開始する前に、[トラッカーリソースを作成する](start-tracking.md)必要があります。トラッカーリソースを作成するには、Amazon Location コンソール、、 AWS CLIまたは Amazon Location APIsを使用できます。 次の例では、Amazon Location Service コンソールを使用してトラッカーリソースを作成します。 1. Amazon Location Service コンソール ([https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home)) を開きます。 1. 左のナビゲーションペインから、[**トラッカー**] を選択します。 1. **トラッカーを作成**を選択します。 1. 次のボックスに入力します。 + **名前** — 最大 100 文字のユニークな名前に入力します。英数字、ハイフン、ピリオド、アンダースコアを使用できます。例えば、*MyTracker* と入力します。 + **説明** – 任意の説明を入力します。例えば、* AWS IoT Core デバイスの位置を保存するためのトラッカー*などです。 + **位置フィルター** — 位置の更新に使用するフィルターを選択します。例えば、**精度ベースのフィルタリング**などです。 1. **トラッカーを作成**を選択します。 ## Lambda 関数を作成する AWS IoT Core と Amazon Location Service 間の接続を作成するには、 によって転送されたメッセージを処理するための AWS Lambda 関数が必要です AWS IoT Core。この関数は、位置データを抽出し、Amazon Location Service 用にフォーマットし、Amazon Location Tracker API を通じて送信します。この関数は、 AWS Lambda コンソールから作成することも、 AWS Command Line Interface (AWS CLI) または AWS Lambda APIsを使用することもできます。 コンソールを使用して Amazon Location に位置更新を公開する Lambda 関数を作成するには: 1. [https://console.aws.amazon.com/lambda/](https://console.aws.amazon.com/lambda/home) で AWS Lambda コンソールを開きます。 1. ナビゲーションペインで、**[関数]** を選択します。 1. **関数を作成**を選択し、**最初から作成する**が選択されていることを確認します。 1. 次のボックスに入力します。 + **[関数の名前]** - 関数の名前を入力します。有効なエントリには、英数字、ハイフン、およびスペースなしのアンダースコアが含まれます。例えば *MyLambda* などです。 + **ランタイム**: *Python 3.8* を選択します。 1. **機能の作成**を選択します。 1. **[コード]** タブを選択してエディタを開きます。 1. `lambda_function.py` のプレースホルダーコードを以下のように書き換え、`TRACKER_NAME` に割り当てられた値を[前提条件](#mqtt-prerequisite-with-lambda)として作成したトラッカーの名前に置き換える。 ``` from datetime import datetime import json import os import boto3 # Update this to match the name of your Tracker resource TRACKER_NAME = "MyTracker" """ This Lambda function receives a payload from AWS IoT Core and publishes device updates to Amazon Location Service via the BatchUpdateDevicePosition API. Parameter 'event' is the payload delivered from AWS IoT Core. In this sample, we assume that the payload has a single top-level key 'payload' and a nested key 'location' with keys 'lat' and 'long'. We also assume that the name of the device is nested in the payload as 'deviceid'. Finally, the timestamp of the payload is present as 'timestamp'. For example: >>> event { 'payload': { 'deviceid': 'thing123', 'timestamp': 1604940328, 'location': { 'lat': 49.2819, 'long': -123.1187 }, 'accuracy': {'Horizontal': 20.5 }, 'positionProperties': {'field1':'value1','field2':'value2'} } } If your data doesn't match this schema, you can either use the AWS IoT Core rules engine to format the data before delivering it to this Lambda function, or you can modify the code below to match it. """ def lambda_handler(event, context): update = { "DeviceId": event["payload"]["deviceid"], "SampleTime": datetime.fromtimestamp(event["payload"]["timestamp"]).strftime("%Y-%m-%dT%H:%M:%SZ"), "Position": [ event["payload"]["location"]["long"], event["payload"]["location"]["lat"] ] } if "accuracy" in event["payload"]: update["Accuracy"] = event["payload"]['accuracy'] if "positionProperties" in event["payload"]: update["PositionProperties"] = event["payload"]['positionProperties'] client = boto3.client("location") response = client.batch_update_device_position(TrackerName=TRACKER_NAME, Updates=[update]) return { "statusCode": 200, "body": json.dumps(response) } ``` 1. **[デプロイ]** を選択して、関数を更新します。 1. **設定**タブを選択します。 1. **権限**セクションで、ハイパーリンク付きのロール名を選択し、Lambda 関数に Amazon Location Service アクセス権限を付与します。 1. ロールの**概要**ページから**アクセス権限の追加**を選択し、ドロップダウンリストから**インラインポリシーの作成**を選択します。 1. **[JSON]** タブを選択して、次の JSON ポリシードキュメントを入力します。これにより、Lambda 関数は、すべてのリージョンのすべてのトラッカーリソースによって管理されているデバイスの位置の更新ができます。 ``` { "Version": "2012-10-17", "Statement": [ { "Sid": "WriteDevicePosition", "Effect": "Allow", "Action": "geo:BatchUpdateDevicePosition", "Resource": "arn:aws:geo:*:*:tracker/*" } ] } ``` 1. **ポリシーの確認**を選択します。 1. ポリシー名を入力します。例えば、*AmazonLocationTrackerWriteOnly* などです。 1. **ポリシーを作成**を選択します。 この関数コードは必要に応じて変更して、独自のデバイスメッセージスキーマに適合させることができます。 ## AWS IoT Core ルールを作成する 次に、変換のためにデバイスの位置テレメトリを AWS Lambda 関数に転送し、Amazon Location Service に発行する AWS IoT Core ルールを作成します。提供されているサンプルルールは、デバイスペイロードの必要な変換がすべて Lambda 関数によって処理されることを前提としています。このルールは、 AWS IoT Core コンソール、 AWS Command Line Interface (AWS CLI)、または AWS IoT Core APIs を使用して作成できます。 **注記** AWS IoT コンソールは が Lambda 関数 AWS IoT Core を呼び出すために必要なアクセス許可を処理しますが、 AWS CLI または SDK からルールを作成する場合は、アクセス[許可を付与するポリシーを設定 AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/lambda-rule-action.html#lambda-rule-action-requirements)する必要があります。 **コンソール AWS IoT Core を使用して を作成するには** 1. [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/home) で AWS IoT Core コンソールにサインインします。 1. 左のナビゲーションペインで、**[ACT]** を拡張し、**[ルール]** の順に選択します。 1. **ルールを作成**を選択して新しいルールウィザードを起動します。 1. ルールの名前と説明を入力します。 1. **ルールクエリステートメント**では、`FROM` 属性を更新して、少なくとも 1 つのデバイスが位置を含むテレメトリを公開しているトピックを参照する。ソリューションをテストする場合、変更は必要ありません。 ``` SELECT * FROM 'iot/topic' ``` 1. **1 つ以上のアクションを設定する**で、**アクションの追加**を選択します。 1. **[Lambda 関数にメッセージを送信する]** を選択します。 1. **アクションの設定**を選択します。 1. リストから Lambda 関数を探して選択します。 1. **Add action**を選択します。 1. **[‬ルールを作成]‭** を選択します。 ## コンソールで AWS IoT Core ルールをテストする 現在、場所を含むテレメトリを公開しているデバイスがない場合は、 AWS IoT Core コンソールを使用してルールとこのソリューションをテストできます。コンソールにはテストクライアントがあり、サンプルメッセージを公開してソリューションの結果を検証することができます。 1. [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/home) で AWS IoT Core コンソールにサインインします。 1. 左側のナビゲーションメニューの **[テスト]** で、**[MQTT テストクライアント]** を選択します。 1. **トピックに発行** で、**トピック名**を *iot/topic* (または AWS IoT Core ルールで設定したトピックの名前が異なる場合) に設定し、**メッセージペイロード**に以下を指定します。タイムスタンプ *1604940328* を過去 30 日間の有効なタイムスタンプに置き換えます (30 日を超えるタイムスタンプは無視されます)。 ``` { "payload": { "deviceid": "thing123", "timestamp": 1604940328, "location": { "lat": 49.2819, "long": -123.1187 }, "accuracy": { "Horizontal": 20.5 }, "positionProperties": { "field1": "value1", "field2": "value2" } } } ``` 1. テストメッセージを送信するには、**[発行]** を選択します。 1. メッセージが Amazon Location Service によって受信されたことを確認するには、次の AWS CLI コマンドを使用します。セットアップ中に変更した場合は、トラッカー名とデバイス ID を使用していたものに置き換えてください。 ``` aws location batch-get-device-position --tracker-name MyTracker --device-ids thing123 ``` # Amazon Location Service トラッカーを管理する Amazon Location コンソール、、 AWS CLIまたは Amazon Location APIs を使用してトラッカーを管理できます。 ## トラッカーリストを表示 Amazon Location コンソール、、 AWS CLIまたは Amazon Location APIs を使用してトラッカーリストを表示できます。 ------ #### [ Console ] **Amazon Location コンソールを使用して既存のトラッカーリストを表示するには** 1. Amazon Location コンソールを開きます ([https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home))。 1. 左側のナビゲーションから、**[トラッカー]** を選択します。 1. **[マイトラッカー]** でトラッカーリソースのリストを表示します。 ------ #### [ API ] Amazon Location Trackers API の `[ListTrackers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListTrackers.html)` オペレーションを使用してください。 次の例は、 AWS アカウント内のトラッカーのリストを取得するための API リクエストです。 ``` POST /tracking/v0/list-trackers ``` 以下に、`[ListTrackers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListTrackers.html)` のレスポンスの例を示します。 ``` { "Entries": [ { "CreateTime": 2020-10-02T19:09:07.327Z, "Description": "string", "TrackerName": "ExampleTracker", "UpdateTime": 2020-10-02T19:10:07.327Z } ], "NextToken": "1234-5678-9012" } ``` ------ #### [ CLI ] `[list-trackers](https://docs.aws.amazon.com/cli/latest/reference/location/list-trackers.html)` コマンドを使用します。 次の例は、 AWS アカウント内のトラッカーのリストを取得 AWS CLI するための です。 ``` aws location list-trackers ``` ------ ## トラッカーをジオフェンスコレクションから切り離す Amazon Location コンソール、、または Amazon Location APIs を使用して AWS CLI、ジオフェンスコレクションからトラッカーを切断できます。 ------ #### [ Console ] **Amazon Location コンソールを使用して、トラッカーとジオフェンスコレクションの関連付けを解除するには** 1. Amazon Location コンソールを開きます ([https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home))。 1. 左側のナビゲーションペインから、**[トラッカー]** を選択します。 1. [**マイトラッカー**] で、対象トラッカーの名前リンクを選択します。 1. [**リンクされたジオフェンスコレクション**] で、ステータスが [**リンク済み**] のジオフェンスコレクションを選択します。 1. [**リンクの解除**] を選択します。 ------ #### [ API ] Amazon Location Trackers API の `[DisassociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DisassociateTrackerConsumer.html)` オペレーションを使用してください。 以下の例は、トラッカーとジオフェンスコレクションの関連付けを解除ための API リクエストです。 ``` DELETE /tracking/v0/trackers/ExampleTracker/consumers/arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleCollection ``` 以下に、`[DisassociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DisassociateTrackerConsumer.html)` のレスポンスの例を示します。 ``` HTTP/1.1 200 ``` ------ #### [ CLI ] `[disassociate-tracker-consumer](https://docs.aws.amazon.com/cli/latest/reference/location/disassociate-tracker-consumer.html)` コマンドを使用します。 次の例は、関連付けられたジオフェンスコレクションからトラッカーの関連付けを解除する AWS CLI コマンドです。 ``` aws location disassociate-tracker-consumer \ --consumer-arn "arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleCollection" \ --tracker-name "ExampleTracker" ``` ------ ## トラッカーの詳細を取得する Amazon Location コンソール、、または Amazon Location APIs を使用して AWS CLI、 AWS アカウント内のトラッカーに関する詳細を取得できます。 ------ #### [ Console ] **Amazon Location コンソールを使用してトラッカーの詳細を表示するには** 1. Amazon Location コンソールを開きます ([https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home))。 1. 左側のナビゲーションから、**[トラッカー]** を選択します。 1. [**マイトラッカー**] で、対象トラッカーの名前リンクを選択します。 1. **[情報]** にトラッカーの詳細が表示されます。 ------ #### [ API ] Amazon Location Tracker API の `[DescribeTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DescribeTracker.html)` オペレーションを使用してください。 以下の例は、*ExampleTracker* のトラッカーの詳細を取得するための API リクエストです。 ``` GET /tracking/v0/trackers/ExampleTracker ``` 以下に、`[DescribeTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DescribeTracker.html)` のレスポンスの例を示します。 ``` { "CreateTime": 2020-10-02T19:09:07.327Z, "Description": "string", "EventBridgeEnabled": false, "KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "PositionFiltering": "TimeBased", "Tags": { "Tag1" : "Value1" }, "TrackerArn": "arn:aws:geo:us-west-2:123456789012:tracker/ExampleTracker", "TrackerName": "ExampleTracker", "UpdateTime": 2020-10-02T19:10:07.327Z } ``` ------ #### [ CLI ] `[describe-tracker](https://docs.aws.amazon.com/cli/latest/reference/location/describe-tracker.html)` コマンドを使用します。 次の例は、*ExampleTracker* のトラッカーの詳細を取得するための AWS CLI コマンドです。 ``` aws location describe-tracker \ --tracker-name "ExampleTracker" ``` ------ ## トラッカーを削除する Amazon Location コンソール、、または Amazon Location APIs を使用して AWS CLI、 AWS アカウントからトラッカーを削除できます。 ------ #### [ Console ] **Amazon Location コンソールを使用して既存のマップリソースを削除するには** **警告** このオペレーションはリソースを完全に削除します。トラッカーリソースが使用されている場合、エラーが発生する可能性があります。対象リソースがアプリケーションに使用されていないことを確認してください。 1. Amazon Location コンソールを開きます ([https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home))。 1. 左側のナビゲーションペインから、**[トラッカー]** を選択します。 1. [**マイトラッカー**] で、対象トラッカーを選択します。 1. [**トラッカーを削除**] を選択します。 ------ #### [ API ] Amazon Location Tracker API の `[DeleteTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DeleteTracker.html)` オペレーションを使用してください。 以下の例は、*ExampleTracker* のトラッカーを削除する API リクエストです。 ``` DELETE /tracking/v0/trackers/ExampleTracker ``` 以下に、`[DeleteTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DeleteTracker.html)` のレスポンスの例を示します。 ``` HTTP/1.1 200 ``` ------ #### [ CLI ] `[delete-tracker](https://docs.aws.amazon.com/cli/latest/reference/location/delete-tracker.html)` コマンドを使用します。 次の例は、トラッカー *ExampleTracker* を削除する AWS CLI コマンドです。 ``` aws location delete-tracker \ --tracker-name "ExampleTracker" ``` ------ # コストと使用状況を管理する Amazon Location トラッカーについて学習を続ける際には、サービス容量の管理方法を理解し、使用制限に従い、クォータと API 最適化を通じて最良の結果を得ることが重要です。パフォーマンスと精度に関するベストプラクティスを適用することにより、場所関連のクエリを効率的に処理し、API リクエストを最大化するようにアプリケーションをカスタマイズできます。 **Topics** + [トラッカーの料金](trackers-pricing.md) + [トラッカーのクォータと使用状況](trackers-quotas.md) # トラッカーの料金 追跡およびジオフェンシング API の料金情報については、「[Amazon Location Service の料金ページ](https://aws.amazon.com/location/pricing/)」を参照してください。 **位置の書き込み** `BatchUpdateDevicePosition` を使用して、1 つ以上のデバイスの位置更新データをトラッカーリソースにアップロードできます (バッチあたり最大 10 個のデバイス)。料金は、API リクエストのデバイス位置の数に基づきます。デバイスの位置更新あたりの単価は、月間使用量の合計に基づきます。単価とボリューム階層の詳細については、「[Amazon Location Service の料金ページ](https://aws.amazon.com/location/pricing/)」を参照してください。 追跡デバイスからデバイスの位置更新頻度 (ping レートとも呼ばれます) を設定することにより、位置の書き込みコストを最適化でき、オプションでローカルフィルターを使用して、関連するデバイスの位置更新のみを Amazon Location Service にアップロードします。 **位置の読み取り** `BatchGetDevicePosition` を使用して、リクエストされたデバイスの最新のデバイス位置を、リクエストごとに最大 100 デバイス一覧表示できます。`GetDevicePosition` を使用して、サンプル時間に応じてデバイスの最新の位置を取得することもできます。 料金は API リクエストの数に基づきます。 **位置の削除** `BatchDeleteDevicePositionHistory` を使用して、トラッカーリソースから 1 つ以上のデバイスの位置履歴を、リクエストごとに最大 100 デバイスまで削除できます。 料金は、API リクエストのデバイス数に基づきます。 **位置の完全性の評価** `VerifyDevicePosition` を使用して、プロキシの背後で報告されたかどうかを判断し、デバイスの状態に基づいて推定された推定位置と比較して、デバイスの位置の完全性を検証できます。 料金は API リクエストの数に基づきます。 # トラッカーのクォータと使用状況 このトピックでは、Amazon Location Service トラッカーのレート制限とクォータの概要を説明します。 **注記** より高いクォータが必要な場合は、Service Quotas コンソールを使用して、調整可能なクォータの[クォータ増加のリクエスト](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas)を行うことができます。クォータの引き上げをリクエストする場合は、クォータの引き上げが必要なリージョンを選択します。ほとんどのクォータは AWS リージョンに固有であるためです。API ごとにデフォルトの制限の 2 倍までリクエストできます。 デフォルトの制限の 2 倍を超えるリクエストの場合、リクエストはサポートチケットを送信します。プレミアムサポートチームに接続することもできます。クォータ引き上げリクエストには直接料金はかかりませんが、使用レベルが高くなると、消費される追加のリソースに基づいてサービスコストが増加する可能性があります。詳細については「[Service Quotas を使用してクォータを管理する](manage-quotas.md)」を参照してください。 Service Quotas は、 AWS アカウントと AWS リージョンごとに保持できるリソースの最大数です。Amazon Location Service、Service Quotas を超える追加のリクエストを拒否します。 ## リソース | API 名 | デフォルト | 最大調整可能制限 | | --- | --- | --- | | アカウントあたりの Tracker リソース | 500 | 1,000 それ以上必要な場合は、[クォータの引き上げをリクエスト](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas)するか、サポートチームにお問い合わせください。 | | トラッカーあたりの Tracker コンシューマー | 5 | 最大調整可能制限は適用されません。 サポートチームにお問い合わせください。 | ## CRUD API **注記** これらの API のいずれかにより高い制限が必要な場合は、[クォータの引き上げをリクエスト](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas)するか、サポートチームにお問い合わせください。 | API 名 | デフォルト | 最大調整可能制限 | | --- | --- | --- | | [AssociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_AssociateTrackerConsumer.html) | 10 | 20 | | [CreateTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_CreateTracker.html) | 10 | 20 | | [DeleteTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DeleteTracker.html) | 10 | 20 | | [DescribeTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DescribeTracker.html) | 10 | 20 | | [DisassociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DisassociateTrackerConsumer.html) | 10 | 20 | | [ListTrackerConsumers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListTrackerConsumers.html) | 10 | 20 | | [ListTrackers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListTrackers.html) | 10 | 20 | | [UpdateTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_UpdateTracker.html) | 10 | 20 | ## Data API **注記** これらの API のいずれかにより高い制限が必要な場合は、[クォータの引き上げをリクエスト](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas)するか、サポートチームにお問い合わせください。 | API 名 | デフォルト | 最大調整可能制限 | | --- | --- | --- | | [BatchGetDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchGetDevicePosition.html) | 50 | 100 | | [BatchUpdateDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchUpdateDevicePosition.html) | 50 | 100 | | [GetDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_GetDevicePosition.html) | 50 | 100 | | [GetDevicePositionHistory](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_GetDevicePositionHistory.html) | 50 | 100 | | [BatchDeleteDevicePositionHistory](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchDeleteDevicePositionHistory.html) | 50 | 100 | | [ListDevicePositions](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListDevicePositions.html) | 50 | 100 | ## その他の使用制限