ktailab世界都市API

for English page, please click here.

開発のねらい

都市名を指定して、その緯度、経度を調べる「whereis」と、緯度経度を指定してその近くの都市リストを返す「nearbycity」の2本で構成しています。API仕様は以下をご覧ください。

作成した検索サービスはこちらです。

2008/05/06 : 登録されている都市の件数は約2300件です。

API仕様 (whereis)

URI : http://api.ktailab.net/cgi-bin/whereis.cgi?city=$city&apikey=000000000000000000

入力パラメータ :

city=都市名 - UTF-8で表現した日本語（カナ）都市名か、英語都市名です。文字列マッチ処理を行います。
(country=国名 - UTF-8で表現した日本語（カナ）国名か、英語国名です。この場合は首都を返します。）
apikey=000000000000000000 (0が18個)はお試しでご利用いただけますが、利用時間が毎時00-29分に限られます。正式APIkey発行手順はこちらをご覧ください。

API仕様 (nearbycity)

URI : http://api.ktailab.net/cgi-bin/nearbycity.cgi?lat=$lat&lon=$lon(&dist=$dist)&apikey=000000000000000000

入力パラメータ :

lat=dd.ddddd（実数） - WGS84で表示した緯度です。度分秒形式(DD.MM.SS.SSにも対応しています。）
lon=ddd.ddddd（実数） - 同じく経度です。度分秒形式(DDD.MM.SS.SSにも対応しています。）
dist=ddd(整数） - 指定した地点からの探索半径をmで表示します。省略すると100kmとなります。
apikey=000000000000000000 (0が18個)はお試しでご利用いただけますが、利用時間が毎時00-29分に限られます。正式APIkey発行手順はこちらをご覧ください。

共通出力形式

文字コード : UTF-8です。（英字のみです。）
フォーマット : XMLです。
- country - 英文字国名です。
- city - 英文字都市名です。
- lat - 緯度です。WGS84。
- lon - 経度です。WGS84。

例

変更履歴

ver 1.0.0 : ベータ版公開 2008/05/22
ver 1.2.0 : リクエスト先URLを変更しました。2009/12/08

注意

予告なくサービス停止または仕様変更する可能性があります。またこの検索結果の位置精度について何の保証もいたしません。同様にスペルについても正確性を保証しません。また非合法活動や個人のプライバシーを侵害する目的で利用することはできません。
当APIを利用した結果生じたいかなる損失・損害についても製作者は一切の責任を負いません。