如何在 Windows Phone 8 中获取手机的当前位置

原文 如何在 Windows Phone 8 中获取手机的当前位置

适用于：仅限于 Windows Phone 8。

本主题演示如何使用 Windows Phone 位置 API 确定手机的当前位置。如果您的应用仅需要用户当时的位置，例如，记录某位置的用户，或进行基于位置的搜索，则这是用于获取位置的建议方法。相比使用持续跟踪，此方法对于手机电池寿命更为有利。如果您确实需要持续更新位置，请参见如何在 Windows Phone 8 中持续跟踪手机位置。

重要说明：

您必须在您的应用清单文件中包含 ID_CAP_LOCATION 功能，才能在您的应用中使用位置 API。如果不这样做，将导致在开发期间部署应用时在应用中引发异常，并且，在您将应用提交到 Windows Phone 商店 时，它将无法被接收。有关更多信息，请参见 Windows Phone 应用的功能和硬件要求。

获取手机的当前位置

1. 在 Visual Studio 中创建新的 Windows Phone 应用。

2. 在“解决方案资源管理器”中，展开“属性”文件夹，然后双击 WMAppManifest.xml。

3. 在清单设计器的“功能”选项卡上，选中“ID_CAP_LOCATION”旁边的复选框。

4. 在 MainPage.xaml 中，将下列 XAML 代码粘贴到现有的名为 ContentPanel 的 Grid 元素上。此代码定义一个将启动位置 API 的按钮，以及一些文本块来显示维度、经度和应用的状态。

   XAML

    

   <Grid x:Name="ContentPanel" Grid.Row="1" Margin="12,0,12,0">
       <StackPanel>
           <Button x:Name="OneShotLocationButton" Click="OneShotLocation_Click" Content="get one-shot location"/>
           <TextBlock x:Name="LatitudeTextBlock"/>
           <TextBlock x:Name="LongitudeTextBlock"/>
           <TextBlock x:Name="StatusTextBlock"/>
       </StackPanel>
   </Grid>
   

5. 在 MainPage.xaml.cs 文件的顶部添加以下 using 语句。

   C#

    

   using System.Threading.Tasks;
   using Windows.Devices.Geolocation;
   

6. 添加同意提示以允许用户选择不让您的应用访问其位置。所有应用在使用位置 API 之前，应取得用户同意。本例检查 MainPage 类的 OnNavigatedTo(NavigationEventArgs) 方法中的用户同意，只要应用启动，就会调用它。代码首先检查 ApplicationSettings 字典，以了解是否存在“LocationConsent”密钥。如果发现该密钥，则意味着用户已经选择或退出位置，因此该方法立即返回。如果未发现该密钥，那么将显示 MessageBox，寻求用户同意。MessageBox 操作的结果受到检查，指示用户同意状态的布尔值存储在 ApplicationSettings 中的“LocationConsent”密钥内。在应用尝试访问用户位置之前，此密钥将受到检查。

   C#

    

   protected override void OnNavigatedTo(System.Windows.Navigation.NavigationEventArgs e)
   {
       if (IsolatedStorageSettings.ApplicationSettings.Contains("LocationConsent"))
       {
           // User has opted in or out of Location
           return;
       }
       else
       {
           MessageBoxResult result =
               MessageBox.Show("This app accesses your phone's location. Is that ok?",
               "Location",
               MessageBoxButton.OKCancel);
   
           if (result == MessageBoxResult.OK)
           {
               IsolatedStorageSettings.ApplicationSettings["LocationConsent"] = true;
           }else
           {
               IsolatedStorageSettings.ApplicationSettings["LocationConsent"] = false;
           }
   
           IsolatedStorageSettings.ApplicationSettings.Save();
       }
   }
   

7. 将下列处理程序粘贴到用于按钮单击事件的 MainPage.xaml.cs 中。该方法首先检查ApplicationSettings 字典中用户同意的状态。如果值为 false，则该方法立即退出。一旦确定用户同意，则该方法初始化 Geolocator 对象，并设置 DesiredAccuracyInMeters 属性。随后，将调用 GetGeopositionAsync 方法。此方法尝试获取手机的当前位置。此为异步操作，因此在获取位置时不会阻止 UI 线程。您可以使用 await 操作符将代码置于异步调用之后，将在调用完成后执行。这需要该处理程序方法被申明为 async。因为可以确保使用 await 发起的调用返回在调用开始的线程上，而且 await 调用从 UI 线程发起，因此代码可以在调用返回时，直接访问并修改 UI。

   整个位置操作都包装在 try 块中，以防止引发任何异常。如果在开发时引发UnauthorizedAccessException 异常，可能意味着您的应用清单中未包含 ID_CAP_LOCATION。如果在已经部署应用之后发生这种情况，则可能意味着用户已在手机“设置”中禁用了此应用的位置。

   C#

    

   private async void OneShotLocation_Click(object sender, RoutedEventArgs e)
   {
   
       if ((bool)IsolatedStorageSettings.ApplicationSettings["LocationConsent"] != true)
       {
           // The user has opted out of Location.
           return;
       }
   
       Geolocator geolocator = new Geolocator();
       geolocator.DesiredAccuracyInMeters = 50;
   
       try
       {
           Geoposition geoposition = await geolocator.GetGeopositionAsync(
               maximumAge: TimeSpan.FromMinutes(5),
               timeout: TimeSpan.FromSeconds(10)
               );
   
           LatitudeTextBlock.Text = geoposition.Coordinate.Latitude.ToString("0.00");
           LongitudeTextBlock.Text = geoposition.Coordinate.Longitude.ToString("0.00");
       }
       catch (Exception ex)
       {
           if ((uint)ex.HResult == 0x80004004)
           {
               // the application does not have the right capability or the location master switch is off
               StatusTextBlock.Text = "location  is disabled in phone settings.";
           }
           //else
           {
               // something else happened acquring the location
           }
       }
   }
   

