緯度・経度を入力値に、国土地理院提供のAPI経由で二点間の距離を算出します。 本gemは、一回のリクエストで、一回だけ国土地理院提供のAPIを叩きます。 APIの使用回数上限については、国土地理院が提示しているAPI利用規約を参照してください。 また、APIの仕様上、日本の緯度・経度にしか対応していません。
Gemfile に下記の記述を追加してください。
gem 'connect_gsi_api'その後、インストールをします:
$ bundle
もしくは自分で手動でインストールしてください:
$ gem install connect_gsi_api
まず、本Gemを使いたいファイルの中で、requireしてください。
その上で、地点1の緯度/経度、地点2の緯度/経度 を引数に ConnectGsiApi.distance2p を呼び出してください。
require "connect_gsi_api"
ConnectGsiApi.distance2p 35.6581, 139.701742, 36.123456, 138.705749なお、パラメータ不正など、エラーが返ってくる呼び出しの場合は、nilが返ってくる仕様になっています。
また、動作確認目的として、コマンドでの呼び出しにも対応しています。
$ bundle exec calcdist 35.6581 139.701742 36.123456 138.705749
$ => 103682.866
本GemはMITライセンスです。 The gem is available as open source under the terms of the MIT License.