配置 LoRaWAN 网关的位置 - Amazon IoT Core
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

配置 LoRaWAN 网关的位置

将网关添加到 Amazon IoT Core for LoRaWAN 时,您可以指定静态位置数据并添加目标。目标描述用于处理网关位置信息并将更新的位置路由到 Amazon Location Service 的 IoT 规则。配置网关位置后,位置数据将显示在 Amazon Location 地图上,其中包含您指定的准确信息和目标。

注意

在此预览版中,您可以使用 GNSS 解算器计算位置信息。此解算器只能与具有 LoRa Edge 芯片的 LoRaWAN 设备一起使用。它不能与 LoRaWAN 网关一起使用。对于网关,您仍然可以指定静态位置坐标并添加目标。如果不使用解算器来计算位置(例如,在网关的情况下),准确度信息将报告为 0.0

您可以使用 Amazon Web Services Management Console、Amazon IoT Wireless API 或 Amazon CLI 配置网关位置。

使用控制台配置网关的位置

要使用 Amazon Web Services Management Console 配置网关资源的位置,请先登录控制台,然后转到 Amazon IoT 控制台的 Gateways(网关)中心页面。

添加位置配置

为网关添加位置配置

  1. Gateways(网关)中心页面中,选择 Add gateway(添加网关)。

  2. 输入网关的 EUI、频段(RFRegion)以及任何其他网关详细信息和 LoRaWAN 配置信息。有关更多信息,请参阅使用控制台添加网关

  3. 输入网关的位置信息和位置数据目标。

    1. 位置信息

      使用纬度和经度坐标以及可选的高度坐标指定网关的位置数据。位置信息基于 WGS84 坐标系。

    2. 位置数据目标

      选择一个目标以描述用于处理网关位置数据并将更新的位置转发到 Amazon IoT Core for LoRaWAN 的 Amazon IoT 规则。此目标仅用于路由位置数据。它必须不同于您用于将设备数据路由到其他 Amazon Web Service 的目标。

查看网关的位置配置

配置网关的位置后,Amazon IoT Core for LoRaWAN 会创建一个称为 iotwireless.map 的 Amazon Location 地图。您可以在网关详细信息页面中的 Position(位置)选项卡上查看此地图。根据您指定的位置坐标,网关的位置将在地图上显示为标记。您可以放大或缩小以在地图上清晰地查看网关的位置。

注意

如果没有安装 Amazon Location Service 地图,您将看到一条消息,指示您必须使用 Amazon Location Service 才能访问地图并查看网关位置。使用 Amazon Location Service 地图可能会对您的 Amazon Web Services 账户 额外计费。有关更多信息,请参阅 Amazon IoT Core 定价

地图 iotwireless.map 用作可使用 Get API 操作(GetMapTile)访问的地图数据的来源。有关与地图一起使用的 Get API 的信息,请参阅 Amazon Location Service API 参考

要获取有关此地图的其他详细信息,请转到 Amazon Location Service 控制台,选择 maps(地图),然后选择 iotwireless.map。有关更多信息,请参阅《Amazon Location Service 开发人员指南》中的地图

在网关详细信息页面中的 Position(位置)选项卡上,您还将看到准确度信息、确定网关位置的时间戳以及您指定的位置数据目标。

更新网关的位置配置

要更改网关的位置配置,请在网关详细信息页面中选择 Edit(编辑),然后更新位置信息和目标。

注意

在此预览版中,历史位置信息不可用。当您更新网关的位置坐标时,它将覆盖以前报告的位置数据。更新位置后,在网关详细信息的 Position(位置)选项卡中,您将看到新的位置信息。时间戳的更改表示它对应于网关的上次已知位置。

使用 API 配置网关的位置

您可以指定位置信息,并使用 Amazon IoT Wireless API 或 Amazon CLI 配置网关位置。

添加位置信息和配置

