confirm_route
ChatGPTRecords the addresses and settings submitted by the Optimize button.
create_route
ChatGPTUse this when a user asks what order to visit delivery addresses, wants an efficient driving route between multiple stops, or wants a route they can open and share. Optimizes and saves one driving route with 1–20 delivery stops; returns the ordered stops, estimated duration, distance, and route links. Call this only after the user clicks Optimize in select_addresses, passing the confirmationToken it submitted. When the host supports a route map in chat, show the saved route using encodedPolyline and the returned stop coordinates in order. Preserve the returned stop roles and delivery numbers; do not number the start as a delivery. If the host cannot render the supplied geometry or encodedPolyline is empty, show the ordered stops and route link without claiming a map represents the saved route. Do not invent geometry or recalculate the route for presentation. Anyone with the returned link can view the addresses. Creates a new route on every call; do not retry automatically. Does not enforce delivery time windows; when stops include them, still plan the route and list them in ignoredFields. Not for package tracking, public transit, multiple drivers, or live-traffic estimates.
resolve_current_location
ChatGPTResolve coordinates obtained after the user clicks Use current location. Return the address to fill the starting location.
search_places
ChatGPTUse this when a user wants to plan deliveries, order driving stops, or optimize a multi-stop driving route and provides addresses or place names, including pasted spreadsheets, tables, CSV, or numbered lists. Resolve the start, delivery stops, and finish before calling create_route. Include the city and country when known; ask for missing location context. When a match is unclear, pass the returned candidates to select_addresses for clickable choices and flag location differences. Never invent place IDs. Not for general place recommendations, package tracking, or public-transit directions.
select_addresses
ChatGPTShow clickable address choices and route settings instead of asking users to type their selection. Always show this panel before route creation, including when every search has a clear match. First call search_places for each address, then pass those returned candidates and the original user input here. Group delivery addresses in one panel; missing start and finish appear as empty fields. Include unsupported spreadsheet fields in routeSettings.ignoredFields. Keep a stable unique id per input row. Explain material location differences in notice. Empty candidates let the user search again. Do not invent candidates. When the user clicks Optimize, the panel sends a confirmationToken for create_route. Clients without UI can use the returned candidates in conversation.
show_dispatch_options
ChatGPTShow a contextual Spoke Dispatch link only when the user explicitly asks for multiple drivers, for delivery time windows to be enforced, or for more than 20 delivery stops. A delivery window column or field in pasted stops is not such a request: plan the route with select_addresses and list the windows in ignoredFields instead. Do not truncate their stops. This only displays options; it does not transfer addresses or create a Dispatch account. Do not use for address errors, outages, or unsupported features not listed here.
confirm_route
ClaudeCalled by the address panel when the user clicks Optimize. Records the chosen addresses and route settings and returns the single-use confirmationToken that create_route takes. Not for direct model use.
create_route
ClaudeOptimizes and saves one driving route for one driver with 1–20 delivery stops, from the addresses and settings the user confirmed in the address panel. Use this when a user asks what order to visit delivery addresses, wants an efficient driving route between multiple stops, or wants a route they can open and share. Takes the single-use token the panel issues when the user clicks Optimize route. Returns the stops in optimized order, estimated duration and distance, the route geometry, and route links. Every call creates a new route, and anyone with the returned link can view its addresses. Does not enforce delivery time windows, and not for package tracking, public transit, multiple drivers, or live-traffic estimates.
resolve_current_location
ClaudeReturns the nearest address for coordinates from the Use current location button in the panel, to fill the start.
search_places
ClaudeFinds Google address suggestions, with place IDs, for one address or place name. Use this when a user wants to plan deliveries, order driving stops, or optimize a multi-stop driving route and provides addresses or place names, including pasted spreadsheets, tables, CSV, or numbered lists. Suggestions come from autocomplete and are not validated addresses. Not for general place recommendations, package tracking, or public-transit directions.
select_addresses
ClaudeShows a panel where the user picks a match for each address and sets the start, finish, time at each stop and distance unit. Takes each original address with its suggested matches; addresses without suggestions let the user search again in the panel. Missing start and finish appear as empty fields, and fields in routeSettings.ignoredFields are listed as not applied. Read-only: when the user clicks Optimize, the panel issues a single-use confirmation token for route creation.
show_dispatch_options
ClaudeShows a link to Spoke Dispatch, our route planner for teams, for needs this free planner does not cover: multiple drivers, enforced delivery time windows, or more than 20 delivery stops. Use this only when the user explicitly asks for one of those. It only displays the link; it does not transfer addresses or create a Dispatch account.