ueblog » API http://ueblog.natural-wave.com Web関連のネタを中心に役立つ情報を配信しています。 Wed, 11 Jan 2012 00:51:56 +0000 ja hourly 1 http://wordpress.org/?v=3.3.1 Zend_Service_AmazonのAmazon新API対応について http://ueblog.natural-wave.com/2009/08/08/zend_service_amazon-new-api/ http://ueblog.natural-wave.com/2009/08/08/zend_service_amazon-new-api/#comments Sat, 08 Aug 2009 06:47:43 +0000 ueblog http://ueblog.natural-wave.com/?p=504 Amazon APIを利用している方、新しい認証方法に対応してますか～？

2009年8月16日からAmazon APIの認証方法が変更されるにあたって、利用している方は対応が必要です。

かなりざっくり説明すると、

  • URLにtimestampを付与
  • URLパラメータをアルファベット順にソート
  • パラメータにAmazonから新しく付与されているキーを元にハッシュ化しURLエンコード
  • ハッシュ化されたキーをURLにくっつけて、APIにアクセス！

と言った具合。詳しくは

[を] アマゾンAPIを使うのに2009年8月15日から認証が必要になるらしい

こちらを参照。

さて本題、Zend_Service_Amazonを利用している場合はどうすればよいか。

実はとても簡単。Zend_Service_APIオブジェクトをnewするときの第3引数にAmazonから付与される、Secret Access Keyを指定するだけ！

まずは、Amazon Web Servicesでログインしてから、上部メニューの「Your Account」⇒「Access Identifiers」へ行き、Your Secret Access Key:と書かれている部分をコピーしておく。

このSecret Access Keyをnew Zend_Service_APIしているソースの第3引数に指定しよう。

PLAIN TEXT
PHP:
  1. $amazon = new Zend_Service_Amazon('Access Key', 'JP', 'Secret Access Key');
  2. $result = $amazon->ItemLookup($item_code, array(
  3.     'AssociateTag'  => 'associate_tag',
  4.     'ResponseGroup' => 'Large'
  5. ));

以上終了！Zend使っててよかった～

ちなみに2009年7月26日に更新されたようなので、zendのアップグレードをしていない方は、ソースを落とすなり、「pear upgrade zend/zend」しておきましょう。

ちなみにZend_Service_Amazonコンストラクターのphpdocはこんな感じ。

PLAIN TEXT
PHP:
  1. /**
  2. * Constructs a new Amazon Web Services Client
  3. *
  4. * @param  string $appId       Developer's Amazon appid
  5. * @param  string $countryCode Country code for Amazon service; may be US, UK, DE, JP, FR, CA
  6. * @throws Zend_Service_Exception
  7. * @return Zend_Service_Amazon
  8. */
  9.  public function __construct($appId, $countryCode = 'US', $secretKey = null){
  10. }

あれ第3引数のdocumentが書かれてない。。でもちゃんと実装はされていて動作もしたので念のため。

]]> http://ueblog.natural-wave.com/2009/08/08/zend_service_amazon-new-api/feed/ 1 Googleのグラフが簡単に書けるAPI http://ueblog.natural-wave.com/2007/12/11/google-chart-api/ http://ueblog.natural-wave.com/2007/12/11/google-chart-api/#comments Mon, 10 Dec 2007 15:16:21 +0000 ueblog http://ueblog.natural-wave.com/2007/12/11/google-chart-api/ とうとうGoogleからグラフを簡単に書けるAPIがでました！

利用方法はimg srcタグにそのままAPIのURLを入れるだけでグラフ画像が生成される。
早速、試してみよう。

グラフの種類

Line Chart

Bar Chart

Pie Chart

Venn diagrams

Scatter plots

APIについて

グラフごとに必須となる項目（データ、ラベルなどの指定）がさまざま。バックグラウンドの色など含め、さまざまな効果をURLパラメータで指定できる。返ってくる画像はPNG方式。

パラメーターの意味はすこし難しいけど、これは便利だ！

利用方法的には、さまざまなデータをブログやインターネットサービスで公開するときが考えられるが、会社の売上げやら、サービスのPVなどをグラフ化しようとして、機密情報をGoogleに送るのはさすがにNGでしょう。（というか通信は暗号化されないので。）

