android.location class
public class Criteria
extends Object implements Parcelable
java.lang.Object
↳ android.location.Criteria
Klasa wskazująca kryteria aplikacji do wyboru dostawcy lokalizacji. Dostawców można zamawiać według dokładności, zużycia energii, możliwości zgłaszania wysokości, prędkości, namiaru i kosztów pieniężnych.
Stałe:
int
|
ACCURACY_COARSE Stała wskazująca przybliżone wymaganie dotyczące dokładności. |
|
int
|
ACCURACY_FINE Stała wskazująca na wymaganie dokładniejszej dokładności lokalizacji. |
|
int |
ACCURACY_HIGH Stała wskazująca na wymaganie wysokiej dokładności - może być używana do dokładności poziomej, wysokości, prędkości lub namiaru. |
|
int |
ACCURACY_LOW Stała wskazująca na niski wymóg dokładności lokalizacji — może być używana do określania dokładności w poziomie, wysokości, prędkości lub namiaru. |
|
int
|
ACCURACY_MEDIUM |
|
int
|
NO_REQUIREMENT Stała wskazująca, że aplikacja nie decyduje się na nałożenie wymagania na konkretną funkcję. |
|
int
|
POWER_HIGH Stała wskazująca na wysokie zapotrzebowanie na moc. |
|
int
|
POWER_LOW Stała wskazująca na niskie zapotrzebowanie na moc. |
|
int
|
POWER_MEDIUM Stała wskazująca na średnie zapotrzebowanie na moc. |
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<Criteria> |
CREATOR |
Konstruktorzy publiczni:
int
|
Criteria() Constructs a new Criteria object. |
|
int
|
Criteria(Criteria criteria) Constructs a new Criteria object that is a copy of the given criteria. |
Metody publiczne:
int
|
describeContents() Opisz rodzaje specjalnych obiektów zawartych w zorganizowanej reprezentacji tej instancji Parcelable. |
|
int
|
getAccuracy() Zwraca stałą wskazującą żądaną dokładność lokalizacji. |
|
int
|
getBearingAccuracy() Zwraca stałą wskazującą żądaną dokładność namiaru. |
|
int
|
getHorizontalAccuracy() Zwraca stałą wskazującą żądaną dokładność poziomą (szerokość i długość geograficzną). |
|
int
|
getPowerRequirement() Zwraca stałą wskazującą żądane maksymalne zapotrzebowanie na moc. |
|
int
|
getSpeedAccuracy() Zwraca stałą wskazującą żądaną dokładność prędkości. |
|
int
|
getVerticalAccuracy() Zwraca stałą wskazującą żądaną dokładność pionową (wysokość). |
|
boolean
|
isAltitudeRequired() Zwraca, czy dostawca musi podać informacje o wysokości. |
|
boolean
|
isBearingRequired() Zwraca, czy dostawca musi podać informacje o namiarze. |
|
boolean
|
isCostAllowed() Zwraca, czy dostawca może ponosić koszty pieniężne. |
|
boolean
|
isSpeedRequired() Zwraca, czy dostawca musi podać informacje o szybkości. |
|
void
|
setAccuracy(int accuracy) Wskazuje żądaną dokładność dla szerokości i długości geograficznej. |
|
void
|
setAltitudeRequired(boolean altitudeRequired) Wskazuje, czy dostawca musi podać informacje o wysokości. |
|
void
|
setBearingAccuracy(int accuracy) Wskazuje żądaną dokładność namiaru. |
|
void
|
setBearingRequired(boolean bearingRequired) Wskazuje, czy dostawca musi dostarczyć informacje o namiarze. |
|
void
|
setCostAllowed(boolean costAllowed) Wskazuje, czy dostawca może ponosić koszty pieniężne. |
|
void
|
setHorizontalAccuracy(int accuracy) Wskazuje żądaną dokładność poziomą (szerokość i długość geograficzną). |
|
void
|
setPowerRequirement(int powerRequirement) Wskazuje żądane maksymalne zapotrzebowanie na moc. |
|
void
|
setSpeedAccuracy(int accuracy) Wskazuje żądaną dokładność prędkości. |
|
void
|
setSpeedRequired(boolean speedRequired) Wskazuje, czy dostawca musi podać informacje o prędkości. |
|
void
|
setVerticalAccuracy(int accuracy) Wskazuje żądaną dokładność pionową (wysokość). |
|
String
|
toString() Zwraca ciąg reprezentujący obiekt. |
|
void
|
writeToParcel(Parcel parcel, int flags) Spłaszcz ten obiekt do Paczki. |
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:
ACCURACY_COARSE
public static final int ACCURACY_COARSE
Stała wskazująca przybliżone wymaganie dotyczące dokładności
Stała wartość: 2 (0x00000002)
Dodano w API poziomu 1
ACCURACY_FINE
public static final int ACCURACY_FINE
Stała wskazująca na wymaganie dokładniejszej dokładności lokalizacji.
Stała wartość: 1 (0x00000001)
Dodano w API poziomu 1
ACCURACY_HIGH
public static final int ACCURACY_HIGH
Stała wskazująca na wymaganie wysokiej dokładności - może być używana do dokładności poziomej, wysokości, prędkości lub namiaru. W przypadku pozycji poziomej i pionowej odpowiada to mniej więcej dokładności mniejszej niż 100 metrów.
Stała wartość: 3 (0x00000003)
Dodano w API poziomu 9
ACCURACY_LOW
public static final int ACCURACY_LOW
Stała wskazująca na niski wymóg dokładności lokalizacji - może być używana do określania dokładności w poziomie, wysokości, prędkości lub namiaru. Dla pozycji poziomej i pionowej odpowiada to mniej więcej dokładności większej niż 500 metrów.
Stała wartość: 1 (0x00000001)
Dodano w API poziomu 9
ACCURACY_MEDIUM
public static final int ACCURACY_MEDIUM
Stała wskazująca na wymaganie średniej dokładności - obecnie używana tylko do dokładności poziomej. W przypadku pozycji poziomej odpowiada to mniej więcej dokładności od 100 do 500 metrów.
Stała wartość: 2 (0x00000002)
Dodano w API poziomu 9
NO_REQUIREMENT
public static final int NO_REQUIREMENT
Stała wskazująca, że aplikacja nie decyduje się na nałożenie wymagania na konkretną funkcję.
Stała wartość: 0 (0x00000000)
Dodano w API poziomu 1
POWER_HIGH
public static final int POWER_HIGH
Stała wskazująca na wysokie zapotrzebowanie na moc.
Stała wartość: 3 (0x00000003)
Dodano w API poziomu 1
POWER_LOW
public static final int POWER_LOW
Stała wskazująca na niskie zapotrzebowanie na moc.
Stała wartość: 1 (0x00000001)
Dodano w API poziomu 1
POWER_MEDIUM
public static final int POWER_MEDIUM
Stała wskazująca na średnie zapotrzebowanie na moc.
Stała wartość: 2 (0x00000002)
Dodano w API poziomu 1
Pola:
CREATOR
public static final Creator<Criteria> CREATOR
Dodano w API poziomu 1
Konstruktorzy publiczni:
Criteria
public Criteria ()
Konstruuje nowy obiekt Criteria. Nowy obiekt nie będzie miał wymagań dotyczących dokładności, mocy ani czasu odpowiedzi; nie będzie wymagać wysokości, prędkości ani namiaru; i nie pozwoli na koszty pieniężne.
Dodano w API poziomu 1
Criteria
public Criteria (Criteria criteria)
Konstruuje nowy obiekt Criteria, który jest kopią podanych kryteriów.
Dodano w API poziomu 1
| Parametry | ||
criteria
|
Criteria |
|
Metody publiczne:
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.
Dodano w API poziomu 1
| Zwroty (Returns) | ||
int
|
maska bitowa wskazująca zestaw specjalnych typów obiektów zorganizowanych przez tę instancję obiektu Parcelable. Wartość to 0 lub CONTENTS_FILE_DESCRIPTOR |
|
getAccuracy
public int getAccuracy ()
Zwraca stałą wskazującą żądaną dokładność lokalizacji.
Dodano w API poziomu 1
| Zwroty (Returns) | ||
int
|
Wartość to NO_REQUIREMENT, ACCURACY_FINE lub ACCURACY_COARSE |
|
Zobacz też:
setAccuracy(int)
getBearingAccuracy
public int getBearingAccuracy ()
Zwraca stałą wskazującą żądaną dokładność namiaru lokalizacji.
Dodano w API poziomu 9
| Zwroty (Returns) | ||
int
|
Wartość to NO_REQUIREMENT, ACCURACY_LOW, ACCURACY_MEDIUM lub ACCURACY_HIGH |
|
Zobacz też:
setBearingAccuracy(int)
getHorizontalAccuracy
public int getHorizontalAccuracy ()
Zwraca stałą wskazującą żądaną dokładność poziomą (szerokość i długość geograficzną).
Dodano w API poziomu 9
| Zwroty (Returns) | ||
int
|
Wartość to NO_REQUIREMENT, ACCURACY_LOW, ACCURACY_MEDIUM lub ACCURACY_HIGH |
|
Zobacz też:
setHorizontalAccuracy(int)
getPowerRequirement
public int getPowerRequirement ()
Zwraca stałą wskazującą żądane maksymalne zapotrzebowanie na moc.
Dodano w API poziomu 1
| Zwroty (Returns) | ||
int
|
Wartość to NO_REQUIREMENT, POWER_LOW, POWER_MEDIUM lub POWER_HIGH |
|
Zobacz też:
setPowerRequirement(int)
getSpeedAccuracy
public int getSpeedAccuracy ()
Zwraca stałą wskazującą żądaną dokładność prędkości.
Dodano w API poziomu 9
| Zwroty (Returns) | ||
int
|
Wartość to NO_REQUIREMENT, ACCURACY_LOW, ACCURACY_MEDIUM lub ACCURACY_HIGH |
|
Zobacz też:
setSpeedAccuracy(int)
getVerticalAccuracy
public int getVerticalAccuracy ()
Zwraca stałą wskazującą żądaną dokładność pionową (wysokość).
Dodano w API poziomu 9
| Zwroty (Returns) | ||
int
|
Wartość to NO_REQUIREMENT, ACCURACY_LOW, ACCURACY_MEDIUM lub ACCURACY_HIGH |
|
Zobacz też:
setVerticalAccuracy(int)
isAltitudeRequired
public boolean isAltitudeRequired ()
Zwraca, czy dostawca musi podać informacje o wysokości.
Dodano w API poziomu 1
| Zwroty (Returns) | ||
boolean
|
|
|
Zobacz też:
setAltitudeRequired(boolean)
isBearingRequired
public boolean isBearingRequired ()
Zwraca, czy dostawca musi podać informacje o lokalizacji.
Dodano w API poziomu 1
| Zwroty (Returns) | ||
boolean
|
|
|
Zobacz też:
setBearingRequired(boolean)
isCostAllowed
public boolean isCostAllowed ()
Zwraca, czy dostawca może ponosić koszty pieniężne.
Dodano w API poziomu 1
| Zwroty (Returns) | ||
boolean
|
|
|
isSpeedRequired
public boolean isSpeedRequired ()
Zwraca, czy dostawca musi podać informacje o szybkości.
Dodano w API poziomu 1
| Zwroty (Returns) | ||
boolean
|
|
|
Zobacz też:
setSpeedRequired(boolean)
setAccuracy
public void setAccuracy (int accuracy)
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.
Dodano w API poziomu 1
| Parametry | ||
accuracy
|
int: Wartość to NO_REQUIREMENT, ACCURACY_FINE lub ACCURACY_COARSE |
|
| Rzuty | ||
IllegalArgumentException
|
jeśli dokładność nie jest jedną z obsługiwanych stałych |
|
setAltitudeRequired
public void setAltitudeRequired (boolean altitudeRequired)
Wskazuje, czy dostawca musi podać informacje o wysokości. Nie gwarantuje się, że wszystkie poprawki zawierają takie informacje.
Dodano w API poziomu 1
| Parametry | ||
altitudeRequired
|
boolean |
|
setBearingAccuracy
public void setBearingAccuracy (int accuracy)
Wskazuje żądaną dokładność lokalizacji kierunku. Dokładność może wynosić ACCURACY_LOW, ACCURACY_MEDIUM, ACCURACY_HIGH lub NO_REQUIREMENT. Bardziej dokładna lokalizacja może zużywać więcej energii i może potrwać dłużej.
Dodano w API poziomu 9
| Parametry | ||
accuracy
|
int: Value is NO_REQUIREMENT, ACCURACY_LOW, ACCURACY_MEDIUM, or ACCURACY_HIGH |
|
| Rzuty | ||
IllegalArgumentException
|
jeśli dokładność nie jest jedną z obsługiwanych stałych |
|
setBearingRequired
public void setBearingRequired (boolean bearingRequired)
Wskazuje, czy dostawca musi dostarczyć informacje o lokalizacjach kierunków. Nie gwarantuje się, że wszystkie poprawki zawierają takie informacje.
Dodano w API poziomu 1
| Parametry | ||
bearingRequired
|
boolean |
|
setCostAllowed
public void setCostAllowed (boolean costAllowed)
Wskazuje, czy dostawca może ponosić koszty pieniężne.
Dodano w API poziomu 1
| Parametry | ||
costAllowed
|
boolean |
|
setHorizontalAccuracy
public void setHorizontalAccuracy (int accuracy)
Wskazuje żądaną dokładność poziomą (szerokość i długość geograficzną). Dokładność może wynosić ACCURACY_LOW, ACCURACY_MEDIUM, ACCURACY_HIGH lub NO_REQUIREMENT. Bardziej dokładna lokalizacja może zużywać więcej energii i może potrwać dłużej.
Dodano w API poziomu 9
| Parametry | ||
accuracy
|
int: Wartość to NO_REQUIREMENT, ACCURACY_LOW, ACCURACY_MEDIUM lub ACCURACY_HIGH |
|
| Rzuty | ||
IllegalArgumentException
|
jeśli dokładność nie jest jedną z obsługiwanych stałych |
|
setPowerRequirement
public void setPowerRequirement (int powerRequirement)
Wskazuje żądane maksymalne zapotrzebowanie na moc. Parametrem zapotrzebowania na moc może być NO_REQUIREMENT, POWER_LOW, POWER_MEDIUM lub POWER_HIGH.
Dodano w API poziomu 1
| Parametry | ||
powerRequirement
|
int: Wartość to NO_REQUIREMENT, POWER_LOW, POWER_MEDIUM lub POWER_HIGH |
|
setSpeedAccuracy
public void setSpeedAccuracy (int accuracy)
Wskazuje żądaną dokładność prędkości. Dokładność może wynosić ACCURACY_LOW, ACCURACY_MEDIUM, ACCURACY_HIGH lub NO_REQUIREMENT. Bardziej dokładna lokalizacja może zużywać więcej energii i może potrwać dłużej.
Dodano w API poziomu 9
| Parametry | ||
accuracy
|
int: Wartość to NO_REQUIREMENT, ACCURACY_LOW, ACCURACY_MEDIUM lub ACCURACY_HIGH |
|
| Rzuty | ||
IllegalArgumentException
|
jeśli dokładność nie jest jedną z obsługiwanych stałych |
|
setSpeedRequired
public void setSpeedRequired (boolean speedRequired)
Wskazuje, czy dostawca musi podać informacje o prędkości. Nie gwarantuje się, że wszystkie poprawki zawierają takie informacje.
Dodano w API poziomu 1
| Parametry | ||
speedRequired
|
boolean |
|
setVerticalAccuracy
public void setVerticalAccuracy (int accuracy)
Wskazuje żądaną dokładność pionową (wysokość). Dokładność może wynosić ACCURACY_LOW, ACCURACY_MEDIUM, ACCURACY_HIGH lub NO_REQUIREMENT. Bardziej dokładna lokalizacja może zużywać więcej energii i może potrwać dłużej.
Dodano w API poziomu 9
| Parametry | ||
accuracy
|
int: Wartość to NO_REQUIREMENT, ACCURACY_LOW, ACCURACY_MEDIUM lub ACCURACY_HIGH |
|
| Rzuty | ||
IllegalArgumentException
|
jeśli dokładność nie jest jedną z obsługiwanych stałych |
|
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())
Dodano w API poziomu 1
| Zwroty (Returns) | ||
String
|
Ciąg znaków reprezentujący obiekt. |
|
writeToParcel
public void writeToParcel (Parcel parcel, int flags)
Spłaszcz ten obiekt do Parcel.
Dodano w API poziomu 1
| Parametry | ||
parcel
|
Parcel: Parcel, w której należy wpisać przedmiot. 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 |
|