{"uid":"cap_uNDVIyYrTFS32oU_ijgaV","slug":"citiview-routing-directions-api-93b7e62f","name":"Citiview Routing & Directions API","description":"Directions between places (addresses, names or lat,lon) with optional stops: distance in km and miles, travel time, and turn-by-turn steps for driving, trucks, cycling, walking or transit, avoiding tolls, highways or ferries; optional GeoJSON route line.","url":"https://agents.citiviewgroup.com/v1/route?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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":["from","to"],"properties":{"to":{"type":"string"},"via":{"type":"string","description":"Stops separated by |"},"from":{"type":"string"},"mode":{"type":"string","description":"drive (default), truck, bicycle, walk, transit, ..."},"avoid":{"type":"string","description":"tolls|highways|ferries"},"units":{"type":"string","description":"metric or imperial"},"geometry":{"type":"boolean","description":"true to include the route line"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BIxUuhSqpC2w4ABpzV4W-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns turn-by-turn driving, cycling, walking, truck, or transit directions between two or more places, with distance, travel time, and optional GeoJSON route geometry.","exampleAgentPrompt":"Can you get me driving directions from Chicago, IL to Milwaukee, WI avoiding tolls, and show me the distance in miles with turn-by-turn steps?","exampleUseCases":[{"title":"Multi-stop road trip planning","prompt":"I'm driving from Los Angeles to San Francisco and want to stop in Santa Barbara and San Luis Obispo along the way — can you get me the full driving route with distance and turn-by-turn directions?"},{"title":"Truck route avoiding highways","prompt":"I need a truck-safe route from Dallas, TX to Houston, TX that avoids highways and shows me the total distance in miles and estimated travel time."},{"title":"Cycling directions with route geometry","prompt":"Can you give me cycling directions from Brooklyn Bridge to Central Park in New York City, with the route line so I can display it on a map?"}],"resultDescription":"Returns the total distance in both kilometers and miles, estimated travel time, and a sequential list of turn-by-turn navigation steps. If geometry is requested, also includes a GeoJSON LineString representing the route path. Intermediate waypoints are supported via the 'via' parameter.","failureModes":["Unresolvable origin or destination address returns an error or empty result","Invalid travel mode value causes a bad request response","Unreachable route (e.g. island with no ferry without ferry option) may return no route found","Malformed coordinates or address strings may produce geocoding errors","Network timeout for very long or complex multi-stop routes"],"whenToPreferThis":"Choose this endpoint when you need turn-by-turn directions, route distance, or travel time between named places or coordinates, especially when travel mode (drive, truck, bike, walk, transit) or avoidance options (tolls, highways, ferries) matter. It is preferred over geocoding-only endpoints when routing and navigation logic is required, and over general mapping APIs when you need a structured step-by-step itinerary with distance in both metric and imperial units.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T06:48:37.941Z","isFirstParty":false,"canonicalSlug":"citiview-routing-directions-api-93b7e62f"}