fuchsia.location.namedplace

与已命名地点相关的协议和类型。已命名的地点包括城市、 其中明确排除了协议和类型 是与纬度和经度相关的

协议

RegulatoryRegionConfigurator

在 fuchsia.location.namedplace/namedplace.fidl 中定义

RegulatoryRegionConfigurator 协议提供了 向位置信息服务告知应该用于 确定应由哪个监管区域管理 无线装置的操作

SetRegion

设置区域。

客户端应注意，对该 API 的调用将以 。例如，将 Zircon 通道用作 则以下代码可能无法按预期运行。

// DANGER: The service may receive "BB" before "AA".
service1 = Open(RegulatoryRegionConfigurator);
service1.SetRegion("AA");
service1.Close();
service2 = Open(RegulatoryRegionConfigurator);
service2.SetRegion("BB");
service2.Close();

为避免此问题，客户端可以保留 在客户端的生命周期内始终有效。

// We use a single channel to ensure that calls arrive in a
// well-defined order.
service = Open(RegulatoryRegionConfigurator);
service.SetRegion("AA");
service.SetRegion("BB");

• 请求 region 当前监管区域。

请求

RegulatoryRegionWatcher

在 fuchsia.location.namedplace/namedplace.fidl 中定义

RegulatoryRegionWatcher 协议提供了一种 以了解当前适用的法规 并在该值发生更改时收到通知。

GetRegionUpdate

在新的 RegionCode 时，返回此代码。

注意：

• 第一个调用会立即返回。
• 我们不保证客户端一定会观察每次调用的效果 发送至 SetRegion()。
• 不过，客户端可以始终通过以下方法实现最终一致性 在请求完成时发出新请求。
• 客户端不应该向此方法发出并发请求。
  • 目前，并发请求数量 <ph type="x-smartling-placeholder">
    </ph>
    • 可能会产生相同或不同的值。
    • 可能会不按顺序完成。
  • 以后并发请求会导致该通道 以ZX_ERR_BAD_STATE结束。

• 响应 new_region 当前监管区域。

请求

<空>

响应

GetUpdate

此调用已弃用。请改用 GetRegionUpdate。

在新的 RegionCode 时，返回此代码。

注意：

• 如果区域已知，则第一个调用会立即返回。
• 我们不保证客户端一定会观察每次调用的效果 发送至 SetRegion()。
• 不过，客户端可以始终通过以下方法实现最终一致性 在请求完成时发出新请求。
• 客户端不应该向此方法发出并发请求。
  • 目前，并发请求数量 <ph type="x-smartling-placeholder">
    </ph>
    • 可能会产生相同或不同的值。
    • 可能会不按顺序完成。
  • 以后并发请求会导致该通道 以ZX_ERR_BAD_STATE结束。

• 响应 new_region 当前监管区域。

请求

<空>

响应

ALIASES