Fabric Mapsにおける外部フィーチャーサービス

Fabric Mapsは外部のフィーチャ サービスに接続し、そのベクター データをマップ レイヤーとして表示できます。 外部特徴サービスは、ポイント、線、多角形などの地理的特徴と、それらを表す属性を提供します。

外部フィーチャーサービスに接続することで、レイクハウスやイベントハウスにコピーすることなく、リモートでホストされた空間データを可視化できます。 Fabric Mapsはサービスにクエリを行い、選択した特徴や属性を取得し、その結果をベクターデータレイヤーとしてレンダリングします。

Fabric Mapsは以下の外部フィーチャーサービスプロトコルをサポートしています:

• ウェブフィーチャーサービス(WFS)
• OGC API - 機能
• Esriフィーチャーサービス

これらのプロトコルには、 地理空間Webサービス 接続タイプ、WMSやWMTSを通じてアクセスできます。 「 接続とゲートウェイの管理」でクラウド接続を作成し、マップのエクスプローラーの 「外部ソース 」タブからマップへの接続を追加します。

外部機能サービスとは何ですか?

外部特徴サービスとは、個々の地理的特徴を公開するウェブベースの地理空間APIです。 各特徴には以下が含まれます:

• ジオメトリーは、特徴の位置と形状を点、線、または多角形として定義します。
• 属性は、名称、カテゴリ、ステータス、測定、日付などの機能に関する情報を提供します。

例えば、フィーチャーサービスは車両の位置を点として、道路を線として、行政境界をポリゴンとして公開することがあります。 Fabric Mapsはジオメトリを使って各特徴を描画し、選択された属性をスタイリング、フィルタリング、ラベル、凡値、ツールチップに利用可能にします。

サービスとそのデータは地図項目の外に残ります。 マップは接続の参照と、データを取得・表示するために必要な設定を保存します。

サポートされたフィーチャーサービスプロトコル

以下の表は、Fabric Mapsがサポートされている各プロトコルでどのように動作するかをまとめたものです。

Fabric Maps における外部フィーチャー サービスのしくみ

外部機能サービスをマップに追加すると、Fabric Maps:

1. 既存の接続を利用するか、リモートエンドポイントへの接続を作成します。
2. サービスが公開する特徴層やコレクションを発見します。
3. ジオメトリタイプ、フィールド、レコード制限、対応クエリ機能などのメタデータを読み込みます。
4. サーバー側のクエリを設定し、取得するフィールドを選択できます。
5. 対応可能な追加結果ページを含むマッチング機能を要求します。
6. 返された特徴をベクターデータレイヤーとしてレンダリングします。

デフォルトの可視化は、サービスが返すジオメトリに基づいています:

レイヤーを追加した後は、スタイリング、ラベル、凡例、ツールチップ、可視性、マップレイヤーフィルターなどの対応ベクターレイヤーオプションを設定できます。 詳細については、Fabric Mapsの「地図のカスタマイズ」および「データフィルタリング」をご覧ください。

WFSまたはOGC APIの場合、混合ジオメトリ応答機能を備え、Fabric Mapsは1つのデータレイヤーを作成します。 このレイヤーの報告されたジオメトリタイプは 不明 です。なぜなら、単一のタイプがそれを記述していないからです。 ポイント特徴はバブルレイヤーを使用し、線の特徴は線レイヤーを使い、ポリゴン特徴は押し出なしのポリゴンレイヤーを使用します。 データ駆動型スタイリングを有効にすると、Fabric Mapsはデータレイヤーのパネルにジオメトリタイプの凡レンドを表示します。 混合ジオメトリレイヤーにはクラスタリングは利用できません。

外部フィーチャーサービス層はカテゴリおよびバリュー範囲のデータ駆動スタイリングをサポートします。

層とコレクションの発見

Fabric Mapsは、エクスプローラーの外部ソースセクションの接続下に該当する特徴層やコレクションを一覧化しています。 利用可能な階層構造は、サービスが公開するプロトコルやメタデータに依存します。

接続を更新すると、新たに追加されたフィールド、レイヤー、コレクションを含む最新のサービスメタデータを取得します。 これらの変更は自動的に現れるわけではありません。 新たに追加されたフィールドを使うには、接続を更新してからソースレイヤーを再度追加し、フィールドを選択します。

