"Flickr" (サービス接続)

Wolfram言語を使って，Flickから写真を検索し，これをインポートする．

接続と認証

ServiceConnect["Flickr"]は，Flickr APIへの接続を行う．以前保存した接続が見付かった場合は，それが使われる．見付からなかった場合は新たな認証リクエストが行われる．
この接続を使用するには，インターネット接続とFlickrのユーザアカウントが必要である．

リクエスト

ServiceExecute["Flickr","request",params]は，パラメータ params を使ってFlickr APIへリクエストを送る．以下は可能なリクエストである．

ユーザ情報

リクエスト：

"UserData" — 指定ユーザのプロフィール情報

パラメータ：
  • "User"認証ユーザユーザID，名前，あるいは電子メール

    • 画像の検索

    リクエスト：

    "ImageSearch" — ユーザ，キーワード，説明，日付の範囲，場所で写真を検索する

    パラメータ：
  • "User"NoneユーザのID，名前，あるいは電子メール
    "Keywords"None一般的な検索キーワード
    "Description"None写真の題名，説明，タグ内に検索するキーワード
    "DateTaken"None写真が撮られた日付または日付の範囲
    "DateUploaded"None写真がアップロードされた日付または日付の範囲
    "Location"None写真の場所
    "Elements""Data"返すべきデータ要素
    "Format""Dataset"出力形式
    "ImageSize""Medium"画像サイズ
    MaxItems30返される結果の数
    "StartIndex"1最初の検索で返す結果のインデックス
    "SortBy"Noneソート順のパラメータ

    • 画像のインポート

    リクエスト：

    "ImportImage" — 特定の画像をインポートする

    パラメータ：
  • "Keys"（必須）写真のID，ファーム，サーバ，シークレットのキー（これらはすべて"ImageSearch"リクエストの"Keys"フィールドによって与えられる）
    "ImageSize""Thumbnail"画像サイズ

    • ユーザ画像のコレクション

    リクエスト：

    "UserGalleries" — 特定ユーザのフォトギャラリーのリスト

    "UserAlbums" — 特定ユーザのフォトアルバムのリスト

    パラメータ：
  • "User"認証ユーザユーザのID，名前，あるいは電子メール
    MaxItems100返される結果の数
    "ShowPrimaryPhoto"False各ギャラリーについて代表的な写真を返すかどうか

    • フォトギャラリーのデータ

    リクエスト：

    "GalleryImages" — 特定のフォトギャラリーのデータ

    パラメータ：
  • "GalleryID"（必須）ギャラリーID
    "Elements""Data"返されるデータ要素
    "Format""Dataset"データ要素の出力形式
    "ImageSize""Medium"画像サイズ

    • フォトアルバムのデータ

    リクエスト：

    "AlbumImages" — 特定のフォトアルバムについてのデータ

    パラメータ：
  • "AlbumID"（必須）アルバムID
    "Elements""Data"返されるデータ要素
    "Format""Dataset"データ要素の出力形式
    "ImageSize""Medium"画像サイズ
    MaxItems100返される要素数

    • パラメータの詳細

    "User"の可能な指定
  • username単純なユーザ名
    {"UserID",id}id がAPIユーザのIDを表しているところ
    {"UserName",username}ユーザ名を渡すことに等しい
    {"UserEmail",address}アドレスがユーザアカウントに関連付けられた電子メールを表しているところ
    • "Elements"の可能な値
  • "Images"画像のリストを返す
    "Data"フィールドの数が限定されたデータ集合を返す
    "FullData"すべてのフィールドが使用可能なデータ集合を返す
    "ImageLinks"画像のハイパーリンクのリストを返す
    "LinkedThumbnails"ハイパーリンクのサムネイルのリストを返す
    • "ImageSize"の可能な値
  • "Small"320×240
    "Medium"800×600
    "Large"1024×768
    "Thumbnail"100×75
    "Original"もとの画像サイズ

    • 注意点と問題点

    この製品は，Flickr APIを使うが，Flickrに認定されてはいない．

    例題

    例  (7)

    新規接続する：

    写真をキーワードで検索する：

    もとの写真へのリンクは，MetaInformationに提供される：

    写真を場所で検索する：

    キーワードまたは場所で，特定の日付範囲に撮影された写真を検索する：

    ユーザの写真を検索する：

    写真のコラージュを作る：

    ユーザのフォトアルバムあるいはフォトギャラリーについての情報を示す：

    特定のフォトギャラリーあるいはフォトアルバムについての情報を示す：