Catalog/geo-bbox-from-radius

Geospatial

Bounding box from center + radius API

Builds the tightest tangent bounding box that contains a circle of given radius (km) around a center point, returning the bbox, the four corner coordinates and the diagonal length. Answers 'What bounding box covers a 10 km search radius?', 'What are the NE/SW corners around a center point?'.

Price$0.04per request
MethodPOST
Route/v1/geo/bbox-from-radius
StatusLive
MIME typeapplication/json
Rate limit120/minute
Cache0s public
geogisbboxbounding-boxradiuscirclesearch-areacornersgeofence
API URLhttps://x402.hexl.dev/v1/geo/bbox-from-radius
Integration docs
Example request
{
  "latitude": 51.5074,
  "longitude": -0.1278,
  "radiusKm": 10
}
Example response
{
  "center": {
    "latitude": 51.5074,
    "longitude": -0.1278
  },
  "radiusKm": 10,
  "bbox": {
    "minLat": 51.417468,
    "minLon": -0.272289,
    "maxLat": 51.597332,
    "maxLon": 0.016689
  },
  "corners": {
    "northWest": {
      "latitude": 51.597332,
      "longitude": -0.272289
    },
    "northEast": {
      "latitude": 51.597332,
      "longitude": 0.016689
    },
    "southWest": {
      "latitude": 51.417468,
      "longitude": -0.272289
    },
    "southEast": {
      "latitude": 51.417468,
      "longitude": 0.016689
    }
  },
  "diagonalKm": 28.284203,
  "interpretation": "Tangent bounding box for a 10 km radius around 51.5074, -0.1278 (the box just contains the circle)."
}
Input schema
{
  "type": "object",
  "required": [
    "latitude",
    "longitude",
    "radiusKm"
  ],
  "properties": {
    "latitude": {
      "type": "number",
      "examples": [
        51.5074
      ]
    },
    "longitude": {
      "type": "number",
      "examples": [
        -0.1278
      ]
    },
    "radiusKm": {
      "type": "number",
      "examples": [
        10
      ]
    }
  }
}
Output schema
{
  "type": "object",
  "additionalProperties": true
}