当前地点

请选择平台： Android iOS

使用 Places SDK for Android，您可以在设备当前报告的位置。地点示例包括本地地图、地图注点和地理位置信息。

权限

若要使用该库，您无需在应用清单中声明任何其他权限，因为库在其清单中声明了它使用的所有权限。但是，如果您的应用使用 PlacesClient.findCurrentPlace()、则必须在运行时请求位置信息权限。

如果您的应用不使用 PlacesClient.findCurrentPlace()，请明确移除引入了 ACCESS_FINE_LOCATION 和 ACCESS_COARSE_LOCATION 权限方法是将以下内容添加到清单中：

<manifest ... xmlns:tools="http://schemas.android.com/tools">
    ...
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" tools:node="remove"/>
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" tools:node="remove"/>
    ...
</manifest>

了解有关的详情权限，并考虑使用 EasyPermissions 开始工作。

获取当前位置

查找设备目前所在的本地商家或其他地点请按照以下步骤操作：

调用 ContextCompat.checkSelfPermission 检查用户是否授权访问其设备位置。您的应用还必须包含提示用户授予权限的代码。并处理结果。请参阅请求应用权限了解详情。
创建 FindCurrentPlaceRequest，传递 Place.Field 的 List，指定地点数据类型。
调用 PlacesClient.findCurrentPlace()，传递您在上一步中创建的 FindCurrentPlaceRequest 操作。
从PlaceLikelihood FindCurrentPlaceResponse。

。

注意：虽然 PlacesClient.fetchPlace() 支持所有地点详情， PlacesClient.findCurrentPlace() 仅支持部分地点详情。对于字段列表，受 findCurrentPlace() 支持，请参阅 Places SDK for Android 字段支持。

这些字段与“地点搜索结果”结果相对应，而且分为三个结算类别：基本、联系人和氛围。“基本”字段按基本费率结算，且不会产生额外费用费用。“联系人”和“氛围”字段按更高的费率结算。更多信息有关地点数据请求的结算方式，请参见使用量和结算。

该 API 会返回一个 FindCurrentPlaceResponse 以 Task。 FindCurrentPlaceResponse 包含一系列 PlaceLikelihood 对象，用于表示设备可能所在的位置。对于那么结果会包含一个指示就是正确位置如果没有已知地点，此列表可能为空与指定设备位置相对应。

您可以拨打 PlaceLikelihood.getPlace() 来检索 Place 对象和 PlaceLikelihood.getLikelihood() 来获取地点的可能性评分。值越高，相应地点最匹配的概率。

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

Kotlin

// Use fields to define the data types to return.
val placeFields: List<Place.Field> = listOf(Place.Field.NAME)

// Use the builder to create a FindCurrentPlaceRequest.
val request: FindCurrentPlaceRequest = FindCurrentPlaceRequest.newInstance(placeFields)

// Call findCurrentPlace and handle the response (first check that the user has granted permission).
if (ContextCompat.checkSelfPermission(this, permission.ACCESS_FINE_LOCATION) ==
    PackageManager.PERMISSION_GRANTED) {

    val placeResponse = placesClient.findCurrentPlace(request)
    placeResponse.addOnCompleteListener { task ->
        if (task.isSuccessful) {
            val response = task.result
            for (placeLikelihood: PlaceLikelihood in response?.placeLikelihoods ?: emptyList()) {
                Log.i(
                    TAG,
                    "Place '${placeLikelihood.place.name}' has likelihood: ${placeLikelihood.likelihood}"
                )
            }
        } else {
            val exception = task.exception
            if (exception is ApiException) {
                Log.e(TAG, "Place not found: ${exception.statusCode}")
            }
        }
    }
} else {
    // A local method to request required permissions;
    // See https://developer.android.com/training/permissions/requesting
    getLocationPermission()
}

Java

// Use fields to define the data types to return.
List<Place.Field> placeFields = Collections.singletonList(Place.Field.NAME);

// Use the builder to create a FindCurrentPlaceRequest.
FindCurrentPlaceRequest request = FindCurrentPlaceRequest.newInstance(placeFields);

// Call findCurrentPlace and handle the response (first check that the user has granted permission).
if (ContextCompat.checkSelfPermission(this, ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED) {
    Task<FindCurrentPlaceResponse> placeResponse = placesClient.findCurrentPlace(request);
    placeResponse.addOnCompleteListener(task -> {
        if (task.isSuccessful()){
            FindCurrentPlaceResponse response = task.getResult();
            for (PlaceLikelihood placeLikelihood : response.getPlaceLikelihoods()) {
                Log.i(TAG, String.format("Place '%s' has likelihood: %f",
                    placeLikelihood.getPlace().getName(),
                    placeLikelihood.getLikelihood()));
            }
        } else {
            Exception exception = task.getException();
            if (exception instanceof ApiException) {
                ApiException apiException = (ApiException) exception;
                Log.e(TAG, "Place not found: " + apiException.getStatusCode());
            }
        }
    });
} else {
    // A local method to request required permissions;
    // See https://developer.android.com/training/permissions/requesting
    getLocationPermission();
}

关于可能性值的说明：

可能性提供了相对概率，返回的地点列表中最符合某个条件的地点单一请求。您无法比较不同请求的可能性。
可能性的值将介于 0.0 和 1.0 之间。

例如，要表示“地方”是正确地点的可能性有 55% 而且这个回答中有两位成员的概率是 35% 地点 A 的可能性为 0.55，地点 B 的可能性为 0.35。

</ph> 注意：如需详细了解如何初始化 PlacesClient，请参阅初始化 Places API 客户端。

在应用中显示提供方说明

当应用显示从 PlacesClient.findCurrentPlace()、应用还必须显示提供方说明。请参阅归因。