flickr.places.find

クエリー文字列に対応する場所IDの一覧を取得します。

flickr.places.find メソッドはジオコーダ(住所などから経度・緯度情報を取得するもの) ではありません。 これで取得される情報は場所IDが適用できる最も近い場所まで切り上げられます。 例えば、あたなが「通り」レベルの住所を設定した場合でも、このメソッドは「通り」や「建物」レベルの精度ではなく、その住所を内部範囲に含む「都市」レベルの情報を返します。

認証

このメソッドには認証は必要ありません。

Arguments

api_key (Required)
あなたのAPIアプリケーションキー。詳細についてはここを参照してください。
query (Required)
場所IDを検索するために使うクエリー文字列

サーバからの応答例

<places query="Alabama" total="3">
  <place place_id="VrrjuESbApjeFS4." woeid="2347559" latitude="32.614" longitude="-86.680" place_url="/United+States/Alabama" place_type="region">Alabama, Alabama, United States</place>
  <place place_id="cGHuc0mbApmzEHoP" woeid="2352520" latitude="43.096" longitude="-78.389" place_url="/United+States/New+York/Alabama" place_type="locality">Alabama, New York, United States</place>
  <place place_id="o4yVPEqYBJvFMP8Q" woeid="1579389" latitude="-26.866" longitude="26.583" place_url="/South+Africa/North+West/Alabama" place_type="locality">Alabama, North West, South Africa</place>
</places>

同じ名前を持つ別々の地域を区別するため、取得される場所情報は場所ID(www.flickr.com/places 配下のURLに対応している)と場所タイプを持っています。

エラーコード

1: Required parameter missing
APIの実行に必要なパラメータのうちいくつかが設定されていません。
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.find



注意事項

  • 本サイトはflickrのサイトを翻訳したものであり、flickrに関する著作権は全てそちらに帰属しています。
  • 誤訳が判明した場合、より分かりやすい言い回しが見つかった場合、原文が変更された場合などにより、本サイトの内容は予告なく変更されることがあります。
  • 誤訳についての指摘や未翻訳部分についての助言など、ご意見についてはこちらへいただけると助かります。
  • 翻訳の内容には誤りがある可能性があります。本サイトの記述内容によって不利益が発生した場合も、サイト管理人は一切の責任を負いません。
    •