APIのバージョン指定

広告
facebookボタン
googleplusボタン
twitterボタン
ダミーボタン
bloggerボタン

2011年5月現在のメジャーバージョンはGoogle Maps API バージョン 3ですが、新機能の追加やバグフィックスなどのために細かいバージョンアップは行われており、V3.1 や V3.3 など細かいバージョンが存在します。

2011年5月現在のメジャーバージョンはGoogle Maps API バージョン 3ですが、新機能の追加やバグフィックスなどのために細かいバージョンアップは行われています。ここでは使用するAPIのバージョンを指定する方法を確認します。

Google側で用意されたコードを読み込む時に次のようなコードを使用していました。

<script type="text/javascript"
  src="http://maps.google.com/maps/api/js?sensor=false"></script>

明示的にバージョンを指定する場合は「v」パラメータを使って指定します。値は次のどちらかです。

v=3      現在の開発バージョン。最新バージョンが反映されている。
v=3.Num  番号付きバージョン。リリースバージョンや凍結バージョンを指定。

最新のバージョンを使用したい場合は「v=3」のように指定して下さい。それに対して特定のバージョンを使用したい場合には「v=3.3」などのように指定することができます。何か特別な理由が無い限りは細かいバージョンを指定する必要はありません。

Google Maps APIのバージョン毎の更新ログは次の「Javascript Maps API v3 Changelog」を参照して下さい。

もし明示的にバージョンを指定したい場合には次のように記述します。

<script type="text/javascript"
  src="http://maps.google.com/maps/api/js?v=3.1&sensor=false"></script>
サンプルコード

では実際に試してみます。

function initialize() {
  var latlng = new google.maps.LatLng(34.687146,135.52597);
  var opts = {
    zoom: 15,
    center: latlng,
    mapTypeId: google.maps.MapTypeId.ROADMAP
  };
  var map = new google.maps.Map(document.getElementById("map_canvas"), opts);
}
<!DOCTYPE html "-//W3C//DTD XHTML 1.0 Strict//EN" 
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="content-type" content="text/html; charset=utf-8"/>
    <title>Google Maps JavaScript API サンプル</title>
    <script type="text/javascript"
      src="http://maps.google.com/maps/api/js?v=3.2&sensor=false"></script>
    <script src="./js/code3_1.js" type="text/javascript"></script>

  </head>
  <body onload="initialize()">
    <p>Google Maps APIを使ったサンプルです。</p>

    <div id="map_canvas" style="width:500px; height:300px"></div>

  </body>
</html>

ブラウザで上記ページを開くと次のように表示されます。

p3-1

少し前のバージョンを指定したためか、右上のコントロールの表示が最新のものと異なっています。バージョン指定をしない場合の下記と比べてみて下さい。

p3-2

最新バージョンで何か不具合があった場合などを除けば、明示的にバージョンを指定して利用する必要はあまりありません。

( Written by T.buzz.Ikura+ )

Social Button
Facebook Page