{"uid":"cap_XUPULQrA92hIB4MxRd-Kt","slug":"karte-halowerk-trip-metrics-7fa38e2a","name":"Karte Halowerk Trip Metrics","description":"HALOWERK kartenwerk — bezahlte Endpunkte nach x402. Preise in USDC auf Base Mainnet.","url":"https://karte.halowerk.com/v1/trip-metrics?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"points":{"type":"array","items":{"type":"object","required":["lat","lon","time"],"properties":{"lat":{"type":"number","maximum":90,"minimum":-90,"description":"Latitude, WGS 84."},"lon":{"type":"number","maximum":180,"minimum":-180,"description":"Longitude, WGS 84."},"time":{"type":"string","maxLength":40,"minLength":4,"description":"ISO 8601 timestamp of the fix. Must not go backwards from one fix to the next."},"soc_percent":{"type":"number","maximum":100,"minimum":0,"description":"Battery state of charge at this fix, in percent. Optional, and may be present on only some fixes."}},"additionalProperties":false},"maxItems":5000,"minItems":2,"description":"The trace, in chronological order. At least two fixes."},"stop_min_s":{"type":"integer","default":120,"maximum":86400,"minimum":10,"description":"Minimum duration of standing time before it is reported as a stop."},"max_speed_kmh":{"type":"number","default":250,"maximum":400,"minimum":1,"description":"Plausibility limit. A segment implying more than this is rejected instead of summed."},"stop_speed_kmh":{"type":"number","default":2,"maximum":30,"minimum":0,"description":"At or below this speed a segment counts as standing."},"battery_capacity_kwh":{"type":"number","maximum":1000,"minimum":0.1,"description":"Usable battery capacity. Without it, energy is reported in percent of charge only, never in kWh."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_t7KAoHorNJuBsZ18r7JWQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes a GPS trace with timestamps to compute trip distance, moving/stopped time, individual stops, mean and max speed, and optional EV energy consumption per kilometre.","exampleAgentPrompt":"Analyze this GPS trace from our delivery van today — here are the 200 fixes with timestamps — and tell me the total distance covered, how long it was moving versus stopped, any stops longer than 2 minutes with their locations, and the average and top speed. The van's battery is 75 kWh, and I've included the state of charge at each point so I also want the energy used and consumption per km.","exampleUseCases":[{"title":"EV fleet daily trip report","prompt":"Here's today's GPS log for vehicle EV-07 — 350 fixes with timestamps and battery SoC at each point. The usable battery capacity is 60 kWh. Can you compute the total distance, moving vs idle time, all stops over 3 minutes with coordinates, mean and max speed, and how much energy it consumed per km?"},{"title":"Delivery route idle time audit","prompt":"I need to audit this morning's delivery route for our van. I have a trace of 180 GPS fixes with timestamps. Flag any stops that lasted more than 5 minutes, and give me the total stopped time versus driving time, and the distance covered."},{"title":"Long-haul driver rest stop analysis","prompt":"Can you parse this 8-hour truck GPS trace — about 1,200 fixes — and identify every stop that lasted at least 15 minutes, along with each stop's location and how long it lasted? Also give me total km driven, average speed, and max speed. Plausibility cap can stay at 120 km/h."}],"resultDescription":"Returns a structured summary including total distance in km, elapsed and moving duration in seconds, stopped duration, a list of stops each with lat/lon, start time, and duration, mean and maximum speed in km/h, and (when SoC data and battery capacity are provided) total energy consumed in kWh and efficiency in kWh/km or percent/km.","failureModes":["Fewer than 2 GPS fixes provided — rejected with validation error","Timestamps go backwards between consecutive fixes — rejected as invalid trace","A segment implies speed above max_speed_kmh threshold — that segment is excluded from totals","Missing required lat/lon/time fields on any fix — validation error","Battery capacity not supplied — energy reported in SoC percent only, not kWh","More than 5000 fixes submitted — rejected by maxItems constraint"],"whenToPreferThis":"Choose this endpoint when you have a raw GPS trace (ordered lat/lon/time fixes) and need structured trip analytics — especially for fleet telematics, EV energy accounting, or delivery operations where stop detection and distance accuracy matter. It is the right choice over generic mapping APIs when you need computed metrics like idle time, stop list, and consumption per km rather than just routing or geocoding.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T00:30:49.688Z","isFirstParty":false,"canonicalSlug":"karte-halowerk-trip-metrics-7fa38e2a"}