場所情報API

リクエストURL

XML
https://map.yahooapis.jp/placeinfo/V1/get
JSONP
https://map.yahooapis.jp/placeinfo/V1/get

目次


概要

場所情報APIは、指定された緯度経度付近の主要ランドマーク名やエリア名などを返すAPIです。
「六本木、東京ミッドタウン、外苑東通り」など人がコミュニケーションの中でその場所を表現する際によく使う情報を返します。

  • 周辺施設名は、単に一番近くの施設ではなく、施設の種別ごとに設定された重要度と影響範囲をスコアリングすることによって、人がその場所を説明するのに最適な施設名を優先して返します。
  • エリア名は、観光地名や駅名などです。

利用イメージ

スマートフォンのGPS機能で取得した緯度経度情報から、「今○○付近にいます。」などと現在地をテキストで表現する際に活用できます。
住所では想像しにくい場所もエリア名や周辺施設名を使うことでわかりやすくなります。
例えば、次のような情報を取得できます。

  • 東京都港区赤坂9丁目(緯度:35.66521320007564、経度:139.7300114513391)の場合

    周辺施設名:東京ミッドタウン
    エリア名:六本木
    道路名:外苑東通り


  • 東京都渋谷区渋谷2丁目(緯度:35.65898718965676、経度:139.70277630100122)の場合

    周辺施設名:渋谷ヒカリエ
    エリア名:渋谷
    道路名:明治通り

※エリア名と周辺施設名はスコア順に複数の情報を取得できます。

リクエストパラメーター一覧

本APIは、GETメソッドのみサポートしています。「Web APIの使い方#GETとは」をご参照ください。

パラメーター 説明
appid(必須) string Client ID(アプリケーションID)。詳細はこちらをご覧ください。
lat(必須) float 緯度。10進度形式。世界測地系。
lon(必須) float 経度。10進度形式。世界測地系。
output string YDFの出力形式:
  • json - JSON(JSONP)形式(デフォルト)
  • xml - XML形式
callback string JSON(JSONP)として出力する際のコールバック関数名。

サンプルリクエストURL

東京都港区赤坂9丁目(緯度:35.66521320007564、経度:139.7300114513391)の場合

https://map.yahooapis.jp/placeinfo/V1/get?lat=35.66521320007564&lon=139.7300114513391&appid=<あなたのClient ID(アプリケーションID)>&output=json

レスポンスフィールド

フィールド 説明
ResultSet クエリーレスポンスのすべてを含みます。
 Result 周辺施設のリストです。
  Name 周辺施設名です。
  Category 周辺施設のカテゴリーです。
  Combined 表示用文字列(表示用場所名+表示用施設名)です。
  Where 表示用場所名です。
  Label 表示用施設名です。
  Uid 施設のUID(ユニークID)です。
  Score スコアです。大きいほど確度が上がります。
 Area エリアのリストです。
  Id エリアのIDです。
  Name エリア名です。
  Type エリアの種類です。
  • 1 - 大規模施設
  • 2 - エリア
  Score スコアです。大きいほど確度が上がります。
 Roadname 道路名です。
 Address 都道府県, 市区町村, 町大字, 町丁目(存在すれば)の配列です。
XMLの場合は半角スペースで区切られます。
 Govcode 行政コードです。
 Country 国情報です。
  Code 国コードです。
  Name 国名です。

サンプルレスポンス

https://map.yahooapis.jp/placeinfo/V1/get?lat=35.66521320007564&lon=139.7300114513391&appid=<あなたのClient ID(アプリケーションID)>&output=json

の結果を以下に示します。

サンプルレスポンス(JSON形式)

