2013年3月17日日曜日

Product Advertising API で提供される画像

Product Advertising API で提供される画像

Amazon には、商品の画像が何百万点も登録されています。次の画像の URL からわかるように、これらの画像は、画像提供専用の数台のサーバ上に格納されています。http://images.amazon.com/images/P/B000BNM5OA.01_SL110_.jpg

全ての画像のURLは同じ構造になっています。

URLの部分

説明
エンドポイント
画像サーバの URL です。どの画像でも、http://images.amazon.com/images/P/と表記されます。
英数字の文字列

B000BNM5OA.01.SWCH など、画像を一意に識別する ID。01 は国コードです。画像に表示される言語は各国ごとに異なるため、国コードは重要です。次に示すのは、国コード値の一覧です。
01 - US, CA
02 - UK
03 - DE
08 - FR
09 - JP

サフィックス
返される画像のサイズを指定します。サフィックスの種類は次の通りです。
大: _SL500_.jpg
中: ._SL160_.jpg
小: ._SL110_.jpg
サムネイル: ._SL110_.jpg
特小: ._SL75_.jpg
極小 (スウォッチ): _SL30_.jpg


注意

小とサムネイルのサイズは同じです。

サフィックスを見るとわかるように、数値は、画像の長辺の最大ピクセル数を表しています。通常、Amazon の画像は、ファイル名で指定されたピクセル数で構成されています。つまり、_SL500_.jpg の画像は、長辺の長さが500ピクセルになります。Amazon 以外から提供される画像は、正確に500ピクセルであるとは限りません。返される画像は、画像のファイル名に指定されているサイズ以下で、種類としては最も大きいものです。例えば、_SL500_.jpg の画像でも、長辺が400ピクセルしかない場合があります。


1インチあたりのピクセル数は96です。

次の例は、大中小の各サイズの画像を並べて相対的な大きさを示しています。






全て同じ画像でサイズだけが異なります。上の画像はいずれも画像IDが同じで、サイズを示すサフィックスだけが異なります。各画像は、その次に大きなサイズの約半分になっています。


画像は増えたり、なくなったりするため、画像の URL をアプリケーションにハードコーディングすることは、お勧めできません。Images または VariationImages レスポンスグループを使用して画像を返すことで、最新の画像 URL であることが保証されます。画像の URL を取得したら、画像名のサフィックスを書き換えるだけで異なるサイズの画像を表示することができます。これにより、異なるサイズの画像ごとにリクエストを送信する必要がなくなります。


参考URL
https://images-na.ssl-images-amazon.com/images/G/09/associates/paapi/dg/UnderstandingImagesSuppliedbyA2S.html


0 件のコメント: