Location API¶

Access GPS and network location services.

Methods¶

startLocating()¶

Start location updates.

startLocating(minUpdateTime=60000, minUpdateDistance=30, updateGnssStatus=False)

Parameters: - minUpdateTime (int): Minimum time between updates in milliseconds (default: 60000) - minUpdateDistance (float): Minimum distance for update in meters (default: 30) - updateGnssStatus (bool): Enable GNSS status updates (default: False)

stopLocating()¶

Stop location updates.

stopLocating()

readLocation()¶

Get last known location.

readLocation()

Returns: Location data dict

getLastKnownLocation()¶

Get cached location.

getLastKnownLocation()

Returns: Location from all providers

geocode()¶

Convert address to coordinates.

geocode(address, maxResults=1)

Location Provider Methods)¶

locationProviders()¶

Get available location providers on the phone.

locationProviders()

Returns: List of available provider names (e.g., ['gps', 'network'])

locationProviderEnabled()¶

Check if a specific location provider is enabled.

locationProviderEnabled(provider)

Parameters: - provider (str): Provider name (e.g., 'gps', 'network')

Returns: True if enabled, False otherwise

readGnssStatus()¶

Read Global Navigation Satellite System status (requires Android 8+).

readGnssStatus()

Returns: JSONArray containing GNSS satellite information

Usage Example¶

import androidhelper
import time

droid = androidhelper.Android()

# Start location updates
droid.startLocating(minUpdateTime=5000, minUpdateDistance=1, updateGnssStatus=False)

# Wait for fix
time.sleep(10)

# Get location
loc = droid.readLocation().result
if loc:
    lat = loc['latitude']
    lon = loc['longitude']
    print(f"Location: {lat}, {lon}")

droid.stopLocating()