signalk-server

<!DOCTYPE html><html class="default" lang="en" data-base="../../"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>Course API | Signal K</title><meta name="description" content="Documentation for Signal K"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="../../assets/style.css?cache=1767726585343"/><link rel="stylesheet" href="../../assets/highlight.css?cache=1767726585343"/><script defer src="../../assets/main.js?cache=1767726585343"></script><script async src="../../assets/icons.js?cache=1767726585343" id="tsd-icons-script"></script><script async src="../../assets/search.js?cache=1767726585343" id="tsd-search-script"></script><script async src="../../assets/navigation.js?cache=1767726585343" id="tsd-nav-script"></script><script async src="../../assets/hierarchy.js?cache=1767726585343" id="tsd-hierarchy-script"></script><link rel="stylesheet" href="../../assets/theme.css"/></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") || "os";document.body.style.display="none";setTimeout(() => window.app?app.showPage():document.body.style.removeProperty("display"),500)</script><header class="tsd-page-toolbar"><div class="tsd-toolbar-contents container"><a href="../../index.html" class="title"><img src="../../assets/logo.svg" alt="Signal K"/></a><button id="tsd-search-trigger" class="tsd-widget" aria-label="Search"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../../assets/icons.svg#icon-search"></use></svg>Search</button><dialog id="tsd-search" aria-label="Search"><input role="combobox" id="tsd-search-input" aria-controls="tsd-search-results" aria-autocomplete="list" aria-expanded="true" autocapitalize="off" autocomplete="off" placeholder="Search the docs" maxLength="100"/><ul role="listbox" id="tsd-search-results"></ul><div id="tsd-search-status" aria-live="polite" aria-atomic="true"><div>Preparing search index...</div></div></dialog><div id="tsd-toolbar-links"><a href="https://discord.gg/uuZrwz4dCS" target="_blank" rel="noopener" class="toolbar-icon visible@s" aria-label="Discord"><svg width="24" height="24" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 640 512"><path d="M524.5 69.8a1.5 1.5 0 0 0 -.8-.7A485.1 485.1 0 0 0 404.1 32a1.8 1.8 0 0 0 -1.9 .9 337.5 337.5 0 0 0 -14.9 30.6 447.8 447.8 0 0 0 -134.4 0 309.5 309.5 0 0 0 -15.1-30.6 1.9 1.9 0 0 0 -1.9-.9A483.7 483.7 0 0 0 116.1 69.1a1.7 1.7 0 0 0 -.8 .7C39.1 183.7 18.2 294.7 28.4 404.4a2 2 0 0 0 .8 1.4A487.7 487.7 0 0 0 176 479.9a1.9 1.9 0 0 0 2.1-.7A348.2 348.2 0 0 0 208.1 430.4a1.9 1.9 0 0 0 -1-2.6 321.2 321.2 0 0 1 -45.9-21.9 1.9 1.9 0 0 1 -.2-3.1c3.1-2.3 6.2-4.7 9.1-7.1a1.8 1.8 0 0 1 1.9-.3c96.2 43.9 200.4 43.9 295.5 0a1.8 1.8 0 0 1 1.9 .2c2.9 2.4 6 4.9 9.1 7.2a1.9 1.9 0 0 1 -.2 3.1 301.4 301.4 0 0 1 -45.9 21.8 1.9 1.9 0 0 0 -1 2.6 391.1 391.1 0 0 0 30 48.8 1.9 1.9 0 0 0 2.1 .7A486 486 0 0 0 610.7 405.7a1.9 1.9 0 0 0 .8-1.4C623.7 277.6 590.9 167.5 524.5 69.8zM222.5 337.6c-29 0-52.8-26.6-52.8-59.2S193.1 219.1 222.5 219.1c29.7 0 53.3 26.8 52.8 59.2C275.3 311 251.9 337.6 222.5 337.6zm195.4 0c-29 0-52.8-26.6-52.8-59.2S388.4 219.1 417.9 219.1c29.7 0 53.3 26.8 52.8 59.2C470.7 311 447.5 337.6 417.9 337.6z"></path></svg></a><a href="https://github.com/SignalK/signalk-server" target="_blank" rel="noopener" class="toolbar-icon visible@s" aria-label="Discord"><svg width="24" height="24" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3 .3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5 .3-6.2 2.3zm44.2-1.7c-2.9 .7-4.9 2.6-4.6 4.9 .3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3 .7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3 .3 2.9 2.3 3.9 1.6 1 3.6 .7 4.3-.7 .7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3 .7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3 .7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"></path></svg></a><a href="#" class="tsd-widget menu" id="tsd-toolbar-menu-trigger" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../../assets/icons.svg#icon-menu"></use></svg></a></div></div></header><div class="container container-main"><div class="col-content"><div class="tsd-page-title"><ul class="tsd-breadcrumb" aria-label="Breadcrumb"><li><a href="../../Developing.html">Developing</a></li><li><a href="../REST_APIs.html">REST APIs</a></li><li><a href="" aria-current="page">Course API</a></li></ul></div><div class="tsd-panel tsd-typography"><h1 id="course-api" class="tsd-anchor-link">Course API<a href="#course-api" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../../assets/icons.svg#icon-anchor"></use></svg></a></h1>The Course API provides common course operations under the path <code>/signalk/v2/api/vessels/self/navigation/course</code> ensuring that all related Signal K data model values are maintained and consistent. This provides a set of data that can be confidently used for course calculations and autopilot operation. Additionally, the Course API persists course information on the server to ensure data is not lost in the event of a server restart. Client applications use <code>HTTP</code> requests (<code>PUT</code>, <code>GET</code>,<code>DELETE</code>) to perform operations and retrieve course data. The Course API also listens for destination information in the NMEA stream and will set / clear the destination accordingly (e.g. NMEA0183 RMB sentence, NMEA2000 PGN 129284). See <a href="#Configuration">Configuration</a> for more details. Note: You can view the _Course API OpenAPI definition in the Admin UI (Documentation => OpenApi)._ <hr> <h2 id="setting-a-course" class="tsd-anchor-link">Setting a Course<a href="#setting-a-course" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../../assets/icons.svg#icon-anchor"></use></svg></a></h2>The Course API provides endpoints for: <ol> <li>Navigate to a location (lat, lon)</li> <li>Navigate to a waypoint (href to waypoint resource)</li> <li>Follow a Route (href to a route resource).</li> </ol> <h3 id="1-navigate-to-a-location" class="tsd-anchor-link">1. Navigate to a Location<a href="#1-navigate-to-a-location" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../../assets/icons.svg#icon-anchor"></use></svg></a></h3>To navigate to a point submit a HTTP <code>PUT</code> request to <code>/signalk/v2/api/vessels/self/navigation/course/destination</code> and supply the latitude & longitude of the destination point. <pre><code class="typescript">HTTP PUT 'http://hostname:3000/signalk/v2/api/vessels/self/navigation/course/destination' {"position": {"latitude": -60.5, "longitude": -166.7}} </code><button type="button">Copy</button></pre> <h3 id="2-navigate-to-a-waypoint" class="tsd-anchor-link">2. Navigate to a Waypoint<a href="#2-navigate-to-a-waypoint" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../../assets/icons.svg#icon-anchor"></use></svg></a></h3>To navigate to a point submit a HTTP <code>PUT</code> request to <code>/signalk/v2/api/vessels/self/navigation/course/destination</code> and supply a reference to a waypoint resource entry under <code>/resources/waypoints</code> <pre><code class="typescript">HTTP PUT 'http://hostname:3000/signalk/v2/api/vessels/self/navigation/course/destination' {"href": "/resources/waypoints/5242d307-fbe8-4c65-9059-1f9df1ee126f"} </code><button type="button">Copy</button></pre> <h3 id="3-follow-a-route" class="tsd-anchor-link">3. Follow a Route<a href="#3-follow-a-route" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../../assets/icons.svg#icon-anchor"></use></svg></a></h3>To follow a route submit a HTTP <code>PUT</code> request to <code>/signalk/v2/api/vessels/self/navigation/course/activeRoute</code> and supply a reference to a route resource entry under <code>/resources/routes</code>. <pre><code class="typescript">HTTP PUT 'http://hostname:3000/signalk/v2/api/vessels/self/navigation/course/activeRoute' {"href": "/resources/routes/5242d307-fbe8-4c65-9059-1f9df1ee126f"} </code><button type="button">Copy</button></pre> Additional parameters can be set when following a route including: <ul> <li>Defining the point along the route to start at</li> <li>The direction to follow the route (forward / reverse)</li> </ul> Example: Following a route in reverse direction: <pre><code class="typescript">HTTP PUT 'http://hostname:3000/signalk/v2/api/vessels/self/navigation/course/activeRoute' { "href": "/resources/routes/5242d307-fbe8-4c65-9059-1f9df1ee126f", "reverse": true } </code><button type="button">Copy</button></pre> <h4 id="advancing-along-a-route" class="tsd-anchor-link">Advancing along a Route<a href="#advancing-along-a-route" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../../assets/icons.svg#icon-anchor"></use></svg></a></h4>As progress along a route is made, you can use the following endpoints to update the destination. To set the destination to the next point along the route: <pre><code class="typescript">HTTP PUT 'http://hostname:3000/signalk/v2/api/vessels/self/navigation/course/activeRoute/nextPoint' </code><button type="button">Copy</button></pre> To advance the destination to a point <code>n</code> places beyond the current destination point, supply a positive number representing the number of points to advance: <pre><code class="typescript">HTTP PUT 'http://hostname:3000/signalk/v2/api/vessels/self/navigation/course/activeRoute/nextPoint' {"value": 2} </code><button type="button">Copy</button></pre> Sets destination to the point after the next in sequence. To set the destination to the previous point along the route: <pre><code class="typescript">HTTP PUT 'http://hostname:3000/signalk/v2/api/vessels/self/navigation/course/activeRoute/nextPoint' {"value": -1} </code><button type="button">Copy</button></pre> To set the destination to a point <code>n</code> places prior the current destination point, supply a negative number representing the number of points prior: <pre><code class="typescript">HTTP PUT 'http://hostname:3000/signalk/v2/api/vessels/self/navigation/course/activeRoute/nextPoint' {"value": -2} </code><button type="button">Copy</button></pre> Sets destination to the point two prior to the current destination. To set the destination to a specific point along the route, supply the zero-based index of the point: Example: 4th point along the route. <pre><code class="typescript">HTTP PUT 'http://hostname:3000/signalk/v2/api/vessels/self/navigation/course/activeRoute/pointIndex' {"value": 3} </code><button type="button">Copy</button></pre> Value contains the 'zero-based' index of the point along the route (i.e. 0 = 1st point, 1 = 2nd point, etc.) To reverse the direction along the route: <pre><code class="typescript">HTTP PUT 'http://hostname:3000/signalk/v2/api/vessels/self/navigation/course/activeRoute/reverse' </code><button type="button">Copy</button></pre> <h4 id="delta-messages" class="tsd-anchor-link">Delta Messages<a href="#delta-messages" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../../assets/icons.svg#icon-anchor"></use></svg></a></h4>The Course API emits delta messages with the following paths when course information has been changed. Note: Delta values reflect the relevant property of the Course Information data object as detailed in the <a href="#retrieving-course-information">Retrieving Course Information</a> section. <ul> <li><code>navigation.course.startTime</code></li> <li><code>navigation.course.targetArrivalTime</code></li> <li><code>navigation.course.arrivalCircle</code></li> <li><code>navigation.course.activeRoute</code></li> <li><code>navigation.course.nextPoint</code></li> <li><code>navigation.course.previousPoint</code></li> </ul> <h2 id="retrieving-course-information" class="tsd-anchor-link">Retrieving Course Information<a href="#retrieving-course-information" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../../assets/icons.svg#icon-anchor"></use></svg></a></h2>Course information is retrieved by submitting a HTTP <code>GET</code> request to <code>/signalk/v2/api/vessels/self/navigation/course</code>. <pre><code class="typescript">HTTP GET 'http://hostname:3000/signalk/v2/api/vessels/self/navigation/course' </code><button type="button">Copy</button></pre> The contents of the response will reflect the operation used to set the current course. The <code>nextPoint</code> & <code>previousPoint</code> sections will always contain values but <code>activeRoute</code> will only contain values when a route is being followed. <h4 id="1-operation-navigate-to-a-location-lat-lon" class="tsd-anchor-link">1. Operation: Navigate to a location (lat, lon)<a href="#1-operation-navigate-to-a-location-lat-lon" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../../assets/icons.svg#icon-anchor"></use></svg></a></h4>Example response: <pre><code class="JSON">{ "startTime": "2023-01-27T01:47:39.785Z", "targetArrivalTime": "2022-06-10T01:29:27.592Z", "arrivalCircle": 4000, "activeRoute": null, "nextPoint": { "type": "Location", "position": { "latitude": -34.92084502261776, "longitude": 131.54823303222656 } }, "previousPoint": { "type":"VesselPosition", "position": { "latitude": -34.82084502261776, "longitude": 131.04823303222656 } } } </code><button type="button">Copy</button></pre> <h4 id="2-operation-navigate-to-a-waypoint-href-to-waypoint-resource" class="tsd-anchor-link">2. Operation: Navigate to a waypoint (href to waypoint resource)<a href="#2-operation-navigate-to-a-waypoint-href-to-waypoint-resource" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../../assets/icons.svg#icon-anchor"></use></svg></a></h4>Example response: <pre><code class="JSON">{ "startTime": "2023-01-27T01:47:39.785Z", "targetArrivalTime": "2022-06-10T01:29:27.592Z", "arrivalCircle": 4000, "activeRoute": null, "nextPoint": { "href": "/resources/waypoints/f24d72e4-e04b-47b1-920f-66b78e7b033e", "type": "Waypoint", "position": { "latitude": -34.92084502261776, "longitude": 131.54823303222656 } }, "previousPoint": { "type":"VesselPosition", "position": { "latitude": -34.82084502261776, "longitude": 131.04823303222656 } } } </code><button type="button">Copy</button></pre> <h4 id="3-operation-follow-a-route-href-to-a-route-resource" class="tsd-anchor-link">3. Operation: Follow a Route (href to a route resource).<a href="#3-operation-follow-a-route-href-to-a-route-resource" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../../assets/icons.svg#icon-anchor"></use></svg></a></h4>Example response: <pre><code class="JSON">{ "startTime": "2023-01-27T01:47:39.785Z", "targetArrivalTime": "2022-06-10T01:29:27.592Z", "arrivalCircle": 1000, "activeRoute": { "href": "/resources/routes/e24d72e4-e04b-47b1-920f-66b78e7b0331", "pointIndex": 0, "pointTotal": 5, "reverse": false, "name": "my route", "waypoints": [ { "latitude": -34.92084502261776, "longitude": 131.54823303222656 }, { "latitude": -34.86621482446046, "longitude": 132.10166931152344, }, { "latitude": -34.6309479733581, "longitude": 132.23350524902344 }, { "latitude": -34.63546778783319, "longitude": 131.8867492675781 }, { "latitude": -34.71000915922492, "longitude": 131.82289123535156 } ] }, "nextPoint": { "type": "RoutePoint", "position": { "latitude": -34.92084502261776, "longitude": 131.54823303222656 } }, "previousPoint": { "type":"VesselPosition", "position": { "latitude": -34.82084502261776, "longitude": 131.04823303222656 } } } </code><button type="button">Copy</button></pre> <h2 id="cancelling-navigation" class="tsd-anchor-link">Cancelling navigation<a href="#cancelling-navigation" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../../assets/icons.svg#icon-anchor"></use></svg></a></h2>To cancel the current course navigation and clear the course data. <pre><code class="typescript">HTTP DELETE 'http://hostname:3000/signalk/v2/api/vessels/self/navigation/course' </code><button type="button">Copy</button></pre> Note: This operation will NOT change the destination information coming from the NMEA input stream! If the NMEA source device is still emitting destination data this will reappear as the current destination. To ignore destination data from NMEA sources see <a href="#configuration">Configuration</a> below. <h2 id="configuration" class="tsd-anchor-link">Configuration<a href="#configuration" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../../assets/icons.svg#icon-anchor"></use></svg></a></h2>The default configuration of the Course API will accept destination information from both API requests and NMEA stream data sources. For NMEA sources, Course API monitors the the following Signal K paths populated by both the <code>nmea0183-to-signalk</code> and <code>n2k-to-signalk</code> plugins: <ul> <li>navigation.courseRhumbline.nextPoint.position</li> <li>navigation.courseGreatCircle.nextPoint.position</li> </ul> HTTP requests are prioritised over NMEA data sources, so making an API request will overwrite the destination information received from and NMEA source. Note: when the destination cleared using an API request, if the NMEA stream is emitting an active destination position, this will then be used by the Course API to populate course data. <h4 id="ignoring-nmea-destination-information" class="tsd-anchor-link">Ignoring NMEA Destination Information<a href="#ignoring-nmea-destination-information" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../../assets/icons.svg#icon-anchor"></use></svg></a></h4>The Course API can be configured to ignore destination data in the NMEA stream by enabling <code>apiOnly</code> mode. In <code>apiOnly</code> mode destination information can only be set / cleared using HTTP API requests. <ul> <li> <code>apiOnly</code> Mode = Off (default) <ul> <li>Destination data is accepted from both HTTP API and NMEA sources</li> <li>Setting a destination using the HTTP API will override the destination data received via NMEA</li> <li>When clearing the destination using the HTTP API, if destination data is received via NMEA this will then be used as the active destination.</li> <li>To clear destination sourced via NMEA, clear the destination on the source device.</li> </ul> </li> <li> <code>apiOnly</code> Mode = On <ul> <li>Course operations are only accepted via the HTTP API</li> <li>NMEA stream data is ignored</li> <li>Switching to <code>apiOnly</code> mode when an NMEA sourced destination is active will clear the destination.</li> </ul> </li> </ul> <h4 id="retrieving-course-api-configuration" class="tsd-anchor-link">Retrieving Course API Configuration<a href="#retrieving-course-api-configuration" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../../assets/icons.svg#icon-anchor"></use></svg></a></h4>To retrieve the Course API configuration settings, submit a HTTP <code>GET</code> request to <code>/signalk/v2/api/vessels/self/navigation/course/_config</code>. <pre><code class="typescript">HTTP GET 'http://hostname:3000/signalk/v2/api/vessels/self/navigation/course/_config' </code><button type="button">Copy</button></pre> Example response: <pre><code class="JSON">{ "apiOnly": false } </code><button type="button">Copy</button></pre> <h4 id="enable--disable-apionly-mode" class="tsd-anchor-link">Enable / Disable <code>apiOnly</code> mode<a href="#enable--disable-apionly-mode" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../../assets/icons.svg#icon-anchor"></use></svg></a></h4>To enable <code>apiOnly</code> mode, submit a HTTP <code>POST</code> request to <code>/signalk/v2/api/vessels/self/navigation/course/_config/apiOnly</code>. Enable apiOnly mode: <pre><code class="typescript">HTTP POST 'http://hostname:3000/signalk/v2/api/vessels/self/navigation/course/_config/apiOnly' </code><button type="button">Copy</button></pre> To disable <code>apiOnly</code> mode, submit a HTTP <code>DELETE</code> request to <code>/signalk/v2/api/vessels/self/navigation/course/_config/apiOnly</code>. Disable apiOnly mode: <pre><code class="typescript">HTTP DELETE 'http://hostname:3000/signalk/v2/api/vessels/self/navigation/course/_config/apiOnly' </code><button type="button">Copy</button></pre> <h2 id="course-calculations" class="tsd-anchor-link">Course Calculations<a href="#course-calculations" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../../assets/icons.svg#icon-anchor"></use></svg></a></h2>Whilst not performing course calculations, the Course API defines the paths to accommodate the values calculated during course navigation. Click <a href="../Plugins/Course_Providers.html">here</a> for details. </div></div><div class="col-sidebar"><div class="page-menu"><details open class="tsd-accordion tsd-page-navigation"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../../assets/icons.svg#icon-chevronDown"></use></svg><h3>On This Page</h3></summary><div class="tsd-accordion-details"><a href="#setting-a-course">Setting a Course</a><ul><li><a href="#1-navigate-to-a-location">1. Navigate to a Location</a></li><li><a href="#2-navigate-to-a-waypoint">2. Navigate to a Waypoint</a></li><li><a href="#3-follow-a-route">3. Follow a Route</a></li></ul><a href="#retrieving-course-information">Retrieving Course Information</a><a href="#cancelling-navigation">Cancelling navigation</a><a href="#configuration">Configuration</a><a href="#course-calculations">Course Calculations</a></div></details></div><div class="site-menu"><nav class="tsd-navigation"><a href="../../modules.html">Signal K</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer>Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></footer><div class="overlay"></div></body></html>