すべてのプロダクト
Search
ドキュメントセンター

DataV:テキスト吹き出しレイヤー (v2.xバージョン)

最終更新日:Jul 16, 2024

テキストラベル付けレイヤは、基本フラットマップのサブコンポーネントです。 テキストラベリングスタイル、ポップアップボックス、マウスインタラクションイベント、位置情報など、独立したスタイル、データ、インタラクション構成をサポートしています。 地理情報をテキストラベルの形式で表すことができます。 このトピックでは、テキストラベル付けレイヤーの各設定項目の意味について説明します。

[サブウィジェットの管理] の下にある [テキストラベル付けレイヤー] をクリックします。 設定パネルで、テキストラベル付けレイヤーのスタイルとデータを設定します。

説明

[コンポーネント管理] セクションに [テキストラベリングレイヤ] が表示されていない場合、[テキストラベリングレイヤ] コンポーネントは追加されていません。 詳細については、「」をご参照ください。

パラメーター

Text Annotation Layer Configuration Panel v2.x

  • [設定の検索]: キャンバスエディターの右側のパネルで、[設定] タブをクリックし、右上隅の [設定の検索] をクリックします。 検索ボックスに必要な設定項目を入力し、検索アイコンをクリックして設定項目をすばやく見つけます。 あいまい一致はサポートされていません。 詳細については、「設定の検索」をご参照ください。

  • 表示レベル: テキストラベル付けレイヤーの表示レベルを指定します。 テキストラベル付けレイヤーは、指定されたレベル範囲内では表示されますが、指定されたレベル以外では表示されません。

  • ディメンションスタイル: テキストディメンションレイヤーの表示フィールドとテキストスタイルパラメーターを設定します。

    パラメーター

    機能

    表示されたフィールド

    ラベルの表示フィールド。地理データのフィールド名と一致する必要があります。

    テキストスタイル

    テキストラベリングレイヤーの各ラベルのテキストフォントファミリ、テキストの太さ、フォントサイズ、色、シャドウの色。 詳細については、「カラーピッカーの手順」をご参照ください。

    説明

    システムにインストールされているフォントのみが表示されます。 選択したフォントがシステムにインストールされていない場合は、デフォルトのフォントが表示されます。

  • ダイアログボックス: [プレビュー] または [公開] ページで、表示されるダイアログボックスをクリックします。 ポップアップボックスの左側にあるEye iconアイコンをクリックして、ポップアップボックスの表示と非表示を制御します。

    説明

    ポップアップ機能を有効にするには、まずinfoフィールドを設定する必要があります。

    • infoフィールド: infoフィールドをオンにすると、infoフィールドをポップアップコンテンツとして設定します。 このフィールドのHTMLタグを設定できます。 infoフィールドをオフにすると、ポップアップコンテンツはnameおよびvalueフィールドと互換性があります。

    • イベントタイプ: ダイアログボックスに表示されるイベントのタイプ。

    • 設定オプション: ポップアップボックスの設定項目の内容。 [デフォルト] または [カスタム] を選択できます。

      • 親コンテナのデフォルト: システムのデフォルトスタイル。

      • カスタム設定: テキストスタイル、線の高さの比率、コーナーの半径などのパラメーターをカスタマイズできます。

        パラメーター

        機能

        テキストスタイル

        ダイアログボックスでテキストのフォント、太さ、フォントサイズ、色を設定します。 詳細については、「カラーピッカーの手順」をご参照ください。

        列の高さの比率

        箇条書きボックス形式の行の高さの比率の値を設定します。

        フィレット半径

        ポップアップボックスのフィレット半径を設定します。 値が大きいほど、角が丸くなります。

        マージン

        ダイアログボックス内のテキストとダイアログボックスの4辺の間の距離を設定します。

        背景色

        ダイアログボックスの背景色を設定します。

        閉じるボタン

        閉じたポップアップボタンの色とサイズ、およびボタン間の距離を上から右に設定します。

  • インタラクティブ設定

    ホバースタイル: ホバースタイルの左側にあるEye iconアイコンをクリックして、ホバー操作機能を有効または無効にします。 このスイッチをオンにすると、ラベルの上にポインタを移動したときにテキストラベルをある程度拡大できます。 ラベルをプレビューまたは公開するときにのみ効果を確認できます。

フィルタリングテーブルのメタデータ。

Text Labeling Layer Data Panel v2.x

表1. 説明

項目

説明

lat

テキストのディメンションポイントの緯度。

lng

テキストのディメンションポイントの経度。

name

テキストディメンションポイントの表示。

データパネルでは、valueまたはinfoフィールドをカスタマイズして、テキストラベリングポイントのポップアップラベリング情報を示すことができます。

info

表1. パラメーター

パラメーター

説明

制御モード

スイッチをオンにすると、ウィジェットの初期化時にデータが要求されません。 データリクエストは、コールバックIDまたはBlueprint Editorで設定されたメソッドに基づいてのみトリガーされます。 スイッチをオフにすると、データ要求が自動的にトリガーされます。 デフォルトでは、スイッチはオフになっています。

