# AgentsToolsHub Geo Distance Calculator

> AgentsToolsHub Geo Distance Calculator is a paid API for AI agents from agentstoolshub.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-17).

Computes great-circle (haversine) distance in km, miles, and nautical miles between two lat/lon points, plus initial bearing and geographic midpoint

## Facts

- Endpoint: GET https://agentstoolshub.com/api/v1/geo-time/distance-calculator?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentstoolshub-geo-distance-calculator-1367f056
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SzUcegziUu4-96shPeACf

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentstoolshub-geo-distance-calculator-1367f056
```

Example prompt: What is the great-circle distance in kilometers, miles, and nautical miles between New York City (40.7128, -74.0060) and London (51.5074, -0.1278), and what's the initial bearing and midpoint?

## When to prefer this

Choose this endpoint when you need deterministic, spherical-Earth great-circle distance calculations between two coordinate pairs in multiple units simultaneously (km, miles, nautical miles), along with bearing and midpoint — all in a single call. Prefer it over mapping APIs when you don't need routing or road distance, just pure geodesic geometry.

## Known failure modes

- Missing required query parameters (lat1, lon1, lat2, lon2) returns a 400 error
- Latitude values outside [-90, 90] or longitude values outside [-180, 180] may cause invalid results or errors
- Non-numeric coordinate values will cause a parameter validation error
- Payment failure or insufficient USDC balance may block the request under x402 protocol

## How this service works

Great-circle (haversine) distance between two latitude/longitude points in km, miles and nautical miles, plus initial bearing and the geographic midpoint. Deterministic spherical math on the IUGG mean Earth radius. Use this when an agent needs to great-circle distance and bearing between coordinates.

## Output

Returns the great-circle (haversine) distance between the two coordinates expressed in kilometers, miles, and nautical miles, along with the initial compass bearing (in degrees) from point 1 to point 2, and the geographic midpoint coordinates — all computed using deterministic spherical math on the IUGG mean Earth radius.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "lat1",
      "lon1",
      "lat2",
      "lon2"
     ],
     "properties": {
      "lat1": {
       "type": "number",
       "description": "Latitude 1"
      },
      "lat2": {
       "type": "number",
       "description": "Latitude 2"
      },
      "lon1": {
       "type": "number",
       "description": "Longitude 1"
      },
      "lon2": {
       "type": "number",
       "description": "Longitude 2"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentstoolshub-geo-distance-calculator-1367f056/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentstoolshub.com](https://www.zero.xyz/host/agentstoolshub.com/llms.txt)