MA8ミートアップ記念! MA8用にAPIを二つ追加!

ジオどす技術担当の上田です。

本日2012/9/17、MA8(Mashup Award 8)のミートアップイベントが京都で開催されます。
せっかくなので実験中のリバースジオコーディング系のサービスをAPIにしました。

MA作品限定で無償公開します。
1.ジオどすⅡ リバースジオコーダAPI
2.ジオどすⅡ 場所説明API
けっこう面白い使い方ができるとおもいます。

なお、実験中サービスであるため、精度が不十分な場合があります。
本APIにつきましてはジオどす2APIの利用規約に準拠するものとします。

1.ジオどすⅡ リバースジオコーダAPI

緯度経度から「○○通△△上ル」などの通り名形式の住所を返します。絡内(道路がいわゆる碁盤の目状になっているエリア)以外では実用的な結果が返らないので注意してください。京都市の通り名では一つの緯度経度に複数の通り名住所を使えますので、リバースジオコーダでは複数の住所候補を返します。また、起点となる交差点からの直線距離も返します。(通常は、最も距離が短いデータを使うのが実用的です)

● リクエスト形式
GETまたはPOST
 
●URI
http://api.geodosu.com/v2/reverse?
 
●必須パラメータ
apikey      登録時に発行するAPIキー文字列。
lat                       緯度。WGS84(世界測地系)で、小数点付の度で指定。
 

lon                      経度。WGS84(世界測地系)で、小数点付の度で指定。

●オプションパラメータ
output                xml(default) XMLで返す
                           json json形式で返す
callback            output=jsonの時に指定するとJSONP 形式となります。コールバック関数の名前です。

レスポンス例

 

XMLのレスポンス
<?xml version="1.0" encoding="UTF-8"?>
<results>
    <geocoder>geodosu2</geocoder>
    <copyright>ジオどすⅡリバースジオコーダAPI</copyright>
    <result>
        <addresses>
        <address>富小路御池上ル</address>
        <distance>69</distance>
        </addresses>
    </result>
    <result>
        <addresses>
        <address>富小路御池東入ル</address>
        <distance>80</distance>
        </addresses>
    </result>
    :
    :    
    
</results>

JSONのレスポンス

{"geocoder":"geodosu2","copyright":"ジオどすⅡリバースジオコーダAPI","result":[{"addresses":{"address":"富小路御池上ル","distance":"69"}},{"addresses":{"address":"富小路御池東入ル","distance":"80"}},{"addresses":{"address":"富小路押小路下ル","distance":"51"}},{"addresses":{"address":"富小路押小路東入ル","distance":"81"}},{"addresses":{"address":"麩屋町御池上ル","distance":"69"}},{"addresses":{"address":"麩屋町御池西入ル","distance":"0"}},{"addresses":{"address":"麩屋町押小路下ル","distance":"49"}},{"addresses":{"address":"麩屋町押小路西入ル","distance":"2"}}]}

 

 
緯度経度から「麩屋町 押小路 の交差点と麩屋町 御池 の交差点の間です。」など、場所を説明する文言を返します。
文言は漢字の通り名を含む日本語、ひらがな、および英語になっています。
絡内(道路がいわゆる碁盤の目状になっているエリア)以外では実用的な結果が返らないので注意してください。
 
● リクエスト形式
GETまたはPOST
 
●URI
http://api.geodosu.com/v2/tellwhere?
 
●必須パラメータ
apikey      登録時に発行するAPIキー文字列。
lat                       緯度。WGS84(世界測地系)で、小数点付の度で指定。
lon                      経度。WGS84(世界測地系)で、小数点付の度で指定。
●オプションパラメータ
output                xml(default) XMLで返す
                           json json形式で返す
callback            output=jsonの時に指定するとJSONP 形式となります。コールバック関数の名前です。
 
レスポンス例
 
XMLのレスポンス
<results>
    <geocoder>geodosu2</geocoder>
    <copyright>ジオどすⅡ場所説明API</copyright>
    <result>
        <kanji>麩屋町 押小路 の交差点と麩屋町 御池 の交差点の間です。</kanji>
        <hira>ふやちょう おしこうじ の こうさてん と ふやちょう おいけ の こうさてん のあいだです</hira>
        <roma>On Fuyacho Street, Between Oshikoji and Oike</roma>
    </result>
</results>
 
JSONのレスポンス
{"geocoder":"geodosu2","copyright":"ジオどすⅡ場所説明API","result":{"kanji":"麩屋町 押小路 の交差点と麩屋町 御池 の交差点の間です。","hira":"ふやちょう おしこうじ の こうさてん と ふやちょう おいけ の こうさてん のあいだです ","roma":"On Fuyacho Street, Between Oshikoji and  Oike "}}
 
 

Comments

Post new comment

The content of this field is kept private and will not be shown publicly.
  • Web page addresses and e-mail addresses turn into links automatically.
  • Allowed HTML tags: <a> <em> <strong> <cite> <code> <ul> <ol> <li> <dl> <dt> <dd><img><br><p>
  • Lines and paragraphs break automatically.

More information about formatting options