シンプルなデータレイヤーの追加

[アーティクル]
06/19/2023

空間 IO モジュールでは、SimpleDataLayer クラスが提供されます。このクラスを使用すると、スタイル設定されたフィーチャーをマップ上に簡単にレンダリングできます。また、スタイルプロパティがあるデータセットや、複数の geometry 型が混在するデータセットをレンダリングすることもできます。シンプルなデータレイヤーでは、複数のレンダリングレイヤーをラップし、スタイル式を使用することにより、この機能を実現しています。スタイル式は、これらのラップされたレイヤー内のフィーチャーの共通スタイルプロパティを検索します。 atlas.io.read 関数と atlas.io.write 関数は、これらのプロパティを使用して、サポートされているファイル形式にスタイルを読み書きします。サポートされているファイル形式にプロパティを追加すると、ファイルをさまざまな目的で使用できます。たとえば、ファイルを使用して、スタイル設定されたフィーチャーをマップに表示することができます。

SimpleDataLayer には、フィーチャーのスタイル設定に加えて、ポップアップテンプレートを使用した組み込みのポップアップフィーチャーも用意されています。フィーチャーがクリックされると、ポップアップが表示されます。必要に応じて、既定のポップアップフィーチャーを無効にすることができます。このレイヤーでは、クラスター化されたデータもサポートされます。クラスターがクリックされると、マップでそのクラスターが拡大され、個々のポイントとサブクラスターに展開されます。

SimpleDataLayer クラスは、多くの geometry 型とフィーチャーに適用される多くのスタイルを持つ大規模なデータセットで使用されることを想定しています。このクラスを使用すると、スタイル式を含む 6 つのレイヤーのオーバーヘッドが追加されます。そのため、コアレンダリングレイヤーを使用する方が効率的な場合もあります。たとえば、コアレイヤーを使用して、フィーチャーに 2 つの geometry 型といくつかのスタイルをレンダリングする場合などです。

シンプルなデータレイヤーを使用する

SimpleDataLayer クラスは、他のレンダリングレイヤーを使用する場合と同じように使用されます。次のコードは、マップ内でのシンプルなデータレイヤーの使用方法を示しています。

//Create a data source and add it to the map.
var datasource = new atlas.source.DataSource();
map.sources.add(datasource);

//Add a simple data layer for rendering data.
var layer = new atlas.layer.SimpleDataLayer(datasource);
map.layers.add(layer);

次のコードスニペットは、オンラインソースのデータを参照するシンプルなデータレイヤーの使用方法を示しています。

function InitMap()
{
  var map = new atlas.Map('myMap', {
    center: [-73.967605, 40.780452],
    zoom: 12,
    view: "Auto",

    //Add authentication details for connecting to Azure Maps.
    authOptions: {
      // Get an Azure Maps key at https://azuremaps.com/.
      authType: 'subscriptionKey',
      subscriptionKey: '{Your-Azure-Maps-Subscription-key}'
    },
  });    

  //Wait until the map resources are ready.
  map.events.add('ready', function () {

    //Create a data source and add it to the map.
    var datasource = new atlas.source.DataSource();
    map.sources.add(datasource);

    //Add a simple data layer for rendering data.
    var layer = new atlas.layer.SimpleDataLayer(datasource);
    map.layers.add(layer);

    //Load an initial data set.
    loadDataSet('https://s3-us-west-2.amazonaws.com/s.cdpn.io/1717245/use-simple-data-layer.json');

    function loadDataSet(url) {
      //Read the spatial data and add it to the map.
      atlas.io.read(url).then(r => {
      if (r) {
        //Update the features in the data source.
        datasource.setShapes(r);

        //If bounding box information is known for data, set the map view to it.
        if (r.bbox) {
          map.setCamera({
            bounds: r.bbox,
            padding: 50
          });
        }
      }
      });
    }
  });
}

loadDataSet 関数に渡される URL は、次の json を指します。

{
    "type": "Feature",
    "geometry": {
        "type": "Point",
        "coordinates": [0, 0]
    },
    "properties": {
        "color": "red"
    }
}

データソースに地物を追加すると、シンプルなデータレイヤーによって、それらをレンダリングする最適な方法が見極められます。個々のフィーチャーのスタイルは、フィーチャーでプロパティとして設定できます。

上記のサンプルコードは、color プロパティが red に設定された GeoJSON ポイント地物を示しています。

このサンプルコードでは、シンプルなデータレイヤーを使用してポイント地物をレンダリングし、次のように表示します。

青い水の上に赤い点が表示されている、座標が 0, 0 のマップのスクリーンショット。赤い点はシンボルレイヤーを使用して追加されました。

注意

マップが初期化されたときに座標が設定されたことに注意してください。

center: [-73.967605, 40.780452]

は、データソースの値によって上書きされます。

"coordinates": [0, 0]

シンプルなデータレイヤーの真の力は、次のような場合に発揮されます。

データソースに複数の異なる種類のフィーチャーがある場合、または
データセット内のフィーチャーに複数のスタイルプロパティが個別に設定されている場合、または
データセットに含まれているものが正確にわからない場合

たとえば、XML データフィードを解析する場合、フィーチャーの正確なスタイルと geometry 型がわからないことがあります。 [Simple data layer options] (シンプルなデータレイヤーのオプション) サンプルは、KML ファイルの地物をレンダリングすることで、シンプルなデータレイヤーの能力を示しています。また、シンプルなデータレイヤークラスで提供されているさまざまなオプションのデモも行えます。このサンプルのソースコードについては、GitHub の Azure Maps コードサンプルの Simple data layer options.html を参照してください。

