android.location - zawiera klasy które definiują usługi oparte na lokalizacji, powiązane z usługami Android - Google Location Services API.
android.location API nie jest zalecany do uzyskiwania dostępu do lokalizacji Android. Google Location
Services API, będący częścią usług Google Play, to zalecany sposób dostępu do lokalizacji w twojej
aplikacji. Oferuje prostszy interfejs API i wyższą dokładność i nie tylko. Jeśli obecnie korzystasz
z interfejsu API android.location, powinieneś jak najszybciej przejść na interfejs Google Location
Services API com.google.android.gms.location.
...
Interfejsy
| GnssAntennaInfo.Listener | Służy do odbierania informacji o antenie GNSS z silnika GNSS ang. Global Navigation Satellite Systems. |
| GpsStatus.Listener | Ten interfejs jest przestarzały na poziomie API 24. Zamiast tego użyj GnssStatus.Callback. Służy do otrzymywania powiadomień o zdarzeniach GNSS. |
| GpsStatus.NmeaListener | Ten interfejs jest przestarzały na 24 poziomie API. Zamiast tego użyj OnNmeaMessageListener. Służy do odbierania zdań NMEA z GNSS. NMEA 0183 to standard komunikacji z morskimi urządzeniami elektronicznymi. |
| LocationListener | Służy do otrzymywania powiadomień o zmianie lokalizacji urządzenia. |
| OnNmeaMessageListener | Służy do odbierania zdań NMEA z GNSS. NMEA 0183 to standard komunikacji z morskimi urządzeniami elektronicznymi. |
Klasy
| Address | Klasa reprezentująca adres, tj. zbiór ciągów opisujących lokalizację. Format adresu to uproszczona wersja xAL (eXtensible Address Language) |
| Criteria | Klasa wskazująca kryteria aplikacji do wyboru dostawcy lokalizacji. |
| Geocoder | Klasa do obsługi geokodowania i odwrotnego geokodowania. |
| GnssAntennaInfo | Klasa do obsługi geokodowania i odwrotnego geokodowania. Klasa zawierająca informacje o antenie GNSS. |
| GnssAntennaInfo.Builder | Klasa konstruktora dla GnssAntennaInfo. |
| GnssAntennaInfo.PhaseCenterOffset | Klasa zawierająca informacje o przesunięciu środka fazowego anteny (PCO). |
| GnssAntennaInfo.SphericalCorrections | Reprezentuje poprawki na mapowaniu sferycznym. |
| GnssCapabilities | Możliwości chipsetu GNSS. |
| GnssCapabilities.Builder | Konstruktor GnssCapabilities. |
| GnssClock | Klasa zawierająca znacznik czasu zegara GPS. |
| GnssMeasurement | Klasa reprezentująca pomiar satelity GNSS, zawierająca surowe i obliczone informacje. |
| GnssMeasurementRequest | Ta klasa zawiera dodatkowe parametry do przekazania w żądaniu pomiaru GNSS. |
| GnssMeasurementRequest.Builder | Konstruktor GnssMeasurementRequest |
| GnssMeasurementsEvent | Klasa implementująca kontener na dane powiązane ze zdarzeniem pomiarowym. |
| GnssMeasurementsEvent.Callback | Służy do odbioru pomiarów satelitarnych GNSS z silnika GNSS. |
| GnssNavigationMessage | Klasa zawierająca komunikat nawigacji satelitarnej GNSS. |
| GnssNavigationMessage.Callback | Służy do odbierania komunikatów nawigacji satelitarnej GNSS z silnika GNSS. |
| GnssStatus | Ta klasa reprezentuje bieżący stan silnika GNSS i jest używana w połączeniu z GnssStatus.Callback. |
| GnssStatus.Builder | Klasa Builder ułatwiająca tworzenie nowych instancji GnssStatus. |
| GnssStatus.Callback | Służy do otrzymywania powiadomień o zdarzeniach GNSS. |
| GpsSatellite | Ta klasa reprezentuje aktualny stan satelity GPS. Ta klasa została uznana za przestarzałą na poziomie 24 interfejsu API. użyj GnssStatus i GnssStatus.Callback. |
| GpsStatus | Ta klasa reprezentuje bieżący stan aparatu GPS. Ta klasa została uznana za przestarzałą na poziomie interfejsu API 24. Zamiast tego użyj GnssStatus. |
| Location | Klasa danych reprezentująca lokalizację geograficzną. |
| LocationManager | Ta klasa zapewnia dostęp do usług lokalizacji systemu. |
| LocationProvider | Ta klasa została uznana za przestarzałą na poziomie interfejsu API 31. Ta klasa nie może reprezentować nieznanych właściwości dostawcy i może zwracać nieprawidłowe wyniki w rzadkich przypadkach, gdy właściwości dostawcy są nieznane. Preferuj użycie LocationManager#getProviderProperties(String), aby zamiast tego pobrać ProviderProperties. |
| LocationRequest | Hermetyzacja różnych parametrów do żądania lokalizacji przez LocationManager. |
| LocationRequest.Builder | Klasa konstruktora dla LocationRequest. |
| SettingInjectorService | Dynamicznie określa podsumowanie (podtytuł) i włączony stan preferencji wstrzykniętych na listę ustawień aplikacji wyświetlanych przez aplikację ustawień systemowych. Do użytku tylko przez aplikacje zawarte w obrazie systemu, w przypadku preferencji, które mają wpływ na wiele aplikacji. |
Dodajemy Google Play services. W pliku build.gradle, w części dependencies musimy dodać biblioteki dotyczące android.location.
dependencies {
...
implementation 'com.google.android.gms:play-services-location:19.0.1'
...
}
Uruchamiamy synchronizację pliku build.gradle, po przez klikniecie Synk Now.
W AndroidManifest.xml dodajemy dostęp do location API:
...
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:roundIcon="@mipmap/ic_launcher_round"
android:supportsRtl="true"
android:theme="@style/AppTheme"
android:usesCleartextTraffic="true">
<meta-data
android:name="com.google.android.gms.version"
android:value="@integer/google_play_services_version" />
...
Dodatkowo w AndroidManifest.xml musimy dodać uprawnienie ACCESS_FINE_LOCATION, które umożliwi dostęp do modułów lokalizacyjnych np. GPS itd.:
...
</application>
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
</manifest>
Przykład:
...
import android.location.Criteria;
import android.location.Location;
import android.location.LocationListener;
import android.location.LocationManager;
...
public class MainActivity extends AppCompatActivity {
// kryteria aplikacji do wyboru dostawcy lokalizacji
private Criteria criteria;
// nazwa dostawcy lokalizacji
private String provider;
// szerokość geograficzna
private String a;
// długość geograficzna
private String b;
// Do przechowywania drogi przebytej urządzenia
// oraz jego ostatniej
// lokalizacji używamy zmiennych statycznych,
private static double drogaMetry;
// Parametr Location opisuje bieżącą lokalizację
// użytkownika. Już niebawem użyjemy tego parametru.
private static Location lastLocation = null;
// szerokość geograficzną
private static double latitude;
// długość geograficzną
private static double longitude;
// Obiekt LocationManager zapisujemy
// w zmiennej prywatnej, dzięki czemu
// inne metody będą miały do niego dostęp.
private LocationManager locManager;
// Łańcuch uprawnienia dodajemy jako stałą. Dotyczy lokalizacji
public static final String PERMISSION_STRING = Manifest.permission.ACCESS_FINE_LOCATION;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_drogomierz);
// wskazująca kryteria aplikacji do wyboru dostawcy lokalizacji.
criteria = new Criteria();
// Wskazuje żądaną dokładność dla szerokości i długości geograficznej.
// Dokładność może wynosić ACCURACY_FINE lub ACCURACY_COARSE. Bardziej
// dokładna lokalizacja może zużywać więcej energii i może potrwać dłużej.
criteria.setAccuracy(Criteria.ACCURACY_COARSE);
// Pobieramy najdokładniejszego dostawcę usług lokalizacji.
locManager = (LocationManager) getSystemService(Context.LOCATION_SERVICE);
// Sprawdzamy, czy aplikacja ma uprawnienie.
if(ContextCompat.checkSelfPermission(this, PERMISSION_STRING) == PackageManager.PERMISSION_GRANTED) {
// Pobieramy menedżera lokalizacji.
// Zwraca nazwę dostawcy, który najlepiej spełnia podane kryteria.
// jeśli true, uwzględniani są tylko aktywni dostawcy
provider = locManager.getBestProvider(criteria, true);
// Służy do otrzymywania powiadomień o zmianie lokalizacji urządzenia.
// Te metody są wywoływane, gdy listener został zarejestrowany w LocationManager.
startlistener = new StartLocationListener();
// sprawdzamy czy dostawca lokalizacji jest ustalony
if(provider != null) {
// Żądamy przekazywania aktualnych danych o lokalizacji.
locManager.requestLocationUpdates(provider, 1000, 1, startlistener);
}
}
// pole tekstowe
final TextView distanceView2 = (TextView)findViewById(R.id.distance2);
// Pobiera ostatnią znaną lokalizację od danego dostawcy lub null,
// jeśli nie ma ostatniej znanej lokalizacji. W niektórych
// okolicznościach zwrócona lokalizacja może być dość stara,
// dlatego zawsze należy sprawdzić wiek lokalizacji.
Location location = locManager.getLastKnownLocation(provider);
a = ""+location.getLatitude(); // pobieramy szerokość geograficzną
b = ""+location.getLongitude(); // pobieramy długość geograficzną
// prezentujemy dane w polu tekstowym
distanceView2.setText("Szerokość: " + a + ", Długość: " + b + "");
// prezentujemy dane w polu Toast
Toast.makeText(DrogomierzActivity.this, "Szerokość: "+location.getLatitude()+", Długość: "
+location.getLongitude(), Toast.LENGTH_SHORT).show();
// Podczas tworzenia aktywności wywołujemy metodę displayHandler()
// do prezentowania aktualnej lokalizacji
displayHandler();
}
@Override
public void onDestroy() {
super.onDestroy();
if (locManager != null && startlistener != null) {
// Przesyłanie danych możemy zatrzymać, wyłącznie jeśli będziemy posiadać odpowiednie uprawnienie.
if (ContextCompat.checkSelfPermission(this, PERMISSION_STRING) == PackageManager.PERMISSION_GRANTED) {
// To wywołanie kończy przekazywanie
// informacji o bieżącej lokalizacji (o ile
// mamy uprawnienia do jego wykonania).
locManager.removeUpdates(startlistener);
}
// Zapisujemy null w zmiennych
// przechowujących wcześniej
// obiekty LocationManager
// i LocationListener.
locManager = null;
startlistener = null;
}
}
// Ta metoda aktualizuje lokalizację,
private void displayHandler() {
final TextView distanceView2 = (TextView)findViewById(R.id.distance2);
final Handler handler = new Handler();
handler.post(new Runnable() {
@Override
public void run() {
//
double droga = 0.0;
// To wyrażenie konwertuje przebyty dystans wyrażony w metrach na kilometry
droga = drogaMetry / 1000.0;
// zapisujemy jako zasób łańcuchowy
String drogaKm = String.format(Locale.getDefault(), "%1$,.2f kilometra", droga);
// pobieramy szerokość geograficzną
a = ""+latitude;
// pobieramy długość geograficzną
b = ""+longitude;
// prezentujemy dane w polu tekstowym
distanceView2.setText("Droga: " + drogaKm + ", Szerokość: " + a + ", Długość: " + b + "");
// Informacje aktualizujemy co sekundę, w polu tekstowym i Toast
handler.postDelayed(this, 1000);
}
});
}
private class StartLocationListener implements LocationListener {
// Służy do otrzymywania powiadomień o zmianie lokalizacji urządzenia.
// Te metody są wywoływane, gdy listener został zarejestrowany w LocationManager.
@Override
public void onLocationChanged(Location location) {
// Tu aktualizujemy ostatnią lokalizację użytkownika.
if (lastLocation == null) {
lastLocation = location; // Ustawiamy wyjściowe położenie użytkownika
}
// Wyniki tłumaczenia Zwraca przybliżoną odległość
// w metrach między tą lokalizacją a podaną lokalizacją
drogaMetry += location.distanceTo(lastLocation);
lastLocation = location; // Ustawiamy aktualne położenie użytkownika
// zapisujemy szerokość geograficzną
latitude = lastLocation.getLatitude();
// zapisujemy długość geograficzną
longitude = lastLocation.getLongitude();
// prezentujemy szerokość i długość geograficzną za pomocą Toast
Toast.makeText(DrogomierzActivity.this, "Szerokość: "+lastLocation.getLatitude()+", Długość: "
+lastLocation.getLongitude(), Toast.LENGTH_SHORT).show();
}
// gdy dostawca lokalizacji zostanie włączony
@Override
public void onProviderEnabled(String provider) {
Toast.makeText(DrogomierzActivity.this, "Dostawca: "+provider+" włączony!", Toast.LENGTH_SHORT)
.show();
}
// gdy dostawca lokalizacji zostanie wyłączony
@Override
public void onProviderDisabled(String provider) {
Toast.makeText(DrogomierzActivity.this, "Dostawca: "+provider+" wyłączony!", Toast.LENGTH_SHORT)
.show();
}
// gdy dostawca lokalizacji - zmieni się jego stan
@Override
public void onStatusChanged(String provider, int status, Bundle bundle) {
Toast.makeText(DrogomierzActivity.this, "Dostawca: "+provider+" status zmienił się na: "+status+"!",
Toast.LENGTH_SHORT).show();
}
}
}
...