サービスが返すメタデータには以下が含まれます:

• 表示名と識別子
• ジオメトリのタイプ
• 属性フィールドとデータ型
• 空間的範囲
• 最大記録数
• フィルタリング、ソート、ページング、時間機能のサポート

利用可能な設定オプションはサービスによって異なる場合があります。なぜなら、Fabric Mapsは各エンドポイントが宣伝する機能を使用しているからです。

ソースクエリ

マップにフィーチャーレイヤーを追加する前に、リモートサービスから取得するレコードやフィールドを制限するソースクエリを設定することができます。 サーバー上でクエリを処理することで、Fabricマップに転送されるデータ量を減らし、シナリオに関連する特徴にレイヤーを集中させることができます。

ソースクエリで利用可能なフィールドや演算子は、選択したプロトコルとサービスが宣伝する機能に依存します。 ソースクエリは出力フィールド選択をサポートし、時間フィルタリングもサポートできます。 Fabric MapsはRFC 3339形式で日付/時刻の値をUTCとして解釈します。

Fabric Mapsは、選択したサービスに対してクエリを検証します。 フィールド、値、演算子がサポートされていない場合、設定体験にエラーが表示され、それを使ってクエリの修正が可能です。

レイヤーを追加した後にソースクエリUIに戻ってクエリを編集することはできません。 異なるソースクエリ条件を使用するには、ソースレイヤーを再度追加し、新しいクエリを設定してください。

Fabric Mapsは、特徴を要求する際にマップビューポートから自動的にバウンディングボックスを導出します。 バウンディングボックスはソースクエリUIでは表示も設定もできません。 ユーザーは座標を入力したり、空間クエリ条件としてエリアを選択したりすることはできません。

ソースクエリとマップ層フィルター

ソース クエリとマップ レイヤー フィルターは、異なる段階でデータを制限します：

リモートサービスからの要求データを減らすためにソースクエリを使いましょう。 マップ作成者やビューアーが返されるデータをインタラクティブに絞り込む必要がある場合は、マップ レイヤー フィルターを使用します。 マップ層フィルターの詳細については、Fabric Mapsのデータフィルタリングをご覧ください。

外部フィーチャーサービス層はカテゴリ、数値範囲、ブール値、日付・時刻マップ層のフィルターをサポートします。 複数のフィルターはロジック AND 使います。 ロックされたフィルター、編集モードおよびビューモードの動作、フィルターの永続性は、WFS、OGC API - Features、Esri Feature Serviceレイヤーで同様に動作します。

ページ分けと結果の制限

フィーチャーサービスは、1回の応答で返されるレコード数を制限できます。 Fabric Mapsはサービスで宣伝されているページング構成を自動的に使用して、その後の結果を取得します。 ページングは透過的であり、ビルダーはページサイズやページングの動作を設定できません。

Fabric Mapsは1レイヤーあたり最大100,000件の特徴をレンダリングします。 ソースクエリがより多くの特徴を返すと、Fabric Mapsは最初の10万件をレンダリングし、レイヤー設定ペインに警告を表示します。 ソースクエリを絞り込んで結果セットを絞り込みます。

ページリクエストが失敗した場合、Fabricは最大3回まで再試行します。 それでもリクエストが失敗した場合、Fabric Mapsは「A request failed」というメッセージを表示します;いくつかの機能が欠落しています。リフレッシュして再試行してください。

保存済み設定

マップを保存すると、Fabric Mapsは外部レイヤー構成を保持します。以下が含まれます:

• 接続参照
• 選択された特徴層またはコレクション
• ソースクエリ
• 選択された出力フィールド
• レイヤーのスタイル設定と凡例
• 視認性
• レイヤーの順序

マップを再開すると、Fabric Mapsは保存した設定を使ってレイヤーを取得してレンダリングします。

重複したレイヤーは同じデータソース、接続、ソースクエリ、選択された出力フィールドを参照します。 マップ レイヤーのフィルターとビジュアル設定は、複製ごとにそれぞれ独立しています。 このリリースでレイヤーを追加した後は、ソースクエリや出力フィールドを編集できません。

外部機能サービスの更新

Fabric Mapsは編集モードで2つのリフレッシュアクションを提供します:

