Maps

Geodesic bounding box & centroid API

Compute a geodesic bounding box two ways: from a center lat/lon + radius (km) with correct cos(lat) longitude shrinkage and approximate area, or from a list of points yielding the enclosing bbox, centroid, span in km and area — geodesic degree math an LLM cannot compute. Answers 'bounding box for a 10km radius around these coordinates', 'enclosing box for these points', 'centroid of a set of coordinates', 'how many degrees of longitude is 10km at this latitude'.

Price$0.01per request

MethodPOST

Route/v1/maps/bbox

StatusLive

MIME typeapplication/json

Rate limit60/minute

CacheNo cache

mapsbboxbounding-boxgeodesiccentroidradiusgeospatialhaversine

API URLhttps://x402.hexl.dev/v1/maps/bbox

Integration docs

Example request

{
  "latitude": 40.7128,
  "longitude": -74.006,
  "radiusKm": 10
}

Example response

{
  "mode": "radius",
  "center": {
    "latitude": 40.7128,
    "longitude": -74.006
  },
  "radiusKm": 10,
  "bbox": {
    "minLat": 40.62236282670429,
    "maxLat": 40.80323717329571,
    "minLon": -74.12451248567916,
    "maxLon": -73.88748751432084
  },
  "deltaDegrees": {
    "latitude": 0.090437,
    "longitude": 0.118512
  },
  "circleAreaKm2": 314.159,
  "boxAreaKm2": 400
}

Input schema

{
  "type": "object",
  "required": [],
  "properties": {
    "latitude": {
      "type": "number",
      "examples": [
        40.7128
      ]
    },
    "longitude": {
      "type": "number",
      "examples": [
        -74.006
      ]
    },
    "radiusKm": {
      "type": "number",
      "examples": [
        10
      ]
    },
    "points": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "latitude",
          "longitude"
        ],
        "properties": {
          "latitude": {
            "type": "number"
          },
          "longitude": {
            "type": "number"
          }
        }
      },
      "examples": [
        [
          {
            "latitude": 40,
            "longitude": -74
          },
          {
            "latitude": 41,
            "longitude": -73
          }
        ]
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}