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

DataV:マップコンテナ (v1.xバージョン)

最終更新日:Jul 15, 2024

マップコンテナは、マップ自体とそのサブコンポーネントを基本フラットマップでホストするために使用されるコンテナです。 リージョンサーマルレイヤーやポイントサーマルレイヤーなどのサブコンポーネントを追加したり、マップの位置、色、マウス操作イベントを設定したり、全国の都市の地理的位置のリアルタイムデータを複数の観点から複数の形式でレンダリングしたりできます。 このトピックでは、基本フラットマップコンテナの設定項目について説明します。

パラメーター

基础平面地图配置面板

  • サブコンポーネントの管理

    • 子コンポーネントの追加

      1. 左側のナビゲーションウィンドウで、[基本フラットマップ] をクリックします。 [設定] タブが表示されます。

      2. アドオンの左側にあるプラス記号 ([+]) をクリックします。

      3. 1つ以上の子コンポーネントを選択し、[子コンポーネントの追加] をクリックします。 コンポーネントを追加すると、[コンポーネントの管理] ページにコンポーネントが表示されます。

      4. 次の図に示すように、追加したサブコンポーネントをクリックし、サブコンポーネントパラメーターを設定します。 配置子组件

      5. 設定が完了したら、[戻る] アイコンをクリックして、基本フラットマップ設定パネルに戻り、他の子コンポーネントを設定します。

    • コンポーネントをコピー、編集、または削除するには、コンポーネントの上にポインターを移動し、アイコンをクリックし复制图标てコンポーネントをコピーします。 [编辑图标] をクリックして、子ウィジェットの名前を編集します。 [删除图标] をクリックして、子ウィジェットを削除します。

      説明

      マップサブウィジェットの管理方法の詳細については、「マップサブウィジェットの管理」をご参照ください。

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

  • Size: ピクセルの幅と高さを含むウィジェットのサイズを示します。 アイコンをクリックするProportional resizingと、ウィジェットの幅と高さを比例調整できます。 このアイコンをもう一度クリックすると、必要に応じて幅と高さを調整できます。

  • 位置: ウィジェットの位置。ピクセルXYの座標で示されます。 X座標は、ウィジェットの左上隅とキャンバスの左枠の間のピクセル距離を示します。 Y座標は、ウィジェットの左上隅とキャンバスの上枠の間のピクセル距離を示します。

  • 回転角度: ウィジェットの中心点を回転点として使用する回転の角度。 単位は度 (°) です。 次のいずれかの方法を使用して、ウィジェットの回転角度を制御できます。

    • 回転角度スピンボックスに角度を直接入力するか、プラス記号 ([+]) またはマイナス記号 ([-]) をクリックして、回転角度スピンボックスの値を増減します。

    • アイコンの黒い点をRotation control iconドラッグします。

    • アイコンをクリックして、Horizontal flipウィジェットを水平に反転します。

    • アイコンをクリックして、Vertical flipウィジェットを垂直に反転します。

  • 不透明度: ウィジェットの不透明度。 有効な値: 0と1。 このパラメーターが0に設定されている場合、ウィジェットは非表示になります。 このパラメーターが1に設定されている場合、ウィジェットは完全に表示されます。 デフォルト値: 1

  • グローバル設定: 背景色、ズームレベル、地図中心の経度と緯度、スケールルーラーの隠蔽などのパラメーターを設定できます。

    • マップの背景: マップの背景色。 詳細については、「カラーピッカーの説明」をご参照ください。

    • ズーム: 地図のズームレベル。

      説明

      マップズームは分数ズームをサポートしています。

    • マップセンター: マップセンターの経度と緯度。

    • スケールルーラー: スケールルーラーの右側にある目のアイコンをクリックして、マップ上にスケールルーラーを表示します。 スイッチをオンにした後、スケールルーラーのフォントの色と境界線の色を調整できます。

    • ドラッグを有効にする: スイッチをオンにして、ドラッグ機能を有効にします。 [プレビュー] または [公開] ページで、マップをクリックしてドラッグできます。

    • ズームを有効にする: スイッチをオンにして、ズーム機能を有効にします。 プレビューまたは公開ページで、マウスホイールをスクロールしてマップをズームできます。

    • マップインタラクション: スイッチをオンにして、マップインタラクション機能を有効にします。 [プレビュー] または [公開] ページで、をクリックしてエリアにフォーカスし、そのエリアのデータ構成情報を表示できます。

    データソースを設定して、マップの中心点とズームレベルを変更することもできます。 配置基础平面地图数据源

    例:

    [
         {
           "zoom": 4,
           "lng": 112,
           "lat": 34
         }
       ]

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

基础平面地图数据面板

上の図のサンプルコード:

[
     {
       "zoom": 4,
       "lng": 112,
       "lat": 34
     }
   ]

表 1. フィールドの説明

パラメーター

説明

