次の方法で共有


Wi-Fi ホット スポット データ送信形式

Wi-Fi ホットスポット オフロードの非推奨のお知らせ

重要

Windows 10 バージョン 1709 以降では、Wi-Fi ホットスポット オフロード機能は非推奨となっているため、使用しないでください。 代わりに、UWP アプリを作成し、Wi-Fi ホットスポット認証 API (Windows.Networking.NetworkOperators) を使用することをお勧めします。

コード サンプルと詳細については、Wi-Fi ホットスポット認証のサンプルを参照してください。

探索サービスに送信されるホットスポット データは、JavaScript Object Notation (JSON) である必要があり、次の要素を使用する必要があります。

要素 Type 説明
BatchId GUID プロバイダーは、複数のホットスポットを含む 1 つの送信を複数の送信に分割できます。 各送信には、同じ BatchId GUID が割り当てられます。
ProviderId GUID プロバイダー ID は、Microsoft によってプロバイダーに割り当てられます。
TransactionId int バッチ内の各要求の増分番号。 デバッグに使用されます。
Hotspots アップロードするホットスポットのリスト。
add 完全な住所プロパティ。AddressCityStateOrProvincePostalCodeCountryOrRegion の各サブ要素が含まれます。
bssids List<string> ホットスポットを構成する BSSID のリスト。 各 BSSID は、00:aa:bb:cc:dd:ee の形式の 8 つの 2 桁の 16 進値で構成されます。
free Boolean ホットスポットが無料かどうかを示すブール値。
pub Boolean ホットスポットがパブリックかどうかを示すブール値。
loc 完全な場所プロパティ。LatitudeLongitudeRadialUncertaintyAltitudeAltitudeUncertainty の各サブ要素が含まれます。
name string ホットスポットのフレンドリ名。
phid string プロバイダーのホットスポット ID。 デバッグに使用されます。
走った uint ホットスポットの範囲。
ssid string ホットスポットの SSID。
電話 string ホットスポットに関連付けられているすべての電話番号のリスト。

  • ヘッダーとそのサブ要素 (ProviderIdBatchIdTransactionId) は必須です。
  • Hotspots リストを空にすることはできません。
  • Location 要素が指定されている場合は、LatitudeLongitude が必須となります。
  • Location 要素が指定されていない場合は、少なくとも 1 つの BSSID を指定する必要があります。 それ以外の場合は警告が返され、探索サービスはホットスポットを処理できません。

次の例は、1 つのホットスポットの完全なデータを示しています。

{
      "Header": {
            "BatchId": "BA85A383-5943-4D84-8ACB-B113BDEA3783", 
            "ProviderId": "AE012377-B0B4-4096-B5D5-D7EFBDC170EC", 
            "TransactionId": 1
      }, 
      "Hotspots":[{
            "add": {
                  "Address": "123 abc street", 
                  "City": "Redmond", 
                  "CountryOrRegion": "USA", 
                  "PostalCode": "98052", 
                  "StateOrProvince": "WA"
            },
            "bssids":["00:aa:bb:cc:dd:ee"],
            "free": true, 
            "pub": true, 
            "loc": {
                  "Latitude": 47.01, 
                  "Longitude": 121.1234, 
                  "RadialUncertainty": 300, 
                  "Altitude": 638.34, 
                  "AltitudeUncertainty": 100.0 
            }, 
            "name": "Joes Coffee Shop", 
            "phid": "abcdefg", 
            "ran": 100, 
            "ssid": "JoesCoffee", 
            "phone": ["425-882-8080"]
      }
}

探索サービスは、デバッグに使用されるアクティビティ ID と、探索サービスがホットスポット データを検証したときに生成された警告のリストを含む単純な応答を JSON 形式で返します。 探索サービスから返されるすべての文字列は UTF-8 でエンコードされます。

次の表に、探索サービス応答の JSON 要素を示します。

要素 Type 説明
ActivityId string 必須。 これは、プロバイダーが問題のデバッグに使用できる文字列です。
警告 List<string> 人間が判読できる警告のリスト。

次の例は、ホットスポット データの送信に対する一般的な応答を示しています。

{
     "ActivityId": "d2856c06-e4a1-4434-90e8-ced0c9ee6e10",
     "Warnings": ["Invalid Latitude: 247.67 – Hotspot Id: abcdefg"]
}