更新日: 2015年3月11日
Ruby

Getty Images APIでRubyを使って画像検索

Getty Images の API を Ruby から使って試してみたので、コードを残しておきます。Getty Images は、写真が膨大にストックしてあるウェブサイトです。API が公開してある。

ストックフォト、ロイヤリティフリー写真、ビデオ映像、音楽 | Getty Images
Getty Images API – Connect Image API: Stock Photo and Video API Integration Service | Getty Images

【お知らせ】英単語を画像イメージで楽に暗記できる辞書サイトを作りました。英語学習中の方は、ぜひご利用ください！

画像付き英語辞書 Imagict | 英単語をイメージで暗記
【開発記録】
英単語を画像イメージで暗記できる英語辞書サービスを作って公開しました

API ドキュメントについては、以下の GitHub ページ等を参照、Ruby 用のライブラリも用意してありました。

https://github.com/gettyimages/gettyimages-api
https://github.com/gettyimages/gettyimages-api_ruby
Swagger UI

APIキー取得とRubyライブラリを使うための準備

まず、API key と secret を取得するために、Mashery Member のアカウントを取得する必要があります。既に持っていればサインイン。

サインアップしたら、サインインして API key と secret を取得します。

Ruby 用のライブラリは、現時点（2015/03/11）で rubygems.org に公開されていないので、ローカルに落としてビルドする。README 通りに進めればOK。


$ cd connect_sdk_ruby/ConnectSDK
$ bundle exec rake install

$ cd connect_sdk_ruby/ConnectSDK

$ bundle exec rake install

Getty Images からキーワードで画像を検索して取得するコード

以下のコードを書いてみました。テスト用なので、例外処理などいい加減です。レスポンスは JSON で返ってきます。API key, API secret の箇所は取得したものに変更。

test_getty_images.rb

#!/usr/bin/env ruby

require "ConnectSDK"

GETTY_API_KEY = "API key"
GETTY_API_SECRET = "API secret"
 
$connect_sdk ||= ConnectSdk.new(GETTY_API_KEY, GETTY_API_SECRET)

def getty_images(keyword)
  response = $connect_sdk.search().images().with_phrase(keyword).with_page(1).with_page_size(10).execute()["images"] rescue []

  getty_images = []
  response.each do |res|
    thumb_url = res["display_sizes"].select{ |i| i["name"] == "thumb" }.first["uri"] rescue ""
    getty_images << { 
      id: res["id"].to_s,
      title: res["title"].to_s,
      thumb_url: thumb_url.to_s
    }
  end
 
  getty_images
end
 
getty_images("mountain").each do |item|
  puts "--------------------------------------------------"
  puts item[:id]
  puts item[:title]
  puts item[:thumb_url]
end

#!/usr/bin/env ruby

require "ConnectSDK"

GETTY_API_KEY = "API key"

GETTY_API_SECRET = "API secret"

$connect_sdk ||= ConnectSdk.new(GETTY_API_KEY, GETTY_API_SECRET)

def getty_images(keyword)

response = $connect_sdk.search().images().with_phrase(keyword).with_page(1).with_page_size(10).execute()["images"] rescue []

getty_images = []

response.each do |res|

thumb_url = res["display_sizes"].select{ |i| i["name"] == "thumb" }.first["uri"] rescue ""

getty_images << {

id: res["id"].to_s,

title: res["title"].to_s,

thumb_url: thumb_url.to_s

}

end

getty_images

end

getty_images("mountain").each do |item|

puts "--------------------------------------------------"

puts item[:id]

puts item[:title]

puts item[:thumb_url]

end

ConnectSdk.new で作ったオブジェクトに、メソッドをチェインして検索の条件を追加していく書き方で、JSONレスポンスを取得できます。画像検索用のAPIですと、以下ソースの define_method で定義してある with_*** のメソッドが使える。

https://github.com/gettyimages/gettyimages-api_ruby/blob/master/ConnectSDK/lib/SearchImages.rb

ファイルに実行権を与えてテスト。


$ chmod 755 test_getty_images.rb
$ ./test_getty_images.rb
--------------------------------------------------
200366333-001
Mountain top, Chugach Mountains, Alaska, USA, elevated view
http://cache3.asset-cache.net/xt/200366333-001.jpg?v=1&g=fs1|0|DV|63|331&s=1&b=OTg3
--------------------------------------------------
sb10068806o-001
Snowcapped mountains and overcast sky
http://cache4.asset-cache.net/xt/sb10068806o-001.jpg?v=1&g=fs1|0|TSIR|80|611&s=1&b=RA==
--------------------------------------------------
518697085
Bow Valley
http://cache4.asset-cache.net/xt/518697085.jpg?v=1&g=fs2|0|editorial255|97|085&s=1&b=QQ==
...