About Bikesy

Bikesy’s bike routes are available via an API. This is still in beta and could change at any time.

Example

https://api.bikesy.com?lat1=37.7910183&lng1=-122.3991499&lat2=37.7700099&lng2=-122.44693656&scenario=3

This example returns JSON for a bike route from the Financial district in San Francisco to Haight and Ashbury.

API Input

InputDescriptionFormatExample
lat1Latitude of starting pointNumeric37.7910
lng1Longitude of starting pointNumeric-122.3991
lat2Latitude of ending pointNumeric37.7700
lng2Longitude of ending pointNumeric-122.4469
scenarioRoute ScenarioString1-9

Example Input

https://bikesy.com/api/route?lat1=37.79099655151367&lng1=-122.39909362792969&lat2=37.78794572301525&lng2=-122.40700721740723&scenario=3

Example Output

{
  directions: [
    [
      "start northwest",
      "1st Street",
      [
        -122.39904022216797,
        37.79095458984375
      ]
    ],
    [
      "left",
      "Market Street",
      [
        -122.39916229248047,
        37.79104995727539
      ]
    ],
    [
      "right",
      "Sutter Street",
      [
        -122.40009307861328,
        37.790313720703125
      ]
    ],
    [
      "left",
      "Stockton Street",
      [
        -122.406982421875,
        37.78943634033203
      ]
    ],
    [
      "right",
      "nameless",
      [
        -122.40679168701172,
        37.78850173950195
      ]
    ],
    [
      "left",
      "nameless",
      [
        -122.40711975097656,
        37.788211822509766
      ]
    ]
  ],
  path: [
    "m`teF~`ajVQVpCxDnD`j@xDe@v@p@@Ln@G",
    "B?@@???B"
  ],
  stats: {
    route_desc_time: 0.07801294326782227,
    route_find_time: 0.026762962341308594,
    endpoint_find_time: 0.03102397918701172
  },
  total_distance: 227.82277810367316,
  elevation_profile: [
    [
      0,
      5.0752482414245605
    ],
    [
      7.544057846069336,
      5.091028213500977
    ],
    [
      15.088115692138672,
      5.083014011383057
    ],
    [
      15.088115692138672,
      5.083014011383057
    ],
    [
      24.6302490234375,
      5.095391273498535
    ],
    [
      34.17238235473633,
      5.0944414138793945
    ],
    [
      34.17238235473633,
      5.0944414138793945
    ],
    [
      42.17867660522461,
      5.131943225860596
    ],
    [
      50.18497085571289,
      5.274590969085693
    ],
    [
      58.19126510620117,
      5.385646343231201
    ],
    [
      66.19755554199219,
      5.406042575836182
    ],
    [
      66.19755554199219,
      5.406042575836182
    ],
    [
      75.31005859375,
      5.507899284362793
    ],
    [
      84.42256164550781,
      5.7164459228515625
    ],
    [
      93.53506469726562,
      5.901495456695557
    ],
    [
      102.64756774902344,
      6.0424957275390625
    ],
    [
      111.76007080078125,
      6.195816516876221
    ],
    [
      111.76007080078125,
      6.195816516876221
    ],
    [
      121.30224323272705,
      6.379543304443359
    ],
    [
      130.84441566467285,
      6.591588020324707
    ],
    [
      130.84441566467285,
      6.591588020324707
    ],
    [
      134.96445083618164,
      6.704606056213379
    ],
    [
      142.76474380493164,
      6.9077301025390625
    ],
    [
      150.5650405883789,
      7.064327239990234
    ],
    [
      150.5650405883789,
      7.064327239990234
    ],
    [
      157.7345848083496,
      7.1707024574279785
    ],
    [
      164.90413284301758,
      7.313899517059326
    ],
    [
      164.90413284301758,
      7.313899517059326
    ],
    [
      170.0148696899414,
      7.466989994049072
    ],
    [
      175.12560272216797,
      7.61562442779541
    ],
    [
      175.12560272216797,
      7.61562442779541
    ],
    [
      179.8487091064453,
      7.760673999786377
    ],
    [
      179.8487091064453,
      7.760673999786377
    ],
    [
      189.2423858642578,
      8.054417610168457
    ],
    [
      198.63607025146484,
      8.314105987548828
    ],
    [
      208.02974700927734,
      8.528959274291992
    ],
    [
      217.42343139648438,
      8.689697265625
    ],
    [
      226.81710815429688,
      8.872651100158691
    ],
    [
      236.21078491210938,
      9.167342185974121
    ],
    [
      245.60446166992188,
      9.378177642822266
    ],
    [
      254.99813842773438,
      9.502896308898926
    ],
    [
      264.3918151855469,
      9.701557159423828
    ],
    [
      273.78550720214844,
      9.916430473327637
    ],
    [
      283.17918395996094,
      10.009174346923828
    ],
    [
      292.57286071777344,
      10.230462074279785
    ],
    [
      301.966552734375,
      10.52198314666748
    ],
    [
      311.3602294921875,
      10.807267189025879
    ],
    [
      320.75390625,
      10.992822647094727
    ],
    [
      320.75390625,
      10.992822647094727
    ],
    [
      330.5104217529297,
      11.14419174194336
    ],
    [
      340.2669372558594,
      11.35804271697998
    ],
    [
      350.0234680175781,
      11.658734321594238
    ],
    [
      350.0234680175781,
      11.658734321594238
    ],
    [
      358.59857177734375,
      11.915679931640625
    ],
    [
      367.1736755371094,
      12.171150207519531
    ],
    [
      375.748779296875,
      12.43166732788086
    ],
    [
      384.3238830566406,
      12.690914154052734
    ],
    [
      392.89898681640625,
      12.948080062866211
    ],
    [
      392.89898681640625,
      12.948080062866211
    ],
    [
      402.2572937011719,
      13.229154586791992
    ],
    [
      411.6155700683594,
      13.510175704956055
    ],
    [
      420.973876953125,
      13.792105674743652
    ],
    [
      430.3321838378906,
      14.073530197143555
    ],
    [
      439.6904602050781,
      14.356657028198242
    ],
    [
      449.04876708984375,
      14.58889389038086
    ],
    [
      458.4070739746094,
      14.701386451721191
    ],
    [
      467.7653503417969,
      14.887154579162598
    ],
    [
      467.7653503417969,
      14.887154579162598
    ],
    [
      475.9289855957031,
      15.12700366973877
    ],
    [
      484.09259033203125,
      15.385390281677246
    ],
    [
      492.2562255859375,
      15.661421775817871
    ],
    [
      500.4198303222656,
      16.04209327697754
    ],
    [
      500.4198303222656,
      16.04209327697754
    ],
    [
      510.1341552734375,
      16.508846282958984
    ],
    [
      519.8484497070312,
      16.982973098754883
    ],
    [
      529.5627746582031,
      17.358182907104492
    ],
    [
      539.2770690917969,
      17.653135299682617
    ],
    [
      548.9913940429688,
      18.020797729492188
    ],
    [
      558.7056884765625,
      18.468069076538086
    ],
    [
      568.4200134277344,
      18.848094940185547
    ],
    [
      578.1343078613281,
      19.275659561157227
    ],
    [
      587.8486328125,
      19.72952651977539
    ],
    [
      597.5629272460938,
      20.26630973815918
    ],
    [
      607.2772521972656,
      20.60575294494629
    ],
    [
      607.2772521972656,
      20.60575294494629
    ],
    [
      615.673228263855,
      20.84258270263672
    ],
    [
      624.0692043304443,
      21.232343673706055
    ],
    [
      632.4651794433594,
      21.679885864257812
    ],
    [
      640.861156463623,
      22.09402847290039
    ],
    [
      649.2571296691895,
      22.46666145324707
    ],
    [
      657.6531066894531,
      22.797697067260742
    ],
    [
      657.6531066894531,
      22.797697067260742
    ],
    [
      667.4096908569336,
      23.258392333984375
    ],
    [
      677.1662750244141,
      23.61315155029297
    ],
    [
      686.9228668212891,
      24.133377075195312
    ],
    [
      696.6794509887695,
      24.848003387451172
    ],
    [
      706.43603515625,
      25.44043731689453
    ],
    [
      716.192626953125,
      25.908044815063477
    ],
    [
      725.9492111206055,
      26.290786743164062
    ],
    [
      735.7057952880859,
      26.706878662109375
    ],
    [
      745.4623718261719,
      27.239797592163086
    ],
    [
      745.4623718261719,
      27.239797592163086
    ],
    [
      754.0364379882812,
      26.89752197265625
    ],
    [
      763.3006591796875,
      26.48716926574707
    ],
    [
      772.5648956298828,
      26.142183303833008
    ],
    [
      781.8291320800781,
      25.74917984008789
    ],
    [
      791.0933532714844,
      25.289548873901367
    ],
    [
      800.3575897216797,
      24.87709617614746
    ],
    [
      800.3575897216797,
      24.87709617614746
    ],
    [
      808.096435546875,
      24.598548889160156
    ],
    [
      815.8352966308594,
      24.230863571166992
    ],
    [
      815.8352966308594,
      24.230863571166992
    ],
    [
      824.5487670898438,
      23.7544002532959
    ],
    [
      833.2622375488281,
      23.327404022216797
    ],
    [
      841.9757232666016,
      22.932119369506836
    ],
    [
      850.5497741699219,
      22.596555709838867
    ],
    [
      850.5497741699219,
      22.596555709838867
    ],
    [
      857.372899055481,
      22.53114128112793
    ],
    [
      864.19602394104,
      22.529682159423828
    ],
    [
      871.0191497802734,
      22.59964942932129
    ],
    [
      879.8062362670898,
      22.91325569152832
    ],
    [
      888.5933227539062,
      23.306537628173828
    ],
    [
      895.4326210021973,
      23.563129425048828
    ],
    [
      895.4326210021973,
      23.563129425048828
    ],
    [
      904.1460952758789,
      23.758033752441406
    ],
    [
      912.8595695495605,
      23.80368423461914
    ],
    [
      921.5730438232422,
      23.817644119262695
    ]
  ]
}

