fuchsia.location.namedplace

與具名地點相關的通訊協定和類型。已命名的地點包括城市、國家/地區、區域等，明確排除了與經緯度相關的通訊協定和類型。

已新增：7

專家

RegulatoryRegionConfigurator

定義於 fuchsia.location.namedplace/namedplace.fidl

RegulatoryRegionConfigurator 通訊協定提供了相關機制，告知定位服務應用於決定哪些法規區域，其規則應規範系統無線電的運作情形。

設定區域

設定區域。

用戶端應留意，對這個 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 目前的法規區域。

要求

名稱類型
region RegionCode

RegulatoryRegionWatcher

定義於 fuchsia.location.namedplace/namedplace.fidl

RegulatoryRegionWatcher 通訊協定可讓無線電子系統瞭解目前適用的法規地區，並在該值變更時收到通知。

取得地區更新

當 RegionCode (變更時) 傳回。

注意事項：

  • 第一個呼叫會立即傳回。
  • 用戶端「沒有」保證會觀察每個 SetRegion() 呼叫的效果。
  • 不過，用戶端可以在要求完成時一律發出新要求，來達成「最終」一致性。
  • 用戶端不應向這個方法發出並行要求。
    • 目前並行要求
      • 可能會產生相同或不同的值。
      • 可能順序有誤。
    • 日後，並行要求將會導致管道關閉 ZX_ERR_BAD_STATE。
  • 回應 new_region 目前的法規區域。

要求

<空白>

回應

名稱類型
new_region RegionCode

取得更新

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

當 RegionCode (變更時) 傳回。

注意事項：

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

要求

<空白>

回應

名稱類型
new_region RegionCode

別名

名稱值說明
RegionCode string[2]敬上

代表法規區域。這些值通常應從 ISO 3166-2 代碼選擇。不過，某些無線電可能支援 ISO 3166-2 代碼集以外的擴充功能。