Get water and toilets on a course
ourpr_get_course_amenitiesPublic drinking water and toilets on the line of one course, each placed at the mile it sits at.
READ THIS LIMIT BEFORE YOU ANSWER. These come from OpenStreetMap: public taps and toilets somebody mapped near the route. It is a FREQUENCY difference, not a category one — a race day sets up many more stops than an ordinary day has. A mapped tap can also be seasonal, shut off or gone. Never present this as an aid-station plan, and never imply the count is guaranteed.
It answers the training question instead: if I run this course on an ordinary day, where can I drink?
Args:
slug (string): From ourpr_list_courses.
response_format ('markdown' | 'json'): Default 'markdown'.
Returns: { "slug": string, "name": string, "distance_mi": number, "source": string, "is_race_aid_station_list": false, "water_count": number, "toilet_count": number, "longest_gap_without_water_mi": number | null, "longest_gap_from_mi": number | null, "longest_gap_to_mi": number | null, "amenities": [{ "kind": string, "mi": number, "lat": number, "lng": number }], "page_url": string }
The longest gap counts the start and the finish as ends, so a course with one water stop at mile 3 of 6 reports a 3 mile gap, not 0.
Examples:
"Where can I refill on the Cowtown ultra?" -> slug="cowtown-ultra-marathon"
"How far do I go without water on Boston?" -> read longest_gap_without_water_mi
Do not use when: you want race-day aid stations. ourpr. does not hold those.
Error handling:
A course with no mapped amenity returns empty arrays and zero counts. That means none is mapped, not that none exists.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | Yes | The course's slug. | |
| response_format | No | Output format. 'markdown' reads well in a chat answer. 'json' carries every field for further computation. | markdown |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| slug | Yes | ||
| source | Yes | ||
| page_url | Yes | ||
| amenities | Yes | ||
| distance_mi | Yes | ||
| water_count | Yes | ||
| toilet_count | Yes | ||
| longest_gap_to_mi | Yes | ||
| longest_gap_from_mi | Yes | ||
| is_race_aid_station_list | Yes | Always false. These are public amenities, not race aid stations. | |
| longest_gap_without_water_mi | Yes |