Route Intents

ROUTE

Start a previously saved route by name.

Action: theappninjas.gpsjoystick.ROUTE Tier: Free

Extras

Extra	Type	Required	Description
name	String	Yes	Name of the saved route (case-sensitive)

Tasker Example

1. Create a new Task → Add Action → Misc → Send Intent
2. Set Action to theappninjas.gpsjoystick.ROUTE
3. Enter Extra: name:My Awesome Route
4. Set Target to Service

ADB Shell Example

adb shell am start-foreground-service \
  -a theappninjas.gpsjoystick.ROUTE \
  --es name "My Awesome Route"

---

WALK

Walk through a list of waypoints with optional speed and teleport-to-start.

Action: theappninjas.gpsjoystick.WALK Tier: Pro

Extras

Extra	Type	Required	Description
waypoints	String	Yes	Semicolon-separated lat,lng pairs: lat,lng;lat,lng;...
teleport	boolean	No	Teleport to first waypoint before walking (default: false)
speed	float	No	Walking speed in km/h

Tasker Example

1. Create a new Task → Add Action → Misc → Send Intent
2. Set Action to theappninjas.gpsjoystick.WALK
3. Enter Extra: waypoints:37.8095,-122.4101;37.8060,-122.4090
4. (Optional) Enter Extra: teleport:true
5. (Optional) Enter Extra: speed:15.0
6. Set Target to Service

ADB Shell Example

adb shell am start-foreground-service \
  -a theappninjas.gpsjoystick.WALK \
  --es waypoints "37.8095,-122.4101;37.8060,-122.4090" \
  --ez teleport true \
  --ef speed 15.0

Invalid or empty waypoint strings are silently ignored. Verify your waypoint format (lat,lng;lat,lng;...) before sending.

---

GENERATE

Generate a random or circular route from the current position and start walking it.

Action: theappninjas.gpsjoystick.GENERATE Tier: Pro

Extras

Extra	Type	Required	Description
mode	int	No	0 = random (default), 1 = circle
marker_count	int	No	Number of waypoints, 1-5000 (default: 10)
offset	float	No	Distance between points in meters (default: 50.0)

ADB Shell Example

# Generate a circular route with 20 waypoints, 100m apart
adb shell am start-foreground-service \
  -a theappninjas.gpsjoystick.GENERATE \
  --ei mode 1 \
  --ei marker_count 20 \
  --ef offset 100.0

---

Route Recording

Record a route by adding waypoints from the current position.

RECORD_START

Start recording a new route. The joystick must be running.

Action: theappninjas.gpsjoystick.RECORD_START Tier: Pro Extras: None

Error: Returns ALREADY_RECORDING if a recording is already in progress.

RECORD_ADD

Add the current position as a waypoint to the active recording.

Action: theappninjas.gpsjoystick.RECORD_ADD Tier: Pro Extras: None

Error: Returns NOT_RECORDING if no recording is active.

RECORD_STOP

Stop recording. Optionally save the recorded route.

Action: theappninjas.gpsjoystick.RECORD_STOP Tier: Pro

Extra	Type	Required	Description
name	String	No	Route name - if provided, saves the route. If omitted, the recording is cancelled and discarded.

Success broadcast: theappninjas.gpsjoystick.RECORD_SAVED with extras name (String) and point_count (int). Requires at least 2 recorded points.

Error: Returns SAVE_FAILED if fewer than 2 points were recorded.

Recording Example (ADB)

# Start recording
adb shell am start-foreground-service \
  -a theappninjas.gpsjoystick.RECORD_START

# Walk around, adding waypoints as you go
adb shell am start-foreground-service \
  -a theappninjas.gpsjoystick.RECORD_ADD

# Save the recording
adb shell am start-foreground-service \
  -a theappninjas.gpsjoystick.RECORD_STOP \
  --es name "My Recorded Route"