ズーム

オプションです。 マップのズームレベル。 この値は、[マップズーム] タブに対応します。 両方が設定されている場合、DataVはデータ内の設定を優先的に使用します。

lng

オプションです。 マップの中心の経度。 このパラメーターは、設定パネルの [マップセンター] > [経度] パラメーターに相当します。 両方が設定されている場合、DataVはデータ内の設定を優先的に使用します。

lat

オプションです。 マップセンターの緯度。設定パネルの [マップセンター] > [緯度] パラメーターに対応します。 両方が設定されている場合、DataVはデータ内の設定を優先的に使用します。

表1. パラメーター

パラメーター

説明

制御モード

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

自動データ要求

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

データソース

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

データフィルター

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

データ応答結果

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

相互連携

ウィジェット操作機能を有効にするには、[有効化] を選択します。 カスタム変数値は、map is movedおよびmap is movedのときにスローされます。 詳細は、「コールバックIDの設定」をご参照ください。

一部のサブコンポーネントは、地域のサーマルレイヤー、線密度マップレイヤー、スキャッタレイヤーなど、インタラクティブな構成、つまりコールバックIDをサポートしています。 コールバックIDを使用してマップを操作できます。 詳細については、「ウィジェットインタラクションの設定」および「コールバックIDの設定」をご参照ください。

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

  1. キャンバスエディターで、レイヤーパネルでウィジェットを右クリックし、[ブループリントエディターに追加] を選択します。

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

  3. Blueprint Editorで、[ノードのインポート] ペインで [基本フラットマップ] コンポーネントをクリックします。 基本的なフラットマップ設定パラメータは、キャンバスで表示できます。

    • イベント

      イベント

      説明

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

      イベントは、データインターフェイス要求が応答され、フィルターによって処理された後、処理されたJSONデータでトリガーされます。 特定のデータについては、「データ」をご参照ください。

      マップが移動するとき

      マップの中心点が移動したときにスローされるイベント。 下表に、各パラメーターを説明します。

      {
        // The latitude.
        lat: 38.5714
        // Longitude
        lng: 106.5306
        // The zoom level.
        zoom: 4.3
        // The type of the trigger.
        type: "move_mouse"
      }

      マップ移動エンド

      マップの中心点が移動したときに発生するイベント。 下表に、各パラメーターを説明します。

      {
        // The latitude.
        lat: 38.5714
        // Longitude
        lng: 106.5306
        // The zoom level.
        zoom: 4.3
        // The type of the trigger.
        type: "moveend_mouse"
      }
    • Action

      ポリシーアクション

      説明

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

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

      データのインポート

      ウィジェットのデータがその描画フォーマットに従って処理された後、ウィジェットは再描画のためにインポートされる。 サーバーデータを再度リクエストする必要はありません。 特定のデータについては、「データ」をご参照ください。

      コンポーネント設定の更新

      ウィジェットのスタイル設定は動的に更新されます。 [設定] パネルで、[設定をクリップボードにコピー] をクリックして、コンポーネントの設定データを取得します。 その後、Blueprint Editorでデータ処理ノードのスタイルフィールドを変更します。

      表示

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

      非表示

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

      暗黙の状態への切り替え

      ウィジェットを表示するか非表示にするかを切り替えます。 下表に、各パラメーターを説明します。

          {
            //true indicates that a widget is shown, whereas false indicates that a widget is hidden. 
            "status": true,
            // Animation is displayed. 
            "animationIn": {
              // The animation type, which can be set to fade. If it is not specified, no animation is displayed. 
              "animationType": "fade",
              // The duration in which animation is displayed. It is in the unit of milliseconds. 
              "animationDuration": 1000,
              // The function that is used to display animation. You can set this parameter to linear|easeInOutQuad|easeInOutExpo. 
              "animationEasing": "linear"
            },
            // Animation is hidden. 
            "animationOut": {
              // The animation type, which can be set to fade. If it is not specified, no animation is displayed. 
              "animationType": "fade",
              // The duration in which animation is hidden. It is in the unit of milliseconds. 
              "animationDuration": 1000,
              // The function that is used to hide animation. You can set this parameter to linear|easeInOutQuad|easeInOutExpo. 
              "animationEasing": "linear"
            }
          }

      移動

      コンポーネントを指定した位置に移動します。 下表に、各パラメーターを説明します。

          {
            // The positioning type. to indicates absolute positioning, whereas by indicates relative positioning. The default value is to. 
              "positionType": "to",
            // The location, which is indicated by the x and y coordinates. 
            "attr": {
              "x": 0,
              "y": 0
            },
            // The animation type. 
            "animation": {
              "enable": false,
              // The duration in which animation is displayed. 
              "animationDuration": 1000,
              // The animation curve, which can be set to linear|easeInOutQuad|easeInOutExpo. 
              "animationEasing": "linear"
            }
          }