翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ジオマップパネル
<a name="v9-panels-geomap"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

ジオマップパネルの視覚的表現により、地理空間データを用いて世界地図を表示、カスタマイズできます。さまざまなオーバーレイスタイルとマップビュー設定を設定して、データの重要な位置情報に注目しやすくすることができます。

## マップビュー
<a name="v9-panels-geomap-view"></a>

マップビューは、ダッシュボードのロード時にマップの初期ビューを制御します。

**[初期ビュー]**

初期ビューは、パネルが最初にロードされたときに GeoMap パネルがどのようにレンダリングされるかを設定します。
+ **[ビュー]** は、パネルが最初にロードされたときにマップの中心を設定します。
  + **[Fit to data]** は、データが変更されたときのマップレイヤーと更新のデータ範囲に基づいてマップビューに適合します。
    + **[データ]** オプションでは、[すべてのレイヤー] のデータ、単一の [レイヤー]、または選択したレイヤーの [最後の値] に基づいて範囲を選択できます。
    + **[レイヤー]** において、単一の [レイヤー] またはレイヤーの [最後の値] からデータをフィッティングする場合に選択できます。
    + **[パディング]** は、データ範囲を超えた相対的な割合でパディングを設定します ([最後の値] のみを参照する場合は使用できません)。
    + **[Max Zoom]** は、データをフィッティングするときに最大ズームレベルを設定します。
  + **[座標]** は、以下に基づいてマップビューを設定します。
    + **Latitude** (緯度)
    + **Longitude** (経度)
  + デフォルトビューには、以下を含むものもあります。
    + **(0°, 0°)**
    + **北米**
    + **南米**
    + **欧州**
    + **アフリカ**
    + **西アジア**
    + **南アジア**
    + **東南アジア**
    + **東アジア**
    + **オーストラリア**
    + **オセアニア**
+ **[Zoom]** は、初期ズームレベルを設定します。

## レイヤーのマッピング
<a name="v9-panels-geomap-layers"></a>

Geomap 視覚化は、複数のレイヤーの表示をサポートします。各レイヤーは、ベースマップ上に地理空間データをどのように表示するかを決定します。

**タイプ**