API Details

We made assumptions about weighting different OpenStreetMaps road classifications for each scenario. For all scenarios, busier road classifications such as “motorway” and “primary” were given a higher weight than less busy road classifications such as “tertiary” and “path”. Weights are multipliers on the actual length of the link so a higher weight on a segment of road means that we are more likely to avoid routing on that segment.

The weights used by bikesy for each scenario are shown below:

TypeExampleLowMediumHigh
Highway:Motorway/Motorway LinkBay Bridge, I-101100100100
Highway:Trunk/Trunk Link19th Ave, Lombard to I-1011.21.351.5
Highway:Primary/Primary LinkGeary, Cesar Chavez1.11.251.4
Highway:Secondary/Secondary LinkPotrero, 3rd St11.11.2
Highway:ResidentialShotwell10.950.9
Highway:Living Street*not in SF10.950.9
Highway:Stepsany steps222
Highway:TrackWawona St (usually dirt track)1.11.051
Highway:PedestrianCivic Center Plaza1.11.11.1
Highway:PathUsually dirt path1.11.051
Highway:CyclewayOctavia Blvd0.90.80.7
Cycleway:LaneValencia0.90.80.7
Cycleway:TrackOctavia Blvd0.90.80.7
Cycleway:PathGolden Gate Bridge0.90.80.7
Bicycle:DesignatedOcean Ave (along beach)0.90.80.7
Bicycle:YesEl Camino Del Mar0.90.80.7
Route:Bicycle0.90.80.7

Contact Us

Let us know how you use the API, send us suggestions for improving it or ask us a question about our less-than-complete documentation. info@bikesy.com. Want to contribute? Fork ourfront end or back end and get going.