{"uid":"cap_OD5Lqa2Tb3Uh9JaKmZR7m","slug":"halowerk-geo-distance-bearing-9abcb105","name":"Halowerk Geo Distance & Bearing","description":"Calculates WGS84 great-circle distance and initial bearing. Missing facts are returned as null and named in unavailable_fields where applicable. Derived values disclose their method; source-backed values disclose source, time window and age. ","url":"https://geo.halowerk.com/v1/distance-bearing","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"to":{"type":"object","required":["lat","lon"],"properties":{"lat":{"type":"number","maximum":90,"minimum":-90,"description":""},"lon":{"type":"number","maximum":180,"minimum":-180,"description":""}},"additionalProperties":false},"from":{"type":"object","required":["lat","lon"],"properties":{"lat":{"type":"number","maximum":90,"minimum":-90,"description":""},"lon":{"type":"number","maximum":180,"minimum":-180,"description":""}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VNX8Y26Aj2wnAOYUhoib8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates the WGS84 great-circle distance and initial bearing between two geographic coordinates","exampleAgentPrompt":"What's the great-circle distance and initial bearing from New York (40.7128°N, 74.0060°W) to London (51.5074°N, 0.1278°W)?","exampleUseCases":[{"title":"Flight path planning distance check","prompt":"Calculate the great-circle distance and initial bearing from Los Angeles (34.0522, -118.2437) to Tokyo (35.6762, 139.6503) so I can estimate the flight route."},{"title":"Drone delivery range estimation","prompt":"How far is it from our warehouse at 37.7749, -122.4194 to a delivery point at 37.3382, -121.8863, and what's the initial bearing? I need to check if it's within drone range."},{"title":"Ship navigation heading calculation","prompt":"Give me the WGS84 great-circle distance and initial compass bearing from Cape Town at -33.9249, 18.4241 to Sydney at -33.8688, 151.2093 for a voyage planning calculation."}],"resultDescription":"Returns the WGS84 great-circle distance between the two points and the initial bearing (azimuth) from the origin to the destination. Missing or uncomputable values are returned as null and listed in an unavailable_fields array. The response also discloses the computation method used for derived values.","failureModes":["Invalid latitude or longitude values outside allowed ranges (-90 to 90 for lat, -180 to 180 for lon)","Missing required 'from' or 'to' objects in the request body","Identical from/to coordinates may produce zero distance and undefined bearing","Antipodal points may result in undefined or null bearing, listed in unavailable_fields","Payment failure or insufficient USDC balance (x402 protocol rejection)"],"whenToPreferThis":"Use this endpoint when you need a precise WGS84 great-circle (geodesic) distance and/or initial bearing between two coordinate pairs on Earth's surface. Prefer it over simple Euclidean distance calculations when geographic accuracy matters, or over full routing APIs when you only need the straight-line distance and direction rather than road-based navigation. It is especially useful for aviation, maritime, drone range checking, and any geospatial proximity or heading calculation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:31:01.988Z","isFirstParty":false}