WebサービスAPIの使い方

目指せ！世界ジオコーダー　アルファ版

1. フリーワードで検索しXMLで取得

   国名、または都市名に対して、カタカナでの部分一致検索ができます。検索結果をXMLにて出力します。
   例：「ロンドン」でフリーワード検索

   http://geo.tatamilab.jp/geocode/?q=<検索文字列(地名、部分一致)>　※文字コード：utf8のみ
   
   取得例
   <results>
   <query>
   <q>ロンドン</q>
   </query>
   
   <candidate>
   <name>イーストロンドン</name>
   <latitude>-32.593</latitude>
   <longitude>27.543</longitude>
   <type>city</type>
   <link>http://geo.tatamilab.jp/cities/show3055</link>
   <country>南アフリカ</country>
   <country_id>394</country_id>
   </candidate>
   −
   <candidate>
   <name>ロンドン</name>
   <latitude>42.59</latitude>
   <longitude>-81.14</longitude>
   <type>city</type>
   <link>http://geo.tatamilab.jp/cities/show3100</link>
   <country>カナダ</country>
   <country_id>251</country_id>
   </candidate>
   　　　　：
   　　　　：
   </results>

2. 国一覧をXMLで取得

   登録されている国一覧を生成し、XMLにて出力します。
   例：世界の国一覧

   http://geo.tatamilab.jp/geocode/
   
   取得例
   <results>
   <query/>
   <candidate>
   <name>アイスランド</name>
   <latitude>65.1</latitude>
   <longitude>-18.1</longitude>
   <type>country</type>
   <link>http://geo.tatamilab.jp/countries/show302</link>
   </candidate>
   　　　:
   　　　:
   </results>

3. 国ごとの都市一覧をXMLで取得

   指定された国ごとに、都市一覧を生成し、XMLにて出力します。
   例：モンゴルの都市一覧

   http://geo.tatamilab.jp/geocode/?country=<国コード>　※国一覧で取得した国コード
   
   取得例
   <results>
   <query>
   <country_id>344</country_id>
   <query/>
   <candidate>
   <name>ウランバートル</name>
   <latitude>47.523</latitude>
   <longitude>106.48</longitude>
   <type>city</type>
   <link>http://localhost:3000/cities/show/2133</link>
   <country>モンゴル</country>
   <country_id>344</country_id>
   </candidate>
   −
   <candidate>
   <name>チョイバルサン</name>
   <latitude>48.0139</latitude>
   <longitude>114.255</longitude>
   <type>city</type>
   <link>http://localhost:3000/cities/show/2134</link>
   <country>モンゴル</country>
   <country_id>344</country_id>
   </candidate>
   　　　:
   　　　:
   </results>

4. 注意

   ・サービスは、予告無しに停止することがあります。

   ・取得したデータに関しての内容、精度等に対する保証はいたしません。

   ・原則たたみラボ利用規約に準じたサービスとなります。