使用以下 Amazon IoT Wireless API 操作或 Amazon CLI 命令来更新给定无线网关的位置信息和位置配置。

  • 添加网关位置

    要添加给定无线网关的静态位置信息,请使用 UpdatePosition API 操作或 update-position CLI 命令指定坐标。将 WirelessGateway 指定为 ResourceType,将要更新的无线网关的 ID 指定为 ResourceIdentifier,并将位置坐标指定为包含纬度、经度和高度信息的数组。

    aws iotwireless update-position \ --resource-type WirelessGateway \ --resource-id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" \ --position [37.33, 108.10, 20.0]

    运行此命令不会生成任何输出。要查看您指定的位置信息,请使用 GetPosition API。

  • 指定位置目标

    要配置给定无线网关的位置,请使用 PutPositionConfiguration API 操作或 put-position-configuration CLI 命令。将 WirelessGateway 指定为 ResourceType,将要更新的无线网关的 ID 指定为 ResourceIdentifier,并指定配置信息。虽然您无法使用地理位置解算器,但仍可以指定用于路由位置数据的目标。

    aws iotwireless put-position-configuration \ --resource-type WirelessGateway \ --resource-id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" \ --destination "Gateway_position_destination"

    运行此命令不会生成任何输出。要查看您指定的位置信息,请使用 GetPositionConfigurationListPositionConfigurations API 操作。

获取位置信息和配置

使用以下 Amazon IoT Wireless API 操作或 Amazon CLI 命令来获取给定无线设备的位置信息和位置配置。

  • 获取位置信息

    要获取给定无线网关的位置信息,请使用 GetPosition API 或 get-position CLI 命令。将 WirelessGateway 指定为 resourceType,并提供无线网关的 ID 作为 resourceIdentifier

    aws iotwireless get-position \ --resource-type WirelessGateway \ --resource-id "12345678-a1b2-3c45-67d8-e90fa1b2c34d"

    运行此命令会显示无线设备的位置信息。您将看到有关位置坐标的信息、对应于设备的上次已知位置的时间戳以及准确度信息。

    { "Accuracy": { "HorizontalAccuracy": 0.0, "VerticalAccuracy": 0.0 }, "Position": [ 33.33000183105469, -33.33000183105469, 10.0 ], "SolverProvider": null, "SolverType": null, "SolverVersion": null, "Timestamp": "Fri Jul 01 19:43:37 UTC 2022" }
  • 获取网关的位置配置

    要获取给定无线网关的位置配置,请使用 GetPositionConfiguration API 或 get-position-configuration CLI 命令。将 WirelessGateway 指定为 resourceType,并提供无线网关的 ID 作为 resourceIdentifier

    aws iotwireless get-position-configuration \ --resource-type WirelessGateway \ --resource-id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" --destination "Gateway_position_destination"

    运行此命令将显示无线网关的位置配置。您将看到有关您为路由位置数据指定的目标的信息。

    { "Destination": "Gateway_position_destination", }

列出位置配置

您可以为账户中的多个资源配置位置信息和目标。资源可以是无线设备和/或网关。创建这些配置后,可以使用 ListPositionConfigurations API 操作或 list-position-configurations CLI 命令来获取这些配置的列表。要筛选列表以仅显示无线网关的位置配置,请将 resourceType 设置为 WirelessGateway

aws iotwireless list-position-configurations \ --resource-type WirelessGateway

运行此命令会显示您的 Amazon Web Services 账户 中所有 LoRaWAN 网关的位置配置。也可以使用 max-results 参数来指定要显示多少个配置。下面的代码显示运行此命令的输出。

{ "PositionConfigurationList": [ { "Destination": "Gateway_position_destination1", "ResourceIdentifier": "12345678-a1b2-3c45-67d8-e90fa1b2c34d", "ResourceType": "WirelessGateway", "Solvers": { "SemtechGnss": { "Fec": "ROSE", "Provider": "Semtech", "Status": "Enabled", "Type": "GNSS" } } }, { "Destination": "Gateway_position_destination2", "ResourceIdentifier": "12345678-a1b2-c3d4-e5f6-e90fa1b2c34d", "ResourceType": "WirelessGateway", "Solvers": { "SemtechGnss": { "Fec": "ROSE", "Provider": "Semtech", "Status": "Enabled", "Type": "GNSS" } } } ] }