SimpleAPI「最寄り駅Webサービス」とは？

　経緯度データを指定すると、その付近にある駅(もより駅)の駅名や方角などを表示するウェブAPI(Web Service)です。たとえば、東京ドーム(東京都文京区後楽1-3)の経緯度データ(x、yで指定)を渡すと、後楽園駅や水道橋駅といった最寄り駅のデータや最寄り駅地図を返します。

　「この場所って駅からどれくらい？どっち？」というのを調べてくれるAPIです。最近ではGoogleMapsなど地図がらみのAPIが流行っているのでそれと合わせて利用すると、いっそう便利になります。

　SimpleAPIシリーズの特徴でもある画像方式のAPIやJavascriptやHTML出力も用意しており、プログラム無しで最寄り駅地図画像を表示することができます(※1ページあたり最大10枚まで)。

　画像地図は、PC用あるいはケータイ向けサイトなどで、簡単な位置を示すのに適しています。実際に携帯ブラウザから見てみると意外に見栄えが良いようです。

　とくに、端末の登場が今後予想されるケータイのGPS機能を勝手サイトで有効活用できます。

　組み込み利用にあたっては、1ページあたり10リクエスト以下でお願いします。また、下記仕様と「利用上の注意」をよくご覧のうえサイトに組み込んでください。また、最新情報は、SimpleAPI 開発日記でご覧いただけます。


SimpleAPIシリーズのコンセプトは？

　SimpleAPIは、複雑化しがちな現在のWeb業界において、ウェブサイト作成初心者でも利用しやすいAPIを続々提供することを目標としています。とくにWebプログラミング言語やXMLやJSONを利用せずに利用できる画像方式やHTML、iframeを利用した簡易APIを今後提供していきます。

　第1弾としては、サムネイル作成APIがあります。

簡単な使い方

▽一番簡単な使い方 : xy座標を指定して地図画像を取得
http://map.simpleapi.net/stationmap?x=139.75271700&y=35.70481800

▽簡単な使い方 : 地名を指定して地図画像を取得
http://map.simpleapi.net/stationmap?q=中央区銀座6-4 (要URLエンコード)

▽簡単な使い方 : xy座標を指定してHTMLソースを取得
http://map.simpleapi.net/stationapi?x=139.75271700&y=35.70481800&output=html

▽簡単な使い方 : xy座標を指定してJavascriptで自動挿入
<script language="javascript" charset="UTF-8" type="text/javascript" src="http://map.simpleapi.net/stationapi?x=139.6980&y=35.6580&output=javascript"></script>
ウェブサイトのHTMLにこのようなコードを埋め込むと、自動的に表示します。

SimpleAPI最寄り駅Webサービス 利用事例

SimpleAPI最寄り駅Webサービス 入力仕様

APIのURI : http://map.simpleapi.net/stationapi

地図画像取得のURI : http://map.simpleapi.net/stationmap

パラメータは、GETあるいはPOSTで指定します。文字コードは入力は現在UTF-8のみ。出力はUTF-8固定。

  • x : 経度座標(度指定)。エイリアスとしてlng、longitudeも可
  • y : 緯度座標(度指定)。エイリアスとしてlat、latitudeも可
  • datum : 測地系。wgs84（世界測地系）、tokyo（日本測地系）を指定可能。デフォルトはwgs84
  • p : 住所、駅名をを指定。緯度経度の代わりに直接住所を指定することができる。重複する駅名は、「八丁堀 広島県」とスペースのあとに都道府県名を指定することで特定できる。エイリアスとしてqも可能。UTF-8（URLエンコードしたもの）で渡すこと
    ※この機能は現在ベータテスト中につき、将来的にはサポートを中止あるいはリクエスト回数を制限する可能性がある。「千代田区平河町1-1」といったふうに、「区市町村名から○丁目○番」の部分までのみを指定すること。これ以外の指定方式では正常に動作しないことがある。
  • output : 出力方式。省略可能。デフォルトはxml。xml（XML）、html（html）、javascript（Javascript）、json（JSON）、php（PHPシリアライズ）
  • callback : JSONPの関数名を指定。outputがJSONのときのみ。

SimpleAPI最寄り駅Webサービス 出力仕様

　まずは出力サンプルをご覧ください。(出力サンプル1 , 出力サンプル2 , 出力サンプル3)。それぞれの情報内容は下記のとおりです。

  • name 駅名
  • furigana ふりがな
  • line 路線
  • city 市町村
  • url 駅情報ページURL
  • prefecture 都道府県
  • direction 指定地点からの駅方角
  • directionReverse 駅からの指定地点の方角
  • distance 直線距離(m)
  • distanceM 直線距離(メートル記述)
  • distanceKm 直線距離(キロメートル記述)
  • traveltime 直線距離での徒歩時間

表示サンプル

　このサンプルの最寄り駅一覧の表示には、output=javascriptによるjavascript動的差し込みを利用しています。下記のようなHTMLソースで、プログラミング言語を介さず呼び出すことができます。

<script language="javascript" charset="UTF-8" type="text/javascript" src="http://map.simpleapi.net/stationapi?x=139.6980&y=35.6580&output=javascript"></script>

東京都中央区新川1-8-2付近 → x:139.7825 y:35.6782

XML : http://map.simpleapi.net/stationapi?x=139.7825&y=35.6782
地図 : http://map.simpleapi.net/stationmap?x=139.7825&y=35.6782

javascriptで差し込み表示 →
愛知県名古屋市千種区内山3-4-4付近 → x:136.9346 y:35.1717

XML : http://map.simpleapi.net/stationapi?x=136.9346&y=35.1717
地図 : http://map.simpleapi.net/stationmap?x=136.9346&y=35.1717

javascriptで差し込み表示 →
東京都中央区日本橋馬喰町2-2-1付近 → x:139.7832 y:35.6954

XML : http://map.simpleapi.net/stationapi?x=139.7832&y=35.6954
地図 : http://map.simpleapi.net/stationmap?x=139.7832&y=35.6954

javascriptで差し込み表示 →
東京都渋谷区神山町10-8付近 → x:139.6951 y:35.6638

XML : http://map.simpleapi.net/stationapi?x=139.6951&y=35.6638
地図 : http://map.simpleapi.net/stationmap?x=139.6951&y=35.6638

javascriptで差し込み表示 →

利用上の注意

  • このサービスは無保証です。いかなる損害も保証いたしかねます。
  • 広告掲載している商用サイト、非商用サイト、どちらにも利用可能です。
  • PCあるいは携帯ブラウザから自由にアクセスできるサイトのみでご利用ください
  • 「特定ユーザーのみに利用を限定しかつ有料提供のサービス」では原則としてご利用いただくことができません。事前にご相談ください。
  • 地図画像を貼る場合、1ページ10枚までとしてください。
  • XMLやjavascirptなどによる呼び出しの場合、1ページにつき10リクエストまでとしてください。
  • 1日5万リクエスト以上予測される場合、あらかじめご相談ください。
  • 非合法活動や個人のプライバシーを侵害するのに利用することはできません。
  • APIはアップグレードすることがあります。なるべく下位互換を保つようにします。もし下位互換は保証されない大規模な変更がある場合、移行期間を設けます。
  • サービス提供者はサービスを中断、終了する権利、サービス利用を停止する権利を保有します。