{"uid":"cap_sqOnp-L7mtRpA_-2ErN4I","slug":"geo402-great-circle-distance-33dd53f6","name":"geo402 Great-Circle Distance","description":"Pay-per-call geolocation utility for AI agents: geocoding, reverse geocoding, timezone lookup, and great-circle distance. No API key, no subscription — agents pay per request via x402 (Base/USDC) or MPP (Tempo/pathUSD).","url":"https://69.67.172.228.sslip.io/v1/distance","method":"GET","headers":{},"bodySchema":{"type":"object","required":["lat1","lat2","lon1","lon2"],"properties":{"lat1":{"type":"number","description":"Start latitude in decimal degrees."},"lat2":{"type":"number","description":"Destination latitude in decimal degrees."},"lon1":{"type":"number","description":"Start longitude in decimal degrees."},"lon2":{"type":"number","description":"Destination longitude in decimal degrees."},"unit":{"enum":["km","mi","m","nmi"],"type":"string","description":"Distance unit: kilometers, miles, meters, or nautical miles."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/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_848R0EahPWtdX3J3dYqVA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates the great-circle (shortest path) distance between two geographic coordinates, returning the result in the requested unit.","exampleAgentPrompt":"What is the great-circle distance in kilometers between the coordinates 40.7128, -74.0060 (New York City) and 51.5074, -0.1278 (London)?","exampleUseCases":[{"title":"Flight path distance estimation","prompt":"How far is it in kilometers from Sydney (coordinates -33.8688, 151.2093) to Tokyo (35.6762, 139.6503) as the crow flies? I want to estimate the flight distance for a route planning tool."},{"title":"Nearest warehouse distance check","prompt":"Can you calculate the straight-line distance in miles between my warehouse at 41.8781, -87.6298 in Chicago and a customer location at 29.7604, -95.3698 in Houston? I need to figure out which distribution center is closest."},{"title":"Delivery radius eligibility check","prompt":"I have a restaurant at coordinates 48.8566, 2.3522 in Paris and a customer at 48.9021, 2.4186 — can you tell me the great-circle distance between them in kilometers so I can check if they fall within our 10 km delivery zone?"}],"resultDescription":"Returns the computed great-circle (shortest spherical path) distance between the two provided coordinate pairs, expressed in the requested unit (e.g., kilometers or miles). The response is a numeric distance value along with the unit.","failureModes":["Missing required parameters (lat1, lat2, lon1, lon2) returns a 400 error","Invalid non-numeric coordinate values return a validation error","Coordinates out of valid range (latitude outside -90 to 90, longitude outside -180 to 180) may return an error","Payment not included or insufficient USDC returns a 402 Payment Required response","Invalid or unsupported unit string may return an error or default to a standard unit"],"whenToPreferThis":"Use this endpoint when you need a fast, pay-per-call great-circle distance computation between two GPS coordinate pairs without committing to a subscription or obtaining an API key. Ideal for AI agents that need occasional or on-demand geospatial distance calculations and support x402 or MPP micropayment protocols (Base/USDC or Tempo/pathUSD).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T23:25:33.066Z","isFirstParty":false}