概要
ALPSLABコンテンツ検索APIはALPSLABに投稿された「
ブログ」「
写真」「
ルート」「
ビデオ」「
スタンプ(WEBサイト)」
の各位置情報付きコンテンツをキーワードや緯度経度からの距離などから検索するAPIです。
コンテンツ検索APIとその結果からさらに詳細情報を取得するAPIが存在します。
コンテンツ検索API
URL
http://api.alpslab.jp/v1/search
リクエストパラメータ（RESTリクエストの構築はこちらをご覧ください）
| パラメータ |
値 |
説明 |
| appid（必須） |
string |
アプリケーションIDを指定します。詳細はこちらをご覧ください。 |
| q (※) |
string |
検索キーワード(UTF-8)を指定します。 |
| p（※） |
string |
円検索用の中心点の緯度経度を度/分/秒で指定します(日本測地系)。緯度と軽度はカンマ(,)で区切ります。 |
| r (※) |
integer |
円検索用の中心点からの距離をメートルで指定します。距離は10000以下を指定してください。 |
| url（※） |
string |
URLを元に検索を行う場合に指定します。 |
| ps |
string |
上記URLを元にした検索の検索方法を指定します。
- yes : URLを前方一致で検索
- no : URLを完全一致で検索
デフォルトはnoが指定されます。
|
| type |
string |
検索する対象のコンテンツを指定します。対象コンテンツはこちらをご覧ください。デフォルトではすべて選択となります。 |
| num |
integer |
1ページあたりの件数を指定します。デフォルトは20件です。100件以下を指定してください。 |
| page |
integer |
取得したいページを指定します。デフォルトは1となります。 |
※ q, p, urlのいずれか必須です。同時に指定された場合はこの順で１つのみが有効。 p が有効の場合、r が必須です。
リクエスト例
http://api.alpslab.jp/v1/search?appid=guest&q=%E5%90%8D%E5%8F%A4%E5%B1%8B&type=&num=20&page=1
http://api.alpslab.jp/v1/search?appid=guest&p=35%2F9%2F23.218%2C136%2F58%2F34.217&r=1000&type=&num=20&page=1
http://api.alpslab.jp/v1/search?appid=guest&url=http://www.alpslab.jp/&type=&num=20&page=1
レスポンスフィールド
| パラメータ |
値 |
説明 |
| count |
integer |
指定したページの検索件数です。 |
| all |
integer |
検索結果の全件数です。 |
| page |
integer |
取得したページ番号です。 |
| pages |
integer |
検索結果の総ページ数です。 |
| id |
string |
検索されたコンテンツのIDです。このIDは詳細情報取得APIで利用し、コンテンツの詳細を取得します。 |
| type |
string |
検索結果のコンテンツ種別です。コンテンツ種別はこちらをご覧ください。 |
| title |
string |
検索結果のタイトルです。 |
| link |
string |
検索結果のURL文字列です。 |
| coordinates |
string |
検索結果の緯度経度です。度/分/秒形式(日本測地系)で緯度と経度は(,)で区切られます。 |
| date |
string |
コンテンツが投稿された日時を表します。yyyy-mm-dd hh:mm:ssの形式です。 |
レスポンス例
<?xml version="1.0" encoding="UTF-8"?>
<result count="20" all="1099" page="1" pages="55">
<item id="e65f74995a21feb36290ab99a74386a0">
<type>stamp</type>
<title>ミッドランド スクエア / MIDLAND SQUARE | 総合サイト</title>
<link>http://www.midland-square.jp/</link>
<coordinates>35/10/1.192,136/53/17.214</coordinates>
<date>2007-07-25 14:12:33</date>
</item>
:
</result>
詳細情報取得API
URL
http://api.alpslab.jp/v1/detail
リクエストパラメータ（RESTリクエストの構築はこちらをご覧ください）
| パラメータ |
値 |
説明 |
| appid（必須） |
string |
アプリケーションIDを指定します。詳細はこちらをご覧ください。 |
| id (必須) |
string |
コンテンツ検索APIで取得したコンテンツIDを指定します。 |
リクエスト例
http://api.alpslab.jp/v1/detail?appid=guest&id=c3677719ff49540d1ae4cad27299ee72
レスポンスフィールド
| パラメータ |
値 |
説明 |
| type |
string |
検索結果のコンテンツ種別を表します。コンテンツ種別はこちらをご覧ください。 |
| title |
string |
コンテンツのタイトルです。 |
| link |
string |
コンテンツのURLです。 |
| coordinates |
string |
コンテンツの緯度経度（コンテンツ種別はルートの場合は緯度経度列）です。度/分/秒形式（日本測地系）で緯度と経度は(,)で区切られます。 |
| date |
string |
コンテンツが投稿された日時を表します。yyyy-mm-dd hh:mm:ssの形式です。 |
| comment |
string |
コンテンツのコメント及びサマリーを表します。 |
| blog_name |
string |
ブログのタイトルです。（コンテンツ種別がブログの場合のみ） |
| name |
string |
コンテンツの投稿者名です。（コンテンツ種別がルート、ビデオ、写真の場合のみ） |
| square |
string |
square写真のURLです。（コンテンツ種別が写真の場合のみ） |
| thumbnail |
string |
thumbnail写真のURLです。（コンテンツ種別が写真の場合のみ） |
| small |
string |
small写真のURLです。（コンテンツ種別が写真の場合のみ） |
| medium |
string |
medium写真のURLです。（コンテンツ種別が写真の場合のみ） |
| large |
string |
large写真のURLです。（コンテンツ種別が写真の場合のみ） |
| tag |
string |
コンテンツにつけられたタグです。複数の場合はスペース区切りとなります。（コンテンツ種別がビデオとルートの場合のみ） |
| routeurl |
string |
ルートのURLです。（コンテンツ種別がビデオの場合のみ） |
| videourl |
string |
ビデオのURLです。（コンテンツ種別がビデオの場合のみ） |
| embed |
string |
コンテンツ貼り付け用のHTMLです。（コンテンツ種別がビデオとルートの場合のみ） |
レスポンス例
ブログ
<?xml version="1.0" encoding="UTF-8"?>
<result>
<type>blog</type>
<title>名古屋城</title>
<link>http://puchitabi.jp/archives/2007/01/post_2189.html</link>
<coordinates>35/10/49.199,136/54/2.500</coordinates>
<date>2007-01-17 05:08:59</date>
<comment><![CDATA[1612（慶長17）年築城の名古屋城は、明治時代まで約250年間、徳川御三家の筆...]]></comment>
<blog_name>旅行ブログ『プチたび』</blog_name>
</result>
写真
<?xml version="1.0" encoding="UTF-8"?>
<result>
<type>photo</type>
<title>TV tower at Nagoya</title>
<link>http://www.flickr.com/photos/63601153@N00/316456685/</link>
<coordinates>35/10/14.143,136/54/41.049</coordinates>
<date>2006-12-08 00:34:29</date>
<comment><![CDATA[<a href="http://clip.alpslab.jp/bin/rd?flickr=316456685" target="_blank">[MAP by ALPSLAB]</a>
]]></comment>
<name>yanwoo-yanwoo</name>
<square>http://static.flickr.com/99/316456685_57a6bd79af_s.jpg</square>
<thumbnail>http://static.flickr.com/99/316456685_57a6bd79af_t.jpg</thumbnail>
<small>http://static.flickr.com/99/316456685_57a6bd79af_m.jpg</small>
<medium>http://static.flickr.com/99/316456685_57a6bd79af.jpg</medium>
<large>http://static.flickr.com/99/316456685_57a6bd79af_b.jpg</large>
</result>
ルート
<?xml version="1.0" encoding="UTF-8"?>
<result>
<type>route</type>
<title>山手グリーンロード</title>
<link>http://route.alpslab.jp/watch.rb?id=a5463eb51b182d3ce201b92510c2a6dc</link>
<date>2007-06-21 18:38:39</date>
<comment><![CDATA[なんとなく]]></comment>
<name>yanwoo</name>
<tag>コース</tag>
<coordinates>
35/9/38.390,136/57/59.207
35/9/37.406,136/57/59.561
:
35/7/24.781,136/55/22.870
</coordinates>
<embed><![CDATA[<object codebase="http://fpdownload.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=8,0,22,0" width="320" height="240"><param name="movie" value="http://route.alpslab.jp/fslide.swf" /><param name="flashvars" value="routeid=a5463eb51b182d3ce201b92510c2a6dc" /><embed src="http://route.alpslab.jp/fslide.swf" width="320" height="240" type="application/x-shockwave-flash" flashvars="routeid=a5463eb51b182d3ce201b92510c2a6dc" /></object>]]></embed>
</result>
ビデオ
<?xml version="1.0" encoding="UTF-8"?>
<result>
<type>video</type>
<title>東山動物園マニアックス</title>
<link>http://video.alpslab.jp/watch.rb?id=20f8e5661678ab94ead5c7b43276c96c</link>
<coordinates>35/9/20.851,136/58/36.770</coordinates>
<date>2007-07-06 18:14:50</date>
<comment><![CDATA[東山動物園の動物たちの静止画をpicasaでスライドショーの動画にして見ました。
0:30 アムールトラ
1:25 オウサマペンギン
1:36 キンシコウ]]></comment>
<name>yanwoo</name>
<tag>観光 東山動物園 動物</tag>
<routeurl>http://route.alpslab.jp/watch.rb?id=77c62fc6298e7687268be7cd76f9d592</routeurl>
<videourl>http://videocast.yahoo.co.jp/video/detail/?vid=288230376151748300</videourl>
<embed><![CDATA[<object codebase="http://fpdownload.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=8,0,22,0" width="400" height="330"><param name="movie" value="http://video.alpslab.jp/svideoslide.swf" /><param name="flashvars" value="lapid=20f8e5661678ab94ead5c7b43276c96c" /><embed src="http://video.alpslab.jp/svideoslide.swf" width="400" height="330" type="application/x-shockwave-flash" flashvars="lapid=20f8e5661678ab94ead5c7b43276c96c" /></object>]]></embed>
</result>
スタンプ(WEBページ)
<?xml version="1.0" encoding="UTF-8"?>
<result>
<type>stamp</type>
<title>ミッドランド スクエア / MIDLAND SQUARE | 総合サイト</title>
<link>http://www.midland-square.jp/</link>
<coordinates>35/10/1.192,136/53/17.214</coordinates>
<date>2007-07-25 14:12:33</date>
<comment><![CDATA[ミッドランド スクエア]]></comment>
</result>
備考
コンテンツ種別