自転車大好きマップ 全国版 API
「自転車大好きマップ 全国版」に登録されている地点や道のデータをAPIで提供します。
このAPIを利用して生成したページでは、「自転車大好きマップ 全国版」トップページ
（http://www.bicyclemap.net）へのリンクをお願いいたします。
また、info@bicyclemap.netまで一言お知らせをお願いします。
文字コードはすべてUTF-8です。
「自転車大好きマップ 全国版 API」によるアクセスは1リクエスト/秒までを目安としてください。サービスに影響の出る過剰なアクセスは制限させていただく場合がありますのでご了承ください。
リクエストURL
http://www.bicyclemap.net/map/read.php
●クエリ
まずパラメータactionで機能を選択します。
| パラメータ | 値 | 説明 | 例 |
|---|---|---|---|
| action | area | 地図上の範囲を緯度・経度で指定して、そこに含まれるデータを取得する | action=area |
| recent | 新着データを取得する | ||
| comment | 地点や線のコメントを取得する |
action=areaのとき
●クエリ
| パラメータ | 説明 | 例 |
|---|---|---|
| centerx | 読み出す範囲の中心の経度 | centerx=139.759468 |
| centery | 読み出す範囲の中心の緯度 | centery=35.696224 |
| spanx |
読み出す範囲の中心から端までの経度幅 例えばcenterx=135,spanx=1のときは、経度が134°〜136°の範囲のデータが得られる |
spanx=0.002301 |
| spany | 読み出す範囲の中心から端までの緯度幅 例えばcenterx=35,spanx=1のときは、緯度が34°〜36°の範囲のデータが得られる | spany=0.002215 |
リクエストの例：
http://www.bicyclemap.net/map/read.php?action=area
¢erx=139.759468¢ery=35.696224
&spanx=0.002301&spany=0.002215
●レスポンス
レスポンスは、[パラメータ1]=[値1]&[パラメータ2]=[値2]&……&[パラメータn]=[値n]の形式で得られます。
パラメータ名の後には、一つ目のデータから順に、0からシリアル番号が付きます。
| パラメータ | 説明 | 例 | |
|---|---|---|---|
| id[n] | 地点または線のID | id0=864 | |
| pt[n] | 0のとき線 1のとき地点 | pt1=0 | |
| x[n] | 地点のとき（pt[n]=1）はその経度 線のとき（pt[n]=0）は経度のリスト（詳細は後述） | x4=135.545745（地点のとき | |
| y[n] | 地点のとき（pt[n]=1）はその緯度 線のとき（pt[n]=0）は緯度のリスト（詳細は後述） | y4=35.184644 | |
| type[n] | 地点または線の種類（詳細は後述） | type8=way1 | |
| date[n] | 地点または線の登録日 yyyymmddhhmmssの形式 |
|
|
| update[n] | 地点または線の更新日 yyyymmddhhmmssの形式 | update5=20080524182608 （2008年5月24日18時26分08秒ということ） |
|
| author[n] | 作成者のID | author10=1 | |
| authorname[n] | 作成者の名前（英数字） | authorname10=fujimoto | |
| res | 全てのデータの一番最後にひとつだけ付きます。OK：正常終了 ERR：読み出しエラー | res=OK |
線の経度・緯度について
次のような形式で得られます。
x[n]またはy[n]=[始点];[中間点1];[中間点2];[中間点3];……;[終点]
ただし、始点、中間点、終点共にデータ量を圧縮するため緯度・経度の値を1000000倍して小数点以下を四捨五入してあります。
また、中間点、終点は一つ前の点からの相対座標です。
中間点として$が指定されていた場合は、そこで線が一旦切れて次の中間点の位置から再び線が始まることを表します。
例：x0=139755386;-64;1373;408;$;1588;687;965;236
&y0=35702318;-680;-296;-1255;$;-1620;-959;-1272;-139;-35;-1377
地点または線の種類について
| 種類 | type | 説明 |
|---|---|---|
| 地点 | shop | 自転車店 |
| parking | 駐輪場 | |
| rentacycle | レンタサイクル | |
| wc | トイレ | |
| attention | 注意ヵ所 | |
| gradient | 急勾配 | |
| accommodation | 宿泊施設 | |
| hotspring | 温泉・銭湯 | |
| view | 眺めのいい所 | |
| historical | 歴史スポット | |
| nature | 自然スポット | |
| cherry | 桜の名所 | |
| maple | 紅葉の名所 | |
| cafe | お勧めカフェ | |
| restaurant | レストラン | |
| flag1 | その他 | |
| tabichari | 『旅チャリ』が借りられるところ | |
| tabiaccommodation | 『旅チャリ』付き宿泊プランがある宿泊施設 | |
| bicycleaccommodation | 「自転車のまま宿泊プラン」がある宿泊施設 | |
| tabishop | 『旅チャリ』利用者の方に特典があるお店 | |
| 線 | way1 | お勧めコース |
| way2 | 走りやすい道 | |
| way3 | 未舗装の道 | |
| way4 | 走りにくい道 | |
| way5 | きつい坂 |
例：type0=way2
レスポンスの例：
id0=8166&pt0=0&x0=139755386;-64;1373;408;$;1588;687;965;236
&y0=35702318;-680;-296;-1255;$;-1620;-959;-1272;-139;-35;-1377
&type0=way2&date0=20070403000427&update0=20070403000618
&author0=1060&authorname0=jory_temp&id1=1894&pt1=1
&x1=139.759824&y1=35.695164&type1=restaurant
&date1=20060806132743&update1=20060806132816&author1=73
&authorname1=blacksanta&id2=1895&pt2=1&x2=139.761723
&y2=35.694895&type2=shop&date2=20060806132851
&update2=20060825201811&author2=73&authorname2=blacksanta
&res=OK
action=recentのとき
●クエリ
| パラメータ | 説明 | 例 |
|---|---|---|
| centerx | 読み出す範囲の中心の経度 | centerx=139.759468 |
| centery | 読み出す範囲の中心の緯度 | centery=35.696224 |
| spanx |
読み出す範囲の中心から端までの経度幅 例えばcenterx=135,spanx=1のときは、経度が134°〜136°の範囲のデータが得られる |
spanx=0.002301 |
| spany | 読み出す範囲の中心から端までの緯度幅 例えばcenterx=35,spanx=1のときは、緯度が34°〜36°の範囲のデータが得られる | spany=0.002215 |
| number | 読み出すデータの数 | number=20 |
リクエストの例：
http://www.bicyclemap.net/map/read.php?action=recent
¢erx=139.759468¢ery=35.696224
&spanx=0.002301&spany=0.002215&number=3
●レスポンス
レスポンスは、[パラメータ1]=[値1]&[パラメータ2]=[値2]&……&[パラメータn]=[値n]の形式で得られます。
パラメータ名の後には、一つ目のデータから順に、0からシリアル番号が付きます。
| パラメータ | 説明 | 例 | |
|---|---|---|---|
| id[n] | 地点または線のID | id0=864 | |
| pt[n] | 0のとき線 1のとき地点 | pt1=0 | |
| x[n] | 地点のときはその経度 線のときは線に沿って距離を測ったとき、そのちょうど中間の点 | x4=135.545745 | |
| y[n] | 地点のときはその緯度 線のときは線に沿って距離を測ったとき、そのちょうど中間の点 | y4=35.184644 | |
| xmin[n] | 線のときはその線のポイントのxの最小値。点の時はxと同じ | xmin4=135.245865 | |
| ymin[n] | 線のときはその線のポイントのyの最小値。点の時はyと同じ | ymin4=35.035845 | |
| xmax[n] | 線のときはその線のポイントのxの最大値。点の時はxと同じ | xmax4=135.769626 | |
| ymax[n] | 線のときはその線のポイントのyの最大値。点の時はyと同じ | ymax4=35.685245 | |
| type[n] | 地点または線の種類（詳細は「action=areaのとき」の「地点または線の種類について」を参照） | type8=way1 | |
| date[n] | 地点または線の更新日 yyyymmddhhmmssの形式 |
|
|
| update[n] | 地点または線の更新日 yyyymmddhhmmssの形式 | update5=20080524182608 （2008年5月24日18時26分08秒ということ） |
|
| author[n] | 作成者のID | author10=1 | |
| authorname[n] | 作成者の名前（英数字） | authorname10=fujimoto | |
| prefecture[n] | 地点または線の中心点がある場所の都道府県名（UTF-8)。日本以外や不明の場合は"?" | prefecture12=東京都 | |
| municipality[n] | 地点または線の中心点がある場所の市町村区名（UTF-8)。prefectureの値が"?"のときは意味を持たない | municipality12=千代田区 | |
| section[n] | 町名等（UTF-8)。prefectureの値が"?"のときは意味を持たない | section12=丸の内一丁目 | |
| pollcount[n] | 投票数 | pollcount2=2 | |
| viewcount[n] | 閲覧数 | viewcount2=483 | |
| res | 全てのデータの一番最後にひとつだけ付きます。OK：正常終了 ERR：読み出しエラー | res=OK |
レスポンスの例：
id0=23481&pt0=0&x0=139.766229&y0=35.686236&xmin0=139.716284
&ymin0=35.623648&xmax0=139.783648&ymax0=35.693658&type0=way2
&date0=20080521235533&update0=20080521235856&author0=1793
&authorname0=fj2&prefecture0=東京都&municipality0=千代田区
§ion0=大手町二丁目&pollcount0=0&viewcount0=352&id1=22434
&pt1=0&x1=139.637731&y1=35.799796&xmin1=139.572847
&ymin1=35.703584&xmax1=139.686264&ymax1=35.853692&type1=way1
&date1=20080506124214&update1=20080506210220&author1=2238
&authorname1=Nao2Rav4&prefecture1=埼玉県&municipality1=和光市
§ion1=下新倉六丁目&id2=20557&pollcount1=1&viewcount1=854&pt2=0
&x2=139.769677&y2=35.698505&xmin2=139.718654&ymin2=35.636845
&xmax2=139.796284&ymax2=35.684236&type2=way1&date2=20080329231902
&update2=20080329234030&author2=2223&authorname2=purin09&prefecture2=東京都
&municipality2=千代田区§ion2=外神田一丁目&pollcount1=0&viewcount1=38
action=commentのとき
●クエリ
| パラメータ | 説明 | 例 |
|---|---|---|
| flagid | 地点または線のID。action=areaまたはrecentのときのレスポンス中のid[n]の値 | flagid=864 |
リクエストの例：
http://www.bicyclemap.net/map/read.php?action=comment&flagid=2692
●レスポンス
レスポンスは、[パラメータ1]=[値1]&[パラメータ2]=[値2]&……&[パラメータn]=[値n]の形式で得られます。
ひとつの地点または線に複数人がコメントを付けられるので、パラメータ名の後には、0から順にシリアル番号が付きます。
| パラメータ | 説明 | 例 |
|---|---|---|
| author[n] | 作成者のID | author=1 |
| text[n] | コメントのテキスト（UTF-8)。写真が貼り付けられている場合は後述 | text0=さくらがきれいです。 |
| date[n] |
コメントの登録日 yyyymmddhhmmssの形式 |
date5=20080524182608（2008年5月24日18時26分08秒ということ） |
| update[n] |
コメントの更新日 yyyymmddhhmmssの形式 |
update5=20080524182608（2008年5月24日18時26分08秒ということ） |
| commentcnt | 指定した書き込みに付いているコメントの数。以下は全てのデータの一番最後にひとつだけ付きます。 | commentcnt=3 |
| pollcount | 投票数 | pollcount=2 |
| viewcount | 閲覧数 | viewcount=483 |
| res | OK：正常終了 ERR：読み出しエラー | res=OK |
コメントに写真が貼り付けられている場合
コメントテキスト中の写真の位置に"【写真[n]】"または"[photo[n]]"（[n]は数字）の文字列が記述されています。
写真のファイルのURLは次のように求めます。
http://www.bicyclemap.net/map/photos/[地点または線のID]-[コメント作成者のID]-[n][bまたはt].jpg
※[n]は"【写真[n]】"または"[photo[n]]"の[n]。tは写真小（横長のときは幅165pixel、縦長のときは高さ150pixel）、bは写真大（長辺が300pixel）
例：地点または線のIDが413、コメント作成者のIDが56、【写真1】のとき、
http://www.bicyclemap.net/map/photos/413-56-1t.jpg（写真小）
http://www.bicyclemap.net/map/photos/413-56-1t.jpg（写真大）
また、写真が貼り付けられているときには、コメントの最後に次のような形式で写真の高さが書かれています。
コメントの文字列<!--EOT[写真1の高さ],[写真2の高さ],……,[写真nの高さ]-->
例：<!--EOT150-->（高さ150pixelの写真が一枚貼られているとき）
レスポンスの例：
commentid0=485&author0=232
&text0=東京タワーが綺麗に見えるスポットの一つです【写真1】<!--EOT150-->
&name0=motorov&date0=20061015221919&update0=20061015221919
&commentid1=358&author1=783
&text1=確かにこのあたりは東京タワーがきれい&name1=nori1234&date1=20070115220522
&update1=20070115220522&pollcount=1&viewcount=745&commentcnt=2&res=OK
※ご意見、ご希望、不明点、間違い、機能追加のリクエスト等があればinfo@bicyclemap.netまたは、こちら＜ご意見・ご希望＞までご連絡よろしくお願いします。
