기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

위치

Location(location) 작업은 지리적 위치 데이터를 Amazon Location Service로 전송합니다.

요구 사항

이 규칙 작업은 다음 요구 사항을 충족해야 합니다.

파라미터

이 작업으로 AWS IoT 규칙을 생성할 때는 다음 정보를 지정해야 합니다.

예

다음 JSON 예제는 규칙의 위치 작업을 정의합니다. AWS IoT

{
	"topicRulePayload": {
		"sql": "SELECT * FROM 'some/topic'",
		"ruleDisabled": false,
		"awsIotSqlVersion": "2016-03-23",
		"actions": [
			{
				"location": {
					"roleArn": "arn:aws:iam::123454962127:role/service-role/ExampleRole",
					"trackerName": "MyTracker",
					"deviceId": "001",
					"sampleTime": {
						"value": "${timestamp()}",
						"unit": "MILLISECONDS"
					},
					"latitude": "-12.3456",
					"longitude": "65.4321"
				}
			}
		]
	}
}

다음 JSON 예제는 규칙에 대체 템플릿이 포함된 위치 작업을 정의합니다. AWS IoT

{
	"topicRulePayload": {
		"sql": "SELECT * FROM 'some/topic'",
		"ruleDisabled": false,
		"awsIotSqlVersion": "2016-03-23",
		"actions": [
			{
				"location": {
					"roleArn": "arn:aws:iam::123456789012:role/service-role/ExampleRole",
					"trackerName": "${TrackerName}",
					"deviceId": "${DeviceID}",
					"timestamp": {
						"value": "${timestamp()}",
						"unit": "MILLISECONDS"
					},
					"latitude": "${get(position, 0)}",
					"longitude": "${get(position, 1)}"
				}
			}
		]
	}
}

다음 MQTT 페이로드 예시는 위 예시의 대체 템플릿이 데이터에 액세스하는 방법을 보여줍니다. get-device-position-history CLI 명령을 사용하여 MQTT 페이로드 데이터가 위치 추적기에 전달되는지 확인할 수 있습니다.

{
	"TrackerName": "mytracker",
	"DeviceID": "001",
	"position": [
		"-12.3456",
		"65.4321"
	]
}

aws location get-device-position-history --device-id 001 --tracker-name mytracker

{
	"DevicePositions": [
		{
			"DeviceId": "001",
			"Position": [
				-12.3456,
				65.4321
			],
			"ReceivedTime": "2022-11-11T01:31:54.464000+00:00",
			"SampleTime": "2022-11-11T01:31:54.308000+00:00"
		}
	]
}

다음 사항도 참조하세요.