Gets the current device location using GPS or network providers.

Usage #

package main

import (
    "fmt"
    t "github.com/hugmouse/gotermux"
)

func main() {
    locationRequest := t.TLocation{
        Provider: "gps",
        Request:  "once",
    }
    
    location := t.TermuxLocation(locationRequest)
    fmt.Printf("Latitude: %f, Longitude: %f\n", 
        location.Latitude, location.Longitude)
    fmt.Printf("Accuracy: %f meters\n", location.Accuracy)
}
Output: Latitude: 37.4219999, Longitude: -122.0840575 Accuracy: 10.0 meters

Parameters #

  • location TLocation - Location request configuration

Struct TLocation #

FieldTypeDescription
ProviderstringLocation provider (“gps”, “network”, etc.)
RequeststringRequest type (“once”, “updates”, etc.)

Return Value #

Returns TLocationResult containing location information.

Struct TLocationResult #

FieldTypeDescription
Latitudefloat64Latitude coordinate
Longitudefloat64Longitude coordinate
Altitudefloat64Altitude in meters
Accuracyfloat64Location accuracy in meters
Bearingfloat64Direction of travel in degrees
Speedfloat64Speed in meters per second
Timestampint64Unix timestamp of location fix
ProviderstringProvider used for location

Location Providers #

  • gps - GPS satellite positioning (more accurate, requires clear sky)
  • network - Network-based positioning (faster, works indoors)
  • passive - Use cached location from other apps

Request Types #

  • once - Get location once and return
  • updates - Get continuous location updates
Location access requires appropriate permissions. The device may prompt for location permission when first used.