使用本机代码获取手机的当前位置

1. 本演练使用 IAsyncOperation<TResult> 来代表获取手机位置的异步操作。重要的一点是，获取位置时该对象没有超出范围，因此最好在标头中声明它的类成员变量。

   C++

    

   	Windows::Foundation::IAsyncOperation<Windows::Devices::Geolocation::Geoposition^>^ m_getOperation;
   

2. 就本例而言，我们也声明方法 GetOneShotLocation，将在其中使用位置 API 。该方法以 3 个整数作为参数，用它们表示结果的所需精度（以米为单位）、系统为获取位置结果而在超时前应等待的最长秒数以及位置结果的最长生存期（以秒为单位）。

   C++

    

   	void GetOneShotLocation(int accuracyInMeters, int timeoutSeconds, int maxAgeSeconds);
   

3. 在 .cpp 实现文件中，using 语句用于引用 Windows.Devices.Geolocation 命名空间。

   C++

    

   using namespace Windows::Devices::Geolocation;
   

4. 该步骤演示示例 GetOneShotLocation 方法的定义。首先实例化 Geolocator 对象。然后使用DesiredAccuracyInMeters 属性设置结果的所需精度。如果已提供超时或最长生存期值，则使用这些值调用 GetGeopositionAsync()，否则调用无参数的版本。该方法返回IAsyncOperation<TResult> 对象（存储在我们的类变量中）。

   其次，定义 Completed 事件处理程序。一旦该事件处理程序被挂钩，系统开始异步获取手机的位置。在本例中，使用内联匿名委托而非单独的事件处理程序。异步操作完成时，内联代码将运行。当委托运行时，它首先检查 AsyncStatus 参数。如果没有错误，则调用 GetResults()，它返回Geoposition 对象，可使用该对象获取纬度、经度、位置结果的精度以及其他数据。如果出现错误，则检查错误代码值是否为 E_ABORT。如果是，则意味着用户已经在手机设置中禁用了此应用的位置服务。如果是这种情况，您可以选择向用户发出警报，然后提供不需要位置的回退应用行为。

   C++

    

   void WPNativeLocationExample::GetOneShotLocation(int accuracyInMeters, int timeoutSeconds, int maxAgeSeconds)
   {
   
       Geolocator^ geolocator = ref new Geolocator();
   
       geolocator->DesiredAccuracyInMeters = (Platform::IBox<UINT>^)(PropertyValue::CreateUInt32(accuracyInMeters));
   
       m_getOperation = nullptr;
   
       if(timeoutSeconds > 0 || maxAgeSeconds > 0)
       {
   		TimeSpan maxAge;
           maxAge.Duration = maxAgeSeconds * 10000;
   
   		TimeSpan timeout;
           timeout.Duration = timeoutSeconds * 10000;
           m_getOperation = geolocator->GetGeopositionAsync(maxAge, timeout);
       }
       else
       {
            // Use the API with defaults
           m_getOperation = geolocator->GetGeopositionAsync();
       }
   
       // Start location acquisition.
       // Setting the completion callback implicitly starts acquisition.
       m_getOperation->Completed = ref new AsyncOperationCompletedHandler<Geoposition^>(
           [=] (IAsyncOperation<Geoposition^>^ asyncOperation, AsyncStatus status) mutable
           {
               if(status != AsyncStatus::Error)
               {
                  Geoposition^ geoposition = asyncOperation->GetResults();
   
                  // use the location information
                  double latitude = geoposition->Coordinate->Latitude;
                  double longitude = geoposition->Coordinate->Longitude;
                  double accuracy = geoposition->Coordinate->Accuracy;
   			   MyUseLocationFunction(latitude, longitude, accuracy);
               }
               else
               {
   				if(asyncOperation->ErrorCode.Value == E_ABORT)
   				{
   					// The user has disable location in the phone settings
   				}
   				else
   				{
   					// There was another error
   				}
               }
           });
   }