左側にパネルに各種のシンプルなデータレイヤーオプションが表示されているマップのスクリーンショット。

Note

このシンプルなデータ層では、ポップアップテンプレートクラスを使用して、KML バルーンまたは機能プロパティがテーブルとして表示されます。既定では、ポップアップでレンダリングされるすべてのコンテンツは、iframe 内にセキュリティ機能としてサンドボックス化されます。ただし、次のような制限があります。

すべてのスクリプト、フォーム、ポインターロック、上部ナビゲーションの機能は無効になります。リンクは、クリックすると新しいタブで開くことができます。
iframe の srcdoc パラメーターをサポートしていない古いブラウザーでは、少量のコンテンツのレンダリングに制限されます。

ポップアップに読み込まれるデータを信頼しており、潜在的に、ポップアップに読み込まれるこれらのスクリプトがアプリケーションにアクセスできるようにしたい場合は、ポップアップテンプレートの sandboxContent オプションを false に設定することによって、これを無効にすることができます。

既定でサポートされているスタイルプロパティ

既に説明したように、シンプルなデータレイヤーでは、コアレンダリングレイヤー (バブル、記号、直線、多角形、押し出しポリゴン) のうちのいくつかがラップされます。その後、式を使用して、個々のフィーチャーで有効なスタイルプロパティが検索されます。

Azure Maps と GitHub スタイルのプロパティは、サポートされているプロパティ名の 2 つの主なセットです。さまざまな Azure Maps レイヤーオプションのほとんどのプロパティ名は、シンプルなデータレイヤー内のフィーチャーのスタイルプロパティとしてサポートされています。一部のレイヤーオプションには、GitHub で一般的に使用されているスタイルプロパティ名をサポートするために、式が追加されています。これらのプロパティ名は GitHub の GeoJSON マップのサポートで定義されており、プラットフォーム内に格納されてレンダリングされる GeoJSON ファイルをスタイル設定するために使用されます。 GitHub のすべてのスタイル設定プロパティ (marker-symbol スタイル設定プロパティを除く) は、シンプルなデータレイヤーでサポートされています。

あまり一般的でないスタイルのプロパティに閲覧者が遭遇した場合、最も近い Azure Maps スタイルのプロパティに変換されます。また、シンプルなデータレイヤーの getLayers 関数を使用し、任意のレイヤーのオプションを更新することで、既定のスタイル式をオーバーライドできます。

次のセクションでは、シンプルなデータレイヤーでサポートされている既定のスタイルプロパティについて詳しく説明します。サポートされているプロパティ名の順序は、プロパティの優先順位でもあります。同じレイヤーオプションに 2 つのスタイルプロパティが定義されている場合、リスト内の最初のプロパティの方が優先順位が高くなります。カラーには任意の CSS3 カラー値 (16 進数、RGB、RGBA、HSL、HSLA、名前付きカラー値) を指定できます。

バブルレイヤーのスタイルプロパティ

フィーチャーが Point または MultiPoint であり、フィーチャーにポイントをシンボルとしてレンダリングするためのカスタムアイコンとして使用される image プロパティがない場合、そのフィーチャーは BubbleLayer でレンダリングされます。

レイヤーオプション	サポートされているプロパティ名	既定値
`color`	`color`, `marker-color`	`'#1A73AA'`
`radius`	`size`¹, `marker-size`², `scale`¹	`8`
`strokeColor`	`strokeColor`, `stroke`	`'#FFFFFF'`

[1] size と scale の値はスカラー値と見なされ、8 で乗算されます

[2] GitHub marker-size オプションが指定されている場合、半径には次の値が使用されます。

[マーカーサイズ]	Radius
`small`	`6`
`medium`	`8`
`large`	`12`

クラスターはバブルレイヤーを使用してもレンダリングされます。既定では、クラスターの半径は 16 に設定されます。クラスターの色は、次の表に定義されているように、クラスター内のポイントの数によって異なります。

ポイントの数	Color
>= 100	`red`
>= 10	`yellow`
< 10	`green`

シンボルのスタイルプロパティ

フィーチャーが Point または MultiPoint であり、フィーチャーにポイントをシンボルとしてレンダリングするためのカスタムアイコンとして使用される image プロパティがある場合、そのフィーチャーは SymbolLayer でレンダリングされます。

レイヤーオプション	サポートされているプロパティ名	既定値
`image`	`image`	`none`
`size`	`size`, `marker-size`¹	`1`
`rotation`	`rotation`	`0`
`offset`	`offset`	`[0, 0]`
`anchor`	`anchor`	`'bottom'`

[1] GitHub marker-size オプションが指定されている場合、アイコンサイズオプションには次の値が使用されます。

[マーカーサイズ]	シンボルのサイズ
`small`	`0.5`
`medium`	`1`
`large`	`2`

ポイントフィーチャーがクラスターの場合、point_count_abbreviated プロパティはテキストラベルとしてレンダリングされます。イメージはレンダリングされません。

線のスタイルプロパティ

このフィーチャーが LineString、MultiLineString、Polygon、または MultiPolygon の場合、フィーチャーは LineLayer でレンダリングされます。

レイヤーオプション	サポートされているプロパティ名	既定値
`strokeColor`	`strokeColor`, `stroke`	`'#1E90FF'`
`strokeWidth`	`strokeWidth`, `stroke-width`, `stroke-thickness`	`3`
`strokeOpacity`	`strokeOpacity`, `stroke-opacity`	`1`