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

リクエストURL

目次

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

概要

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

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

「RESTリクエストの構築（GET）」をご参照ください。

サンプルリクエスト

日本橋（東京）の住所検索（緯度：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

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

サンプルレスポンス

以下は、東京都港区赤坂９丁目７－１（緯度：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>

エラー

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