Cyclemate

Edit a route saved through this connection: restyle its page, rename it, change who can see it, move its stops, or make it a group ride. Send only what changes; everything omitted stays as it is. The theme is replaced whole, so read the route with get_route first and send its theme with the rider's changes. Returns the route as it now is.

update_route

Find a pub, cafe, shop, park or other venue by name inside a served city and get its coordinates and address. Pass near (the previous stop, or the ride's start) so the closest match ranks first. Returns one venue unless you ask for more. For an address or an area name use geocode instead.

find_place

Turn an address, street, postcode, neighbourhood or area name into coordinates inside a served city. For a business or venue by name use find_place instead. Results are approximate to the street; pass them straight to plan_ride.

geocode

The routes saved through this connection, newest first. Routes the rider made in the Cyclemate app or through another assistant are not listed.

list_routes

Turn coordinates into the nearest street, neighbourhood and city. Use it to describe a point back to the rider, or to check what a coordinate you were given actually is.

reverse_geocode

Plan a cycling route from an origin to a destination through up to eight stops, in order, using Cyclemate SuperSafe routing. Use geocode (an address or area) or find_place (a business or venue) for any coordinate you are not sure of; the planner snaps each to the nearest road. To start from wherever the rider is now, set from_current_location and give origin as your best estimate of their position (ask for a nearby street or landmark if you do not know it; never guess a city centre). Served cities: London, New York City, Los Angeles, Bay Area. Every place in one ride must be in the same city. Call once per ride with every stop. To end the ride at parking and walk the rest, set parking_type ("regular" for a public rack or stand, "ebike" for a rental e-bike bay in London, with the operator the rider's hire bike belongs to); the summary's `parking` then says where the bike is left and how far the walk is, or that nothing was found nearby. Returns the route options for the rider's own bike (distance, time, quiet share, each leg and the road it starts on); the bike-share and hire options for the same ride in `hire` (operator, time, walking and riding minutes, estimated fare, and the pickup and drop-off points with bikes or docks free); an "Open in Cyclemate" link to give the rider; and a map image.

plan_ride

One route saved through this connection: its page URL, privacy, theme, stops, distance and route_status (pending while the line is planned, then ready). Use it before editing a theme, or to check a route just saved is ready.

get_route

Save a ride as a custom route on the rider's Cyclemate account, with a page and a link to share. Pass the places in order (the start first, the end last, up to 25, all in one city), usually the places of a ride you just planned; Cyclemate plans the safest line between them. Style the page with a theme (font, colours, background, animation, stickers) when the rider describes a look. Give it a start time to make it a group ride riders can RSVP to. Returns the route's page URL and id; the line is planned in the background, so route_status is pending for a few seconds. The rider may save 10 routes a day.

save_route

The signed-in rider: display name, handle, saved city and units, whether they have Premium, and the cities Cyclemate routes in with a centre coordinate each. Call once at the start of a conversation.

whoami