Location Tool
Get GPS location from Android device.
How It Works
This skill provides instructions for the Location tool node. Connect the Location node to Zeenie's input-tools handle to enable location tracking.
location Tool
Get current GPS location from the Android device.
Schema Fields
| Field |
Type |
Required |
Description |
| action |
string |
Yes |
"status" - Get current location |
Actions
| Action |
Description |
status |
Get current GPS coordinates and location info |
Example
Get current location:
{
"action": "status"
}
Response Format
{
"success": true,
"service": "location",
"action": "status",
"data": {
"latitude": 37.7749,
"longitude": -122.4194,
"altitude": 10.5,
"accuracy": 15.0,
"speed": 0.0,
"bearing": 180.0,
"provider": "gps",
"timestamp": "2025-01-30T12:00:00Z"
}
}
Response Fields
| Field |
Type |
Description |
| latitude |
float |
Latitude in degrees |
| longitude |
float |
Longitude in degrees |
| altitude |
float |
Altitude in meters (if available) |
| accuracy |
float |
Horizontal accuracy in meters |
| speed |
float |
Speed in m/s (if moving) |
| bearing |
float |
Direction of travel in degrees |
| provider |
string |
"gps", "network", "fused" |
| timestamp |
string |
When location was obtained |
Error Response
{
"error": "Location not available - GPS may be disabled",
"service": "location",
"action": "status"
}
Accuracy Guide
| Accuracy (m) |
Quality |
Typical Source |
| < 5 |
Excellent |
GPS with clear sky |
| 5-15 |
Good |
GPS |
| 15-50 |
Fair |
Network/WiFi |
| 50-100 |
Poor |
Cell tower |
| > 100 |
Very Poor |
Coarse location |
Provider Types
| Provider |
Description |
| gps |
GPS satellites (most accurate outdoors) |
| network |
WiFi/Cell towers |
| fused |
Combined sources (Android Fused Location) |
Use Cases
| Use Case |
Description |
| Location tracking |
Get device position |
| Geofencing |
Check if in specific area |
| Speed monitoring |
Track movement speed |
| Navigation |
Get coordinates for routing |
Common Workflows
Share location via WhatsApp
- Get location from device
- Use
whatsapp_send with message_type="location"
- Pass latitude/longitude from location result
Location-based reminder
- Get current location
- Calculate distance to target
- Trigger reminder when near target
Track movement
- Periodically get location
- Store coordinates
- Calculate distance traveled
Integration with Other Tools
Send location to contact
1. location.status -> get lat/lng
2. whatsapp_send with:
- message_type: "location"
- latitude: <from location>
- longitude: <from location>
Find nearby places
1. location.status -> get lat/lng
2. nearby_places with:
- lat: <from location>
- lng: <from location>
- type: "restaurant"
Setup Requirements
- Connect the Location node to Zeenie's
input-tools handle
- Android device must be paired
- Location permission must be granted
- GPS/Location services must be enabled on device
zeenie-ai