Aktualne miejsce

Wybierz platformę: Android iOS

Za pomocą pakietu Places SDK dla Androida możesz sprawdzić dane miejsce w aktualnie raportowanej lokalizacji urządzenia. Mogą to być lokalne firmy, ciekawe miejsca lub lokalizacje geograficzne.

Uprawnienia

Aby korzystać z biblioteki, nie musisz deklarować dodatkowych uprawnień w pliku manifestu aplikacji, ponieważ deklaruje ona wszystkie uprawnienia, których używa w swoim manifeście. Jeśli jednak aplikacja korzysta z PlacesClient.findCurrentPlace(), musisz poprosić o dostęp do lokalizacji w czasie działania.

Jeśli Twoja aplikacja nie korzysta z PlacesClient.findCurrentPlace(), usuń jednoznacznie uprawnienia ACCESS_FINE_LOCATION i ACCESS_COARSE_LOCATION wprowadzone w bibliotece, dodając do pliku manifestu te uprawnienia:

<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>

Aby rozpocząć, zapoznaj się z informacjami o uprawnieniach i rozważ użycie EasyPermissions.

Pobierz bieżącą lokalizację

Aby znaleźć lokalną firmę lub inne miejsce, w którym znajduje się obecnie urządzenie, wykonaj te czynności:

  1. Wywołaj ContextCompat.checkSelfPermission, aby sprawdzić, czy użytkownik zezwolił na dostęp do lokalizacji urządzenia. Aplikacja musi też zawierać kod, który wyświetla użytkownikowi prośbę o zgodę i obsługuje wynik. Więcej informacji znajdziesz w sekcji Żądanie uprawnień aplikacji.
  2. Utwórz FindCurrentPlaceRequest, przekazując List z Place.Field, określając typy danych miejsca, o które prosi Twoja aplikacja.
  3. Wywołaj PlacesClient.findCurrentPlace(), przesyłając wartość FindCurrentPlaceRequest utworzoną w poprzednim kroku.
  4. Pobierz listę PlaceLikelihood z: FindCurrentPlaceResponse.

Pola odpowiadają wynikom wyszukiwania miejsc i są podzielone na 3 kategorie płatności: Podstawowe, Kontakty i atmosfera. Pola podstawowe są rozliczane według stawki podstawowej i nie są naliczane żadne dodatkowe opłaty. Pola kontaktów i atmosfery są rozliczane według wyższej stawki. Więcej informacji o rozliczeniu żądań danych o miejscach znajdziesz w artykule Użycie i płatności.

Interfejs API zwróci błąd FindCurrentPlaceResponse w obiekcie Task. FindCurrentPlaceResponse zawiera listę obiektów PlaceLikelihood reprezentujących miejsca, w których prawdopodobnie znajduje się urządzenie. W przypadku każdego miejsca wynik może wskazywać, że jest to właściwe miejsce. Lista może być pusta, jeśli w danej lokalizacji urządzenia nie ma znanego miejsca.

Możesz wywołać obiekt PlaceLikelihood.getPlace(), aby pobrać obiekt Place, a PlaceLikelihood.getLikelihood(), aby uzyskać ocenę prawdopodobieństwa miejsca. Wyższa wartość oznacza większe prawdopodobieństwo, że dane miejsce jest najlepiej dopasowane.

Ten przykładowy kod pobiera listę miejsc, w których dane urządzenia są najbardziej prawdopodobne, i rejestruje nazwę oraz prawdopodobieństwo w przypadku każdego miejsca.

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();
}

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()
}

Uwagi dotyczące wartości prawdopodobieństwa:

  • Prawdopodobieństwo to względne prawdopodobieństwo, że miejsce jest najlepiej dopasowane na liście zwróconych miejsc dla pojedynczego żądania. Nie można porównywać prawdopodobieństwa w różnych żądaniach.
  • Wartość prawdopodobieństwa będzie wynosić od 0,0 do 1,0.

Aby na przykład podać 55% prawdopodobieństwa, że właściwe miejsce to Miejsce A, i 35% prawdopodobieństwa, że jest to miejsce B, odpowiedź ma 2 członki, miejsce A z prawdopodobieństwem 0,55, a miejsce B z prawdopodobieństwem 0,35.

Wyświetlanie atrybucji w aplikacji

Gdy aplikacja wyświetla informacje uzyskane z PlacesClient.findCurrentPlace(), musi też zawierać informacje o jej atrybucji. Zobacz dokumentację dotyczącą atrybucji.