カセットサーチAPIの基本機能を利用する
YOLPで利用可能なデータは、YOLPカセットギャラリーで公開されています。データはカセットという単位で管理されており、複数のカセットを組み合わせて選択することができます。ご自身の情報をアップロードして、他のカセットと組み合わせることもできます。
カセットサーチAPIは、YOLPカセットギャラリーで公開されているこれらのカセットを、キーワードやカテゴリーから検索することができるAPIです。
1. カセットをキーワードで検索してみる
カセットサーチAPIは、リクエストURL(http://cassete.search.olp.yahooapis.jp/OpenLocalPlatform/V1/cassetteSearch)にさまざまなパラメーターを追加することで、カセットの検索を行うことができます。
カセットサーチAPIのqueryパラメータにUTF-8エンコードされた文字列を指定することで、キーワードからカセットを検索できます。
以下、「ランチ」で検索してみた例です。
http://cassete.search.olp.yahooapis.jp/OpenLocalPlatform/V1/cassetteSearch?appid=<あなたのアプリケーションID>&query=%e3%83%a9%e3%83%b3%e3%83%81
2. カセットをカテゴリーで検索してみる
categoryパラメータを指定することで、カテゴリーを絞った検索を行うことができます。カテゴリーは、YOLPカセットギャラリーのカテゴリー一覧に表示されているものを指定できます。
以下は、「場所・施設(オフィシャル)」カテゴリーで検索した例です。
http://cassete.search.olp.yahooapis.jp/OpenLocalPlatform/V1/cassetteSearch?appid=<あなたのアプリケーションID>&category=poi_official