ourpr_get_course_amenities

io.github.joeyaflores/ourpr-courses · Verify this server

Public 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.