詳しい仕様は下記へ
Developer's Guide - Google Chart API - Google Code

関連記事

これは便利！誰でも簡単にグラフを描けるAPIがGoogleから登場！『Google Charts』

Google Code Chart - 折れ線グラフうぃざ～ど

]]> http://ueblog.natural-wave.com/2007/12/11/google-chart-api/feed/ 0 JavaでRESTするには(RestletによるAPI利用) http://ueblog.natural-wave.com/2007/12/10/java-rest/ http://ueblog.natural-wave.com/2007/12/10/java-rest/#comments Sun, 09 Dec 2007 15:28:58 +0000 ueblog http://ueblog.natural-wave.com/2007/12/10/java-rest/ Javaで各種WebのAPIにRESTするのに一番簡単な方法は？

いろんな手段がありえるが、今回は「Restlet」を取り上げてみる。
Restlet自体はAPIを提供する側のサーバ機能を利用することが多いようですが、今回はあえてクライアントとして利用します。

まずは、Restletのライブラリをダウンロードする。
Restlet - Downloads

Zip archive版の中から、

com.noelios.restlet.jar
org.restlet.jar
com.noelios.restlet.ext.httpclient_3.1.jar

を取り出し、CLASSPATHに通す。

そして、commonsプロジェクトにも依存しているようなので、
Apache Commons - Logging Downloads

Apache Commons - Codec Downloads

HttpClient - HttpClient Downloads

から、それぞれ

commons-logging-1.1.jar
commons-codec-1.3.jar
commons-httpclient-3.1.jar

を取り出し、CLASSPATHに通す。

さて、今日はどのAPIを標的とするかというと、、東京大学空間情報科学研究センターが提供する、住所から位置情報を割り出せるというCSISシンプルジオコーディングを利用してみようと思う。

さっそくコードはこんな感じに。東京都渋谷区道玄坂をターゲットにしてみました。

PLAIN TEXT
JAVA:
  1. import org.restlet.Client;
  2. import org.restlet.data.Protocol;
  3. import org.restlet.data.Reference;
  4. import org.restlet.resource.DomRepresentation;
  5. import org.w3c.dom.Node;
  6.  
  7. public class Main {
  8.  
  9.     public static void main(String[] args) {
  10.         try {
  11.             Client client = new Client(Protocol.HTTP);
  12.             String url = "http://geocode.csis.u-tokyo.ac.jp/cgi-bin/simple_geocode.cgi"
  13.                 + "?addr=" + Reference.encode("東京都渋谷区道玄坂")
  14.                 + "&charset=UTF8";
  15.             DomRepresentation xml = client.get(url).getEntityAsDom();
  16.             Node n1 = xml.getNode("//results/candidate/address");
  17.             System.out.println("address : " + n1.getTextContent());
  18.             Node n2 = xml.getNode("//results/candidate/longitude");
  19.             System.out.println("longitude : " + n2.getTextContent());
  20.             Node n3 = xml.getNode("//results/candidate/latitude");
  21.             System.out.println("latitude : " + n3.getTextContent());
  22.            
  23.         } catch (Exception e) {
  24.             e.printStackTrace();
  25.         }
  26.     }
  27. }

実行結果はこちら

address : 東京都/渋谷区/道玄坂
longitude : 139.698166
latitude : 35.657429

Clientのインスタンスを作って、URLを書き、そして簡単にxmlの解析ができます。超簡単！
なんといっても、ソースが直感的。
ライブラリの依存関係がうざいけど、シンプルなAPIにはかなり使えそうだ。

そして、このシンプルジオコーディング、かなりつかえるぞ！
住所の文字列から住所の区分けまでやってくれます。さすが。

]]> http://ueblog.natural-wave.com/2007/12/10/java-rest/feed/ 2 HeartRails Express APIを利用して路線と駅のプルダウンをつくろう http://ueblog.natural-wave.com/2007/12/09/heartrails-express-api/ http://ueblog.natural-wave.com/2007/12/09/heartrails-express-api/#comments Sat, 08 Dec 2007 15:01:05 +0000 ueblog http://ueblog.natural-wave.com/2007/12/09/heartrails-express-api/ 路線や駅情報を提供してくれる、HeartRails ExpressのAPIを利用して、路線と駅のプルダウンを作成してみます。

