{"uid":"cap_uxfz178u1mDx_dKj8GpXS","slug":"spherical-route-great-circle-leg-bearings-7f52ce18","name":"Spherical Route Great-Circle Leg Bearings","description":"Compute spherical route lengths and each departure bearing.","url":"https://detect.halowerk.com/v1/F-TD2000-GEO-INDUSTRY-B001/spherical-route-great-circle-leg-bearings?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"artifact":{"type":"object","required":["sphereRoute"],"properties":{"sphereRoute":{"type":"object","required":["data","claim"],"properties":{"data":{"type":"object","required":["points","radius"],"properties":{"points":{"type":"array","items":{"type":"array","items":{"type":"number","maximum":1000000,"minimum":-1000000},"maxItems":2,"minItems":2},"maxItems":64,"minItems":2},"radius":{"type":"number","maximum":10000000,"minimum":1}},"additionalProperties":false},"claim":{}},"additionalProperties":false}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_A9mQ3PU8G_wUXfy24PkFC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes the great-circle arc length and initial departure bearing for each leg of a multi-point spherical route.","exampleAgentPrompt":"Calculate the great-circle leg lengths and departure bearings for a 4-stop route on a sphere of radius 6371 km, using waypoints [48.8566, 2.3522], [51.5074, -0.1278], [40.7128, -74.0060], and [35.6762, 139.6503].","exampleUseCases":[{"title":"Multi-city flight route analysis","prompt":"I have a 5-city flight itinerary through Paris, London, New York, Tokyo, and Sydney — can you compute the great-circle distance and initial departure bearing for each leg of that route, treating Earth as a sphere of radius 6371 km?"},{"title":"Maritime voyage leg planning","prompt":"Plan out the per-leg arc lengths and headings for a ship sailing from [51.5, 0.12] to [38.7, -9.14] to [35.9, 14.5] on a sphere of radius 6371 km so I can brief the navigator on each leg's bearing and distance."},{"title":"Satellite orbit segment metrics","prompt":"For a satellite passing over ground stations at [28.5, -80.6], [51.9, 15.5], and [35.7, 139.7], compute the arc length and departure bearing for each leg assuming a sphere of radius 6771 km — that's Earth's radius plus 400 km altitude."}],"resultDescription":"Returns an artifact containing per-leg great-circle arc lengths (in the same units as the input radius) and the initial departure bearing (in degrees) for each consecutive pair of waypoints along the route, along with a claim object for verification.","failureModes":["Fewer than 2 waypoints provided — minimum is 2 points to form at least one leg","Waypoint arrays with other than exactly 2 elements (not [lat, lon] pairs)","Radius outside allowed range (1 to 10,000,000) causes validation error","More than 64 waypoints submitted — exceeds maxItems limit","Coordinate values outside the allowed range (-1,000,000 to 1,000,000)","Missing required fields sphereRoute.data.points or sphereRoute.data.radius returns schema error","Payment failure or insufficient USDC balance returns 402"],"whenToPreferThis":"Choose this endpoint when you need precise great-circle leg-by-leg bearing and arc length decomposition for a multi-waypoint route on any sphere (Earth, other planetary bodies, or custom radius). Ideal when you need both distance and initial heading per segment in a single call, rather than just point-to-point distance. Well-suited for aviation, maritime, orbital, or geodesic planning workflows that handle sequences of 2–64 waypoints.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-04T06:40:48.223Z","isFirstParty":false,"canonicalSlug":"spherical-route-great-circle-leg-bearings-7f52ce18"}