{
  "ResultSet": {
    "Result": [
      {
        "Combined": "外苑東通りの東京ミッドタウン付近",
        "Uid": "29586a2bea6bcea0f0934695959d389404b04269",
        "Score": 87.9099807710434,
        "Label": "東京ミッドタウン",
        "Name": "東京ミッドタウン",
        "Where": "外苑東通り",
        "Category": "ショッピングセンター・モール、複合商業施設"
      },
      {
        "Combined": "外苑東通りのガレリア付近",
        "Uid": "ea2608029527655a41f6c148260fef2eab7a7bc6",
        "Score": 87.3656565843029,
        "Label": "ガレリア",
        "Name": "ガレリア",
        "Where": "外苑東通り",
        "Category": "ショッピングセンター・モール、複合商業施設"
      },
      {
        "Combined": "外苑東通りのプレッセプレミアム東京ミッドタウン店付近",
        "Uid": "f747e832655f64b33578834f2c42ae36959e350b",
        "Score": 87.014615993934,
        "Label": "プレッセプレミアム東京ミッドタウン店",
        "Name": "プレッセプレミアム東京ミッドタウン店",
        "Where": "外苑東通り",
        "Category": "その他のスーパーマーケット"
      },
      {
        "Combined": "外苑東通りのユニクロ東京ミッドタウン店付近",
        "Uid": "64a2d39068e11dc4904f18ba89b4ba8d42f62224",
        "Score": 84.9923217077316,
        "Label": "ユニクロ東京ミッドタウン店",
        "Name": "ユニクロ東京ミッドタウン店",
        "Where": "外苑東通り",
        "Category": "大型専門店(衣料品)"
      },
      {
        "Combined": "外苑東通りのさわやか信用金庫六本木支店付近",
        "Uid": "a79454b26c4cf679f91d0c8c4b58515cda25e492",
        "Score": 73.5244736679095,
        "Label": "さわやか信用金庫六本木支店",
        "Name": "さわやか信用金庫六本木支店",
        "Where": "外苑東通り",
        "Category": "信用金庫"
      },
      {
        "Combined": "外苑東通りのMUJI東京ミッドタウン付近",
        "Uid": "70081aa713e6c30e7d6fbc8d9fb07d4cd956a90b",
        "Score": 65.8596268435632,
        "Label": "MUJI東京ミッドタウン",
        "Name": "MUJI東京ミッドタウン",
        "Where": "外苑東通り",
        "Category": "大型専門店(衣料品)"
      },
      {
        "Combined": "外苑東通りの東京ミッドタウン西交差点付近",
        "Uid": "fd6ea86d2d1089718b76e3b86450db724746c286",
        "Score": 49.3929643945868,
        "Label": "東京ミッドタウン西交差点",
        "Name": "東京ミッドタウン西",
        "Where": "外苑東通り",
        "Category": "地点名"
      },
      {
        "Combined": "外苑東通りのTSUTAYA MUSIC&BOOK STORE付近",
        "Uid": "b5cf9e62f5f6dce944357438b1e5cc397d6a991a",
        "Score": 48.7193793788076,
        "Label": "TSUTAYA MUSIC&BOOK STORE",
        "Name": "TSUTAYA MUSIC&BOOK STORE",
        "Where": "外苑東通り",
        "Category": "レンタルショップ"
      },
      {
        "Combined": "外苑東通りのBEAMS HOUSE ROPPONGI付近",
        "Uid": "8dd57b8c3a428dd63142bed32598361289289f43",
        "Score": 35.0850453821048,
        "Label": "BEAMS HOUSE ROPPONGI",
        "Name": "BEAMS HOUSE ROPPONGI",
        "Where": "外苑東通り",
        "Category": "大型専門店(衣料品)"
      },
      {
        "Combined": "外苑東通りのメルセデス・ベンツコネクション付近",
        "Uid": "bde427d488b99ac358db78102362aa078e85dcb7",
        "Score": 8.85588662576679,
        "Label": "メルセデス・ベンツコネクション",
        "Name": "メルセデス・ベンツコネクション",
        "Where": "外苑東通り",
        "Category": "名所・観光地等"
      },
      {
        "Combined": "外苑東通りの叙々苑六本木本店付近",
        "Uid": "95bc93d3aa9068e2afd9cf8123266f3f4b36c15d",
        "Score": 0.0115017607819381,
        "Label": "叙々苑六本木本店",
        "Name": "叙々苑六本木本店",
        "Where": "外苑東通り",
        "Category": "その他のファミリーレストラン"
      },
      {
        "Combined": "外苑東通りのビルボードライブ東京付近",
        "Uid": "0de552c8fdf663c2547768fd080d071222ded282",
        "Score": 1.35847734996468e-05,
        "Label": "ビルボードライブ東京",
        "Name": "ビルボードライブ東京",
        "Where": "外苑東通り",
        "Category": "ホール・会館"
      },
      {
        "Combined": "外苑東通りのトモズエクスプレス東京ミッドタウン店付近",
        "Uid": "e2054d94cc4ad2d9c55ad6993893bf5c32809847",
        "Score": 6.95202337303787e-06,
        "Label": "トモズエクスプレス東京ミッドタウン店",
        "Name": "トモズエクスプレス東京ミッドタウン店",
        "Where": "外苑東通り",
        "Category": "ドラッグストア"
      },
      {
        "Combined": "外苑東通りのザクラシカ東京付近",
        "Uid": "2eb6f48b4f359b611a73c8b44ddcba30eefa7571",
        "Score": 4.85862034069515e-06,
        "Label": "ザクラシカ東京",
        "Name": "ザクラシカ東京",
        "Where": "外苑東通り",
        "Category": "結婚式場"
      },
      {
        "Combined": "外苑東通りの出光石油付近",
        "Uid": "8b0f1e36b753d3c6d8b2d2913b00e72700f54b8b",
        "Score": 1.1964360736942e-06,
        "Label": "出光石油",
        "Name": "出光石油六本木SS",
        "Where": "外苑東通り",
        "Category": "出光石油"
      },
      {
        "Combined": "外苑東通りの麻布迎賓館付近",
        "Uid": "1987e6491387300c9f4ec37e8f2245eae258676d",
        "Score": 1.01093612756565e-08,
        "Label": "麻布迎賓館",
        "Name": "麻布迎賓館",
        "Where": "外苑東通り",
        "Category": "結婚式場"
      },
      {
        "Combined": "外苑東通りのセブンイレブン六本木7丁目店付近",
        "Uid": "05e65b95524a81adb257fe19fdbd0ae560943940",
        "Score": 9.69874580294341e-20,
        "Label": "セブンイレブン六本木7丁目店",
        "Name": "セブンイレブン六本木7丁目店",
        "Where": "外苑東通り",
        "Category": "セブン-イレブン"
      },
      {
        "Combined": "外苑東通りのセブンイレブン東京ミッドタウン店付近",
        "Uid": "50d8693dc8c635e342f6d9859bd9092907320e43",
        "Score": 3.32135911206335e-31,
        "Label": "セブンイレブン東京ミッドタウン店",
        "Name": "セブンイレブン東京ミッドタウン店",
        "Where": "外苑東通り",
        "Category": "セブン-イレブン"
      },
      {
        "Combined": "外苑東通りのファミリーマート六本木七丁目店付近",
        "Uid": "408f5edb161f4dcbf54b9bf1147f784477e646dd",
        "Score": 9.40472355241487e-43,
        "Label": "ファミリーマート六本木七丁目店",
        "Name": "ファミリーマート六本木七丁目店",
        "Where": "外苑東通り",
        "Category": "ファミリーマート"
      }
    ],
    "Country": {
      "Code": "JP",
      "Name": "日本"
    },
    "Address": [
      "東京都",
      "港区",
      "赤坂",
      "9丁目"
    ],
    "Area": [
      {
        "Score": 99.9999999986545,
        "Name": "六本木",
        "Id": "53dd9508-08cc-4c59-a9cc-e00715a181e6",
        "Type": 2
      },
      {
        "Score": 99.0,
        "Name": "ガレリア",
        "Id": "ea2608029527655a41f6c148260fef2eab7a7bc6",
        "Type": 1
      },
      {
        "Score": 99.0,
        "Name": "東京ミッドタウン",
        "Id": "29586a2bea6bcea0f0934695959d389404b04269",
        "Type": 1
      },
      {
        "Score": 50.0562143203225,
        "Name": "乃木神社",
        "Id": "00c7dca6-8fbe-4887-a52f-24517ca8a825",
        "Type": 2
      },
      {
        "Score": 21.5017934685757,
        "Name": "乃木坂",
        "Id": "70ae38e8-35c8-4473-b916-6ca60091e816",
        "Type": 2
      }
    ],
    "Govcode": "13103",
    "Roadname": "外苑東通り"
  }
}

