仮想化

MapVirtualLayer は、仮想化と非同期データロードをサポートしてマップ上に要素を表示します。一度に表示する要素が多くない場合は、これを使用して、無制限の数の要素を表示できます。そのオブジェクトモデルは MapItemsLayer とはまったく異なります。C1MapVirtualLayer では、マップ空間がいくつかの領域に分割されている必要があり、項目のソースは IMapVirtualSource インターフェイスを実装している必要があります。

マップ空間の分割は、MapSlice の MapVirtualLayer.Slices コレクションを使って定義されます。各マップスライスはに、その区分の最小ズームレベルが定義され、あるスライスの最大ズームレベルが次のスライスの最小ズームレベルになります。したがって、最後のスライスの最大ズームレベルは、マップの最大ズームレベルになります。さらに、各スライスは、緯度/経度のグリッドに分割されます。

例として次のレイヤを紹介します。

ここには、ズーム５～10 とズーム 10～最大ズームの２つのスライスがあります。ズーム値が元のスライスから別のスライスに移動すると、仮想レイヤはそのソースにデータを要求します。また、最初のスライスは緯度/経度によって２×２に分割されます。つまり、マップは４つの領域に分割され、レイヤは現在表示されている領域のデータのみを要求します。２番目のスライスが 16 個の領域に分割されているのは、ズーム値が大きくなるほど多数に分割した方がパフォーマンスが向上するためです。

IMapVirtualSource インターフェイスを理解するために、Factories サンプルの実装を紹介します。

public class LocalStoreSource : IMapVirtualSource
        {
            DataBase _dataBase;
            public LocalStoreSource(DataBase localDataBase)
            {
                _dataBase = localDataBase;
            }
            public void Request(double minZoom, double maxZoom, Point lowerLeft, Point upperRight, Action<ICollection> callback)
            {
                if (minZoom < minStoreZoom)
                    return;
                var stores = new List<Store>();
                foreach (var store in _dataBase.Stores)
                {
                    if (store.Latitude > lowerLeft.Y
                      && store.Longitude > lowerLeft.X
                      && store.Latitude <= upperRight.Y
                      && store.Longitude <= upperRight.X)
                    {
                        stores.Add(store);
                    }
                }
                callback(stores);
            }
        }

Request メソッドは、マップ空間の１つの領域をパラメータとして受け取るほか、コールバックを使って返される項目のコレクションを受け取ります。この実装は最初に、要求された最小ズームがアプリケーションパラメータより小さいかどうかをチェックし、小さい場合は何もしません。そうでない場合は、Web サービスを呼び出してデータを取得します。