pyxpo-location

Device location, compass heading and geocoding for pyxpo apps. The API follows expo-location. iOS uses Core Location. Android uses the platform LocationManager (no Google Play services), the accelerometer and magnetometer for the heading, and Geocoder for geocoding.

pip install pyxpo-location

[tool.pyxpo]
modules = ["location"]

# Optional: the text of the iOS permission prompts.
[tool.pyxpo.module_options.location]
locationWhenInUsePermission = "Show places near you."

import pyxpo_location as Location

perm = await Location.request_foreground_permissions_async()
if perm["granted"]:
    loc = await Location.get_current_position_async(accuracy=Location.Accuracy.HIGH)
    print(loc["coords"]["latitude"], loc["coords"]["longitude"])

sub = await Location.watch_position_async({"accuracy": Location.Accuracy.BALANCED, "distanceInterval": 10},
                                          lambda loc: print(loc["coords"]))
sub.remove()

places = await Location.reverse_geocode_async({"latitude": 48.8584, "longitude": 2.2945})

Functions

Accuracy runs from LOWEST (about 3 km) to BEST_FOR_NAVIGATION. camelCase names work too (getCurrentPositionAsync, {"distanceInterval": 10}).

Not supported yet

Background updates (start_location_updates_async) and geofencing (start_geofencing_async) need a background task manager, which pyxpo does not have yet. They raise NotSupportedError; is_background_location_available_async() returns False. Use watch_position_async while the app is open.

Platforms

iOS 15+ and Android 7+ (API 24). On desktop the functions raise NotSupportedError, except has_services_enabled_async(), which returns False.