サンプルレスポンス(XML形式)

- <ResultSet>
  <Govcode>13103</Govcode> 
- <Country>
  <Code>JP</Code> 
  <Name>日本</Name> 
  </Country>
  <Address>東京都 港区 赤坂 9丁目</Address> 
- <Area>
  <Name>六本木</Name> 
  <Type>2</Type> 
  <Id>53dd9508-08cc-4c59-a9cc-e00715a181e6</Id> 
  <Score>99.9999999986545</Score> 
  </Area>
- <Area>
  <Name>ガレリア</Name> 
  <Type>1</Type> 
  <Id>ea2608029527655a41f6c148260fef2eab7a7bc6</Id> 
  <Score>99.0</Score> 
  </Area>
- <Area>
  <Name>東京ミッドタウン</Name> 
  <Type>1</Type> 
  <Id>29586a2bea6bcea0f0934695959d389404b04269</Id> 
  <Score>99.0</Score> 
  </Area>
- <Area>
  <Name>乃木神社</Name> 
  <Type>2</Type> 
  <Id>00c7dca6-8fbe-4887-a52f-24517ca8a825</Id> 
  <Score>50.0562143203225</Score> 
  </Area>
- <Area>
  <Name>乃木坂</Name> 
  <Type>2</Type> 
  <Id>70ae38e8-35c8-4473-b916-6ca60091e816</Id> 
  <Score>21.5017934685757</Score> 
  </Area>
  <Roadname>外苑東通り</Roadname> 
