{"uid":"cap_chCaHqE4YnuEFdvTsZGBU","slug":"vextorium-geo-distance-calculator-efc50f8b","name":"Vextorium Geo Distance Calculator","description":"Distance between two coordinates (Vincenty geodesic on WGS84 plus great-circle), in km, miles and nautical miles, initial bearing and compass direction, midpoint and estimated time on foot, by car and by plane.","url":"https://api.vextorium.com/v1/geo-distance?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"lat1":{"type":"number"},"lat2":{"type":"number"},"lon1":{"type":"number"},"lon2":{"type":"number"}}},"responseSchema":{"type":"json","example":{"note":"Straight-line distance, not by road.","method":"Vincenty WGS84","heading":"E","midpoint":{"lat":40.939351,"lon":-0.789164},"distance_km":506.3,"distance_miles":314.6,"estimated_time_h":{"car_80kmh":6.33,"plane_800kmh":1.13,"walking_5kmh":101.26},"spherical_distance_km":505.096,"distance_nautical_miles":273.38,"initial_bearing_degrees":75.75}},"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_VC2sXlHGFyul-KBy4oxnY","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates the straight-line geodesic distance between two geographic coordinates using the Vincenty WGS84 formula, returning distance in km, miles, and nautical miles, plus bearing, midpoint, and estimated travel times.","exampleAgentPrompt":"What's the straight-line distance between Madrid (40.4168° N, 3.7038° W) and Paris (48.8566° N, 2.3522° E)? Give me the result in kilometers and miles, and also tell me the bearing and estimated flight time.","exampleUseCases":[{"title":"Flight distance estimation for trip planning","prompt":"How far is it in a straight line from New York (40.7128° N, 74.0060° W) to London (51.5074° N, 0.1278° W), and roughly how long would a plane take to cover that distance?"},{"title":"Nautical navigation between two ports","prompt":"I need the geodesic distance in nautical miles between the port of Rotterdam (51.9225° N, 4.4792° E) and the port of Hamburg (53.5753° N, 9.9552° E), plus the initial bearing heading."},{"title":"Midpoint between two field survey sites","prompt":"Can you calculate the midpoint and straight-line distance in kilometers between survey site A at 34.0522° N, 118.2437° W and survey site B at 37.7749° N, 122.4194° W?"}],"resultDescription":"A JSON object containing the straight-line distance in kilometers, miles, spherical kilometers, and nautical miles; the compass heading (e.g. 'E'); the initial bearing in degrees; the geographic midpoint as a lat/lon pair; estimated travel times by car at 80 km/h, plane at 800 km/h, and walking at 5 km/h; and a note clarifying this is not a road distance.","failureModes":["Missing required parameters (lat1, lon1, lat2, lon2) returns a validation error","Out-of-range latitude/longitude values (lat outside -90 to 90, lon outside -180 to 180) may produce incorrect results or errors","Identical coordinates for both points returns zero distance","Non-numeric values for coordinates cause schema validation failure","Payment failure via x402 results in 402 response and no data returned"],"whenToPreferThis":"Choose this endpoint when you need a fast, precise geodesic distance computation between two coordinate pairs without routing or road network data. It is ideal for aviation, nautical, logistics, or survey applications where straight-line (great-circle) distance and bearing matter more than driving directions. Prefer this over map-routing APIs when you need Vincenty WGS84 accuracy, travel-time estimates across multiple modes, or nautical miles output in a single pay-per-call call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-15T12:37:32.353Z","isFirstParty":false,"canonicalSlug":"vextorium-geo-distance-calculator-efc50f8b"}