LocationProvider
  public
  
  
  
  class
  LocationProvider
  
    extends Object
  
  
  
  
  
  
| java.lang.Object | |
| ↳ | android.location.LocationProvider | 
      This class was deprecated
      in API level 31.
    This class is incapable of representing unknown provider properties and may return
 incorrect results on the rare occasion when a provider's properties are unknown. Prefer using
 LocationManager.getProviderProperties(String) to retrieve ProviderProperties
 instead.
  
Information about the properties of a location provider.
Summary
Constants | |
|---|---|
int | 
        
          AVAILABLE
          This constant was deprecated in API level 29. Location provider statuses are no longer supported.  | 
    
int | 
        
          OUT_OF_SERVICE
          This constant was deprecated in API level 29. Location provider statuses are no longer supported.  | 
    
int | 
        
          TEMPORARILY_UNAVAILABLE
          This constant was deprecated in API level 29. Location provider statuses are no longer supported.  | 
    
Public methods | |
|---|---|
        
        
        
        
        
        int
     | 
  
    
      
      getAccuracy()
      
      
        Returns the rough accuracy of this provider, one of the ProviderProperties.ACCURACY_* constants.  | 
  
        
        
        
        
        
        String
     | 
  
    
      
      getName()
      
      
        Returns the name of this provider.  | 
  
        
        
        
        
        
        int
     | 
  
    
      
      getPowerRequirement()
      
      
        Returns the power requirement for this provider, one of the ProviderProperties.POWER_USAGE_* constants.  | 
  
        
        
        
        
        
        boolean
     | 
  
    
      
      hasMonetaryCost()
      
      
        Returns true if the use of this provider may result in a monetary charge to the user, false if use is free.  | 
  
        
        
        
        
        
        boolean
     | 
  
    
      
      meetsCriteria(Criteria criteria)
      
      
        Returns true if this provider meets the given criteria, false otherwise.  | 
  
        
        
        
        
        
        boolean
     | 
  
    
      
      requiresCell()
      
      
        Returns true if the provider requires access to an appropriate cellular network (e.g., to make use of cell tower IDs), false otherwise.  | 
  
        
        
        
        
        
        boolean
     | 
  
    
      
      requiresNetwork()
      
      
        Returns true if the provider requires access to a data network (e.g., the Internet), false otherwise.  | 
  
        
        
        
        
        
        boolean
     | 
  
    
      
      requiresSatellite()
      
      
        Returns true if the provider requires access to a satellite-based positioning system (e.g., GPS), false otherwise.  | 
  
        
        
        
        
        
        boolean
     | 
  
    
      
      supportsAltitude()
      
      
        Returns true if the provider is able to provide altitude information, false otherwise.  | 
  
        
        
        
        
        
        boolean
     | 
  
    
      
      supportsBearing()
      
      
        Returns true if the provider is able to provide bearing information, false otherwise.  | 
  
        
        
        
        
        
        boolean
     | 
  
    
      
      supportsSpeed()
      
      
        Returns true if the provider is able to provide speed information, false otherwise.  | 
  
Inherited methods | |
|---|---|
Constants
AVAILABLE
public static final int AVAILABLE
      This constant was deprecated
      in API level 29.
    Location provider statuses are no longer supported.
  
Constant Value: 2 (0x00000002)
OUT_OF_SERVICE
public static final int OUT_OF_SERVICE
      This constant was deprecated
      in API level 29.
    Location provider statuses are no longer supported.
  
Constant Value: 0 (0x00000000)
TEMPORARILY_UNAVAILABLE
public static final int TEMPORARILY_UNAVAILABLE
      This constant was deprecated
      in API level 29.
    Location provider statuses are no longer supported.
  
Constant Value: 1 (0x00000001)
Public methods
getAccuracy
public int getAccuracy ()
Returns the rough accuracy of this provider, one of the ProviderProperties.ACCURACY_* constants.
| Returns | |
|---|---|
int | 
        |
getName
public String getName ()
Returns the name of this provider.
| Returns | |
|---|---|
String | 
        |
getPowerRequirement
public int getPowerRequirement ()
Returns the power requirement for this provider, one of the ProviderProperties.POWER_USAGE_* constants.
| Returns | |
|---|---|
int | 
        |
hasMonetaryCost
public boolean hasMonetaryCost ()
Returns true if the use of this provider may result in a monetary charge to the user, false if use is free. It is up to each provider to give accurate information.
| Returns | |
|---|---|
boolean | 
        |
meetsCriteria
public boolean meetsCriteria (Criteria criteria)
Returns true if this provider meets the given criteria, false otherwise.
| Parameters | |
|---|---|
criteria | 
        
          Criteria  | 
      
| Returns | |
|---|---|
boolean | 
        |
requiresCell
public boolean requiresCell ()
Returns true if the provider requires access to an appropriate cellular network (e.g., to make use of cell tower IDs), false otherwise.
| Returns | |
|---|---|
boolean | 
        |
requiresNetwork
public boolean requiresNetwork ()
Returns true if the provider requires access to a data network (e.g., the Internet), false otherwise.
| Returns | |
|---|---|
boolean | 
        |
requiresSatellite
public boolean requiresSatellite ()
Returns true if the provider requires access to a satellite-based positioning system (e.g., GPS), false otherwise.
| Returns | |
|---|---|
boolean | 
        |
supportsAltitude
public boolean supportsAltitude ()
Returns true if the provider is able to provide altitude information, false otherwise. A provider that reports altitude under most circumstances but may occassionally not report it should return true.
| Returns | |
|---|---|
boolean | 
        |
supportsBearing
public boolean supportsBearing ()
Returns true if the provider is able to provide bearing information, false otherwise. A provider that reports bearing under most circumstances but may occassionally not report it should return true.
| Returns | |
|---|---|
boolean | 
        |
supportsSpeed
public boolean supportsSpeed ()
Returns true if the provider is able to provide speed information, false otherwise. A provider that reports speed under most circumstances but may occassionally not report it should return true.
| Returns | |
|---|---|
boolean | 
        |