Flickr API ドキュメント日本語訳 |
flickr.photos.geo.setLocation
写真の地理データ(経度、緯度、追加で精度レベル)を設定します。
既定では、位置データを写真に設定する前にそのデータを誰が参照できるか定義しておかなければなりません。
http://www.flickr.com/account/geo/privacy/にてこの設定を編集することができます。
この設定がされていない場合、このAPIメソッドはエラーを返します。
認証
このメソッドには「書き込み」権限の認証が必要です。
注意: このメソッドはHTTP POST リクエストを使用します。
引数
api_key
(Required)- あなたのAPIアプリケーションキー。詳細についてはここを参照してください。
photo_id
(Required)- 位置データを設定する写真のID。
lat
(Required)- 更新する写真の経度。有効な値は-90 to 90です。小数点第6位よりも下の部分は切り捨てられます。
lon
(Required)- 更新する写真の緯度。有効な値は-180 to 180です。小数点第6位よりも下の部分は切り捨てられます。
accuracy
(Optional)- 保存された写真の精度を更新します。世界レベルは 1、国レベルは ~3、地域レベルは ~6、都市レベルは ~11、通りレベルは ~16。 現在設定できる範囲は 1-16です。この値が設定されていない場合、既定では 16 が設定されます。
context
(Optional)- コンテキストは、経度や緯度とは別の、写真のジオタグを表す数値です。例えば、写真を撮影したのが"室内"か"室外"かを現したい場合などに使えます。.
現在使用できるコンテキストIDの一覧を以下の通りです :
- 0, 定義されていない。
- 1, 室内。
- 2, 室外。
写真にタグ付けされている既定のコンテキストは0もしくは "not defined"です。
サーバからの応答例
このメソッドでは特別な応答はありません - エラーなしで完了した場合、空の成功応答が返ります。
エラーコード
1: Photo not found
- この写真IDは無効か、もしくはメソッド実行ユーザーには参照権限がない写真です。
2: Required arguments missing.
- 必須引数の一部または全部が設定されていません。
3: Not a valid latitude.
- 経度に設定した引数が有効ではありません。
4: Not a valid longitude.
- 緯度に設定した引数が有効ではありません。
5: Not a valid accuracy.
- 精度に設定された引数が有効ではありません。
6: Server error.
- 写真に位置情報を設定する際に予期せぬトラブルが発生しました。
7: User has not configured default viewing settings for location data.
- 写真にロケーションデータを設定する前に、既定では、そのデータは誰が参照できるかを定義しなければなりません。 この設定は http://www.flickr.com/account/geo/privacy/で編集できます。
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.setLocation
注意事項 |