位置データのインデックス作成 - AWS IoT Core
サポートされているデータ形式位置データのインデックス作成方法モノのインデックス作成を設定するジオクエリの例

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

位置データのインデックス作成

AWS IoT フリートのインデックス作成を使用して、デバイスの最後に送信された位置データのインデックスを作成し、ジオクエリを使用してデバイスを検索できます。この機能は、位置追跡や近接検索などのデバイスモニタリングと管理のユースケースを解決します。位置インデックス作成は、他のフリートインデックス作成機能と同様に機能し、モノのインデックス作成で を指定する追加の設定で機能します。

一般的なユースケースには、目的の地理的境界内に位置するデバイスを検索および集約する、インデックス作成されたデータソースから、デバイスのメタデータと状態に関連するクエリ用語を使用して、位置固有のインサイトを取得する、結果を特定の地理的エリアにフィルタリングするなどの詳細なビューを提供し、フリートモニタリングマップ内のレンダリングの遅延を減らし、最後に報告されたデバイスの位置を追跡する、目的の境界制限外のデバイスを特定し、フリートメトリクスを使用してアラームを生成するなどがあります。位置インデックス作成とジオクエリを開始するには、「入門チュートリアル」を参照してください。

サポートされているデータ形式

AWS IoT フリートインデックス作成は、次の位置データ形式をサポートしています。

  1. 座標参照システムのよく知られたテキスト表現

    地理情報 - 座標参照システム形式のよく知られたテキスト表現の形式に従う文字列。例として、"POINT(long lat)" を使用できます。

  2. 座標を表す文字列

    "latitude, longitude" または "longitude, latitude" の形式の文字列。"longitude, latitude" を使用する場合は、geoLocations で order も指定する必要があります。例として、"41.12,-71.34" を使用できます。

  3. lat (緯度）、lon (経度) キーのオブジェクト

    この形式は、クラシックシャドウと名前付きシャドウに適用されます。サポートされるキー: lat、latitude、lon、long、longitude。例として、{"lat": 41.12, "lon": -71.34} を使用できます。

  4. 座標を表す配列

    形式が [lat,lon] または [lon,lat] の配列。GeoJSON の座標 (クラシックシャドウと名前付きシャドウに適用) と同じ形式 [lon,lat] を使用する場合は、geoLocations で order も指定する必要があります。

    例としては、次のようなものがあります。

    {
  "location": {
    "coordinates": [
      **Longitude**,
      **Latitude**
    ],
    "type": "Point",
    "properties": {
      "country": "United States",
      "city": "New York",
      "postalCode": "*****",
      "horizontalAccuracy": 20,
      "horizontalConfidenceLevel": 0.67,
      "state": "New York",
      "timestamp": "2023-01-04T20:59:13.024Z"
    }
  }
}

位置データのインデックス作成方法

次の手順では、位置データのインデックス作成の設定を更新し、ジオクエリを使用してデバイスを検索する方法を示します。

  1. 位置情報データが保存されている場所を把握する

    現在、フリートのインデックス作成は、クラシックシャドウまたは名前付きシャドウに保存されている位置データのインデックス作成をサポートしています。

  2. サポートされている位置データ形式を使用する

    位置データ形式がサポートされているデータ形式 のいずれかに従っていることを確認します。

  3. インデックス作成の設定の更新

    少なくとも、モノ (レジストリ) インデックス作成の設定を有効にします。また、位置データを含むクラシックシャドウまたは名前付きシャドウでインデックス作成を有効にする必要があります。モノのインデックス作成を更新するときは、インデックス作成の設定に位置情報データを含める必要があります。

  4. ジオクエリを作成して実行する

    ユースケースに応じて、ジオクエリを作成して実行し、デバイスを検索します。作成するジオキューは、クエリ構文に従う必要があります。ジオクエリの例 にいくつかの例があります。

モノのインデックス作成を設定する

位置データのインデックスを作成するには、インデックス作成の設定を更新し、位置データを含める必要があります。位置データが保存されている場所に応じて、手順に従ってインデックス作成の設定を更新します。

位置データがクラシックシャドウに保存されている場合は、thingIndexingMode を REGISTRY_AND_SHADOW に設定し、filter の geoLocations フィールド (name および order) に位置データを指定する必要があります。

次のモノのインデックス作成の設定例では、位置データパス shadow.reported.coordinates を name、 LonLat を order として指定します。

{
	"thingIndexingMode": "REGISTRY_AND_SHADOW",
	"filter": {
		"geoLocations": [
			{
				"name": "shadow.reported.coordinates",
				"order": "LonLat"
			}
		]
	}
}

  • thingIndexingMode

    インデックス作成モードは、レジストリまたはシャドウがインデックス作成されているかどうかを制御します。thingIndexingMode が OFF に設定されている場合、モノのインデックス作成は無効になります。

    クラシックシャドウに保存されている位置データをインデックス作成するには、thingIndexingMode を REGISTRY_AND_SHADOW に設定する必要があります。詳細については、「モノのインデックス作成モード」を参照してください。

  • filter

    インデックス作成フィルターは、名前付きシャドウと位置情報データに追加の選択を提供します。詳細については、「インデックス作成フィルター」を参照してください。

  • geoLocations

    インデックス作成のために選択した位置情報ターゲットのリスト。インデックス作成の位置情報ターゲットのデフォルトの最大数は 1 です。制限の引き上げをリクエストするには、「AWS IoT Device Management クォータ」を参照してください。

  • name

    位置情報ターゲットフィールドの名前。name の値は、シャドウの位置データパス (shadow.reported.coordinates) にすることができます。

  • order

    位置情報ターゲットフィールドの順序。有効な値: LatLon および LonLat。LatLon は緯度と経度を意味し、LonLat は経度と緯度を意味します。このフィールドはオプションです。デフォルト値は LatLon です。

位置データが名前付きシャドウに保存されている場合は、namedShadowIndexingMode を ONに設定し、名前付きシャドウ名 (複数可) を filter の namedShadowNames フィールドに追加し、filter の geoLocations フィールドに位置データパスを指定します。

次のモノのインデックス作成の設定例では、位置データパス shadow.name.namedShadow1.reported.coordinates を name、 LonLat を order として指定します。

{
	"thingIndexingMode": "REGISTRY",
	"namedShadowIndexingMode": "ON",
	"filter": {
		"namedShadowNames": [
			"namedShadow1"
		],
		"geoLocations": [
			{
				"name": "shadow.name.namedShadow1.reported.coordinates",
				"order": "LonLat"
			}
		]
	}
}

  • thingIndexingMode

    インデックス作成モードは、レジストリまたはシャドウがインデックス作成されているかどうかを制御します。thingIndexingMode が OFF に設定されている場合、モノのインデックス作成は無効になります。

    名前付きシャドウに保存されている位置データのインデックスを作成するには、thingIndexingMode を REGISTRY (または REGISTRY_AND_SHADOW) に設定する必要があります。詳細については、「モノのインデックス作成モード」を参照してください。

  • filter

    インデックス作成フィルターは、名前付きシャドウと位置情報データに追加の選択を提供します。詳細については、「インデックス作成フィルター」を参照してください。

  • geoLocations

    インデックス作成のために選択した位置情報ターゲットのリスト。インデックス作成の位置情報ターゲットのデフォルトの最大数は 1 です。制限の引き上げをリクエストするには、「AWS IoT Device Management クォータ」を参照してください。

  • name

    位置情報ターゲットフィールドの名前。name の値は、シャドウの位置データパス (shadow.name.namedShadow1.reported.coordinates) にすることができます。

  • order

    位置情報ターゲットフィールドの順序。有効な値: LatLon および LonLat。LatLon は緯度と経度を意味し、LonLat は経度と緯度を意味します。このフィールドはオプションです。デフォルト値は LatLon です。

ジオクエリの例

位置データのインデックス作成の設定が完了したら、ジオクエリを実行してデバイスを検索します。ジオクエリを他のクエリ文字列と組み合わせることもできます。詳細については、「クエリ構文」および「モノのクエリの例」を参照してください。

クエリの例 1

この例では、位置データが名前付きシャドウ gps-tracker に保存されていることを前提としています。このコマンドの出力は、座標 (47.6204,-122.3491) を持つ中心点から 15.5 km の半径距離内にあるデバイスのリストです。

aws iot search-index --query-string \
"shadow.name.gps-tracker.reported.coordinates:geo_distance,47.6204,-122.3491,15.5km"

クエリの例 2

この例では、位置データがクラシックシャドウに保存されていることを前提としています。このコマンドの出力は、座標 (47.6204,-122.3491) を持つ中心点から 15.5 km の半径距離内にあるデバイスのリストです。

aws iot search-index --query-string \
"shadow.reported.coordinates:geo_distance,47.6204,-122.3491,15.5km"

クエリの例 3

この例では、位置データがクラシックシャドウに保存されていることを前提としています。このコマンドの出力は、接続されておらず、座標 (47.6204、-122.3491) を持つ中心点から 15.5 km の半径距離外にあるデバイスのリストです。

aws iot search-index --query-string \
"connectivity.connected:false AND (NOT shadow.reported.coordinates:geo_distance,47.6204,-122.3491,15.5km)"