Integrate GPS tracking and location services using our HTTP REST API. Perfect for web applications, server-side integrations, and general-purpose development.

📝 Register Approved Device

Register a new hardware device to the TripQube system. This is a public endpoint that does not require user authentication.

Request Body

{
  "device_id": "TRK-ABC-12345",
  "pin": "98765",
  "firmware_version": "2.1.0",
  "manufacturer": "TripQube Hardware"
}

Request Parameters

Success Response (200 OK)

{
  "success": true,
  "message": "Approved device registered successfully.",
  "device_id": "TRK-ABC-12345"
}

📍 Push Tracker Location

Push location data from your hardware device to update tracker position. Supports both single location updates and buffered batch updates for offline scenarios.

Single Location Update

{
  "device_id": "TRK-ABC-12345",
  "pin": "98765",
  "latitude": 37.7749,
  "longitude": -122.4194,
  "battery_level": 85,
  "timestamp": 1705012345000
}

Buffered Locations (Batch Update)

{
  "device_id": "TRK-ABC-12345",
  "pin": "98765",
  "location_buffer": [
    {
      "latitude": 37.7749,
      "longitude": -122.4194,
      "timestamp": 1705012345000,
      "speed": 15.5,
      "altitude": 50
    },
    {
      "latitude": 37.7750,
      "longitude": -122.4195,
      "timestamp": 1705012375000,
      "speed": 20.2,
      "altitude": 55
    }
  ],
  "battery_level": 84
}

Request Parameters

* Either (latitude AND longitude) OR location_buffer must be provided.

💻 Integration Examples

Python

Simple Python implementation for pushing location data via HTTP.

import requests
import time

DEVICE_ID = "TRK-ABC-12345"
PIN = "98765"
PUSH_URL = "https://pushtrackerlocation-3y3utatgia-uc.a.run.app"

def push_location(lat, lon, battery=None):
    payload = {
        "device_id": DEVICE_ID,
        "pin": PIN,
        "latitude": lat,
        "longitude": lon,
        "timestamp": int(time.time() * 1000)
    }
    
    if battery is not None:
        payload["battery_level"] = battery
    
    response = requests.post(PUSH_URL, json=payload)
    return response.json()

# Usage
result = push_location(37.7749, -122.4194, battery=85)
print(result)

JavaScript/Node.js

Example implementation for Node.js server applications.

const axios = require('axios');

const DEVICE_ID = 'TRK-ABC-12345';
const PIN = '98765';
const PUSH_URL = 'https://pushtrackerlocation-3y3utatgia-uc.a.run.app';

async function pushLocation(lat, lon, battery = null) {
  const payload = {
    device_id: DEVICE_ID,
    pin: PIN,
    latitude: lat,
    longitude: lon,
    timestamp: Date.now()
  };

  if (battery !== null) {
    payload.battery_level = battery;
  }

  const response = await axios.post(PUSH_URL, payload);
  return response.data;
}

// Usage
pushLocation(37.7749, -122.4194, 85)
  .then(result => console.log(result));

💬 Support & Resources

📡 Overview

Welcome to the TripQube Developer API Documentation. Our API allows you to integrate GPS tracking, location sharing, and real-time trip updates into your applications.

This documentation provides all the information you need to push location data from your GPS devices or applications to TripQube's tracking system.

🔑 Getting Started

To start pushing location data, you'll need:

• ✅ A valid tracker ID and tracker key (contact us for credentials)
• ✅ HTTPS-enabled GPS device or application
• ✅ Ability to make POST requests with JSON payloads

📋 API Parameters

* Either (latitude AND longitude) OR location_buffer must be provided.

💻 Integration Examples

Python

Simple Python implementation for pushing location data via HTTP.

import requests
import json
import time

# Configuration
TRACKER_ID = "your_tracker_id_here"
TRACKER_KEY = "your_tracker_key_here"
API_URL = "https://tripserver-hjf6a3ekha-el.a.run.app/tracker/location/push"

def push_location(latitude, longitude, altitude=None, speed=None, accuracy=None):
    """Push single location update to TripQube"""
    
    payload = {
        "tracker_id": TRACKER_ID,
        "tracker_key": TRACKER_KEY,
        "latitude": latitude,
        "longitude": longitude,
        "timestamp": int(time.time() * 1000)  # Current time in milliseconds
    }
    
    # Add optional parameters if provided
    if altitude is not None:
        payload["altitude"] = altitude
    if speed is not None:
        payload["speed"] = speed
    if accuracy is not None:
        payload["accuracy"] = accuracy
    
    try:
        response = requests.post(
            API_URL,
            json=payload,
            headers={"Content-Type": "application/json"}
        )
        
        if response.status_code == 200:
            print("✅ Location pushed successfully")
            return response.json()
        else:
            print(f"❌ Error: {response.status_code} - {response.text}")
            return None
    
    except Exception as e:
        print(f"❌ Exception occurred: {str(e)}")
        return None

# Example usage
if __name__ == "__main__":
    # Push a single location
    result = push_location(
        latitude=28.6139,
        longitude=77.2090,
        altitude=216,
        speed=15.5,
        accuracy=10
    )
    print(result)

JavaScript/Node.js

Example implementation for Node.js server applications.

const axios = require('axios');

// Configuration
const TRACKER_ID = 'your_tracker_id_here';
const TRACKER_KEY = 'your_tracker_key_here';
const API_URL = 'https://tripserver-hjf6a3ekha-el.a.run.app/tracker/location/push';

/**
 * Push single location update to TripQube
 */
async function pushLocation(latitude, longitude, options = {}) {
  const payload = {
    tracker_id: TRACKER_ID,
    tracker_key: TRACKER_KEY,
    latitude: latitude,
    longitude: longitude,
    timestamp: Date.now(), // Current time in milliseconds
    ...options // Include altitude, speed, accuracy, heading if provided
  };

  try {
    const response = await axios.post(API_URL, payload, {
      headers: {
        'Content-Type': 'application/json'
      }
    });

    console.log('✅ Location pushed successfully');
    return response.data;
  } catch (error) {
    console.error('❌ Error pushing location:', error.message);
    if (error.response) {
      console.error('Response:', error.response.data);
    }
    return null;
  }
}

// Example usage
(async () => {
  const result = await pushLocation(28.6139, 77.2090, {
    altitude: 216,
    speed: 15.5,
    accuracy: 10,
    heading: 90
  });
  console.log(result);
})();

💬 Support & Resources