https://homelab.nbkelley.com/tags/bluebikes/ Recent content in Bluebikes on homelab Hugo en Fri, 01 May 2026 00:00:00 +0000 https://homelab.nbkelley.com/docs/services/bluebikes-api/ Fri, 01 May 2026 00:00:00 +0000 https://homelab.nbkelley.com/docs/services/bluebikes-api/ <h1 id="bluebikes-api-feeds-guide">BlueBikes API Feeds Guide<a class="anchor" href="#bluebikes-api-feeds-guide">#</a></h1> <h2 id="what-was-established">What Was Established<a class="anchor" href="#what-was-established">#</a></h2> <ul> <li>Comprehensive breakdown of BlueBikes GBFS (General Bikeshare Feed Specification) endpoints.</li> <li>JSON structure analysis for static (<code>station_information</code>) and real-time (<code>station_status</code>) feeds.</li> <li>JavaScript patterns for fetching, joining, and displaying station data.</li> </ul> <h2 id="key-decisions">Key Decisions<a class="anchor" href="#key-decisions">#</a></h2> <ul> <li><strong>Base URL</strong>: <code>https://gbfs.lyft.com/gbfs/1.1/bos/en/</code></li> <li><strong>Primary Feeds</strong>: <code>station_information</code> (static map/location data) and <code>station_status</code> (live availability) are the core feeds for real-time tracking.</li> <li><strong>Join Strategy</strong>: Match <code>station_id</code> fields between static and status feeds to combine location metadata with live bike/dock counts.</li> </ul> <h2 id="current-configuration">Current Configuration<a class="anchor" href="#current-configuration">#</a></h2> <h3 id="core-gbfs-endpoints">Core GBFS Endpoints<a class="anchor" href="#core-gbfs-endpoints">#</a></h3> <table> <thead> <tr> <th>Feed</th> <th>Purpose</th> </tr> </thead> <tbody> <tr> <td><code>station_information</code></td> <td>Static station list, names, IDs, coordinates, capacity, kiosk info</td> </tr> <tr> <td><code>station_status</code></td> <td>Real-time bike/dock counts, station active/inactive status, last reported timestamp</td> </tr> <tr> <td><code>system_information</code></td> <td>System metadata (operator, name, URLs)</td> </tr> <tr> <td><code>system_regions</code></td> <td>Regional breakdowns for color-coding/mapping</td> </tr> <tr> <td><code>system_hours</code></td> <td>Operating hours</td> </tr> <tr> <td><code>system_calendar</code></td> <td>Start/end years, holidays</td> </tr> <tr> <td><code>gbfs_versions</code></td> <td>Available GBFS versions</td> </tr> <tr> <td><code>free_bike_status</code></td> <td>Free-floating bike locations</td> </tr> <tr> <td><code>ebikes_at_stations</code></td> <td>Real-time e-bike counts per station</td> </tr> <tr> <td><code>system_pricing_plans</code></td> <td>Membership &amp; pricing details</td> </tr> <tr> <td><code>system_alerts</code></td> <td>Current advisories</td> </tr> </tbody> </table> <h3 id="data-structure-examples">Data Structure Examples<a class="anchor" href="#data-structure-examples">#</a></h3> <p><strong><code>station_information</code></strong></p>