Documentation

Documentation

Learn how to configure and use Truck GPS for your fleet. Guides for drivers, fleet managers, and developers.

Getting Started

Set up your first truck profile, input dimensions, and configure weight limits in under 5 minutes.

Routing Engine

Understand how our algorithm calculates routes based on vehicle constraints and live traffic data.

Hazmat Configuration

Instructions on setting up Hazmat classes and ensuring compliance with DOT regulations.

Fleet Management API

Integrate our routing engine into your existing telematics and dispatch platform with REST APIs.

Getting Started

Truck GPS is available as a free download on the App Store and Google Play. The basic plan is free forever. A Premium subscription ($9.99/month or $99.99/year) unlocks truck-safe routing, turn-by-turn navigation, and Hazmat features.

Installation

  1. Download the app from the App Store (iOS 15+) or Google Play (Android 8+). Search "Truck GPS by Fleetzio" or click the download links on our homepage.
  2. Create your account using your email address or sign in with Apple/Google. Your profiles and history sync across devices.
  3. Choose your plan — start with Basic (free) or unlock Premium for full truck-safe routing.
  4. Create your first truck profile — enter your vehicle's dimensions and you're ready to go.

Tip: Grant location permissions when prompted. Background location is required for accurate turn-by-turn navigation while the screen is off.

Creating a Truck Profile

A truck profile tells the routing engine about your specific vehicle. The more accurate your profile, the safer and more efficient your routes will be.

Required Fields

  • Vehicle Type — Select from 9 presets or create a custom profile
  • Height — Total height including trailer and any cargo (in feet/inches or meters)
  • Width — Total width including mirrors (standard is 8'6")
  • Length — Total combination length (truck + trailer)
  • Gross Vehicle Weight — Total weight of truck + trailer + cargo
  • Number of Axles — Used for bridge formula calculations

Optional Fields

  • Maximum curvature radius
  • Hazmat class (if applicable)
  • Trailer type (affects turning radius calculations)
  • Preferred route type (highways, fastest, safest)

How the Routing Engine Works

Truck GPS uses a modified Dijkstra shortest-path algorithm with multi-constraint filtering. Unlike car GPS systems that optimize only for time or distance, our engine applies your truck's physical constraints as hard filters before calculating the optimal path.

Data Sources

  • Bridge clearance data — sourced from FHWA's National Bridge Inventory, updated quarterly
  • Weight restriction data — state DOT databases, updated monthly
  • Road geometry — OpenStreetMap enhanced with truck-specific attributes
  • Traffic — real-time data from HERE Traffic APIs
  • Hazmat restrictions — PHMSA and state DOT hazmat databases

Route Calculation Steps

  1. Load active truck profile constraints (height, weight, width, length, axles)
  2. Remove all road segments that violate any constraint
  3. Apply Hazmat zone filters if applicable
  4. Run modified Dijkstra on the remaining graph to find the fastest valid path
  5. Validate final route against local seasonal restrictions

Hazmat Configuration

To enable Hazmat routing, open your truck profile and toggle "Hazmat Load" to ON. Then select the hazardous material class from the DOT classification system:

  • Class 1 — Explosives
  • Class 2 — Gases (flammable, non-flammable, toxic)
  • Class 3 — Flammable Liquids
  • Class 4 — Flammable Solids
  • Class 5 — Oxidizers & Organic Peroxides
  • Class 6 — Toxic & Infectious Substances
  • Class 7 — Radioactive Material
  • Class 8 — Corrosives
  • Class 9 — Miscellaneous Hazardous Materials

Important: Always verify routing with official permit documents. Truck GPS provides route guidance but is not a substitute for proper DOT permits and driver training.

Fleet Management API

Enterprise customers can integrate Truck GPS's routing engine into their existing telematics, TMS, or dispatch platform via our REST API. Contact our enterprise team for API credentials.

Base URL

https://api.fleetzio.app/v1

Calculate Route Endpoint

# POST /routes/calculate { "origin": { "lat": 40.7128, "lng": -74.0060 }, "destination": { "lat": 34.0522, "lng": -118.2437 }, "vehicle": { "height_ft": 13.5, "width_ft": 8.5, "length_ft": 75, "weight_lbs": 78000, "axles": 5, "hazmat_class": null } }

Authentication

All API requests require a Bearer token in the Authorization header. Enterprise API keys are available with your fleet subscription plan.

Authorization: Bearer your_api_key_here Content-Type: application/json

For enterprise pricing, API documentation, and onboarding support, contact our enterprise team.