Flickr API ドキュメント日本語訳 |
flickr.photos.geo.photosForLocation
メソッド実行ユーザーの写真の中から、指定した緯度・経度・精度を持つ一覧を取得します。
認証
このメソッドには「読み込み」権限の認証が必要です。
引数
api_key
(Required)- あなたのAPIアプリケーションキー。詳細についてはここを参照してください。
lat
(Required)- 更新する写真の経度。有効な値は-90 から 90です。小数点第6位よりも下の部分は切り捨てられます。
lon
(Required)- 更新する写真の緯度。有効な値は-180 から 180です。小数点第6位よりも下の部分は切り捨てられます。
accuracy
(Optional)- 保存された写真の精度を更新します。世界レベルは 1、国レベルは ~3、地域レベルは ~6、都市レベルは ~11、通りレベルは ~16。 現在設定できる範囲は 1-16です。この値が設定されていない場合、既定では 16 が設定されます。
extras
(Optional)- 追加で取得したい情報があれば、その情報が保存されているフィールドをコンマ区切りで設定します。現時点では、以下のフィールドをサポートしています:
description
,license
,date_upload
,date_taken
,owner_name
,icon_server
,original_format
,last_update
,geo
,tags
,machine_tags
,o_dims
,views
,media
,path_alias
,url_sq
,url_t
,url_s
,url_q
,url_m
,url_n
,url_z
,url_c
,url_l
,url_o
per_page
(Optional)- 1ページ当たりに出力する写真数。この引数を省略した場合、既定では100が設定されます。設定できる最大値は500です。
page
(Optional)- 出力するページのページ番号。この引数が省略された場合、既定では1が設定されます。
サーバからの応答例
このメソッドでは、標準的なxml形式の写真一覧を戻り値として返します:
<photos page="2" pages="89" perpage="10" total="881"> <photo id="2636" owner="47058503995@N01" secret="a123456" server="2" title="test_04" ispublic="1" isfriend="0" isfamily="0" /> <photo id="2635" owner="47058503995@N01" secret="b123456" server="2" title="test_03" ispublic="0" isfriend="1" isfamily="1" /> <photo id="2633" owner="47058503995@N01" secret="c123456" server="2" title="test_01" ispublic="1" isfriend="0" isfamily="0" /> <photo id="2610" owner="12037949754@N01" secret="d123456" server="2" title="00_tall" ispublic="1" isfriend="0" isfamily="0" /> </photos>
<photo>
エレメントからそのURLを割り出す方法については、 url ドキュメントを参照してください。
エラーコード
1: Required arguments missing
- メソッドの実行に必要な引数のうち一つ以上が設定されていません。
2: Not a valid latitude
- 経度に設定した引数が有効ではありません。
3: Not a valid longitude
- 緯度に設定した引数が有効ではありません。
4: Not a valid accuracy
- 精度に設定された引数が有効ではありません。
95: SSL is required
- Flickr APIにはSSLでの接続が必要です。
96: Invalid signature
- 送信された署名は無効です。
97: Missing signature
- 実行には署名が必要ですが、署名が送信されていませんでした。
98: Login failed / Invalid auth token
- 送信されたログイン情報や認証トークンが無効です。
99: User not logged in / Insufficient permissions
- このメソッドの実行にはユーザー認証が必要ですが、ユーザがログインしていないか、認証メソッドを実行するのに必要な権限がありません。
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.photos.geo.photosForLocation
注意事項 |