当前地点

请选择平台: Android iOS

使用 Places SDK for iOS,您可以发现设备当前所在的地点。也就是当前报告的设备位置处的地点。地点的示例包括本地商家、地图注点和地理位置。

  1. 请求营业地点授权
  2. 用量限额
  3. 获取当前位置
  4. 在应用中显示提供方说明

请求位置信息授权

如果您的应用使用 GMSPlacesClient findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:,则必须请求权限才能使用位置信息服务。将 NSLocationWhenInUseUsageDescription 键添加到 Info.plist 文件中,以定义一个字符串,告知用户您为何需要位置信息服务。例如:

<key>NSLocationWhenInUseUsageDescription</key>
<string>Show your location on the map</string>

如果您想在应用在后台运行时调用 findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:,而不触发确认对话框,请在进行调用之前执行以下步骤:

  1. NSLocationAlwaysUsageDescription 键添加到 Info.plist 文件中。
  2. 在调用该方法之前,先对 CLLocationManager 的任意实例调用 requestAlwaysAuthorization

如下所示,请求CLLocationManager授权:

Swift

    locationManager.requestAlwaysAuthorization()
    

Objective-C

    [self.locationManager requestAlwaysAuthorization];
    

获取当前位置

如需查找本地商家或设备当前所在地点,请调用 GMSPlacesClient findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:。请添加以下参数:

  • 一个或多个 GMSPlaceField,指定要返回的数据类型。如果省略此参数,系统将返回所有可能的字段,并向您收取相应费用。这仅适用于“地点详情”请求。
  • 用于处理结果的回调方法。

这些字段与地点搜索结果相对应,而且分为三个结算类别:基本、联系人和氛围。“基本”字段按基本费率结算,且不会产生额外费用。“联系人”和“氛围”字段按更高的费率结算。如需详细了解地点数据请求的结算方式,请参阅使用量和结算

API 会调用指定的回调方法,并返回 GMSPlaceLikelihood 对象的数组。

每个 GMSPlaceLikelihood 对象代表一个地点。对于每个地点,结果都会包含一个指示地点是正确地点的可能性。值越高,表示该地点是最佳匹配项的可能性越大。如果没有与设备位置对应的已知地点,缓冲区可能为空。

以下代码示例会检索设备最有可能位于的地点列表,并记录每个地点的名称和可能性。

Swift

// Specify the place data types to return.
let fields: GMSPlaceField = GMSPlaceField(rawValue: UInt(GMSPlaceField.name.rawValue) |
                                          UInt(GMSPlaceField.placeID.rawValue))!
placesClient?.findPlaceLikelihoodsFromCurrentLocation(withPlaceFields: fields, callback: {
  (placeLikelihoodList: Array<GMSPlaceLikelihood>?, error: Error?) in
  if let error = error {
    print("An error occurred: \(error.localizedDescription)")
    return
  }

  if let placeLikelihoodList = placeLikelihoodList {
    for likelihood in placeLikelihoodList {
      let place = likelihood.place
      print("Current Place name \(String(describing: place.name)) at likelihood \(likelihood.likelihood)")
      print("Current PlaceID \(String(describing: place.placeID))")
    }
  }
})

Objective-C

// Specify the place data types to return.
GMSPlaceField fields = (GMSPlaceFieldName | GMSPlaceFieldPlaceID);
[_placesClient findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:fields callback:^(NSArray<GMSPlaceLikelihood *> * _Nullable likelihoods, NSError * _Nullable error) {
  if (error != nil) {
    NSLog(@"An error occurred %@", [error localizedDescription]);
    return;
  }
  if (likelihoods != nil) {
    for (GMSPlaceLikelihood *likelihood in likelihoods) {
      GMSPlace *place = likelihood.place;
      NSLog(@"Current place name: %@", place.name);
      NSLog(@"Place ID: %@", place.placeID);
    }
  }
}];

关于可能性值的说明:

  • 可能性是指在针对单个请求返回的地点列表中,相应地点是最佳匹配项的相对概率。您无法比较不同请求的可能性。
  • 可能性的值将在 0 和 1.0 之间。
  • 返回的 GMSPlaceLikelihood 对象数组中的可能性总和始终小于或等于 1.0。请注意,总和不一定是 1.0。

例如,若要表示地点 A 是正确地点的可能性为 55%,地点 B 是正确地点的可能性为 35%,可能性数组包含两个成员:可能性为 0.55 的地点 A 和可能性为 0.35 的地点 B。

在应用中显示提供方说明

如果应用要显示通过 GMSPlacesClient findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: 获取的信息,则还必须显示提供方说明。详细了解归因