- <Result>
  <Combined>外苑東通りの東京ミッドタウン付近</Combined> 
  <Name>東京ミッドタウン</Name> 
  <Where>外苑東通り</Where> 
  <Category>ショッピングセンター・モール、複合商業施設</Category> 
  <Label>東京ミッドタウン</Label> 
  <Score>87.9099807710434</Score> 
  <Uid>29586a2bea6bcea0f0934695959d389404b04269</Uid> 
  </Result>
- <Result>
  <Combined>外苑東通りのガレリア付近</Combined> 
  <Name>ガレリア</Name> 
  <Where>外苑東通り</Where> 
  <Category>ショッピングセンター・モール、複合商業施設</Category> 
  <Label>ガレリア</Label> 
  <Score>87.3656565843029</Score> 
  <Uid>ea2608029527655a41f6c148260fef2eab7a7bc6</Uid> 
  </Result>
- <Result>
  <Combined>外苑東通りのプレッセプレミアム東京ミッドタウン店付近</Combined> 
  <Name>プレッセプレミアム東京ミッドタウン店</Name> 
  <Where>外苑東通り</Where> 
  <Category>その他のスーパーマーケット</Category> 
  <Label>プレッセプレミアム東京ミッドタウン店</Label> 
  <Score>87.014615993934</Score> 
  <Uid>f747e832655f64b33578834f2c42ae36959e350b</Uid> 
  </Result>
