Omówienie usługi odnajdywania Wi-Fi

2025-04-03

Nota dotycząca wycofania funkcji odciążania hotspotu Wi-Fi

Ważny

Począwszy od systemu Windows 10 w wersji 1709, funkcja odciążania hotspotu Wi-Fi jest przestarzała i nie powinna być używana. Zamiast tego zalecamy stworzenie aplikacji UWP i użycie interfejsu API do uwierzytelniania hotspotu Wi-Fi (Windows.Networking.NetworkOperators).

Aby uzyskać przykładowy kod i więcej informacji, zobacz przykład uwierzytelniania hotspotu Wi-Fi.

Usługa odkrywania Wi-Fi umożliwia użytkownikom zmniejszenie kosztów danych dzięki przenoszeniu ruchu komórkowego na hotspoty Wi-Fi. Usługa wykrywania agreguje dane hotspotów Wi-Fi od dostawców, takich jak operatorzy sieci komórkowej, oraz z innych źródeł, aby utworzyć katalog znanych hotspotów Wi-Fi. Korzystając z tego katalogu, użytkownicy mogą uzyskiwać informacje o hotspotach w pobliżu bieżącej pozycji.

Operatorzy urządzeń przenośnych mogą przesyłać dane hotspotów do usługi, wysyłając żądanie HTTP POST lub używając narzędzia wiersza polecenia dostarczonego przez firmę Microsoft.

Instrukcje

Wi-Fi dane hotspotu muszą być w formacie opisanym w Wi-Fi Format przesyłania danych hotspotu.

Usługa odnajdywania wymaga przesłania wszystkich hotspotów dostawcy w jednej partii. Każda partia może zawierać wiele żądań przesyłania z mniejszą ilością danych. Na przykład partia zawierająca 1000 hotspotów może zostać przekazana do usługi odnajdywania, wysyłając 10 żądań przesyłania, z których każda zawiera dane dla 100 hotspotów. Każde żądanie przesyłania ma przypisany ten sam numer serii. Ostateczne żądanie przesłania musi zawierać nagłówek X-FinalBatchRequest ustawiony na całkowitą liczbę hotspotów w serii. Partia danych nie jest przetwarzana do momentu odebrania żądania przesłania z tym nagłówkiem. Jeśli nagłówek nie jest zgodny z liczbą hotspotów w partii, przesyłanie nie jest przetwarzane.

Przesyłanie danych hotspotu przy użyciu protokołu HTTP POST

W poniższym przykładzie przedstawiono typową prośbę o przesłanie. Obecność nagłówka X-FinalBatchRequest i wartości liczbowej "1" wskazuje, że w tej partii istnieje tylko jeden hotspot i jest to ostateczna prośba o przesłanie. W związku z tym jest to jedyna prośba o przesłanie. Jeśli grupa zawiera wiele hotspotów, ten wiersz powinien zostać usunięty dla wszystkich żądań przesyłania z wyjątkiem ostatniego.

POST https://submitwifiservice.windowsphone.com/v1/SubmitHotspots HTTP/1.1
Content-Type: application/json
X-FinalBatchRequest: 1
 [More headers…]
{
      "Header": {
            "BatchId": "2E20A8DB-9AFA-4A5A-AF6E-5F87DA639C15", 
            "TransactionId": 1, 
            "ProviderId": "FD9E5EE6-75C7-4A54-8B29-45A3FC83AD63"
      }, 
      "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"]
      }
}

Po odebraniu komunikatu na serwerze docelowym SubmitHotspots weryfikuje żądanie i uwierzytelnia nadawcę przed wysłaniem danych hotspotu do usługi odnajdywania.

Przesyłanie danych hotspotu przy użyciu narzędzia wiersza polecenia

WifiProviderExe.exe to narzędzie wiersza polecenia dostarczone przez firmę Microsoft, które przyjmuje jako wejściowy plik danych hotspotu, konwertuje go na wymagany format i przekazuje go do określonego serwera usługi odnajdywania.

Aby uruchomić WiFiProvider.exe, użyj następującej składni:

WifiProviderExe –DataFile filename -ProviderId GUID -ServiceEndpoint URL -CustomTransformer filename.dll [-MappingFile filename.xml] [-CertFile filename.pfx] [-CertPassword password] [-CertSubject name]

Na przykład:

WifiProviderExe -DataFile "file.txt" -ProviderId 00000000-0000-0000-0000-000000000000 -ServiceEndpoint "https://submitwifiservice.windowsphone.com/v1/SubmitHotspots" -CustomTransformer "transformer.dll"

Poniższa tabela zawiera listę możliwych parametrów dla WiFiProvider.exe.