ジオマップの視覚的表現では、3 つのマップレイヤータイプを選択できます。
+ [マーカーレイヤー](#v9-panels-geomap-markers) は、各データポイントにマーカーをレンダリングします。
+ [ヒートマップレイヤー](#v9-panels-geomap-heatmap) はデータのヒートマップを視覚化します。
+ [GeoJSON レイヤー](#v9-panels-geomap-geojson) は GeoJSON ファイルから静的データをレンダリングします。

また、現在アルファに入っているレイヤータイプは 5 つあります。
+ [夜間/昼間レイヤー (アルファ）](#v9-panels-geomap-nightday) は夜間または昼間のリージョンをレンダリングします。
+ **[Icon at last point (alpha)]** は、最後のデータポイントにアイコンをレンダリングします。
+ **[Dynamic GeoJSON (alpha)]** は、クエリ結果に基づいて GeoJSON ファイルをスタイルします。
+ **[Route (alpha)]** は、データポイントをルートとしてレンダリングします。
+ [写真レイヤー (アルファ)](#v9-panels-geomap-photos) は、各データポイントに写真をレンダリングします。

**[レイヤーコントロール]**

レイヤーコントロールを使用すると、レイヤーの作成、名前の変更、レイヤーの順序の変更、削除を行うことができます。
+ **[レイヤーを追加]** で、Geomap 視覚化用に設定可能な追加のデータレイヤーを作成します。レイヤーを追加すると、レイヤータイプを選択するように求められます。レイヤータイプは、パネル設定中にいつでも変更できます。各レイヤータイプの詳細については、上記の「**レイヤータイプ**」セクションを参照してください。
+ レイヤーコントロールを使用すると、パネルのレイヤーの名前変更、削除、順序変更をすることができます。
  + **[レイヤー名の編集]** (鉛筆アイコン) でレイヤーの名前を変更できます。
  + **[Trash Bin]** (ごみ箱) でレイヤーを削除できます。
  + **[Reorder]** (順序変更) (6 つのドット/グラブハンドル) では、レイヤーの順序を変更できます。上位レイヤーのデータは、下位レイヤーのデータの上に表示されます。パネルはドラッグアンドドロップするたびにレイヤーの順序を更新するため、レイヤーの順序の選択を簡素化します。

1 つのジオマップパネルに複数のデータレイヤーを追加して、リッチで詳細な視覚化を作成できます。

**場所**

ジオマップパネルには、地理的データの情報源が必要です。このデータには 4 つのマッピングオプションがあり、データベースクエリを使用して取得します。
+ **[自動]** でロケーションデータを自動的に検索します。クエリがデータフィールドの次のいずれかの名前に基づいている場合は、このオプションを使用します。
  + ジオハッシュ:「geohash」
  + 緯度:「latitude」、「lat」
  + 経度:「longitude」、「lng」、「lon」
  + ルックアップ:「lookup」
+ **Coords** (座標): クエリに座標データが含めることを指定します。データベースクエリから、緯度と経度の数値データフィールドを選択するよう求められます。
+ **Geohash** (ジオハッシュ): クエリがジオハッシュデータが含めることを指定します。データベースクエリから、ジオハッシュの文字列データフィールドを選択するよう求められます。
+ **[ルックアップ]**: クエリに値にマッピングする必要があるロケーション名データが含めることを指定します。データベースクエリと地名索引からルックアップフィールドを選択するよう求められます。地名索引は、クエリされたデータを地理的ポイントにマッピングするために使用されるディレクトリです。

## マーカーレイヤー
<a name="v9-panels-geomap-markers"></a>

マーカーレイヤーを使用すると、データポイントを円、正方形、三角形、星などのさまざまな形のマーカーとして表示することができます。

マーカーには多くのカスタマイズオプションがあります。
+ [**マーカーの色**] で、マーカーの色を設定します。デフォルトの `Single color` では、すべてのポイントが 1 色に保たれます。`Thresholds` セクションで設定されたデータポイント値としきい値に応じて、複数の色を使用できる代替オプションがあります。
+ **マーカーサイズ**: マーカーのサイズを設定します。デフォルトは `Fixed size` で、すべてのマーカーサイズはデータポイントに関係なく同じになります。ただし、対応するデータポイントに円を拡大縮小するオプションもあります。マーカーレイヤーの拡大縮小の範囲を指定するため、マーカーサイズの `Min` と `Max` を設定する必要があります。
+ **[Marker Shape]** を使用すると、データに追加のビジュアルコンテキストを提供するのに役立つ図形、アイコン、またはグラフィックを選択できます。シンプルな図形や Unicon ライブラリなど、Grafana に含まれているアセットから選択します。画像アセットを含む URL を指定することもできます。画像は SVG (Scalable Vector Graphics: スケーラブルベクトルグラフィック) である必要があります。
+ **[塗りつぶしの透明度]**: 各マーカーの透明度を設定します。

## ヒートマップレイヤー
<a name="v9-panels-geomap-heatmap"></a>

ヒートマップレイヤーは、さまざまなデータポイントをクラスター化して、密度の異なる場所を視覚化します。ヒートマップレイヤーを追加するには

[Data レイヤー] のドロップダウンメニューをクリックし、`Heatmap` を選択します。

`Markers` と同様に、視覚化するデータポイントとその視覚化方法を決定するオプションが表示されます。
+ **[重み値]** では、ヒートマップクラスターの強度を設定します。`Fixed value` は、すべてのデータポイントで一定の重み値を維持します。この値は 0～1 の範囲で設定します。マーカーと同様に、ドロップダウンには、データ値に応じて重み値を自動的にスケールする代替オプションがあります。
+ **[Radius]** (半径): ヒートマップクラスターのサイズを設定します。
+ **[Blur]** (ぼかし) では、各クラスターのぼかしの量を設定します。

## GeoJSON レイヤー
<a name="v9-panels-geomap-geojson"></a>

GeoJSON レイヤーを使用すると、ファイルシステムから静的 GeoJSON ファイルを選択してロードできます。
+ **[GeoJSON URL]** では、Grafana に付属する GeoJSON ファイルを選択できます。
+ **[デフォルトのスタイル]** では、上記のルールが一致しない場合に適用するスタイルを制御します。
  + **[色]** ではデフォルトのスタイルの色を設定します
  + **[不透明度]** ではデフォルトの不透明度を設定します
+ **[スタイルルール]** では、機能のプロパティに基づいてスタイルを適用します
  + **[ルール]** を使用すると、GeoJSON ファイルから*特徴量*、*条件*、および*[値]*を選択して、ルールを定義できます。ごみ箱アイコンを使用して、現在のルールを削除できます。
  + **[色]** では、現在のルールに対するスタイルの色を設定します
  + **[不透明度]** では、現在のルールの透明性レベルを設定します
+ **[スタイルルールの追加]** で、追加のスタイルルールを作成できます。

## CARTO レイヤー
<a name="v9-panels-geomap-carto"></a>

CARTO レイヤーは [CARTO](https://carto.com/about-us/) Raster ベースマップからのものです。

**オプション**
+ **Theme (テーマ)**

   **Light** テーマ、**Dark** テーマ、または **Auto** テーマのいずれかのテーマを選択します。
+ **[ラベルの表示]** で、マップの上部に国の詳細が表示されます。
+ **[不透明度]** は 0 (透明) から 1 (不透明) です

## XYZ タイルレイヤー
<a name="v9-panels-geomap-xyz"></a>

XYZ タイルレイヤーは、汎用タイルレイヤーからのマップです。

**注記**  
汎用タイルレイヤーの詳細については、「[Web マップのタイル化](https://en.wikipedia.org/wiki/Tiled_web_map)」および「[Open Street Map タイルサーバーの一覧](https://wiki.openstreetmap.org/wiki/Tile_servers)」を参照してください。

**オプション**
+ **URL テンプレート**
**注記**  
`https://tile.openstreetmap.org/{z}/{x}/{y}.png` など、\$1z\$1/\$1x\$1/\$1y\$1 が付いた有効なタイルサーバー URL を設定します。
+ **[Attribution]** (属性) では、[マップコントロール](#v9-panels-geomap-controls)に表示されるレイヤーのリファレンス文字列を設定します。
+ **[不透明度]** は 0 (透明) から 1 (不透明) です

## Open Street Map レイヤー
<a name="v9-panels-geomap-osm"></a>

[Open Street Map](https://www.openstreetmap.org/about) からのマップで、これは共同による無料の地理的世界データベースです。

**オプション**
+ **[不透明度]** は 0 (透明) から 1 (不透明) です

## ArcGIS レイヤー
<a name="v9-panels-geomap-arcgis"></a>

[ArcGIS](https://services.arcgisonline.com/arcgis/rest/services) レイヤーは、[ESRI](https://www.esri.com/en-us/about/about-esri/overview) ArcGIS MapServer からのレイヤーです。

**オプション**
+ **サーバーインスタンス**で、次のマップタイプから選択します。
  + World Street Map (世界の道路地図)
  + World Imagery (衛星画像)
  + World Physical
  + Topographic (トポロジ)
  + USA Topographic (米国トポロジ)
  + World Ocean (海洋図)
  + Custom MapServer (書式設定については [XYZ](#v9-panels-geomap-xyz) を参照)
    + URL テンプレート
    + Attribution (属性)
+ **[不透明度]** は 0 (透明) から 1 (不透明) です

## 夜間/昼間レイヤー (アルファ）
<a name="v9-panels-geomap-nightday"></a>

夜間/昼間レイヤーには、現在の時間範囲に基づいて夜間および昼間の領域が表示されます。

**注記**  
詳細については、「[OpenLayers の拡張機能 - DayNight](https://viglino.github.io/ol-ext/examples/layer/map.daynight.html)」を参照してください。

**オプション**
+ **[表示]** では、パネルの時間範囲から時間ソースを切り替えます
+ **[Night region color]** では、夜間領域の色を選択します
+ **[Display sun]** (太陽の表示) で太陽アイコンが切り替えられます
+ **[不透明度]** は 0 (透明) から 1 (不透明) です

## 写真レイヤー (アルファ)
<a name="v9-panels-geomap-photos"></a>

写真レイヤーは、各データポイントに写真をレンダリングします。

**注記**  
詳細については、「[OpenLayers の拡張機能 - 画像写真スタイル](http://viglino.github.io/ol-ext/examples/style/map.style.photo.html)」を参照してください。

**オプション**
+ **画像ソースフィールド**

  次のいずれかの形式で、画像データを含む文字列フィールドを選択します。
  + **画像 URL**
  + **Base64 でエンコードされた**バイナリ画像 (`data:image/png;base64,…`)
+ **[Kind]** (種類)

   画像の周りのフレームスタイルを選択します
  + **[Square]** (平方)
  + **[Circle]** (円形)
  + **[Anchored]** (アンカー)
  + **[Folio]** (フォリオ)
+ **[Crop]** (トリミング) では、画像がフィットするようにトリミングされるかどうか切り替えます
+ **[Shadow]** (シャドウ) では、画像の背後にあるボックスシャドウを切り替えます
+ **[Border]** (境界線) では、画像の周囲の境界サイズを設定します
+ **[境界線の色]** では、画像の周囲の境界線の色を設定します
+ **[Radius]** (範囲) では、画像の全体的なサイズをピクセル単位で設定します

## マップコントロール
<a name="v9-panels-geomap-controls"></a>

マップコントロールインターフェイスには、マップ情報とツールオーバーレイの以下のオプションが含まれています。

**Zoom**

このセクションでは、各ズームコントロールについて説明します。

*Show zoom control*

ズームコントロールを左上隅に表示します。

*Mouse wheel zoom*

マウスホイールを使用してズームインまたはズームアウトできる設定を、オンまたはオフにします。

**Show attribution**

マップ上のベースマップレイヤーの属性を表示します。

**Show scale**

スケール情報を左下隅に表示します。

**注記**  
[m]/[km] 単位で表示します。

**Show measure tools**

測定ツールを右上隅に表示します。測定値は、このコントロールが開いている場合にのみ表示されます。
+ **クリック**して測定を開始します
+ **連続クリック**で測定を続行します
+ **ダブルクリック**して測定を終了します

**注記**  
測定タイプまたは単位を変更すると、以前の測定がマップから削除されます。  
コントロールを閉じてから再度開くと、最新の測定値が表示されます。  
測定値は、クリックしてドラッグすることで変更できます。

*Length*

ジオメトリの球面長を取得します。この長さは、座標間の大圏距離の合計です。マルチパートジオメトリの場合、長さは各パートの長さの合計です。ジオメトリは「EPSG:3857」にあると仮定されます。

長さ測定には、次の単位を選択できます。
+ **メートル (m/km)**
+ **フィート (ft)**
+ **マイル (mi)**
+ **海里 (nmi)**

*[面積]*

ジオメトリの球の表面積を取得します。この面積は、ポリゴンエッジが球上の大円のセグメントであると仮定して計算されます。ジオメトリは「EPSG:3857」にあると仮定されます。

面積測定には、次の単位を選択できます。
+ **平方メートル (m²)**
+ **平方キロメートル (km²)**
+ **平方フィート (ft²)**
+ **平方マイル (mi²)**
+ **エーカー (acre)**
+ **ヘクタール (ha)**

**Show debug**

デバッグ情報をマップの右上隅に表示します。これは、データソースのデバッグまたは検証に役立ちます。
+ **[Zoom]** は、マップの現在のズームレベルを表示します。
+ **[Center]** (中央) には、マップ中央の現在の**経度**と**緯度**が表示されます。

**Tooltip** (ツールチップ)
+ **[なし]** では、データポイントがクリックされた場合にのみツールチップが表示されます。
+ **[Details]** (詳細) では、データポイントにポインタを合わせると、ツールチップが表示されます。