- <Result>
  <Combined>外苑東通りのユニクロ東京ミッドタウン店付近</Combined> 
  <Name>ユニクロ東京ミッドタウン店</Name> 
  <Where>外苑東通り</Where> 
  <Category>大型専門店(衣料品)</Category> 
  <Label>ユニクロ東京ミッドタウン店</Label> 
  <Score>84.9923217077316</Score> 
  <Uid>64a2d39068e11dc4904f18ba89b4ba8d42f62224</Uid> 
  </Result>
- <Result>
  <Combined>外苑東通りのさわやか信用金庫六本木支店付近</Combined> 
  <Name>さわやか信用金庫六本木支店</Name> 
  <Where>外苑東通り</Where> 
  <Category>信用金庫</Category> 
  <Label>さわやか信用金庫六本木支店</Label> 
  <Score>73.5244736679095</Score> 
  <Uid>a79454b26c4cf679f91d0c8c4b58515cda25e492</Uid> 
  </Result>
- <Result>
  <Combined>外苑東通りのMUJI東京ミッドタウン付近</Combined> 
  <Name>MUJI東京ミッドタウン</Name> 
  <Where>外苑東通り</Where> 
  <Category>大型専門店(衣料品)</Category> 
  <Label>MUJI東京ミッドタウン</Label> 
  <Score>65.8596268435632</Score> 
  <Uid>70081aa713e6c30e7d6fbc8d9fb07d4cd956a90b</Uid> 
  </Result>
- <Result>
  <Combined>外苑東通りの東京ミッドタウン西交差点付近</Combined> 
  <Name>東京ミッドタウン西</Name> 
  <Where>外苑東通り</Where> 
  <Category>地点名</Category> 
  <Label>東京ミッドタウン西交差点</Label> 
  <Score>49.3929643945868</Score> 
  <Uid>fd6ea86d2d1089718b76e3b86450db724746c286</Uid> 
  </Result>
- <Result>
  <Combined>外苑東通りのTSUTAYA MUSIC&BOOK STORE付近</Combined> 
  <Name>TSUTAYA MUSIC&BOOK STORE</Name> 
  <Where>外苑東通り</Where> 
  <Category>レンタルショップ</Category> 
  <Label>TSUTAYA MUSIC&BOOK STORE</Label> 
  <Score>48.7193793788076</Score> 
  <Uid>b5cf9e62f5f6dce944357438b1e5cc397d6a991a</Uid> 
  </Result>
- <Result>
  <Combined>外苑東通りのBEAMS HOUSE ROPPONGI付近</Combined> 
  <Name>BEAMS HOUSE ROPPONGI</Name> 
  <Where>外苑東通り</Where> 
  <Category>大型専門店(衣料品)</Category> 
  <Label>BEAMS HOUSE ROPPONGI</Label> 
  <Score>35.0850453821048</Score> 
  <Uid>8dd57b8c3a428dd63142bed32598361289289f43</Uid> 
  </Result>
- <Result>
  <Combined>外苑東通りのメルセデス・ベンツコネクション付近</Combined> 
  <Name>メルセデス・ベンツコネクション</Name> 
  <Where>外苑東通り</Where> 
  <Category>名所・観光地等</Category> 
  <Label>メルセデス・ベンツコネクション</Label> 
  <Score>8.85588662576679</Score> 
  <Uid>bde427d488b99ac358db78102362aa078e85dcb7</Uid> 
  </Result>
- <Result>
  <Combined>外苑東通りの叙々苑六本木本店付近</Combined> 
  <Name>叙々苑六本木本店</Name> 
  <Where>外苑東通り</Where> 
  <Category>その他のファミリーレストラン</Category> 
  <Label>叙々苑六本木本店</Label> 
  <Score>0.0115017607819381</Score> 
  <Uid>95bc93d3aa9068e2afd9cf8123266f3f4b36c15d</Uid> 
  </Result>
