Flickr API ドキュメント日本語訳 |
flickr.places.getTopPlacesList
一日で最もジオタグが付けられた場所のトップ100を取得します。
認証
このメソッドには認証は必要ありません。
引数
api_key
(Required)- あなたのAPIアプリケーションキー。詳細についてはここを参照してください。
place_type_id
(Required)- 写真をクラスタ化するのに使われる場所タイプを数字で表したID
有効な場所タイプIDは以下の通りです :- 22: 近所
- 7: 地方
- 8: 地域
- 12: 国
- 29: 大陸
date
(Optional)- 有効な日付型は YYYY-MM-DD 形式になります。既定では昨日の日付が設定されます。
woe_id
(Optional)- 検索対象を、ここで設定した 地球上での位置ID (WOE)に属する場所に限定します。
place_id
(Optional)- 検索対象を、ここで設定した Flickrの場所IDに属する場所に限定します。
サーバからの応答例
<places total="100" date_start="1246320000" date_stop="1246406399"> <place place_id="4KO02SibApitvSBieQ" woeid="23424977" latitude="48.890" longitude="-116.982" place_url="/United+States" place_type="country" place_type_id="12" photo_count="23371">United States</place> </places>
エラーコード
1: Required parameter missing
- リクエストに必要なパラメータのうちいくつかが設定されていません。
2: Not a valid place type.
- リクエストに不明の場所タイプID、もしくはサポートされていない場所タイプIDが設定されています。
3: Not a valid date.
- リクエストに設定されたdate引数が無効です。
4: Not a valid Place ID
- リクエストに無効な場所ID(もしくはWOE ID)が含まれています。
100: Invalid API Key
- 送信されたAPIキーは無効か、既に失効しています。
105: Service currently unavailable
- 要求されたサービスは、一時的に利用できない状態です。
106: Write operation failed
- 要求された操作は、一時的な問題のために失敗しました。
111: Format "xxx" not found
- 要求された応答形式は見つかりませんでした。
112: Method "xxx" not found
- 要求されたメソッドは見つかりませんでした。
114: Invalid SOAP envelope
- リクエスト時に送信されたSOAPエンベロープを解析できませんでした。
115: Invalid XML-RPC Method Call
- リクエスト時に送信されたXML-RPC ドキュメントを解析できませんでした。
116: Bad URL found
- 引数の中に、Flickrに対して有害なURLが含まれています。
API 体験
API 体験 : flickr.places.getTopPlacesList
注意事項 |