Parametr	Opis
Plik danych	Wymagane. Nazwa pliku zawierającego dane hotspotu.
Identyfikator dostawcy	Wymagane. Identyfikator dostawcy przypisanego przez firmę Microsoft (identyfikator GUID).
Punkt końcowy usługi	Wymagane. Adres URL serwera usługi odnajdywania, do którego zostaną przekazane dane hotspotu.
CustomerTransformer	Wymagane. Nazwa zestawu zawierającego transformator.
Plik mapowania	Fakultatywny. Plik mapowania, który mapuje dane hotspotu dostawcy na format wymagany przez usługę odnajdywania.
CertFile	Fakultatywny. Wskaźnik do rzeczywistego pliku pfx, który zawiera certyfikaty na potrzeby uwierzytelniania. Parametr hasła certyfikatu (CertPassword) musi być określony podczas korzystania z tej metody uwierzytelniania.
CertPassword	Fakultatywny. Hasło do certyfikatu określonego w CertFile.
PodmiotCertyfikatu	Fakultatywny. Nazwa podmiotu certyfikatu. Znajduje się w sklepie certyfikatów "Moje" bieżącego użytkownika. W przypadku korzystania z tego mechanizmu uwierzytelniania CertFile i CertPassword nie są wymagane. Należy jednak utworzyć klucz prywatny dla certyfikatu i na liście kontroli dostępu przyznać uprawnienia dostępu dla klucza do konta, które będzie używać certyfikatu.

Transformers

Dane hotspotu mogą być w dowolnym formacie. Jednak konieczne jest określenie "transformatora danych", do którego narzędzie wiersza polecenia ma dostęp w celu przekształcenia danych hotspotu na format wymagany przez usługę odnajdywania.

W poniższej tabeli przedstawiono przykładowe transformatory, które są dostarczane z narzędziem do obsługi wiersza polecenia. Mogą służyć do konwertowania określonych formatów danych na wymagany format.

Transformator	Format danych	Opis
Microsoft.Wps.WifiService.ProviderSdk.JsonHotspotDataTransformer.dll	JSON	Dane muszą być zgodne z formatem JSON określonym w formacie Wi-Fi Format przesyłania danych hotspotu.
Microsoft.Wps.WifiService.ProviderSdk.JsonHotspotDataTransformer.dll	Prosty Excel	Musisz podać plik mapowania.

Pliki mapowania

Jeśli dane hotspotu są w prostym formacie programu Excel, musisz podać plik XML mapujący kolumny w pliku programu Excel na odpowiednie wymagane elementy JSON. Poniższa lista zawiera dozwolone nazwy kolumn:

Szerokość geograficzna
Długość
Niepewność promieniowa
Wysokość
Niepewność wysokości
Nazwa hotspotu
Identyfikator SSID
Zakres
Adres
Miasto
stan lub prowincja
Kod pocztowy
KrajLubRegion
Identyfikatory BSSID
ProviderHotspotId
IsPublic
IsFree
Numer telefonu

Poniższy przykład przedstawia część pliku mapowania. Każdy element MappingRule kojarzy kolumnę programu Excel (PartnerColumnName i PartnerColumnNumber) z wymaganym elementem JSON (MicrosoftColumnName). Element ContainsHeaderRow, który znajduje się po zamykającym tagu Reguły (</Rules>), wskazuje, że plik zawiera wiersz nagłówka, który powinien zostać pominięty podczas odczytywania danych.

<?xml version="1.0" encoding="utf-8"?>
<MappingRules xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <Rules>
    <MappingRule>
      <PartnerColumnName>english_hotspot_name</PartnerColumnName>
      <PartnerColumnNumber>3</PartnerColumnNumber>
      <MicrosoftColumnName>HotspotName</MicrosoftColumnName> 
    </MappingRule>
    <MappingRule>
      <PartnerColumnName>english_city_name</PartnerColumnName>
      <PartnerColumnNumber>2</PartnerColumnNumber>
      <MicrosoftColumnName>City</MicrosoftColumnName>
    </MappingRule>
    <MappingRule>
      <PartnerColumnName>ssid</PartnerColumnName>
      <PartnerColumnNumber>4</PartnerColumnNumber>
      <MicrosoftColumnName>SSID</MicrosoftColumnName>
    </MappingRule>
    <MappingRule>
      <PartnerColumnName>venue</PartnerColumnName>
      <PartnerColumnNumber>7</PartnerColumnNumber>
      <MicrosoftColumnName>HotspotType</MicrosoftColumnName>
    </MappingRule>
        .
        .
        .
        .    
  </Rules>
  <ContainsHeaderRow>true</ContainsHeaderRow>
</MappingRules>