android.location class
public class Location
extends Object implements Parcelable
java.lang.Object
↳ android.location.Location
Klasa danych reprezentująca lokalizację geograficzną. Lokalizacja może składać się z szerokości i długości geograficznej, znacznika czasu i innych informacji, takich jak namiar, wysokość i prędkość. Wszystkie lokalizacje wygenerowane przez LocationManager gwarantują, że mają prawidłową szerokość geograficzną, długość geograficzną i znacznik czasu (zarówno czas UTC, jak i czas rzeczywisty, który upłynął od uruchomienia). Wszystkie inne parametry są opcjonalne.
Stałe:
int
|
FORMAT_DEGREES Stała używana do określenia formatowania szerokości lub długości geograficznej w postaci "[+-]DDD.DDDDD", gdzie D oznacza stopnie. |
|
int
|
FORMAT_MINUTES Stała używana do określenia formatowania szerokości lub długości geograficznej w postaci "[+-]DDD:MM.MMMMM", gdzie D oznacza stopnie, a M oznacza minuty łuku (1 minuta = 1/60 stopnia). |
|
int
|
FORMAT_SECONDS Stała używana do określenia formatowania szerokości lub długości geograficznej w postaci "DDD:MM:SS.SSSSS", gdzie D oznacza stopnie, M oznacza minuty łuku, a S oznacza sekundy łuku (1 minuta = 1/60 stopnia, 1 sekunda = 1/3600 stopnia). |
Odziedziczone stałe:
Z interfejsu android.os.Parcelable | ||
int
|
CONTENTS_FILE_DESCRIPTOR Bit deskryptora używany z defineContents(): wskazuje, że spłaszczona reprezentacja obiektu Parcelable zawiera deskryptor pliku. |
|
int |
PARCELABLE_WRITE_RETURN_VALUE Flaga do użycia z writeToParcel(Parcel, int): zapisywany obiekt jest wartością zwracaną, która jest wynikiem funkcji takiej jak "Parcelable someFunction()", "void someFunction(out Parcelable)" lub "void someFunction( wout Parcelable)". |
Pola:
public static final Creator<Location> |
CREATOR |
Konstruktorzy publiczni:
Location(String provider) Utwórz nową lokalizację z nazwanym dostawcą. |
Location(Location l) Skonstruuj nowy obiekt Location, który jest kopiowany z istniejącego. |
Metody publiczne:
float
|
bearingTo(Location dest) Zwraca przybliżony namiar początkowy w stopniach na wschód od prawdziwej północy podczas podróży najkrótszą ścieżką między tą lokalizacją a daną lokalizacją. |
|
static String
|
convert(double coordinate, int outputType) Konwertuje współrzędną na reprezentację String. |
|
static double
|
convert(String coordinate) Konwertuje String w jednym z formatów opisanych przez FORMAT_DEGREES, FORMAT_MINUTES lub FORMAT_SECONDS na double. |
|
int
|
describeContents() Opisz rodzaje specjalnych obiektów zawartych w zorganizowanej reprezentacji tej instancji Parcelable. |
|
static void
|
distanceBetween(double startLatitude, double startLongitude, double endLatitude, double endLongitude, float[] results). Oblicza przybliżoną odległość w metrach między dwoma lokalizacjami oraz opcjonalnie początkowy i końcowy namiar najkrótszej ścieżki między nimi. |
|
float
|
distanceTo(Location dest) Zwraca przybliżoną odległość w metrach między tą lokalizacją a daną lokalizacją. |
|
void
|
dump(Printer pw, String prefix) |
|
boolean
|
equals(Object o) Równość lokalizacji jest zapewniana przede wszystkim do celów testowych. |
|
float
|
getAccuracy() Uzyskaj szacunkową dokładność poziomą tej lokalizacji, radialnie, w metrach. |
|
double
|
getAltitude() Uzyskaj wysokość, jeśli jest dostępna, w metrach nad elipsoidą odniesienia WGS 84. |
|
float
|
getBearing() Sprawdź kierunek w stopniach. |
|
float
|
getBearingAccuracyDegrees() Uzyskaj szacunkową dokładność namiaru tej lokalizacji w stopniach. |
|
long
|
getElapsedRealtimeNanos() Zwróć czas wprowadzenia tej poprawki w nanosekundach czasu rzeczywistego, jaki upłynął od uruchomienia systemu. |
|
double
|
getElapsedRealtimeUncertaintyNanos() Uzyskaj szacunkową względną precyzję wyrównania znacznika czasu ElapsedRealtimeNanos z zgłoszonymi pomiarami w nanosekundach (pewność 68%). |
|
Bundle
|
getExtras() Zwraca dodatkowe informacje specyficzne dla dostawcy dotyczące poprawki lokalizacji jako pakiet. |
|
double
|
getLatitude() Określ szerokość geograficzną w stopniach. |
|
double
|
getLongitude() Podaj długość geograficzną w stopniach. |
|
String
|
getProvider() Returns the name of the provider that generated this fix. |
|
float
|
getSpeed() Get the speed if it is available, in meters/second over ground. |
|
float
|
getSpeedAccuracyMetersPerSecond() Uzyskaj szacowaną dokładność prędkości tej lokalizacji w metrach na sekundę. |
|
long
|
getTime() Zwróć czas UTC tej poprawki lokalizacji w milisekundach od epoki (1 stycznia 1970). |
|
float
|
getVerticalAccuracyMeters() Uzyskaj szacunkową dokładność pionową tej lokalizacji w metrach. |
|
boolean
|
hasAccuracy() True, jeśli ta lokalizacja ma dokładność poziomą. |
|
boolean
|
hasAltitude() True, jeśli ta lokalizacja ma wysokość. |
|
boolean
|
hasBearing() True, jeśli ta lokalizacja ma namiar. |
|
boolean
|
hasBearingAccuracy() True, jeśli ta lokalizacja ma dokładność namiaru. |
|
boolean
|
hasElapsedRealtimeUncertaintyNanos() True, jeśli ta lokalizacja ma upływającą dokładność w czasie rzeczywistym. |
|
boolean
|
hasSpeed() True, jeśli ta lokalizacja ma prędkość. |
|
boolean
|
hasSpeedAccuracy() True, jeśli ta lokalizacja ma dokładność prędkości. |
|
boolean
|
hasVerticalAccuracy() True, jeśli ta lokalizacja ma dokładność pionową. |
|
int
|
hashCode() Zwraca wartość kodu skrótu dla obiektu. |
|
boolean
|
isFromMockProvider() Zwraca true, jeśli lokalizacja pochodzi od dostawcy próbnego. Ta metoda jest przestarzała na poziomie API 31. Zamiast tego preferuj metodę isMock(). |
|
boolean
|
isMock() Zwraca wartość true, jeśli ta lokalizacja jest oznaczona jako fikcyjna lokalizacja. |
|
void
|
removeAccuracy() Usuń dokładność poziomą z tej lokalizacji. Ta metoda jest przestarzała na 26 poziomie interfejsu API. Użyj nowego obiektu Location do aktualizacji lokalizacji. |
|
void
|
removeAltitude() Usuń wysokość z tej lokalizacji. Ta metoda jest przestarzała na 26 poziomie interfejsu API. Użyj nowego obiektu Location do aktualizacji lokalizacji. |
|
void
|
removeBearing() Usunąć ten kierunek z tego miejsca. Ta metoda jest przestarzała na 26 poziomie interfejsu API. Użyj nowego obiektu Location do aktualizacji lokalizacji. |
|
void
|
removeSpeed() Usuń prędkość z tej lokalizacji. Ta metoda jest przestarzała na 26 poziomie interfejsu API. Użyj nowego obiektu Location do aktualizacji lokalizacji. |
|
void
|
reset() Usuwa zawartość lokalizacji. |
|
void
|
set(Location l) Ustawia zawartość lokalizacji na wartości z podanej lokalizacji. |
|
void
|
setAccuracy(float horizontalAccuracy) Ustaw szacunkową dokładność poziomą tej lokalizacji, metry. |
|
void
|
setAltitude(double altitude) Ustaw wysokość w metrach powyżej elipsoidy odniesienia WGS 84. |
|
void
|
setBearing(float bearing) Ustaw kierunek w stopniach. |
|
void
|
setBearingAccuracyDegrees(float bearingAccuracyDegrees) Ustaw szacunkową dokładność namiaru tej lokalizacji, stopnie. |
|
void
|
setElapsedRealtimeNanos(long time) Ustaw czas tej poprawki, w czasie rzeczywistym, który upłynął od uruchomienia systemu. |
|
void
|
setElapsedRealtimeUncertaintyNanos(double time) Ustaw oszacowanie względnej precyzji wyrównania znacznika czasu ElapsedRealtimeNanos z zgłoszonymi pomiarami w nanosekundach (pewność 68%). |
|
void
|
setExtras(Bundle extras) Ustawia dodatkowe informacje związane z tą poprawką do danego pakietu. |
|
void
|
setLatitude(double latitude) Ustaw szerokość geograficzną w stopniach. |
|
void
|
setLongitude(double longitude) Ustaw długość geograficzną w stopniach. |
|
void
|
setMock(boolean mock) Ustawia, czy ta lokalizacja jest oznaczona jako symulowana lokalizacja. |
|
void
|
setProvider(String provider) Ustawia nazwę dostawcy, który wygenerował tę poprawkę. |
|
void
|
setSpeed(float speed) Ustaw prędkość w metrach/sekundę nad ziemią. |
|
void
|
setSpeedAccuracyMetersPerSecond(float speedAccuracyMeterPerSecond) Ustaw szacowaną dokładność prędkości tej lokalizacji, metry na sekundę. |
|
void
|
setTime(long time) Ustaw czas UTC tej poprawki w milisekundach od epoki (1 stycznia 1970 r.). |
|
void
|
setVerticalAccuracyMeters(float verticalAccuracyMeters) Ustaw szacunkową dokładność pionową tej lokalizacji, metry. |
|
String
|
toString() Zwraca ciąg reprezentujący obiekt. |
|
void
|
writeToParcel(Parcel parcel, int flags) Spłaszcz ten obiekt do Parcel. |
Metody dziedziczone:
Z klasy java.lang.Object |
||
Object
|
clone() |
|
boolean
|
equals(Object obj) Wskazuje, czy jakiś inny obiekt jest „równy” temu. |
|
void |
finalize() Wywoływana przez moduł odśmiecania pamięci na obiekcie, gdy wyrzucanie elementów bezużytecznych określa, że nie ma więcej odniesień do obiektu. Podklasa zastępuje metodę finalize, aby pozbyć się zasobów systemowych lub wykonać inne czyszczenie. |
|
final Class<?>
|
getClass() |
|
int
|
hashCode() Zwraca wartość kodu skrótu dla obiektu. |
|
final void
|
notify() Wybudza pojedynczy wątek, który czeka na monitorze tego obiektu. |
|
final void
|
notifyAll() Wybudza wszystkie wątki oczekujące na monitorze tego obiektu. |
|
String
|
toString() Zwraca ciąg reprezentujący obiekt. |
|
final void |
wait(long timeout, int nanos) Powoduje, że bieżący wątek czeka, aż inny wątek wywoła metodę notyfikacji() lub notyfikacjęAll() dla tego obiektu, lub jakiś inny wątek przerwie bieżący wątek lub upłynie określona ilość czasu rzeczywistego. |
|
final void
|
wait(long timeout) Powoduje, że bieżący wątek czeka, aż inny wątek wywoła metodę notyfikacji() lub notyfikacjęAll() dla tego obiektu, albo upłynie określony czas. |
|
final void
|
wait() Powoduje, że bieżący wątek czeka, aż inny wątek wywoła metodę notyfikacji() lub metodę notyfikacjiAll() dla tego obiektu. |
|
Z interfejsu android.os.Parcelable |
||
abstract int
|
describeContents() Opisz rodzaje specjalnych obiektów zawartych w zorganizowanej reprezentacji tej instancji Parcelable. |
|
abstract void
|
writeToParcel(Parcel dest, int flags) Spłaszcz ten obiekt do Paczki. |
Stałe:
FORMAT_DEGREES
public static final int FORMAT_DEGREES
Stała używana do określenia formatowania szerokości lub długości geograficznej w postaci „[+-]DDD.DDDDD, gdzie D oznacza stopnie.
Constant Value: 0 (0x00000000)
FORMAT_MINUTES
public static final int FORMAT_MINUTES
Stała używana do określenia formatowania szerokości lub długości geograficznej w postaci „[+-]DDD:MM.MMMMM”, gdzie D oznacza stopnie, a M oznacza minuty łuku (1 minuta = 1/60 stopnia).
Constant Value: 1 (0x00000001)
FORMAT_SECONDS
public static final int FORMAT_SECONDS
Stała używana do określenia formatowania szerokości lub długości geograficznej w postaci „DDD:MM:SS.SSSSS”, gdzie D oznacza stopnie, M oznacza minuty łuku, a S oznacza sekundy łuku (1 minuta = 1/60 stopnia, 1 sekunda = 1/3600 stopnia).
Constant Value: 2 (0x00000002)
Pola:
CREATOR
public static final Creator<Location> CREATOR
Konstruktorzy publiczni:
Location
public Location (String provider)
Konstruuje nową lokalizację z nazwanym dostawcą. Domyślnie wszystkie wartości są zerowe i nie ma żadnych wartości opcjonalnych.
Parametry Location: | ||
provider |
String: nazwa dostawcy lokalizacji skojarzona z tą lokalizacją Ta wartość może mieć wartość null. |
Location
public Location (Location l)
Skonstruuj nowy obiekt Location, który jest kopiowany z istniejącego.
Parametry Location: | ||
l |
Location: Ta wartość nie może być pusta. |
Metody publiczne:
bearingTo
public float bearingTo (Location dest)
Zwraca przybliżony namiar początkowy w stopniach na wschód od prawdziwej północy podczas podróży najkrótszą ścieżką między tą lokalizacją a daną lokalizacją. Najkrótsza ścieżka jest definiowana za pomocą elipsoidy WGS84. Lokalizacje, które są (prawie) antypodami, mogą dawać nic nie znaczące wyniki.
Parametry bearingTo: | ||
dest |
Location: lokalizacja docelowa Ta wartość nie może być pusta. |
Zwroty bearingTo: | ||
float |
namiar początkowy w stopniach |
convert
public static String convert (double coordinate, int outputType)
Konwertuje współrzędną szerokości/długości geograficznej na reprezentację String. OutputType wyjściowych musi być jednym z FORMAT_DEGREES, FORMAT_MINUTES lub FORMAT_SECONDS. Współrzędna musi być liczbą z zakresu od -180,0 do 180,0 włącznie. Ta konwersja jest wykonywana w metodzie, która jest zależna od domyślnych ustawień regionalnych, a więc nie ma gwarancji, że zostanie wykonana w obie strony z convert(java.lang.String).
Parametry convert: | ||
coordinate |
double | |
outputType |
int: Value is FORMAT_DEGREES, FORMAT_MINUTES, or FORMAT_SECONDS |
Zwroty convert: | ||
String |
This value cannot be null. |
Rzuty convert: | ||
IllegalArgumentException |
jeśli współrzędna jest mniejsza niż -180,0, większa niż 180,0 lub nie jest liczbą | |
IllegalArgumentException |
jeśli outputType nie jest rozpoznaną wartością |
convert
public static double convert (String coordinate)
Konwertuje String w jednym z formatów opisanych przez FORMAT_DEGREES, FORMAT_MINUTES lub FORMAT_SECONDS na double. Ta konwersja jest wykonywana w metodzie niezależnej od ustawień regionalnych, a więc nie ma gwarancji, że zostanie wykonana w obie strony z convert(double, int).
Parametry convert: | ||
coordinate |
String: Ta wartość nie może być pusta. |
Zwroty convert: | ||
double |
Rzuty convert: | ||
NullPointerException |
jeśli współrzędna ma wartość null | |
IllegalArgumentException |
jeśli współrzędna nie jest w jednym z poprawnych formatów |
describeContents
public int describeContents()
Opisz rodzaje specjalnych obiektów zawartych w zorganizowanej reprezentacji tej instancji Parcelable. Na przykład, jeśli obiekt będzie zawierał deskryptor pliku w danych wyjściowych writeToParcel(android.os.Parcel, int), wartość zwracana przez tę metodę musi zawierać bit CONTENTS_FILE_DESCRIPTOR.
Zwroty describeContents: | ||
int |
maska bitowa wskazująca zestaw specjalnych typów obiektów zorganizowanych przez tę instancję obiektu Parcelable. Wartość to 0 lub CONTENTS_FILE_DESCRIPTOR |
distanceBetween
public static void distanceBetween (double startLatitude,
double startLongitude,
double endLatitude,
double endLongitude,
float[] results)
Oblicza przybliżoną odległość w metrach między dwoma lokalizacjami oraz opcjonalnie początkowy i końcowy namiar najkrótszej drogi między nimi. Odległość i namiar definiuje się za pomocą elipsoidy WGS84. Obliczona odległość jest przechowywana w results[0]. Jeśli wyniki mają długość 2 lub większą, początkowy namiar jest przechowywany w results[1]. Jeśli wyniki mają długość 3 lub większą, ostateczny namiar jest przechowywany w results[2].
Parametry distanceBetween: | ||
startLatitude |
double: początkowa szerokość geograficzna | |
startLongitude |
double: długość początkowa | |
endLatitude |
double: końcowa szerokość geograficzna | |
endLongitude |
double: końcowa długość geograficzna | |
results |
float: tablica pływaków do przechowywania wyników |
Rzuty distanceBetween: | ||
IllegalArgumentException |
jeśli wyniki są zerowe lub mają długość < 1 |
distanceTo
public float distanceTo (Location dest)
Zwraca przybliżoną odległość w metrach między tą lokalizacją a podaną lokalizacją. Odległość jest definiowana za pomocą elipsoidy WGS84.
Parametry distanceTo: | ||
dest |
Location: lokalizacja docelowa Ta wartość nie może być pusta. |
Zwroty distanceTo: | ||
float |
przybliżona odległość w metrach |
dump
public void dump (Printer pw, String prefix)
Zrzuty lokalizacji.
Parametry dump: | ||
pw |
Printer: Ta wartość nie może być pusta. | |
prefix |
String: Ta wartość może być pusta. |
equals
public boolean equals (Object o)
Równość lokalizacji jest zapewniana głównie do celów testowych. Porównywanie lokalizacji pod kątem równości w produkcji może wskazywać na nieprawidłowe założenia i należy ich unikać, gdy tylko jest to możliwe.
Wskazuje, czy jakiś inny obiekt jest „równy” temu.
Metoda equals implementuje relację równoważności na odwołaniach do obiektów innych niż null:
- Jest to refleksyjne: dla każdej non-null wartości odniesienia x, x.equals(x) powinno zwrócić true.
- Jest symetryczny: dla dowolnych non-null wartości referencyjnych x i y, x.equals(y) powinno zwrócić true wtedy i tylko wtedy, gdy y.equals(x) zwraca true.
- Jest przechodnia: dla dowolnych non-null wartości odniesienia x, y i z, jeśli x.equals(y) zwraca true, a y.equals(z) zwraca true, to x.equals(z) powinno zwracać true.
- Jest spójny: dla dowolnych niezerowych wartości referencyjnych x i y, wielokrotne wywołania x.equals(y) konsekwentnie zwracają true lub konsekwentnie zwracają false, pod warunkiem, że żadna informacja użyta w porównaniach equals na obiektach nie zostanie zmodyfikowana.
- Dla każdej niezerowej wartości odniesienia x, x.equals(null) powinien zwrócić wartość false.
Metoda equals dla klasy Object implementuje najbardziej dyskryminującą możliwą relację równoważności na obiektach; oznacza to, że dla dowolnych non-null wartości referencyjnych x i y ta metoda zwraca wartość true wtedy i tylko wtedy, gdy x i y odnoszą się do tego samego obiektu (x == y ma wartość true).
Należy zauważyć, że generalnie konieczne jest przesłonięcie metody hashCode za każdym razem, gdy ta metoda zostanie przesłonięta, aby zachować ogólny kontrakt dla metody hashCode, który stwierdza, że równe obiekty muszą mieć takie same kody skrótu.
Parametry equals: | ||
o |
Object: Ta wartość może być pusta. |
Zwroty equals: | ||
boolean |
true, jeśli ten obiekt jest taki sam jak argument obiekt; false inaczej. |
getAccuracy
public float getAccuracy ()
Zwraca szacowany promień dokładności poziomej w metrach dla tej lokalizacji na 68 percentylu poziomu ufności. Oznacza to, że istnieje 68% prawdopodobieństwa, że prawdziwa lokalizacja urządzenia znajduje się w pewnej odległości od tej niepewności raportowanej lokalizacji. Innym sposobem ujmowania tego jest to, że jeśli wokół podanej lokalizacji zostanie narysowany okrąg o promieniu równym tej dokładności, istnieje 68% szans, że prawdziwa lokalizacja znajdzie się w tym okręgu. Ta wartość dokładności dotyczy tylko pozycjonowania poziomego, a nie pionowego.
Jest to prawidłowe tylko wtedy, gdy hasSpeed() ma wartość true. Wszystkie lokalizacje generowane przez LocationManager obejmują dokładność poziomą.
Zwroty getAccuracy: | ||
float |
dokładność pozioma tej lokalizacji |
getAltitude
public double getAltitude ()
Wysokość tej lokalizacji w metrach nad elipsoidą odniesienia WGS84.
Jest to prawidłowe tylko wtedy, gdy hasAltitude() ma wartość true.
Zwroty getAltitude: | ||
double |
wysokość tej lokalizacji |
getBearing
public float getBearing ()
Zwraca namiar w czasie tej lokalizacji w stopniach. Namiar jest poziomym kierunkiem ruchu tego urządzenia i nie ma związku z orientacją urządzenia. Gwarantuje się, że łożysko będzie w zakresie [0, 360).
Jest to prawidłowe tylko wtedy, gdy hasBearing() ma wartość true.
Zwroty getBearing: | ||
float |
namiar w momencie tej lokalizacji Wartość mieści się w zakresie od 0f do 360f włącznie |
getBearingAccuracyDegrees
public float getBearingAccuracyDegrees ()
Zwraca szacowaną dokładność namiaru w stopniach tej lokalizacji na 68. percentylu poziomu ufności. Oznacza to, że istnieje 68% prawdopodobieństwa, że namiar rzeczywisty w momencie tej lokalizacji mieści się w zakresie getBearing() ()} +/- ta niepewność.
Jest to prawidłowe tylko wtedy, gdy hasBearingAccuracy() ()} ma wartość true.
Zwroty getBearingAccuracyDegrees: | ||
float |
dokładność namiaru w stopniach tego położenia |
getElapsedRealtimeAgeMillis
public long getElapsedRealtimeAgeMillis (long referenceRealtimeMs)
Wygodna metoda, która zwraca wiek tej lokalizacji w odniesieniu do danego odniesienia, które upłynęło w czasie rzeczywistym.
Parametry getElapsedRealtimeAgeMillis: | ||
referenceRealtimeMs |
long: odniesienia w czasie rzeczywistym w milisekundach |
Zwroty getElapsedRealtimeAgeMillis: | ||
long |
wiek tej lokalizacji w milisekundach |
getElapsedRealtimeAgeMillis
public long getElapsedRealtimeAgeMillis ()
Wygodna metoda, która zwraca wiek tej lokalizacji w milisekundach w odniesieniu do bieżącego czasu rzeczywistego, który upłynął.
Zwroty getElapsedRealtimeAgeMillis: | ||
long |
wiek tej lokalizacji w milisekundach |
getElapsedRealtimeMillis
public long getElapsedRealtimeMillis ()
Zwróć czas tej poprawki w milisekundach czasu rzeczywistego, który upłynął od uruchomienia systemu.
Zwroty getElapsedRealtimeMillis: | ||
long |
upływ czasu rzeczywistego tej lokalizacji w milisekundach |
Zobacz też: getElapsedRealtimeNanos()
getElapsedRealtimeNanos
public long getElapsedRealtimeNanos ()
Zwróć czas tej poprawki w nanosekundach czasu rzeczywistego, który upłynął od uruchomienia systemu.
Tę wartość można porównać z SystemClock.elapsedRealtimeNanos(), aby wiarygodnie uporządkować lub porównać lokalizacje. Jest to niezawodne, ponieważ czas rzeczywisty, który upłynął, jest gwarantowany jako monotoniczny i nadal rośnie, nawet gdy system jest w głębokim uśpienia (w przeciwieństwie do getTime()). Jednak ponieważ czas rzeczywisty, który upłynął, odnosi się do rozruchu systemu, nie ma sensu używać tej wartości do porządkowania lub porównywania lokalizacji w różnych cyklach rozruchowych lub urządzeniach.
Wszystkie lokalizacje generowane przez LocationManager gwarantują, że mają ustawiony poprawny upływ czasu rzeczywistego.
Zwroty getElapsedRealtimeNanos: | ||
long |
upływ czasu rzeczywistego tej lokalizacji w nanosekundach |
getElapsedRealtimeUncertaintyNanos
public double getElapsedRealtimeUncertaintyNanos ()
Uzyskaj niepewność w nanosekundach dokładności funkcji getElapsedRealtimeNanos() na 68. percentylu poziomu ufności. Oznacza to, że istnieje 68% szans, że rzeczywisty czas, który upłynął dla tej lokalizacji, mieści się w zakresie getElapsedRealtimeNanos() +/- ta niepewność.
Jest to prawidłowe tylko wtedy, gdy hasElapsedRealtimeUncertaintyNanos() ma wartość true.
Zwroty getElapsedRealtimeUncertaintyNanos: | ||
double |
niepewność w nanosekundach upływającego czasu rzeczywistego tej lokalizacji |
getExtras
public Bundle getExtras ()
Zwraca opcjonalny pakiet dodatkowych informacji skojarzonych z tą lokalizacją. Klucze i wartości w pakiecie są określane przez dostawcę lokalizacji.
Poniżej wymieniono typowe pary klucz/wartość. Nie ma gwarancji, że te pary klucz/wartość będą obecne w dowolnej lokalizacji.
satelity - liczba satelitów wykorzystanych do ustalenia pozycji GNSS
Zwroty getExtras: | ||
Bundle |
Ta wartość może być pusta |
getLatitude
public double getLatitude ()
Podaj szerokość geograficzną w stopniach. Wszystkie lokalizacje generowane przez LocationManager będą miały prawidłową szerokość geograficzną.
Zwroty getLatitude: | ||
double |
szerokość geograficzna tej lokalizacji |
getLongitude
public double getLongitude ()
Uzyskaj długość geograficzną w stopniach. Wszystkie lokalizacje generowane przez LocationManager będą miały prawidłową długość geograficzną.
Zwroty getLongitude: | ||
double |
długość geograficzna tej lokalizacji |
getProvider
public String getProvider ()
Zwraca nazwę dostawcy powiązanego z tą lokalizacją.
Zwroty getProvider: | ||
String |
nazwa dostawcy Ta wartość może być pusta |
getSpeed
public float getSpeed ()
Zwraca prędkość w czasie tej lokalizacji w metrach na sekundę. Zwróć uwagę, że zwrócona tutaj prędkość może być dokładniejsza niż uzyskana po prostu przez obliczenie distance / time dla pozycji sekwencyjnych, na przykład w przypadku uwzględnienia pomiarów Dopplera z satelitów GNSS.
Jest to prawidłowe tylko wtedy, gdy hasSpeed() ma wartość true.
Zwroty getSpeed: | ||
float |
prędkość w czasie tej lokalizacji |
getSpeedAccuracyMetersPerSecond
public float getSpeedAccuracyMetersPerSecond ()
Zwraca szacowaną dokładność prędkości w metrach na sekundę dla tej lokalizacji na 68. percentylu poziomu ufności. Oznacza to, że istnieje 68% szans, że rzeczywista prędkość w tej lokalizacji mieści się w zakresie getSpeed() ()} +/- ta niepewność.
Jest to prawidłowe tylko wtedy, gdy hasSpeedAccuracy() ma wartość true.
Zwroty getSpeedAccuracyMetersPerSecond: | ||
float |
dokładność pionowa tej lokalizacji |
getTime
public long getTime ()
Zwróć czas UTC tej poprawki lokalizacji w milisekundach od epoki (1 stycznia 1970).
Nie ma gwarancji, że różne lokalizacje mają czas ustawiony na ten sam zegar. Lokalizacje wyprowadzone z LocationManager#GPS_PROVIDER gwarantują, że ich czas będzie ustawiony na podstawie zegara używanego przez konstelację satelity, która dostarczyła poprawkę. Lokalizacje pochodzące od innych dostawców mogą używać dowolnego zegara do ustawiania czasu, chociaż najczęściej używany jest zegar urządzenia (który może być nieprawidłowy).
Zauważ, że czas UTC zegara urządzenia nie jest monotoniczny; może przeskakiwać do przodu lub do tyłu w sposób nieprzewidywalny i może być zmieniany w dowolnym momencie przez użytkownika, więc ten czas nie powinien być wykorzystywany do zamawiania lub porównywania lokalizacji. W tym celu preferuj getElapsedRealtimeNanos(), ponieważ ten zegar jest gwarantowany jako monotoniczny.
Z drugiej strony ta metoda może być przydatna do przedstawiania użytkownikowi czasu czytelnego dla człowieka lub jako heurystyka do porównywania poprawek lokalizacji podczas ponownego uruchamiania lub na różnych urządzeniach.
Wszystkie lokalizacje generowane przez LocationManager gwarantują ustawienie czasu UTC, jednak pamiętaj, że zegar urządzenia mógł się zmienić od czasu wygenerowania lokalizacji.
Zwroty getTime: | ||
long |
Czas UTC tej lokalizacji |
getVerticalAccuracyMeters
public float getVerticalAccuracyMeters ()
Zwraca szacowaną dokładność wysokości w metrach tej lokalizacji na 68. percentylu poziomu ufności. Oznacza to, że istnieje 68% szans, że rzeczywista wysokość tej lokalizacji mieści się w zakresie getAltitude() ()} +/- ta niepewność.
Jest to prawidłowe tylko wtedy, gdy hasVerticalAccuracy() ma wartość true.
Zwroty getVerticalAccuracyMeters: | ||
float |
dokładność pionowa tej lokalizacji |
hasAccuracy
public boolean hasAccuracy ()
Zwraca true, jeśli ta lokalizacja ma dokładność poziomą, w przeciwnym razie false.
Zwroty hasAccuracy: | ||
boolean |
hasAltitude
public boolean hasAltitude ()
Zwraca true, jeśli ta lokalizacja ma wysokość, w przeciwnym razie false.
Zwroty hasAltitude: | ||
boolean |
hasBearing
public boolean hasBearing ()
True, jeśli ta lokalizacja ma namiar, w przeciwnym razie false.
Zwroty hasBearing: | ||
boolean |
hasBearingAccuracy
public boolean hasBearingAccuracy ()
Zwraca true, jeśli ta lokalizacja ma dokładność namiaru, w przeciwnym razie false.
Zwroty hasBearingAccuracy: | ||
boolean |
hasElapsedRealtimeUncertaintyNanos
public boolean hasElapsedRealtimeUncertaintyNanos ()
True, jeśli ta lokalizacja ma upływającą niepewność w czasie rzeczywistym, w przeciwnym razie false.
Zwroty hasElapsedRealtimeUncertaintyNanos: | ||
boolean |
hasSpeed
public boolean hasSpeed ()
True, jeśli ta lokalizacja ma prędkość, w przeciwnym razie false.
Zwroty hasSpeed: | ||
boolean |
hasSpeedAccuracy
public boolean hasSpeedAccuracy ()
Zwraca true, jeśli ta lokalizacja ma dokładność prędkości, w przeciwnym razie false.
Zwroty hasSpeedAccuracy: | ||
boolean |
hasVerticalAccuracy
public boolean hasVerticalAccuracy ()
Zwraca true, jeśli ta lokalizacja ma dokładność pionową, w przeciwnym razie false.
Zwroty hasVerticalAccuracy: | ||
boolean |
hashCode
public int hashCode ()
Zwraca wartość kodu skrótu dla obiektu. Ta metoda jest obsługiwana z korzyścią dla tabel mieszających, takich jak te udostępniane przez HashMap.
Ogólna umowa hashCode to:
Za każdym razem, gdy jest wywoływana na tym samym obiekcie więcej niż raz podczas wykonywania aplikacji Java, metoda hashCode musi konsekwentnie zwracać tę samą liczbę całkowitą, pod warunkiem, że żadne informacje używane w porównaniach równości na obiekcie nie są modyfikowane. Ta liczba całkowita nie musi być spójna od jednego wykonania aplikacji do innego wykonania tej samej aplikacji.
Jeśli dwa obiekty są równe zgodnie z metodą equals(Object), wywołanie metody hashCode na każdym z dwóch obiektów musi dać ten sam wynik jako liczbę całkowitą.
Nie jest wymagane, że jeśli dwa obiekty są nierówne zgodnie z metodą equals(java.lang.Object), to wywołanie metody hashCode na każdym z tych dwóch obiektów musi dać różne wyniki w postaci liczb całkowitych. Jednak programista powinien mieć świadomość, że generowanie odrębnych wyników liczb całkowitych dla nierównych obiektów może poprawić wydajność tablic mieszających.
O ile jest to rozsądne, metoda hashCode zdefiniowana przez klasę Object zwraca różne liczby całkowite dla różnych obiektów. (Zazwyczaj jest to implementowane przez konwersję wewnętrznego adresu obiektu na liczbę całkowitą, ale ta technika implementacji nie jest wymagana przez język programowania Java™).
Zwroty hashCode: | ||
int |
Wartość kodu skrótu dla tego obiektu. |
isComplete
public boolean isComplete ()
Zwróć true, jeśli ta lokalizacja zostanie uznana za kompletną. Lokalizacja jest uważana za kompletną, jeśli ma dostawcę innego niż null, dokładność oraz niezerowy czas i czas rzeczywisty, który upłynął. Dokładna definicja kompletności może z czasem ulec zmianie.
Gwarantujemy, że wszystkie lokalizacje dostarczone przez LocationManager są kompletne.
Zwroty isComplete: | ||
boolean |
isFromMockProvider
public boolean isFromMockProvider ()
Dodano na poziomie API 18
Przestarzałe na poziomie API 31
Ta metoda została wycofana na poziomie API 31.
Zamiast tego preferuj isMock().
Zwraca true, jeśli lokalizacja pochodzi od dostawcy próbnego.
Zwroty isFromMockProvider: | ||
boolean |
true, jeśli ta lokalizacja pochodzi od pozornego dostawcy, w przeciwnym razie false |
isMock
public boolean isMock ()
Zwraca true, jeśli ta lokalizacja jest oznaczona jako lokalizacja pozorowana. Jeśli ta lokalizacja pochodzi z platformy Android, oznacza to, że lokalizacja została podana przez dostawcę lokalizacji testowej, a zatem może nie być powiązana z rzeczywistą lokalizacją urządzenia.
Zwroty isMock: | ||
boolean |
Zobacz też: LocationManager.addTestProvider(String, ProviderProperties)
removeAccuracy
public void removeAccuracy ()
Dodano w API poziomu 1
Przestarzałe na poziomie API 26
Usuń dokładność poziomą z tej lokalizacji.
removeAltitude
public void removeAltitude ()
Dodano w API poziomu 1
Przestarzałe na poziomie API 26
Usuwa wysokość z tej lokalizacji.
removeBearing
public void removeBearing ()
Dodano w API poziomu 1
Przestarzałe na poziomie API 26
Usuń kierunek z tego miejsca.
removeBearingAccuracy
public void removeBearingAccuracy ()
Usunąć dokładność namiaru z tej lokalizacji.
removeElapsedRealtimeUncertaintyNanos
public void removeElapsedRealtimeUncertaintyNanos ()
Usuwa z tej lokalizacji niepewność upływającą w czasie rzeczywistym.
removeSpeed
public void removeSpeed ()
Usuń prędkość z tej lokalizacji.
removeSpeedAccuracy
public void removeSpeedAccuracy ()
Usuń dokładność prędkości z tej lokalizacji.
removeVerticalAccuracy
public void removeVerticalAccuracy ()
Usuń dokładność pionową z tej lokalizacji.
reset
public void reset ()
Ustawia dostawcę na null, usuwa wszystkie pola opcjonalne i ustawia wartości wszystkich innych pól na zero.
set
public void set (Location l)
Zamienia tę lokalizację w kopię podanej lokalizacji.
Parametry set: | ||
l |
Location: Ta wartość nie może być null. |
setAccuracy
public void setAccuracy (float horizontalAccuracyMeters)
Ustaw dokładność poziomą w metrach tej lokalizacji.
Parametry setAccuracy: | ||
horizontalAccuracyMeters |
float: wysokość pozioma w metrach. |
setAltitude
public void setAltitude (double altitudeMeters)
Ustaw wysokość tej lokalizacji w metrach nad elipsoidą odniesienia WGS84.
Parametry setAltitude: | ||
altitudeMeters |
double: wysokość w metrach |
setBearing
public void setBearing (float bearingDegrees)
Ustaw namiar w stopniach na czas tego miejsca. Podane namiar zostanie przeliczone na zakres [0, 360).
Uwaga: przekazywanie bardzo wysokich lub niskich wartości zmiennoprzecinkowych do tej funkcji może dawać dziwne wyniki ze względu na zawiłości matematyki zmiennoprzecinkowej.
Parametry setBearing: | ||
bearingDegrees |
float: namiar w stopniach |
setBearingAccuracyDegrees
public void setBearingAccuracyDegrees (float bearingAccuracyDegrees)
Ustawić dokładność namiaru w stopniach tej lokalizacji.
Parametry setBearingAccuracyDegrees: | ||
bearingAccuracyDegrees |
float: dokładność namiaru w stopniach |
setElapsedRealtimeNanos
public void setElapsedRealtimeNanos (long elapsedRealtimeNs)
Ustaw czas tej lokalizacji w nanosekundach czasu rzeczywistego, który upłynął od uruchomienia systemu.
Parametry setElapsedRealtimeNanos: | ||
elapsedRealtimeNs |
long: upłynął w czasie rzeczywistym w nanosekundach |
setElapsedRealtimeUncertaintyNanos
public void setElapsedRealtimeUncertaintyNanos (double elapsedRealtimeUncertaintyNs)
Ustawia niepewność w nanosekundach dokładności znacznika czasu, który upłynął w czasie rzeczywistym na poziomie ufności 68%.
Parametry setElapsedRealtimeUncertaintyNanos: | ||
elapsedRealtimeUncertaintyNs |
double: niepewność w nanosekundach upływającego czasu rzeczywistego tej lokalizacji |
setExtras
public void setExtras (Bundle extras)
Ustawia dodatkowe informacje związane z tą poprawką do danego pakietu.
Zauważ, że przechowuje to kopię podanych dodatków, więc wszelkie zmiany w dodatkach po wywołaniu tej metody nie zostaną odzwierciedlone w pakiecie lokalizacji.
Parametry setExtras: | ||
extras |
Bundle: Ta wartość może być pusta. |
setLatitude
public void setLatitude (double latitudeDegrees)
Ustaw szerokość geograficzną tej lokalizacji.
Parametry setLatitude: | ||
latitudeDegrees |
double: szerokość geograficzna w stopniach. |
setLongitude
public void setLongitude (double longitudeDegrees)
Ustaw długość geograficzną tej lokalizacji.
Parametry setLongitude: | ||
longitudeDegrees |
double: długość geograficzna w stopniach. |
setMock
public void setMock (boolean mock)
Ustawia, czy ta lokalizacja jest oznaczona jako lokalizacja pozorowana.
Parametry setMock: | ||
mock |
boolean: |
setProvider
public void setProvider (String provider)
Ustawia nazwę dostawcy powiązanego z tą lokalizacją.
Parametry setProvider: | ||
provider |
String: nazwa dostawcy Ta wartość może być pusta. |
setSpeed
public void setSpeed (float speedMetersPerSecond)
Ustaw prędkość w tym miejscu w metrach na sekundę. Wolę nie ustawiać ujemnych prędkości.
Parametry setSpeed: | ||
speedMetersPerSecond |
float: prędkość w metrach na sekundę. |
setSpeedAccuracyMetersPerSecond
public void setSpeedAccuracyMetersPerSecond (float speedAccuracyMeterPerSecond)
Ustaw dokładność prędkości tej lokalizacji w metrach na sekundę.
Parametry setSpeedAccuracyMetersPerSecond: | ||
speedAccuracyMeterPerSecond |
float: dokładność prędkości w metrach na sekundę. |
setTime
public void setTime (long timeMs)
Ustaw czas UTC dla tej lokalizacji w milisekundach od epoki (1 stycznia 1970).
Parametry setTime: | ||
timeMs |
long: Czas UTC tej lokalizacji. |
setVerticalAccuracyMeters
public void setVerticalAccuracyMeters (float altitudeAccuracyMeters)
Ustaw dokładność wysokości tej lokalizacji w metrach.
Parametry setVerticalAccuracyMeters: | ||
altitudeAccuracyMeters |
float: dokładność wysokości w metrach. |
toString
public String toString ()
Zwraca ciąg reprezentujący obiekt. Ogólnie rzecz biorąc, metoda toString zwraca ciąg, który „tekstowo reprezentuje” ten obiekt. Wynik powinien być zwięzłym, ale pouczającym przedstawieniem, łatwym do odczytania przez osobę. Zaleca się, aby wszystkie podklasy przesłoniły tę metodę.
Metoda toString dla klasy Object zwraca ciąg znaków składający się z nazwy klasy, której instancją jest obiekt, znaku znaku „@” oraz szesnastkowej reprezentacji kodu skrótu obiektu bez znaku. Innymi słowy, ta metoda zwraca ciąg równy wartości:
getClass().getName() + '@' + Integer.toHexString(hashCode())
Zwroty toString: | ||
String |
Ta wartość nie może być pusta. |
writeToParcel
public void writeToParcel (Parcel parcel, int flags)
Spłaszcz ten obiekt do Paczki.
Parametry writeToParcel: | ||
parcel |
Parcel: Ta wartość nie może być pusta.. | |
flags |
int: Dodatkowe flagi określające, jak obiekt powinien być napisany. Może wynosić 0 lub Parcelable.PARCELABLE_WRITE_RETURN_VALUE. Wartość to 0 lub kombinacja Parcelable.PARCELABLE_WRITE_RETURN_VALUE i android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES. |