HeartRails ExpressのAPIは、JSONPをサポートしているので、javascriptだけでできてしまいます。

利用するライブラリは、
JQuery

selectタグの操作を楽にしてくれるJQueryのプラグイン

JSONPをサポートしてくれるライブラリjsr_class.js

ダウンロードして、jsファイルをとりだし、下記のように宣言してあげます。

PLAIN TEXT
JAVASCRIPT:
  1. <script src="js/jquery-1.2.1.min.js" type="text/javascript"></script>
  2. <script src="js/jsr_class.js" type="text/javascript"></script>
  3. <script src="js/jquery.selectboxes.pack.js" type="text/javascript"></script>

パスは適宜置き換えてください。

そして、実装コードはこんな感じになります。

PLAIN TEXT
JAVASCRIPT:
  1. <script type="text/javascript">
  2. //<![CDATA[
  3. // 都道府県プルダウン変更時
  4. var prefObj = {};
  5. function PrefChange(){
  6.   if ($("#pref").val()){
  7.     var url = 'http://express.heartrails.com/api/json?method=getLines'
  8.       + '&prefecture=' + encodeURIComponent( $("#pref").val() )
  9.       + '&jsonp=PrefCallback';
  10.     prefObj = new JSONscriptRequest( url );
  11.     prefObj.buildScriptTag();
  12.     prefObj.addScriptTag();
  13.   } else {
  14.     $("#train").removeOption(/./);
  15.   }
  16. }
  17. function PrefCallback(json){
  18.   if (!json){ return; }
  19.   if (json.response.line.length == 0) { return; }
  20.  
  21.   var lines = json.response.line;
  22.   var options = {};
  23.   for (var i = 0; i <lines.length; i++){
  24.     options[lines[i]] = lines[i];
  25.   }
  26.   $("#train").removeOption(/./);
  27.   $("#train").addOption(options,false);
  28.   prefObj.removeScriptTag();
  29. }
  30.  
  31. // 路線プルダウン変更時
  32. var trainObj = {};
  33. function TrainChange(){
  34.   if ($("#train").val()){
  35.     var url = 'http://express.heartrails.com/api/json?method=getStations'
  36.       + '&line=' + encodeURIComponent( $("#train").val() )
  37.       + '&jsonp=TrainCallback';
  38.     trainObj = new JSONscriptRequest( url );
  39.     trainObj.buildScriptTag();
  40.     trainObj.addScriptTag();
  41.   } else {
  42.     $("#station").removeOption(/./);
  43.   }
  44. }
  45. function TrainCallback(json){
  46.   if (!json){ return; }
  47.   if (json.response.station.length == 0) { return; }
  48.  
  49.   var stations = json.response.station;
  50.   var options = {};
  51.   for (var i = 0; i <stations.length; i++){
  52.     options[stations[i].name] = stations[i].name;
  53.   }
  54.   $("#station").removeOption(/./);
  55.   $("#station").addOption(options,false);
  56.   trainObj.removeScriptTag();
  57. }
  58. //]]>
  59. </script>

HTMLはシンプルにこんな感じで。（都道府県は省略しました・・・。都道府県の値もAPIから取得できますが。手抜きで。）

PLAIN TEXT
HTML:
  1. <select id="pref" onChange="PrefChange();">
  2. <option value="">都道府県を選択&nbsp;</option>
  3. <option value="東京都">東京都</option>
  4. <option value="神奈川県">神奈川県</option>
  5. <option value="埼玉県">埼玉県</option>
  6. <option value="千葉県">千葉県</option>
  7. </select>
  8. <br /><br />
  9. <select id="train" onChange="TrainChange();">
  10. <option value="">路線を選択&nbsp;&nbsp;&nbsp;</option>
  11. </select>
  12. <br /><br />
  13. <select id="station">
  14. <option value="">駅を選択&nbsp;&nbsp;&nbsp;&nbsp;</option>
  15. </select>

サンプルはこちら

これは地図系のサイトでかなり使えそうですね。

]]> http://ueblog.natural-wave.com/2007/12/09/heartrails-express-api/feed/ 9