• 外部ソースの接続を更新して、新たに追加されたフィールド、レイヤー、コレクションを含む最新のサービスメタデータを取得します。 新たに追加されたフィールドを使用するには、ソースレイヤーを再度追加し、フィールドを選択してください。
• マップアイテムを更新して保存されたレイヤーから現在のデータをクエリします。 この操作は保存済みソースクエリを変更しません。

このリリースでは、ビューアは外部フィーチャーサービスのデータを更新することはできません。 保存された出力フィールド、スタイリング、凡例、可視性、レイヤー順序はリフレッシュ後も維持されます。

認証とアクセス

外部機能サービスは、Fabricマップの開開や編集に必要な権限に加えて、認証情報を必要とすることがあります。

Esri Feature Service APIキー認証では、APIキーパラメータ名として token を使用します。

Fabricはクラウド接続に認証情報を保存します。 ビューアは外部データをレンダリングするために、別々に接続を共有しなくてもよい。 Fabric Mapsが有効な接続認証情報を取得できず、サービスに到達できない場合、サービスにアクセスできないエラーが表示されます。

外部フィーチャーサービスおよび画像サービス

外部特徴サービスはベクタージオメトリと属性を返します。 WMSおよびWMTSサービスはレンダリングされたラスタ画像やタイルを返します。 マップに必要なデータや相互作用に合ったソースタイプを選びましょう。

外部画像に関する情報については、Fabric Mapsの「WMSおよびWMTS画像ソースを使ってレイヤーを作成」をご覧ください。

プロトコル固有の考慮事項

WFS

• サービス機能から利用可能なレイヤーを発見しましょう。
• WFSのバージョン1.0.0、1.1.0、または2.0.0を使用してください。
• サービスが複数の対応バージョンを宣伝する場合、Fabric Mapsは最新バージョンを使用します。
• WFSサービスはGeoJSON応答をサポートしなければなりません。
• 1層で混合ジオメトリ応答をサポートします。

OGC API - 機能

• 利用可能なデータをコレクションに整理しましょう。
• 高度な属性演算や時間演算は、サービスが推奨する適合クラスに依存します。
• 1層で混合ジオメトリ応答をサポートします。
• Fabric Mapsは、選択したエンドポイントがサポートする機能のみを使用します。

Esriフィーチャーサービス

• 選択したレイヤーはGeoJSON出力をサポートしなければなりません。
• 混合幾何学応答はサポートしないでください。
• Fabric MapsはMまたはZ座標値のジオメトリを受け入れ、追加の次元は無視します。

制限事項と考慮事項

• 外部機能サービスの統合は読み取り専用です。 インジェス、フィーチャー編集、書き込みはサポートされていません。
• クエリ機能はリモートサービスが宣伝する機能に依存します。
• Fabric Mapsは、経度・緯度順の座標を含むEPSG:4326の特徴を要求しています。 別の座標参照系でデータを公開するサービスは、そのサービスがデータをEPSG:4326に再投影できる場合にサポートされます。 サービスがデータを再投影できない場合、例えばレイヤーの座標系にEPSG権限コードが欠けている場合、レイヤーは読み込みに失敗します。
• 逆子午線を横切るバウンディングボックスはサポートされていません。
• ジオメトリがジオメトリコレクションである特徴はレンダリングされません。 同じレイヤー内の他のサポート機能は通常レンダリングされます。
• 混合ジオメトリレイヤーにはクラスタリングは利用できません。
• WFSおよびEsriフィーチャーサービス層はGeoJSON出力をサポートしなければなりません。
• このリリースではGML応答形式はサポートされていません。
• Fabric MapsはEsri Feature ServiceのジオメトリにおいてM次元とZ次元を無視します。
• レイヤーは最大10万件の特徴をレンダリングできます。
• マップ項目はWMS、WMTS、WFS、OGC API - Features、Esri Feature Serviceを通じて最大100の外部接続を参照できます。
• サポートされているのは公共のインターネットを通じてアクセス可能なサービスのみです。 プライベートエンドポイント、オンプレミスデータゲートウェイ、仮想ネットワークデータゲートウェイ、その他のマネージドプライベートネットワークオプションはサポートされていません。
• 可用性やクエリ応答時間は、リモートサービスやネットワーク接続によって異なります。

次のステップ

スタイリングオプションについては 「地図のカスタマイズ」をご覧ください。