VEMap.SetTileBuffer メソッド

表示されるマップ ビュー領域の外側に読み込む必要のある、マップ タイルの "リング" の数を設定します。これは、タイル オーバーフェッチとも呼ばれます。

構文

VEMap.SetTileBuffer(numRings);

パラメータ

パラメータ 説明

numRings

読み込むべき追加タイルのリングの数を表す 0 以上の整数値です。既定値は 0、最大値は 3 です。

解説

このメソッドでは、VEMap.LoadMap メソッドより前に呼び出してタイルを最初にどのように読み込むかを制御できますが、マップを読み込んだ後に任意のタイミングで呼び出しすことで、オーバーフェッチ動作を変更することもできます。

注意

このメソッドを使用する場合は、パフォーマンスを考慮する必要があります。読み込むリングの数を多くすると、初期状態でユーザーが体感するパンの速度は向上します。ただし、最初にページを読み込むのにかかる時間が長くなる可能性があります。

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<title></title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">

<script type="text/javascript" src="http://dev.virtualearth.net/mapcontrol/mapcontrol.ashx?v=6.1"></script>

<script type="text/javascript">
var map = null;
var value = 0;
 
function GetMap()
         {
map = new VEMap('myMap');
map.LoadMap();

map.SetMapStyle(VEMapStyle.Aerial);
map.SetZoomLevel("5");         
         } 
     
function SetVal(v)
         {
value = v;
         }
     
function SetTileBuffer()
         {
map.SetTileBuffer(value);
alert("タイル バッファが " + value + 
" に設定されました。\nバッファを大きくするとパンの速度が向上しますが、" +
"\nページの読み込みにかかる時間が長くなる可能性があります。");
         }  
</script>
</head>
<body onload="GetMap();">
<div id='myMap' style="position:relative; width:400px; height:400px;">
</div>
<input id="btnSetBuffer" type="button" value="タイル バッファを設定" 
onclick="SetTileBuffer()"><br />
<form id="buffValues">
0<input name="tbVal" type="radio" onclick="SetVal('0')" 
checked="checked"/> | 
1<input name="tbVal" type="radio" onclick="SetVal('1')" /> | 
2<input name="tbVal" type="radio" onclick="SetVal('2')" /> | 
3<input name="tbVal" type="radio" onclick="SetVal('3')" />
</form>
</body>
</html>