GMSPlacesClient 类参考

为 Google Places SDK for iOS 提供GMSPlacesClient的共享实例，并在必要时创建它。

如果您的应用经常使用GMSPlacesClient的方法，您可能需要直接持有此对象，否则系统可能会定期重新启动您与 Google 的连接。

向 Google Places SDK for iOS 提供您的 API 密钥。

此密钥通过 Google Cloud Platform Console 为您的应用生成，并与您应用的软件包 ID 配对来识别它。在使用GMSPlacesClient之前（例如，在 application:didFinishLaunchingWithOptions: 中），您的应用应调用此方法。

返回：

如果成功提供了 APIKey，则为“是”。

返回 Google Places SDK for iOS 的开源软件许可信息。

此信息必须在您的应用中提供。

返回此版 Google Places SDK for iOS 的版本。

。例如“1.0.0”。

返回此版本的 Google Places SDK for iOS 的详细版本。

。例如“1.0.0 (102.1)”。

获取某个地点的详细信息。

此方法是非阻塞的。

参数：

placeID	要查找的地点 ID。
callback	要使用查询结果调用的回调函数。

获取与某个地点关联的最多 10 张照片的元数据。

照片来自于不同的地点，包括商家所有者和 Google+ 用户提供的照片。在大多数情况下，使用这些照片时可以不包含提供方说明，或将必需的提供方说明作为图片的一部分。不过，您必须使用响应中的 attributions 属性来检索所需的任何其他提供方说明，并在您的应用中显示相应图片的任何位置显示这些提供方说明。最多返回 10 张照片。

多次调用此方法可能会每次返回相同的照片。不过，无法保证这一点，因为底层数据可能已发生变化。

此方法会执行网络查询。

参数：

placeID	要为其查找照片的地点 ID。
callback	要使用查询结果调用的回调函数。

以最大尺寸加载特定照片的图片。

图片数据可以由 SDK 缓存。如果缓存中不存在请求的照片，则会执行网络查找。

参数：

photoMetadata	要为其加载 UIImage 的 GMSPlacePhotoMetadata。
callback	要使用已加载的 UIImage 调用的回调。

加载特定照片的图片，该图片会进行缩放以适应指定的最大尺寸。

图片会在保持原始宽高比的同时，缩放至适合指定尺寸。这种扩缩在服务器端执行。

如果 scale 参数不是 1.0，则 maxSize 将乘以此值，并将返回的 UIImage 设置为具有指定的比例。如果您要加载要在屏幕上显示的图片，则应将此参数设置为屏幕尺寸。

图片数据可以由 SDK 缓存。如果缓存中不存在请求的照片，则会执行网络查找。

注意：

应用缩放比例后，maxSize 中的尺寸将向上舍入为最接近的整数，然后才能使用。如果请求的图片大于可用大小上限，则可能会返回一张较小的图片。

参数：

photoMetadata	要为其加载 UIImage 的 GMSPlacePhotoMetadata。
maxSize	图片的大小上限。
和 WAF	图片的加载比例。
callback	要使用已加载的 UIImage 调用的回调。

返回设备当前已知所在位置的估算值。

根据设备最近一次的估计位置生成地点可能性列表。在成功时使用此可能性列表调用所提供的回调函数，并在出现错误时返回 NSError。

注意：

此方法要求您的应用有权访问当前设备位置信息。在调用该方法之前，请确保使用 [CLLocationManager requestWhenInUseAuthorization] 或 [CLLocationManager requestAlwaysAuthorization] 请求访问用户位置。如果您确实调用此方法，但您的应用没有正确的授权状态，系统将调用该回调函数并显示错误。

参数：

callback

使用地点可能性列表调用的回调。

从文本查询中查找自动补全预测结果。

结果可能会偏向于特定位置或仅限于某个区域。此方法是非阻塞的。

如果操作成功，则会使用一系列自动填充预测结果调用所提供的回调函数，并在出现错误时通过一个 NSError 进行调用。

参数：

个查询	要自动填充的部分文本。
filter	要应用于结果的过滤条件。此参数可以为零。
sessionToken	要将请求与结算会话关联的 GMSAutocompleteSessionToken。
callback	要对预测结果调用的回调函数。

提取地点的详细信息。

此方法是非阻塞的。

参数：

placeID	要查找的地点 ID。
placeFields	为列表中的地点对象请求的各个地点字段。
sessionToken	要将请求与结算会话关联的 GMSAutocompleteSessionToken。
callback	要使用查询结果调用的回调函数。

根据用户的当前位置查找地点可能性。

此方法是非阻塞的。

所提供的回调函数将使用一组地点调用，在成功时返回可能性得分，并在出现错误时返回 NSError。

参数：

placeFields	为列表中的地点对象请求的各个地点字段。
callback	使用地点可能性调用的回调。

获取地点的详细信息，包括确定当前时间的 GMSPlaceOpenStatus 所需的所有字段。

此方法是非阻塞的。

参数：

placeID	要查找的地点 ID。
callback	要通过地点结果调用的回调函数。

获取地点的详细信息，包括确定指定 NSDate 的 GMSPlaceOpenStatus 所需的所有字段。

此方法是非阻塞的。

参数：

placeID	要查找的地点 ID。
date	用于确定其打开状态的 NSDate。
callback	要通过地点结果调用的回调函数。

获取地点的详细信息，包括确定当前时间的 GMSPlaceOpenStatus 所需的所有字段。

仅当 GMSPlace 不包含所有必填字段时，才请求其他字段，否则回调中会立即返回 GMSPlaceOpenStatus。此方法是非阻塞的。

参数：

地点	要查找的 GMSPlace。
callback	要通过地点结果调用的回调函数。

获取地点的详细信息，包括确定指定 NSDate 的 GMSPlaceOpenStatus 所需的所有字段。

仅当 GMSPlace 不包含所有必填字段时，才请求其他字段，否则回调中会立即返回 GMSPlaceOpenStatus。此方法是非阻塞的。

参数：

地点	要查找的 GMSPlace。
date	用于确定其打开状态的 NSDate。
callback	要通过地点结果调用的回调函数。

好友及相关功能文档