{"uid":"cap_WEKCJipOAN1s7AoxNTLSJ","slug":"halowerk-robotic-path-clearance-calculator-f55c604d","name":"Halowerk Robotic Path Clearance Calculator","description":"Computes the minimum Euclidean distance from each circular obstacle center to every path segment, then subtracts obstacle radius and robot radius. It detects planar static clearance only; it does not model robot shape beyond a circle, dynamics, uncertainty or moving obstacles.","url":"https://iot.halowerk.com/v1/robotic-path-clearance","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"path":{"type":"array","items":{"type":"object","required":["x","y"],"properties":{"x":{"type":"number","maximum":1000000000,"minimum":-1000000000},"y":{"type":"number","maximum":1000000000,"minimum":-1000000000}},"additionalProperties":false},"maxItems":10000,"minItems":2},"obstacles":{"type":"array","items":{"type":"object","required":["id","x","y","radius"],"properties":{"x":{"type":"number","maximum":1000000000,"minimum":-1000000000},"y":{"type":"number","maximum":1000000000,"minimum":-1000000000},"id":{"type":"string","maxLength":128,"minLength":1},"radius":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":10000},"robot_radius":{"type":"number","maximum":1000000000,"minimum":0},"required_margin":{"type":"number","maximum":1000000000,"minimum":0}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3WRVRVKAwOP5iczNiVpXe","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes the minimum Euclidean clearance between each circular obstacle and every segment of a robot's planned path, accounting for both obstacle radius and robot radius.","exampleAgentPrompt":"Check if my robot path is clear of obstacles — the path goes through waypoints (0,0), (5,5), (10,0), and there's a circular obstacle at (5,3) with radius 1.5. My robot has a radius of 0.5 and I need at least 0.3 meters of clearance margin.","exampleUseCases":[{"title":"Warehouse robot aisle safety check","prompt":"I have a warehouse robot with radius 0.4 meters following a path through these waypoints: (0,0), (10,0), (10,20), (20,20). There are two shelving units modeled as circles — obstacle A at (10,5) with radius 1.2 and obstacle B at (10,15) with radius 1.2. Can you check the path clearance and tell me if we have at least 0.5 meters of safety margin?"},{"title":"Drone delivery path obstacle validation","prompt":"My delivery drone has a body radius of 0.8 meters and needs to fly a path through (0,0), (50,30), (100,60), (150,60). There are three trees in the way: tree1 at (50,32) radius 3, tree2 at (100,55) radius 2.5, tree3 at (140,60) radius 4. Calculate the clearance from each obstacle and check if we exceed the required 1-meter margin everywhere."},{"title":"Mobile robot corridor navigation check","prompt":"We're planning a route for a factory floor robot with 0.3 meter radius through points (0,0), (0,10), (5,10), (5,20). There are two pillars — pillar1 centered at (1,10) radius 0.6 and pillar2 at (4,10) radius 0.6. What's the minimum clearance we have from each pillar, and do we meet our required 0.2 meter safety margin?"}],"resultDescription":"Returns the computed clearance values (minimum Euclidean distance from obstacle center to nearest path segment, minus obstacle radius and robot radius) for each obstacle, along with pass/fail status against the required margin. Identifies which obstacles violate the margin threshold.","failureModes":["Path with fewer than 2 waypoints returns validation error","Obstacle radius or robot radius out of allowed range (0 to 1e9) returns 400","Path or obstacle arrays exceeding 10,000 items rejected","Missing required fields (x, y for waypoints; id, x, y, radius for obstacles) return schema validation errors","Obstacle ID strings exceeding 128 characters rejected"],"whenToPreferThis":"Use this endpoint when you need a fast, deterministic computation of static planar clearance between a robot path and circular obstacles. It is ideal for pre-flight or pre-execution path validation in 2D environments where obstacles are fixed circles and the robot can be approximated as a circle. It does not handle 3D environments, dynamic obstacles, non-circular robot shapes, uncertainty, or kinodynamic constraints — for those cases a full motion planning solver is needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:36:14.348Z","isFirstParty":false}