自動データ要求

[自動データ要求] チェックボックスをオンにすると、動的ポーリングを有効にし、ポーリング間隔を手動で指定できます。 このチェックボックスをオンにしないと、データは自動的に要求されません。 手動でページを更新してデータを要求するか、Blueprint EditorまたはコールバックIDイベントを使用してデータ要求をトリガーする必要があります。

データソース

キャンバスエディターの右側のパネルで、[データ] タブをクリックします。 [静的データ] の横にある [設定] をクリックします。 [Configure Datasource] パネルで、[data source Type] ドロップダウンリストからデータソースを選択します。 コードエディターでデータクエリのコードを入力し、[データ応答のプレビュー] をクリックしてデータソースの応答をプレビューし、応答を表示します。 詳細については、「資産データの設定」をご参照ください。

データフィルター

[データフィルタ] チェックボックスをオンにすると、データ構造の変換、データのフィルタリング、および簡単な計算を実行できます。 [フィルターの追加] の横にあるプラス記号 (+) をクリックすると、表示されるエディターでデータフィルターのスクリプトを設定できます。 詳細については、「データフィルターの使用」をご参照ください。

データ応答結果

データ要求に対する応答。 データソースが変更された場合は、[データ応答結果] の横にあるRefresh icon アイコンをクリックして、データ応答をリアルタイムで表示できます。

相互連携

Text callout layer interaction panel V2.X

表2. 説明

インタラクション

説明

ポイントをクリックしたとき

ウィジェット間のインタラクションを有効にするには、[有効化] チェックボックスをオンにします。 テキストラベリング層のサブコンポーネントは、インタラクティブな構成を有する。 ラベリングポイントをクリックすると、コールバック値がスローされます。 デフォルトでは、データのlngフィールドとlatフィールドがスローされます。 詳細は、「コールバックIDの設定」をご参照ください。

マウスが入ったとき

ウィジェット間のインタラクションを有効にするには、[有効化] チェックボックスをオンにします。 テキストラベリング層のサブコンポーネントは、インタラクティブな構成を有する。 マウスがラベリングポイントの位置に移動すると、コールバック値がスローされ、デフォルトでデータのlngフィールドとlatフィールドがスローされます。 詳細は、「コールバックIDの設定」をご参照ください。

Blueprint Editorでのインタラクションの設定

  1. キャンバスエディターで、基本フラットマップウィジェットのテキストラベル付けレイヤーの横にあるAdd to Blueprint Editorアイコンをクリックします。

  2. ページのBlueprint Editor icon左上隅にあるアイコンをクリックします。

  3. Blueprint Editorで、[追加ノード] ペインの [テキストラベリングレイヤー] ウィジェットをクリックします。 キャンバスでは、次の図に示すように、テキストラベル付けレイヤーのパラメーターを設定できます。 Text Callout Layer Blueprint Parameters v2.x

    • イベント

      イベント

      説明

      データインターフェイス要求が完了したとき

      イベントは、データインターフェイス要求が応答され、フィルターによって処理された後、処理されたJSONデータでトリガーされます。 特定のデータ例の詳細については、キャンバスエディターの右側の構成パネルにある [データ] タブの [データ応答結果] セクションをご参照ください。

      データインターフェイス要求が失敗した場合

      データインターフェイス要求が失敗したときに返され (要求はネットワークの問題またはインターフェイスのエラーが原因である可能性があります) 、フィルターによって処理されるイベント。 イベントは、処理されたJSONデータもスローします。 特定のデータ例の詳細については、キャンバスエディターの右側の構成パネルにある [データ] タブの [データ応答結果] セクションをご参照ください。

      ポイントをクリックしたとき

      テキストラベル付けレイヤーでラベルポイントをクリックしたときに発生するイベント。 このイベントはまた、ラベルポイントに対応する経度および緯度データ項目を上げる。

      マウスが入ったとき

      テキストラベル付けレイヤーでラベル付けされたポイントにマウスが移動したときに発生するイベントで、ラベル付けされたポイントに対応する経度と緯度のデータ項目も発生します。

    • ポリシーアクション

      Action

      説明

      要求データインタフェース

      このアクションは、サーバーデータを再度要求するために実行されます。 アップストリームデータ処理ノードまたはレイヤノードによって送信されたデータは、パラメータとして使用される。 たとえば、APIデータソースがhttp:// api.testで、リクエストデータインターフェイスに渡されるデータが { id: '1'} の場合、最終的なリクエストインターフェイスはhttp:// api.test?id=1です。

      データのインポート

      ウィジェットのデータがその描画フォーマットに従って処理された後、ウィジェットは再描画のためにインポートされる。 サーバーデータを再度リクエストする必要はありません。 特定のデータ例の詳細については、キャンバスエディターの右側の構成パネルにある [データ] タブの [データ応答結果] セクションをご参照ください。

      表示

      ウィジェットは、パラメータを指定する必要なしに表示されます。

      非表示

      ウィジェットは、パラメータを指定する必要なしに非表示になります。