使用 AWS IoT Core 裝置位置 MQTT 主題解析裝置位置

您可以使用保留的 MQTT 主題，透過裝置位置功能取得裝置的最新位 AWS IoT Core 置資訊。

裝置位置 MQTT 主題的格式

「 AWS IoT Core 裝置位置」的保留主題使用下列前置詞：

$aws/device_location/{customer_device_id}/

若要建立完整的主題，請先將 customer_device_id 取代為您用來識別裝置的唯一 ID。我們建議您指定WirelessDeviceId，例如針對 LoRa WAN 和人行道裝置，以及thingName如果您的裝置已註冊為 AWS IoT 物件。然後，您可以將主題附加到主題 Stub，例如 get_position_estimate 或 get_position_estimate/accepted，如下節所示。

注意

{customer_device_id} 只能包含英文字母、數字和破折號。訂閱裝置位置主題時，您只能使用加號 (+) 作為萬用字元。例如，您可以針對 {customer_device_id} 使用 + 萬用字元，以取得您裝置的位置資訊。當您訂閱主題 $aws/device_location/+/get_position_estimate/accepted 時，如果已成功解析，則會發佈一則訊息，其中包含符合任何裝置 ID 之裝置的位置資訊。

以下是用來與 AWS IoT Core 裝置位置互動的保留主題。

裝置位置 MQTT 主題
主題	允許操作	描述
$aws/device_location/`customer_device_id`/get_position_estimate	發佈	裝置會發佈至此主題，以取得由裝置位 AWS IoT Core 置解析的掃描原始量測資料。
$aws/device_location/`customer_device_id`/get_position_estimate/accepted	訂閱	AWS IoT Core 裝置位置成功解析裝置位置時，會將位置資訊發佈至此主題。
$aws/device_location/`customer_device_id`/get_position_estimate/rejected	訂閱	AWS IoT Core 裝置位置無法解析裝置位置時，會將錯誤資訊發佈至此主題。

裝置位置 MQTT 主題的政策

若要接收來自裝置位置主題的訊息，您的裝置必須使用允許裝置閘道連線至 AWS IoT 裝置閘道並訂閱 MQTT 主題的原則。

以下為接收各種主題訊息所需的政策範例。


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "iot:Publish"
      ],
      "Resource": [
        "arn:aws:iot:region:account:topic/$aws/device_location/customer_device_id/get_position_estimate"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "iot:Receive"
      ],
      "Resource": [
        "arn:aws:iot:region:account:topic/$aws/device_location/customer_device_id/get_position_estimate/accepted",
        "arn:aws:iot:region:account:topic/$aws/device_location/customer_device_id/get_position_estimate/rejected"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "iot:Subscribe"
      ],
      "Resource": [
        "arn:aws:iot:region:account:topicfilter/$aws/device_location/customer_device_id/get_position_estimate/accepted",
        "arn:aws:iot:region:account:topicfilter/$aws/device_location/customer_device_id/get_position_estimate/rejected"
      ]
    }
  ]
}

裝置位置主題和承載

以下顯示 AWS IoT Core 裝置位置主題、其訊息承載的格式，以及每個主題的範例原則。

/get_position_estimate

將訊息發佈至此主題，以從裝置取得原始測量資料，以透過「 AWS IoT Core 裝置位置」解析。


$aws/device_location/customer_device_id/get_position_estimate

AWS IoT Core 裝置位置會透過發佈至/get_position_estimate/accepted或來回應/get_position_estimate/rejected。

注意

發佈至此主題的訊息必須是有效的 JSON 承載。如果輸入訊息不是有效的 JSON 格式，您將不會收到任何回應。如需詳細資訊，請參閱訊息承載。

訊息承載格式遵循與 AWS IoT Wireless API 操作請求內文類似的結構 (GetPositionEstimate)。它包含以下內容：

