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()。
• 但用戶端可以始終達成最終一致性 ，在要求完成時發出新的要求。
• 用戶端不應對這個方法發出並行要求。
  • 目前有並行要求
    • 可能會產生相同的值或不同的值。
    • 可能會發生順序錯誤。
  • 在未來，並行要求會導致管道 已關閉「ZX_ERR_BAD_STATE」。

• 回應 new_region 目前監管區域。

要求

<空白>

回應

GetUpdate

此呼叫已淘汰，請改用 GetRegionUpdate。

傳回新的 RegionCode (變更時)。

注意：

• 如果區域已已知，系統會立即傳回第一個呼叫。
• 用戶端無法保證每次呼叫的效果 至 SetRegion()。
• 但用戶端可以始終達成最終一致性 ，在要求完成時發出新的要求。
• 用戶端不應對這個方法發出並行要求。
  • 目前有並行要求
    • 可能會產生相同的值或不同的值。
    • 可能會發生順序錯誤。
  • 在未來，並行要求會導致管道 已關閉「ZX_ERR_BAD_STATE」。

• 回應 new_region 目前監管區域。

要求

<空白>

回應

ALIASES