위치 데이터 인덱싱

AWS IoT 플릿 인덱싱을 사용하여 디바이스가 마지막으로 전송한 위치 데이터를 인덱싱하고 지오쿼리를 사용하여 디바이스를 검색할 수 있습니다. 이 기능은 위치 추적 및 근접성 검색과 같은 장치 모니터링 및 관리 사용 사례를 해결합니다. 위치 인덱싱은 다른 플릿 인덱싱 기능과 비슷하게 작동하며 사물 인덱싱에서 추가 구성을 지정해야 합니다.

일반적인 사용 사례로는 원하는 지리적 경계 내에 위치한 장치를 검색 및 집계하고, 인덱싱된 데이터 소스의 장치 메타데이터 및 상태와 관련된 검색어를 사용하여 위치별 통찰력을 얻고, 특정 지리적 영역에 결과를 필터링하여 플릿 모니터링 지도 내에서 렌더링 지연을 줄이고 마지막으로 보고된 장치 위치를 추적하는 등 세분화된 보기를 제공하고, 원하는 경계 제한을 벗어나는 장치를 식별하고 플릿 지표를 사용하여 경보를 생성하는 것이 포함됩니다. 위치 색인 및 지오쿼리를 시작하려면 을 참조하십시오시작하기 자습서.

지원되는 데이터 형식

AWS IoT 플릿 인덱싱은 다음과 같은 위치 데이터 형식을 지원합니다.

위치 데이터를 인덱싱하는 방법

다음 단계는 위치 데이터의 색인 구성을 업데이트하고 지오쿼리를 사용하여 기기를 검색하는 방법을 보여줍니다.

사물 인덱싱 구성을 업데이트하십시오.

위치 데이터를 인덱싱하려면 색인 구성을 업데이트하고 위치 데이터를 포함해야 합니다. 위치 데이터가 저장된 위치에 따라 다음 단계에 따라 색인 구성을 업데이트하세요.

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

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

지오쿼리 예시

위치 데이터에 대한 색인 구성을 완료한 후 지오쿼리를 실행하여 기기를 검색합니다. 지오쿼리를 다른 쿼리 문자열과 결합할 수도 있습니다. 자세한 내용은 쿼리 구문 및 사물 쿼리 예 섹션을 참조하세요.

예제 쿼리 1

이 예제에서는 위치 데이터가 명명된 gps-tracker 섀도우에 저장되어 있다고 가정합니다. 이 명령의 출력은 중심점으로부터 좌표 (47.6204, -122.3491) 를 기준으로 반경 방향 거리 15.5km 내에 있는 장치 목록입니다.

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

예제 쿼리 2

이 예제에서는 위치 데이터가 클래식 섀도우에 저장되어 있다고 가정합니다. 이 명령의 출력은 중심점으로부터 15.5km (좌표 포함) 반경 방향 거리 (47.6204, -122.3491) 내에 있는 장치의 목록입니다.

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

예제 쿼리 3

이 예제에서는 위치 데이터가 클래식 섀도우에 저장되어 있다고 가정합니다. 이 명령의 출력은 중심점으로부터 15.5km (좌표 포함) 반경 방향 거리 (47.6204, -122.3491) 밖에 있고 연결되지 않은 장치의 목록입니다.

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