2011年8月18日

Yahoo! Open Local Platform

カセットサーチAPI をリリースしました

  • このエントリーをはてなブックマークに追加

はじめまして、R&D統括本部フロントエンド開発1本部開発3部に勤める格闘家の西です。

Yahoo!デベロッパーネットワークにて、カセットサーチAPIを公開しましたので、ご紹介させていただきます。

カセットサーチAPIとは、YOLPカセットギャラリーにアップロードされたカセットを、キーワード、カセットIDなどから検索できるAPIです。このAPIにより、カセットの情報を動的に取得することができます。
(※)Yahoo! Open Local Platform では、地域情報・拠点情報のかたまりを「カセット」と呼んでいます。詳しくはこちらをご覧ください 。

さらに、カセットサーチAPIは、YOLP ローカルサーチAPIと組み合わせたときに、その真価を発揮します。つまり、このAPIで取得できるカセットIDを利用して、カセットを絞りこんだ検索をYOLP ローカルサーチAPIで実現できます。

今回はカセット検索APIから「牛丼」に関するカセットを取得して、YOLPローカルサーチで検索するまでの利用例を説明します。

図. 利用例処理フロー概要

(※)先日公開しました「業種マスターAPI 」と非常によく似た利用手法となります。業種マスターAPIの利用例については、こちらをご覧ください。

カセット検索APIリクエスト例

以下の例で出てくるカセットサーチAPIのリクエストパラメータの説明はこちら
また、レスポンスフィールドの説明についてはこちらになります。

キーワード「牛丼」で検索してカセットを取得する例
リクエストパラメータにアプリケーションIDのみを指定してください。

http://cassette.search.olp.yahooapis.jp/OpenLocalPlatform/V1/cassetteSearch?query=%E7%89%9B%E4%B8%BC&category=place_official?appid=<あなたのアプリケーションID>

レスポンスをみると、「なか卯 店舗情報」「すき家 店舗情報」カセットが取得てきており、カセットIDが「508c00c69133da7dfd69a99a9cb1ef54」、「8cfa8ed3d825ba896fa8d7cffd28cd67」であることが分かります。

<Feature>
<Id>508c00c69133da7dfd69a99a9cb1ef54</Id>
<Name>なか卯 店舗情報</Name>
<Description>
「なか卯」の店舗情報です。「こだわり卵の親子丼・牛丼・京風うどん」を中心としたメニューをご提供します。
</Description>
<Property>
<AdultFlag>0</AdultFlag>
<Licence/>
<PublishStart>1289546220</PublishStart>
<UpdateDate>1305714768</UpdateDate>
<Detail>
<Tags>親子丼,牛丼,うどん,カレー,定食</Tags>
<ImageUrl1>
http://olp.c.yimg.jp/olp/508c00c69133da7dfd69a99a9cb1ef54/info/thumbnail/image.png
</ImageUrl1>
<OfficialWebsiteUrl>http://www.nakau.co.jp/</OfficialWebsiteUrl>
<ReferenceUrl/>
<Copyright>
Copyright (C) 2005 Nakau Co., Ltd. All Rights Reserved.
</Copyright>
<UseCondition/>
<SupportEmail/>
<SupportUrl/>
<CassetteOwner>株式会社なか卯</CassetteOwner>
<CassetteType>poi_yolp</CassetteType>
<CassetteVersion>0</CassetteVersion>
<CassetteCategory>place_official</CassetteCategory>
<DownloadCount>11</DownloadCount>
<PoiCount>493</PoiCount>
</Detail>
</Property>
</Feature>
-
<Feature>
<Id>8cfa8ed3d825ba896fa8d7cffd28cd67</Id>
<Name>すき家 店舗情報</Name>
<Description>
ファミリー牛丼店「すき家」の店舗情報です。ミニからメガまで選べるサイズと、牛丼やカレーなど種類豊富なメニューをご提供しています。
</Description>
<Property>
<AdultFlag>0</AdultFlag>
<Licence/>
<PublishStart>1289546220</PublishStart>
<UpdateDate>1305714538</UpdateDate>
<Detail>
<Tags>牛丼,カレー,定食,サイズ,テイクアウト</Tags>
<ImageUrl1>
http://olp.c.yimg.jp/olp/8cfa8ed3d825ba896fa8d7cffd28cd67/info/thumbnail/image.png
</ImageUrl1>
<OfficialWebsiteUrl>http://www.sukiya.jp/</OfficialWebsiteUrl>
<ReferenceUrl/>
<Copyright>
Copyright (C) 2010 ZENSHO Co., Ltd. All Rights Reserved.
</Copyright>
<UseCondition/>
<SupportEmail/>
<SupportUrl/>
<CassetteOwner>株式会社ゼンショー</CassetteOwner>
<CassetteType>poi_yolp</CassetteType>
<CassetteVersion>0</CassetteVersion>
<CassetteCategory>place_official</CassetteCategory>
<DownloadCount>22</DownloadCount>
<PoiCount>1497</PoiCount>
</Detail>
</Property>
</Feature>

カセットIDを利用したローカルサーチAPIリクエスト例

以下の例で出てくるローカルサーチAPIのリクエストパラメータの説明はこちら
また、レスポンスフィールドの説明についてはこちらになります。

リクエストパラメータにアプリケーションIDと先ほど取得した「牛丼」で検索したカセットのカセットID(cid=508c00c69133da7dfd69a99a9cb1ef54,8cfa8ed3d825ba896fa8d7cffd28cd67)を指定することによって、牛丼のカセットに絞った検索ができます。

http://search.olp.yahooapis.jp/OpenLocalPlatform/V1/localSearch?appid=<あなたのアプリケーションID>&cid=508c00c69133da7dfd69a99a9cb1ef54,8cfa8ed3d825ba896fa8d7cffd28cd67

また、ローカルサーチAPIの緯度経度を指定した検索や、住所コードでの検索と組み合わせることも可能となっていますので、ジオコーダAPIで取得した緯度経度をもとに検索といった使い方もできます。

さらには、JavaScriptマップAPIと組み合わせることで、検索結果を地図やリストに簡単に表示するビューを作成することも可能です。以下のサンプルコードはこちらになります。

おわりに

今回紹介したカセットサーチAPIはローカルサーチAPIや他のAPIとマッシュアップすることによって可能性が広がります。ぜひ、こちらのAPIを利用してデベロッパー皆様のアプリケーションに役立てていただけたらと思います。

今後ともYahoo! Open Local Platformをよろしくお願いします。

Yahoo! JAPANでは情報技術を駆使して人々や社会の課題を一緒に解決していける方を募集しています。詳しくは採用情報をご覧ください。

  • このエントリーをはてなブックマークに追加