Aktualne miejsce

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Jeśli Twój adres rozliczeniowy znajduje się w Europejskim Obszarze Gospodarczym, od 8 lipca 2025 r. do korzystania z usług będą miały zastosowanie Warunki korzystania z usługi Google Maps Platform w EOG. Funkcje różnią się w zależności od regionu. Więcej informacji

Wycofano: metoda PlacesClient.findCurrentPlace() została wycofana. Zamiast niej używaj kolumny PlacesClient.searchNearby(). Pamiętaj, że aby używać PlacesClient.searchNearby(), musisz włączyć interfejs Places API (nowy) w kluczu interfejsu API w konsoli Google Cloud.

Za pomocą pakietu Places SDK na Androida możesz odkrywać miejsca w lokalizacji aktualnie zgłaszanej przez urządzenie. Przykłady miejsc to firmy działające lokalnie, ciekawe miejsca i lokalizacje geograficzne.

Uwaga: aby przejść samouczek z praktycznymi ćwiczeniami, zapoznaj się z samouczkiem dotyczącym aktualnego miejsca.

Uprawnienia

Aby korzystać z biblioteki, nie musisz deklarować w pliku manifestu aplikacji żadnych dodatkowych uprawnień, ponieważ biblioteka deklaruje w swoim pliku manifestu wszystkie uprawnienia, z których korzysta. Jeśli jednak Twoja aplikacja korzysta z PlacesClient.findCurrentPlace(), musisz poprosić o uprawnienia do lokalizacji w czasie działania.

Jeśli Twoja aplikacja nie korzysta z PlacesClient.findCurrentPlace(), usuń z niej uprawnienia ACCESS_FINE_LOCATION i ACCESS_COARSE_LOCATION wprowadzone przez bibliotekę, dodając do manifestu te wiersze:

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

Dowiedz się więcej o  uprawnieniach i rozpocznij korzystanie z  EasyPermissions.

Pobieranie bieżącej lokalizacji

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

1. Wywołaj ContextCompat.checkSelfPermission, aby sprawdzić, czy użytkownik przyznał uprawnienia dostępu do lokalizacji urządzenia. Aplikacja musi też zawierać kod, który wyświetla prośbę o przyznanie uprawnień i obsługuje wynik. Szczegółowe informacje znajdziesz w artykule Prośba o uprawnienia aplikacji.
2. Utwórz FindCurrentPlaceRequest, przekazując List Place.Field, określając typy danych o miejscach, o które aplikacja powinna wysyłać prośby.
3. Wywołaj funkcję PlacesClient.findCurrentPlace(), przekazując utworzony w poprzednim kroku parametr FindCurrentPlaceRequest.
4. Pobierz listę PlaceLikelihood z FindCurrentPlaceResponse.

Uwaga: interfejsPlacesClient.fetchPlace() obsługuje wszystkie szczegóły miejsca, a interfejsPlacesClient.findCurrentPlace() tylko ich podzbiór. Listę pól NIE obsługiwanych przez findCurrentPlace() znajdziesz w artykule Obsługa pól w pakiecie SDK Miejsc na Androida.

Pola odpowiadają wynikom wyszukiwania miejsc i są podzielone na 3 kategorie rozliczeniowe: podstawowe, kontaktowe i atmosfera. Za pola podstawowe naliczana jest stawka podstawowa, bez dodatkowych opłat. Pola Contact i Atmosphere są rozliczane według wyższej stawki. Więcej informacji o tym, jak rozliczane są żądania danych o miejscach, znajdziesz w artykule Użycie i rozliczenia.

Interfejs API zwraca wartość FindCurrentPlaceResponse w Task. Obiekt FindCurrentPlaceResponse zawiera listę obiektów PlaceLikelihood, które reprezentują miejsca, w których urządzenie może się znajdować. W przypadku każdego miejsca wynik zawiera informację o prawdopodobieństwie, że jest to właściwe miejsce. Lista może być pusta, jeśli nie ma znanego miejsca odpowiadającego danej lokalizacji urządzenia.

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

Poniższy przykładowy kod pobiera listę miejsc, w których urządzenie najprawdopodobniej się znajduje, i rejestruje nazwę oraz prawdopodobieństwo dla każdego miejsca.

Kotlin

// Use fields to define the data types to return.
val placeFields = listOf(Place.Field.DISPLAY_NAME, Place.Field.FORMATTED_ADDRESS, Place.Field.LOCATION)
val request = 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
) {
    placesClient.findCurrentPlace(request).addOnSuccessListener { response ->
        binding.progressBar.visibility = View.GONE
        adapter.setPlaceLikelihoods(response.placeLikelihoods)
    }.addOnFailureListener { exception ->
        binding.progressBar.visibility = View.GONE
        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 = Arrays.asList(Place.Field.DISPLAY_NAME, Place.Field.FORMATTED_ADDRESS, Place.Field.LOCATION);

// 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 -> {
        binding.progressBar.setVisibility(View.GONE);
        if (task.isSuccessful()) {
            FindCurrentPlaceResponse response = task.getResult();
            adapter.setPlaceLikelihoods(response.getPlaceLikelihoods());
        } else {
            Exception exception = task.getException();
            if (exception instanceof ApiException apiException) {
                Log.e("CurrentPlace", "Place not found: " + apiException.getStatusCode());
            }
        }
    });
} 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 określa względne prawdopodobieństwo, że dane miejsce jest najlepiej dopasowane na liście zwróconych miejsc w przypadku pojedynczego żądania. Nie możesz porównywać prawdopodobieństwa w przypadku różnych żądań.
• Wartość prawdopodobieństwa będzie mieścić się w zakresie od 0,0 do 1,0.

Na przykład, aby przedstawić 55-procentowe prawdopodobieństwo, że prawidłowym miejscem jest Miejsce A, i 35-procentowe prawdopodobieństwo, że jest to Miejsce B, odpowiedź zawiera 2 elementy: Miejsce A z prawdopodobieństwem 0,55 i Miejsce B z prawdopodobieństwem 0,35.

Uwaga: więcej informacji o inicjowaniu PlacesClient znajdziesz w artykule Inicjowanie klienta interfejsu Places API.

Możesz użyć CancellationToken, aby spróbować anulować żądanie w dowolnej klasie żądań (np. FetchPlaceRequest). Anulowanie jest wykonywane w miarę możliwości. Po wysłaniu prośby o anulowanie nie otrzymasz odpowiedzi. Wydanie tokena anulowania NIE gwarantuje, że konkretne żądanie zostanie anulowane, i możesz nadal ponosić opłaty za żądanie, nawet jeśli nie otrzymasz odpowiedzi.

Wyświetlanie atrybucji w aplikacji

Gdy aplikacja wyświetla informacje uzyskane z PlacesClient.findCurrentPlace(), musi też wyświetlać informacje o autorstwie. Więcej informacji znajdziesz w dokumentacji dotyczącej atrybucji.