{"uid":"cap_z5kJAlK018OiKe5Jwnasi","slug":"suverse-freight-gps-trip-telematics-analytics-ec6b2ba0","name":"SuVerse Freight — GPS Trip Telematics Analytics","description":"SuVerse Freight — GPS trip analytics (freight.trip_telematics)","url":"https://api.suverse.io/v1/freight/trip_telematics","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"pings":{"type":"array","items":{"type":"object","properties":{"lat":{"type":"number"},"lon":{"type":"number"},"speed":{"type":"number"},"timestamp":{"type":"string"},"fuelRateGph":{"type":"number"}}}},"options":{"type":"object","properties":{"fuel_price":{"type":"number"},"assumed_mpg":{"type":"number"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_N4XgoSeQ7fZ6LnwrqJIuE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes a sequence of GPS pings from a freight trip to compute distance, duration, fuel consumption, cost, and driving efficiency metrics.","exampleAgentPrompt":"Analyze this truck trip's GPS log for me — here are 45 pings with lat/lon, speed, timestamp, and fuel rate in GPH. Use a fuel price of $3.85 per gallon and an assumed 6.5 MPG, and give me the full trip summary including distance, duration, fuel burned, and total fuel cost.","exampleUseCases":[{"title":"Post-haul fuel cost reconciliation","prompt":"I just finished a load from Dallas to Memphis — here's my truck's GPS ping log with fuel rates. Use $3.90 per gallon and 6.2 MPG to calculate how much fuel I burned and what it cost me total."},{"title":"Driver efficiency scorecard","prompt":"Can you run this set of telematics pings through trip analytics? I want to see average speed, total mileage, and fuel efficiency for my driver's run yesterday so I can score their performance."},{"title":"Dispatch load profitability check","prompt":"I have the raw GPS and fuel rate data for a completed freight trip. Plug in $4.10 per gallon and 5.8 assumed MPG and tell me the total fuel spend so I can compare it against the rate confirmation for this load."}],"resultDescription":"Returns a structured telematics summary for the trip, including total distance traveled, trip duration, average and max speed, total fuel consumed, estimated fuel cost, and efficiency metrics derived from the GPS ping sequence and fuel parameters provided.","failureModes":["Empty or single-ping array returns insufficient data error","Missing or malformed timestamp fields cause processing failure","Unrealistic speed or fuel rate values may produce skewed results","Missing fuel_price or assumed_mpg falls back to defaults or returns partial metrics","Pings out of chronological order may cause incorrect duration/distance calculations"],"whenToPreferThis":"Choose this endpoint when you have raw GPS telemetry data (lat/lon/speed/timestamp/fuel rate) from a freight trip and need computed analytics like distance, fuel cost, and efficiency — especially within a freight operations or fleet management workflow already using the SuVerse Freight platform. Prefer this over manual calculations or generic mapping APIs when fuel economics are central to the output.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:44:32.648Z","isFirstParty":false}