選用的 Timestamp 字串，其對應至位置的解析日期和時間。Timestamp 字串的長度最短可以是 1，最長可以是 10。
選用的 MessageId 字串，其可以用來將請求對應至回應。如果您指定此字串，發佈至 get_position_estimate/accepted 或 get_position_estimate/rejected 主題的訊息將會包含此 MessageId。MessageID 字串的長度最短可以是 1，最長可以是 256。
來自裝置的測量資料，其中包含下列一或多種測量類型：

以下顯示範例訊息承載。


{
    "Timestamp": "1664313161",               
    "MessageId": "ABCD1",                
    "WiFiAccessPoints":  [                           
        {
            "MacAddress": "A0:EC:F9:1E:32:C1",                   
            "Rss": -66 
        }
    ],    
    "Ip":{
        "IpAddress": "54.192.168.0"                         
    },
    "Gnss":{
      "Payload":"8295A614A2029517F4F77C0A7823B161A6FC57E25183D96535E3689783F6CA48",
      "CaptureTime":1354393948
    }
}

以下為所需政策的範例：


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "iot:Publish"
      ],
      "Resource": [
        "arn:aws:iot:region:account:topic/$aws/device_location/customer_device_id/get_position_estimate"
      ]
    }
  ]
}

/get_position_estimate/accepted

AWS IoT Core 裝置位置會在傳回您裝置的已解析位置資訊時，發佈對此主題的回應。位置資訊會以 GeoJSON 格式傳回。


$aws/device_location/customer_device_id/get_position_estimate/accepted

以下顯示訊息承載和範例政策。

以下是 GeoJSON 格式的訊息承載範例。如果您MessageId在原始測量資料中指定了 a，且「 AWS IoT Core 裝置位置」已成功解析位置資訊，則訊息承載會傳回相同的MessageId資訊。


{
    "coordinates": [
        13.37704086303711,
        52.51865005493164
    ],
    "type": "Point",
    "properties": {
        "verticalAccuracy": 707,
        "verticalConfidenceLevel": 0.68,
        "horizontalAccuracy": 389,
        "horizontalConfidenceLevel": 0.68,
        "country": "USA",
        "state": "CA",
        "city": "Sunnyvalue",
        "postalCode": "91234",        
        "timestamp": "2022-11-18T14:03:57.391Z",
        "messageId": "ABCD1"
    }
}

以下為所需政策的範例：


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "iot:Subscribe"
      ],
      "Resource": [
        "arn:aws:iot:region:account:topicfilter/$aws/device_location/customer_device_id/get_position_estimate/accepted"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "iot:Receive"
      ],
      "Resource": [
        "arn:aws:iot:region:account:topic/$aws/device_location/customer_device_id/get_position_estimate/accepted"
      ]
    }
  ]
}

/get_position_estimate/rejected

AWS IoT Core 裝置位置無法解析裝置位置時，會針對此主題發佈錯誤回應。


$aws/device_location/customer_device_id/get_position_estimate/rejected

以下顯示訊息承載和範例政策。如需錯誤的相關資訊，請參閱對解析位置時發生的錯誤進行疑難排解。

以下是提供錯誤碼和訊息的訊息承載範例，指出 AWS IoT Core 裝置位置無法解析位置資訊的原因。如果您在提供原始測量資料MessageId時指定了 a，且 AWS IoT Core 裝置位置無法解析位置資訊，則MessageId訊息承載中會傳回相同的資訊。


{
    "errorCode": 500,
    "errorMessage":"Internal server error",
    "messageId": "ABCD1"
}

以下為所需政策的範例：


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "iot:Subscribe"
      ],
      "Resource": [
        "arn:aws:iot:region:account:topicfilter/$aws/device_location/customer_device_id/get_position_estimate/rejected"
      ]
    },
    {
      "Action": [
        "iot:Receive"
      ],
      "Resource": [
        "arn:aws:iot:region:account:topic/$aws/device_location/customer_device_id/get_position_estimate/rejected"
      ]
    }
  ]
}

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

解析 IoT 裝置的位置

位置求解器和裝置承載