GeoPlatformAPI/GoogleMobileMapPlugin

Ruby on Rails 用 Google Mobile Map Plugin

Google Mobile Map Plugin は、Ruby on Rails から、Google Static Maps API を使って地図を表示する為のプラグインです。 start と end パラメータを渡すことにより、その間の最短ルートを地図上に表示することも可能です。 JavaScript を利用しない為、モバイルサイトでの利用に向いています。

これは何?

以下の機能を提供します。

• Google Static Maps を利用した地図表示機能
• 表示された地図に対して、東西南北へ移動する為のリンクを生成する機能
• 表示された地図に対して、拡大や縮小をする為のリンクを生成する機能
• Orkney Web Routing Service API を使った、最短ルート生成機能
• 上記の機能を実現させる為のジェネレータ

サンプル

地図表示機能	ルート表示機能

インストール方法

rails プロジェクトのルートディレクトリで、以下のコマンドを実行してください。

  0
  1

% script/plugin install http://lab.cirius.co.jp/rails/plugins/google_mobile_map
% script/plugin install http://lab.cirius.co.jp/rails/plugins/wrs

使い方

通常の地図表示

1. Google Static Maps のサイト ( http://code.google.com/apis/maps/signup.html ) で、利用したいドメインの Google Static Maps API キーを取得してください。

2. 取得したキーを、GOOGLE_STATICMAP_API_KEY という名前で config/environments/#{your_environment_file} に定義してください。

3. コントローラとビューを生成します。

 % script/generate google_mobile_map #{controller_name}

例：

  0
  1
  2
  3
  4
  5
  6
  7
  8

% script/generate google_mobile_map maps
exists  app/controllers/
exists  app/helpers/
exists  app/views/
exists  app/views/
create  app/views/Maps
create  app/controllers/maps_controller.rb
create  app/views/maps/index.html.erb
create  lib/maps_helper.rb

このコマンドで、コントローラとビュー、ヘルパーが作成されます。

作成後、 http(s)://#{your_host}/#{controller_name}/?lonlat=#{lonlat} に ア クセスすると、地図が表示されます。

#{lonlat} は、","区切りで世界測地系の経度と緯度を入れてください。
例：http://yourhost/maps/?lonlat=139.69972,35.654955833333

Orkney Web Routing API を使ったルート表示

Cirius GeoPlatformAPI のアカウントを持っている場合、2点間の最短ルートを地図上 に描画することができます。

1. GetPlatform API のアカウントを以下のサイトから取得してください。

  https://api-admin.cirius.co.jp/account/create.form

既にアカウントを持っている方は新規に作成する必要はありません。

2. 取得した API キーを、 WRS_APIKEY という名前で config/environments/#{your_environment_file} に定義してください。

  例： WRS_APIKEY = 'e06f6ba0f3e82397efe4f52bf6cf1852f5a05a36a85af546be5369'

設定後、generate コマンドで作成したコントローラへ、以下のように start と end パラメータをつけてリクエストをしてください。
http(s)://#{your_host}/#{controller_name}/?lonlat=#{lonlat}&start=#{start_lonlat}&end=#{end_lonlat}

#{start_lonlat} から #{end_lonlat} までのルート情報が描画された地図が表示されます。

#{lonlat},#{start_lonlat},#{end_lonlat} は、","区切りで世界測地系の経度と緯度を入れてください。

リクエストパラメータ

controller に、以下のパラメータを渡すことができます。

パラメータ名	解説	例
showc	地図の中心にマーカーを表示する (0:非表示、1:表示)。省略時は 1	showc=0
markers	Google Static Maps の仕様に従い、マーカーを設定する	markers=35.689509,139.691752,reda%7C35.689509,139.691752,bluez

リファレンス

より詳しい使いかたは、RDoc をご確認ください。

http://lab.cirius.co.jp/rails/plugins/google_mobile_map/doc/

ライセンス

MIT ライセンス