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		完全な住所プロパティ。Address、City、StateOrProvince、PostalCode、CountryOrRegion の各サブ要素が含まれます。
bssids	List<string>	ホットスポットを構成する BSSID のリスト。 各 BSSID は、00:aa:bb:cc:dd:ee の形式の 8 つの 2 桁の 16 進値で構成されます。
free	Boolean	ホットスポットが無料かどうかを示すブール値。
pub	Boolean	ホットスポットがパブリックかどうかを示すブール値。
loc		完全な場所プロパティ。Latitude、Longitude、RadialUncertainty、Altitude、AltitudeUncertainty の各サブ要素が含まれます。
name	string	ホットスポットのフレンドリ名。
phid	string	プロバイダーのホットスポット ID。 デバッグに使用されます。
走った	uint	ホットスポットの範囲。
ssid	string	ホットスポットの SSID。
電話	string	ホットスポットに関連付けられているすべての電話番号のリスト。

注

• ヘッダーとそのサブ要素 (ProviderId、BatchId、TransactionId) は必須です。
• Hotspots リストを空にすることはできません。
• Location 要素が指定されている場合は、Latitude と Longitude が必須となります。
• 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"]
}