{"uid":"cap_2mrXFCiV4Brxte-HPDgC8","slug":"geo-distance-haversine-4cdfb71d","name":"Geo Distance (Haversine)","description":"Great-circle distance between two lat/lon points (haversine formula). Returns km, mi or nm.","url":"https://x402.agentindex.world/geo/distance?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"lat1":{"type":"number","title":"Lat1","maximum":90,"minimum":-90},"lat2":{"type":"number","title":"Lat2","maximum":90,"minimum":-90},"lon1":{"type":"number","title":"Lon1","maximum":180,"minimum":-180},"lon2":{"type":"number","title":"Lon2","maximum":180,"minimum":-180},"unit":{"type":"string","title":"Unit","default":"km","pattern":"^(km|mi|nm)$"}}},"responseSchema":{"type":"json","example":{"unit":"km","distance":343.5577}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HZVDkFx9DQGf_cSBl9jui","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","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 distance between two geographic coordinates using the haversine formula, returning the result in km, miles, or nautical miles.","exampleAgentPrompt":"What's the great-circle distance in miles between 51.5074, -0.1278 (London) and 48.8566, 2.3522 (Paris)?","exampleUseCases":[{"title":"Flight distance estimation","prompt":"How far is it in kilometers from New York (40.7128, -74.0060) to Los Angeles (34.0522, -118.2437) as the crow flies?"},{"title":"Nautical route planning","prompt":"What's the great-circle distance in nautical miles between Sydney (−33.8688, 151.2093) and Auckland (−36.8485, 174.7633)?"},{"title":"Delivery radius check","prompt":"Calculate the straight-line distance in kilometers between my warehouse at 52.5200, 13.4050 and a customer location at 53.5511, 9.9937 — I need to see if they're within our 200 km delivery zone."}],"resultDescription":"A numeric distance value between the two specified coordinates expressed in the requested unit (km, mi, or nm), computed via the haversine great-circle formula.","failureModes":["Latitude out of range [-90, 90] returns a validation error","Longitude out of range [-180, 180] returns a validation error","Invalid unit string (not km, mi, or nm) returns a validation error","Missing required lat1/lon1/lat2/lon2 parameters causes a 422 error","Payment failure (insufficient USDC balance) returns 402 Payment Required"],"whenToPreferThis":"Choose this endpoint when you need a fast, cheap, single-call great-circle distance between two coordinate pairs without needing routing, road distances, or map tiles. Ideal for filtering, proximity checks, or any computation that only requires straight-line geographic distance.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T07:06:35.300Z","isFirstParty":false,"canonicalSlug":"geo-distance-haversine-4cdfb71d"}