OACのマップ・ビジュアライゼーションで参照レイヤーを設定する

# はじめに
参照レイヤーとは、OAC（**Oracle Analytics Cloud**）のマップ・ビジュアライゼーションで設定できるレイヤーの一種です。
通常のレイヤーとは違い、データセット等の検索データを表示しません。
参照レイヤーは通常のレイヤーに重ね合わせて使用します。
※ 執筆時点のOACのバージョンはSeptember 2024でした。

# サンプルデータ
国土交通省が公開している国土数値情報の中から、洪水浸水想定区域データを参照レイヤーとして使用してみます。
次のサイトから、神奈川県のデータ（A31-21_14_GML.zip）をダウンロードしました。

https://nlftp.mlit.go.jp/ksj/gml/datalist/KsjTmplt-A31-v3_0.html

酒匂川水系（山王川、狩川）のデータをQGISを使用してマージし、浸水深ランクコード別のgeojsonとしてエクスポートしました。
- 酒匂川水系浸水想定域 ランク1.geojson
- 酒匂川水系浸水想定域 ランク2.geojson
- 酒匂川水系浸水想定域 ランク3.geojson
- 酒匂川水系浸水想定域 ランク4.geojson

次に、小田原市オープンデータサイトから、AED設置場所データをダウンロードし、加工しました。
※不要列の削除と、UTF8への変換

https://www.city.odawara.kanagawa.jp/field/municipality/itpolicy/p25549.html

# 参照レイヤーの登録
OACにログインし、「コンソール」メニューの「マップ」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/3be11e78-6506-d833-6f84-f90592fb812b.png)

参照レイヤータブに移動して、「＋」をクリックして参照レイヤーを追加します。
追加する参照レイヤーは、GeoJSONフォーマットである必要があります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/098ecab1-88d8-886d-5eb4-c28421ad5b44.png)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/d807700b-7088-44fd-d507-b6fa34eb3ab2.png)

GeoJSONファイルを4つとも登録します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/bcb77a48-7b20-c96f-54dd-a215b5583bc5.png)

# マップ・ビジュアライゼーションの作成
AED設置場所データをデータセットとして登録します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/7a354fc7-36af-ec03-a875-d43944009347.png)

緯度、経度は集計列ではなく属性列なので、後で変更しておきます。

## ワークブックの作成
新規にワークブックを作成します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/a7511af3-2e9c-919a-342e-d50ef58fc5e3.png)

AED設置場所データを選択して、ワークブックに追加します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/c8543524-cd6a-462e-0fdf-01dec1843568.png)

## 緯度・経度でマップ・ビジュアライゼーションを作成
緯度、経度でマップ・ビジュアライゼーションを作成します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/79ccb36f-900b-cd63-f4c8-e4af77e37e42.png)

「名称」をツールチップに配置します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/f7e00909-f69e-ceec-7ea7-20d7b83f4868.png)

背景マップを「Oracle DataViz」に変更しました。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/6e37244b-b240-f75e-f8f5-5476793859d8.png)

## 参照レイヤーを追加
事前に作成しておいた参照レイヤーを追加します。
1. マップ・ビジュアライゼーションの「文法」アイコンをクリックします
1. レイヤー・オプションをクリックします
1. レイヤーの追加から参照レイヤーの追加をクリックします

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/ddb76542-de51-73e6-b265-7f84c9495993.png)

「レイヤー2」が作成されます。
同じことを繰り返して、「レイヤー3」「レイヤー4」「レイヤー5」を作成します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/27027628-0a07-506c-2547-10003c58c01d.png)

「プロパティ」アイコンをクリックして、「データ・レイヤー」タブを表示します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/9d12df94-963d-c65b-9544-3b65e5eec087.png)

レイヤー5の「マップ・レイヤー」をデフォルトの「None」から、登録しておいた参照レイヤーに変更します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/d21365a5-8ee6-569d-176c-9580746645a0.png)

色を「カスタム」に変更し、任意の塗りつぶしの色を設定します。
凡例タイトルは表示しないようにしておきます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/390dfbc2-87cc-e350-3d49-d4edfb8972ca.png)

同様に、他の参照レイヤーも設定します。
色は、ランクが大きくなるに従って、徐々に濃い色になるようにしました。

緯度、経度レイヤーを開きます。
1. 名前をカスタムに変更し「AED設置場所」とします
1. サイズを少し小さめに変更します（18 -> 14）
1. データラベルの位置を変更します（オフ -> 上）
1. 列を「名称」にします
1. ハローを「カスタム」に変更します
1. ハローの色を任意の色に変更します

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/28e250a6-7f7f-daff-4374-2927b74006ea.png)

最後にレイヤーの順番を変更します。
「AED設置場所」レイヤーの「レイヤーの順序変更」アイコンをドラッグ＆ドロップで一番上に移動します。

:::note
間違えて隣の「削除」をクリックしてしまったら、慌てずにUNDOしてください。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/1c9dc404-a25f-9100-b371-48a2b5ec44e7.png)
:::

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/3cd5feec-8ca2-2ce6-f2a0-9dee8a693378.png)

ドラッグ＆ドロップします
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/d58119a2-8c1b-ab40-1047-4d371a566f83.png)

完成形です。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/2bd8cad7-d05f-7d10-7081-bf518a8e014a.png)

# 完成
プレビュー表示してみます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/ddfb29ea-f120-8ee3-8992-a14f6a4aa4b0.png)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/429c19ad-4a59-271b-be5d-ee34a7be9d22.png)

# ドキュメント
- [背景マップとマップ・レイヤーを適用してビジュアライゼーションを強化する](https://docs.oracle.com/en/cloud/paas/analytics-cloud/acubi/apply-map-backgrounds-and-map-layers-enhance-visualizations.html)