目前位置

選取平台： 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>

進一步瞭解權限，不妨考慮使用輕鬆取得權限。

取得目前位置

尋找裝置目前所在的當地商家或其他地點，請按照下列步驟進行：

呼叫 ContextCompat.checkSelfPermission 檢查使用者是否已授予裝置存取權或 HTTP/HTTPS 位置應用程式也必須加入提示使用者授予權限的程式碼。並處理結果請參閱「要求應用程式權限」。。
建立 FindCurrentPlaceRequest、傳遞 Place.Field 的 List，並指定應用程式應要求的地點資料類型。
呼叫 PlacesClient.findCurrentPlace()。傳遞您在上一個步驟中建立的 FindCurrentPlaceRequest 採用
從以下網址取得 PlaceLikelihood 清單： FindCurrentPlaceResponse。

，瞭解如何調查及移除這項存取權。

注意： PlacesClient.fetchPlace() 支援所有地點詳細資料 PlacesClient.findCurrentPlace() 僅支援部分地點詳細資料。NOT 欄位清單「findCurrentPlace()」支援，請參閱 Places SDK for Android 欄位支援。

欄位會與 Place Search 結果相對應，並分為三種計費類別：「Basic」、「Contact」和「Atmosphere」「Basic」欄位以基本費率計費，不會產生額外的費用費用。「Contact」和「Atmosphere」欄位會以較高的費率計費。如要進一步瞭解地點資料要求的計費方式，請參閱用量與計費。

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% 的機率表示正確的地點是地點 A，有 35% 的機率是地點 B，回應則有兩個成員地點 A 的可能性為 0.55，地點 B 的可能性為 0.35。

注意：如要進一步瞭解如何初始化 PlacesClient，請參閱初始化 Places API 用戶端。

在應用程式中顯示作者資訊

應用程式顯示 PlacesClient.findCurrentPlace()、應用程式也必須顯示作者資訊。詳情請參閱作者資訊。