- <Result>
  <Combined>外苑東通りのビルボードライブ東京付近</Combined> 
  <Name>ビルボードライブ東京</Name> 
  <Where>外苑東通り</Where> 
  <Category>ホール・会館</Category> 
  <Label>ビルボードライブ東京</Label> 
  <Score>1.35847734996468e-05</Score> 
  <Uid>0de552c8fdf663c2547768fd080d071222ded282</Uid> 
  </Result>
- <Result>
  <Combined>外苑東通りのトモズエクスプレス東京ミッドタウン店付近</Combined> 
  <Name>トモズエクスプレス東京ミッドタウン店</Name> 
  <Where>外苑東通り</Where> 
  <Category>ドラッグストア</Category> 
  <Label>トモズエクスプレス東京ミッドタウン店</Label> 
  <Score>6.95202337303787e-06</Score> 
  <Uid>e2054d94cc4ad2d9c55ad6993893bf5c32809847</Uid> 
  </Result>
- <Result>
  <Combined>外苑東通りのザクラシカ東京付近</Combined> 
  <Name>ザクラシカ東京</Name> 
  <Where>外苑東通り</Where> 
  <Category>結婚式場</Category> 
  <Label>ザクラシカ東京</Label> 
  <Score>4.85862034069515e-06</Score> 
  <Uid>2eb6f48b4f359b611a73c8b44ddcba30eefa7571</Uid> 
  </Result>
- <Result>
  <Combined>外苑東通りの出光石油付近</Combined> 
  <Name>出光石油六本木SS</Name> 
  <Where>外苑東通り</Where> 
  <Category>出光石油</Category> 
  <Label>出光石油</Label> 
  <Score>1.1964360736942e-06</Score> 
  <Uid>8b0f1e36b753d3c6d8b2d2913b00e72700f54b8b</Uid> 
  </Result>
- <Result>
  <Combined>外苑東通りの麻布迎賓館付近</Combined> 
  <Name>麻布迎賓館</Name> 
  <Where>外苑東通り</Where> 
  <Category>結婚式場</Category> 
  <Label>麻布迎賓館</Label> 
  <Score>1.01093612756565e-08</Score> 
  <Uid>1987e6491387300c9f4ec37e8f2245eae258676d</Uid> 
  </Result>
- <Result>
  <Combined>外苑東通りのセブンイレブン六本木7丁目店付近</Combined> 
  <Name>セブンイレブン六本木7丁目店</Name> 
  <Where>外苑東通り</Where> 
  <Category>セブン-イレブン</Category> 
  <Label>セブンイレブン六本木7丁目店</Label> 
  <Score>9.69874580294341e-20</Score> 
  <Uid>05e65b95524a81adb257fe19fdbd0ae560943940</Uid> 
  </Result>
- <Result>
  <Combined>外苑東通りのセブンイレブン東京ミッドタウン店付近</Combined> 
  <Name>セブンイレブン東京ミッドタウン店</Name> 
  <Where>外苑東通り</Where> 
  <Category>セブン-イレブン</Category> 
  <Label>セブンイレブン東京ミッドタウン店</Label> 
  <Score>3.32135911206335e-31</Score> 
  <Uid>50d8693dc8c635e342f6d9859bd9092907320e43</Uid> 
  </Result>
- <Result>
  <Combined>外苑東通りのファミリーマート六本木七丁目店付近</Combined> 
  <Name>ファミリーマート六本木七丁目店</Name> 
  <Where>外苑東通り</Where> 
  <Category>ファミリーマート</Category> 
  <Label>ファミリーマート六本木七丁目店</Label> 
  <Score>9.40472355241487e-43</Score> 
  <Uid>408f5edb161f4dcbf54b9bf1147f784477e646dd</Uid> 
  </Result>
  </ResultSet>

エラー

場所情報APIはYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。

利用制限

場所情報APIは、24時間中1つのアプリケーションにつき50000件のリクエストが上限となっています。詳しくは「利用制限」をご参照ください。

アプリケーションの管理

目次

利用のルール

開発のヒント