当前地点

请选择平台： 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%，可能性数组包含两个成员：地点 A 的可能性为 0.55，地点 B 的可能性为 0.35。

在应用中显示提供方说明

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