{"uid":"cap_WXdmIgNNqstCoXFv3AH1Y","slug":"netzhandwerker-route-matrix-0e55f160","name":"Netzhandwerker Route Matrix","description":"x402-Werkzeuge für autonome Agenten.","url":"https://tools.netzhandwerker.de/v1/route/matrix","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"mode":{"enum":["driving","walking","cycling"],"type":"string","default":"driving"},"points":{"type":"array","items":{"type":["string","object"]},"maxItems":25,"description":"Punkte fuer die volle Matrix, als Text oder als Objekt mit lat und lon"},"origins":{"type":"array","items":{"type":["string","object"]},"maxItems":25,"description":"Alternativ: Startpunkte"},"destinations":{"type":"array","items":{"type":["string","object"]},"maxItems":25,"description":"Alternativ: Zielpunkte"}}},"responseSchema":{"type":"json","example":{"mode":"driving","note":"Freie Streckendaten ohne Verkehrslage und ohne Zeitfenster.","cells":[{"to":"Lager Ost","from":"Gronau, Westfalen","to_index":2,"distance_m":71430,"duration_s":3402,"from_index":0,"distance_km":71.43,"duration_min":56.7}],"points":[{"lat":52.2117,"lon":7.0403,"label":"Gronau, Westfalen","matched":"Gronau (Westf.), Nordrhein-Westfalen","resolved_from":"geokodierung"},{"lat":51.9607,"lon":7.6261,"label":"Lager Ost","resolved_from":"koordinaten"}],"source":"osrm","totals":{"cells":9,"unreachable":0,"max_distance_km":71.43,"max_duration_min":56.7},"origins":["Gronau, Westfalen","Münster, Deutschland","Lager Ost"],"attribution":"Streckendaten: OSRM auf Basis von OpenStreetMap, Mitwirkende ODbL","destinations":["Gronau, Westfalen","Münster, Deutschland","Lager Ost"],"fallback_reason":null,"nearest_per_origin":{"Gronau, Westfalen":{"to":"Münster, Deutschland","distance_km":69.8,"duration_min":55.1}}}},"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_hWVopvOXpIaseY8kSCoXQ","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 a full distance/duration matrix between multiple origins and destinations using OSRM routing on OpenStreetMap data","exampleAgentPrompt":"Calculate a full driving distance and travel time matrix between our three depots — Gronau, Münster, and Lager Ost (coordinates 51.9607, 7.6261) — so I can see how long it takes to get from each depot to every other location.","exampleUseCases":[{"title":"Delivery depot coverage planning","prompt":"I have three warehouses in Gronau, Münster, and Dortmund, and five customer locations. Can you compute the full driving distance and duration matrix between all of them so I can figure out which warehouse is closest to each customer?"},{"title":"Field service technician dispatching","prompt":"We have technicians based in Hamburg, Bremen, and Hannover, and five job sites scattered around northern Germany. Calculate the travel time matrix for driving mode so I can assign each job to the nearest available technician."},{"title":"Cycling route comparison for courier fleet","prompt":"For our bike courier operation, compute a cycling distance and time matrix between our hub at 52.5200, 13.4050 and these five drop-off addresses in Berlin so we can estimate delivery times for each courier run."}],"resultDescription":"Returns a JSON object with a flat list of matrix cells each containing origin label, destination label, distance in meters, distance in km, duration in seconds, and duration in minutes; plus resolved coordinates and labels for each input point, totals (cell count, max distance, max duration, unreachable count), nearest destination per origin, routing source attribution, and a note about data limitations (no live traffic, no time windows).","failureModes":["Unresolvable address geocoding returns the point as unreachable","Exceeding 25 points per array returns a validation error","Invalid transport mode value (not driving/walking/cycling) returns an error","Network or OSRM backend timeout may return a 5xx error","Points in regions with poor OpenStreetMap coverage may produce inaccurate or missing routes"],"whenToPreferThis":"Use this endpoint when you need a full N×M matrix of road distances and travel times between multiple locations simultaneously, especially for logistics, dispatching, or coverage analysis. It is preferable to single-pair routing when you need to compare all combinations at once. Choose this over a simple geocoding API when actual routable distances (not straight-line) are required. The OSRM backbone provides fast, free-road routing without live traffic, making it suitable for planning and scheduling rather than real-time navigation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:43:39.017Z","isFirstParty":false}