Yahoo!リバースジオコーダAPI

リクエストURL

リクエストURLは上記URLをご利用ください。AOSSL対応以前の旧URLは予告なくクローズします。

目次

• 概要
• リクエストパラメータ一覧
• レスポンスフィールド
• サンプルレスポンス
• エラー

---

概要

Yahoo!リバースジオコーダAPI（以下、リバースジオコーダAPI）は、緯度・経度で指定された場所の住所検索結果を返します。

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

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

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

サンプルリクエスト

日本橋（東京）の住所検索（緯度：35.68381981、経度：139.77456498）

https://map.yahooapis.jp/geoapi/V1/reverseGeoCoder?lat=35.68381981&lon=139.77456498&appid=<あなたのアプリケーションID>

レスポンスフィールド

リバースジオコーダAPIのスキーマの記述は、以下のURLをご覧ください。
http://olp.yahooapis.jp/OpenLocalPlatform/V1/YDF.xsd

フィールド	説明
YDF	クエリーレスポンスのすべてを含みます。
ResultInfo	レスポンスのまとめ情報。
Count	レスポンス情報に含まれる住所情報のデータ件数。
Total	出力されている住所情報以外も含めた全データ件数。
Start	レスポンス情報に含まれる住所情報の、全データからの取得開始位置。
Latency	レスポンス情報を生成するのに要した時間。
Status	リクエスト元に処理結果を伝えるためのコード。 正常終了の場合、200を出力します。エラー時は、下記エラー項目を参照してください。
Description	データの説明。詳細情報がある場合に表示されます。
Copyright	コピーライト。
Feature	検索結果1件分のデータ群。
Property	各種データを格納。
Country	国情報。
Code	国（ISO）コード。
Name	国名。
Address	1行であらわす住所。
AddressElement	部分住所情報。
Level	住所レベル： prefecture - 都道府県 city - 市区町村 oaza - 大字 aza - 字 detail1 - 街区
Code	行政コード。
Name	部分住所。
Building	ビル情報。
Id	ビルID（ビル情報部分）
Name	ビル名称（ビル情報部分）
Floor	ビル最上階数（ビル情報部分）
Area	面積（ビル情報部分）
Road	道路情報。
Name	道路名（道路情報）
Kana	道路名かな（道路情報）
PopularName	通称名（道路情報）
PopularKana	通称名かな（道路情報）
Geometry	拠点の場所を表すGeometry要素です。
Type	図形情報
Coordinates	座標情報です。

※海上の住所は取得できません。

サンプルレスポンス

以下は、東京都港区赤坂９丁目７－１（緯度：35.666049811559205、経度：139.73134257366763）の住所検索のリクエストに対するレスポンスです。

<YDF xmlns="http://olp.yahooapis.jp/ydf/1.0" firstResultPosition="1" totalResultsAvailable="1" totalResultsReturned="1">
  <ResultInfo>
    <Count>1</Count>
    <Total>1</Total>
    <Start>1</Start>
    <Latency>0.18004202842712</Latency>
    <Status>200</Status>
    <Description>指定の地点の住所情報を取得する機能を提供します。</Description>
    <Copyright>
      Copyright (C) 2013 Yahoo Japan Corporation. All Rights Reserved.
    </Copyright>
    <CompressType/>
  </ResultInfo>
  <Feature>
    <Property>
      <Country>
        <Code>JP</Code>
        <Name>日本</Name>
      </Country>
      <Address>東京都港区赤坂９丁目７－１</Address>
      <AddressElement>
        <Name>東京都</Name>
        <Kana>とうきょうと</Kana>
        <Level>prefecture</Level>
        <Code>13</Code>
      </AddressElement>
      <AddressElement>
        <Name>港区</Name>
        <Kana>みなとく</Kana>
        <Level>city</Level>
        <Code>13103</Code>
      </AddressElement>
      <AddressElement>
        <Name>赤坂</Name>
        <Kana>あかさか</Kana>
        <Level>oaza</Level>
      </AddressElement>
      <AddressElement>
        <Name>９丁目</Name>
        <Kana>９ちょうめ</Kana>
        <Level>aza</Level>
      </AddressElement>
      <AddressElement>
        <Name>７</Name>
        <Kana>７</Kana>
        <Level>detail1</Level>
      </AddressElement>
      <Building>
        <Id>B@iXzXO-G3A</Id>
        <Name>ミッドタウン・タワー</Name>
        <Floor>54</Floor>
        <Area>5147</Area>
      </Building>
    </Property>
    <Geometry>
      <Type>point</Type>
      <Coordinates>139.73134257366763,35.666049811559205</Coordinates>
    </Geometry>
  </Feature>
</YDF>

エラー

コード	説明
400	渡されたパラメータがWeb APIで期待されたものと一致しない場合に返されます。
204	指定された場所の住所情報が見つからない場合に返されます。
1004	緯度・経度の指定が正しくない場合に返されます。

<?xml version="1.0" encoding="UTF-8"?>
<Error>
    <Message>0 Match From To parameter.</Message>
    <Code>204</Code>
</Error>