ラベル PMTiles の投稿を表示しています。 すべての投稿を表示
ラベル PMTiles の投稿を表示しています。 すべての投稿を表示

2026年10月2日金曜日

Mapterhornの地形データをAPEXのマップ背景として使用する

Mapterhornというプロジェクトが公開している地形データを、Oracle APEXのマップ・リージョンの背景として使用してみます。

Mapterhornによって配布されているデータについては、ホーム・ページのData Accessに以下のように記載されています。

Mapterhorn v0.0.13 distributes Terrarium-encoded terrain rgb tiles as webp images with 512 pixel width. The tiles are bundled into multiple PMTiles archives listed below. Alternatively, single tiles can be retrieved from a zxy-endpoint.

PMTilesであれば、以前に記事「国土地理院が試験公開している最適化ベクトルタイルのPMTiles版をマップの背景にする」にて、国土地理院が公開しているベクトルタイルをAPEXのマップ背景にした実績があります。今回も同様の手順にて、Mapterhornの地形データをAPEXのマップ背景にします。

今回の記事では、株式会社MIERUNEの@nokonoko_1203(のこのこ)さんによる記事を参照させていただいています。


他には同じく株式会社MERUNEのYasunori Kirimotoさんの記事も参照しています。

Zennの記事:Mapterhornの地形データで3Dマップアプリケーションを構築

コードについてはMapterhornのGitHubリポジトリのexamplesを参考にしています。PMTilesの扱いについては、以下のexample.htmlに記載されています。


それ以外のコードやスタイル・シートとなるJSONは、GPT-6 Astra(軽)にやりたいことを伝えて生成させています。

作成したAPEXアプリケーションは以下のように動作します。Mapterhornの地形データをマップ背景として、標高0メートルを青、それからマップに表示されている一番高い標高を赤として、青→水色→緑→黄→赤と連続で表示色を変えます。マップに表示されている領域が変わると一番高い標高が変わるため、マップ背景の色付けが変わります。

筑波山がマップに表示されると、茨城県の南部から千葉県の北部の利根川流域はほとんど青く表示されてしまいます。筑波山がマップから外れると利根川流域とその周辺の違いが見えるようになります。


以下より作成したAPEXアプリケーションについて紹介します。

作成したAPEXアプリケーションのマップのソースとして、都道府県の庁所在地を使用しています。以下のスクリプトを実行し、表PREF_CAPITALSの作成とデータの投入を行います。

空のAPEXアプリケーションを作成し、ホーム・ページにマップ・リージョンを配置します。

リージョンの名前はMapterhornとしています。リージョンのタイプはマップです。


今回のアプリケーションはマップ背景がテーマなので、レイヤーについては簡単に設定します。

レイヤーの識別の名前はCapital、レイヤー・タイプはポイントとします。ソースのSQL問い合せとして、以下のSELECT文を記述します。

select capital_city, lat, lon from pref_capitals

列のマッピングのジオメトリ列のデータ型に緯度/経度を選択し、経度列にLON、緯度列にLATを選択します。


この状態でアプリケーションを実行すると、以下の表示になります。


これからMapterhornの地形データをマップ背景とする設定を行います。

Oracle APEX 26.1に含まれているMapLibre GL JSのバージョンは5.6.1です。このバージョンで利用可能なPMTilesのライブラリとして、以下をロードします。ページ・プロパティのJavaScriptのファイルURLに記述します。

https://cdn.jsdelivr.net/npm/pmtiles@4.5.0/dist/pmtiles.min.js

プロトコルとしてPMTilesをMapLibreに追加します。以下のコードをJavaScriptのページ・ロード時に実行に記述します。コード自体はexample.htmlの記載そのままですが、ズーム・レベル12を境に取得するURLの体系が変わるため、きちんとデータが取得できたかどうか確認するためのコードを追加しています。


スタイルを定義するJSONを静的アプリケーション・ファイルとして作成します。

静的アプリケーション・ファイルとしてstd.jsonを作成し、以下を記述します。



作成した静的アプリケーション・ファイルstd.jsonを参照するマップ背景を作成します。


マップ背景としてMapterhornを作成します。タイプにベクター・タイル・レイヤーを選択します。


スタイル・シートのであるstd.jsonは静的アプリケーション・ファイルとして作成しているため、スタイルシートをマップするURLとして#APP_FILES#std.jsonと設定できれば良かったのですが、この位置では置換文字列APP_FILESは使えないようです。(それかスタイル・シートを直接記述できればよかった。)

そのため、ページ上に表示されているアイコンの画像アドレスを取得し、そのアドレスを元に置換文字列APP_FILESの値を見つけます。その上でスタイルシートをマップするURLとしてstd.jsonをフルパスで記述します。

置換文字列APP_FILESの値はアプリケーションごとに異なるため、アプリケーションをインポートしたら必ずスタイルシートをマップするURLを更新する必要があります。


マップ背景としてMapterhornが作成されたので、これをマップ・リージョンの背景に設定します。

マップの属性を開きマップの背景に共有コンポーネント、標準にMapterhornを選択します。


以上でMapterhornの地形データがマップ背景として設定されました。この時点でのアプリケーションの表示は以下になります。

スタイル・シートstd.jsonに標高300m以上は赤で表示としているため、日本のほとんどは赤く表示されています。


マップに表示されている最高地点を赤にするように、マップの表示後にスタイルのプロパティを更新します。

マップの初期化時に実行される動的アクションを作成します。タイミングのイベントはマップが初期化されました、選択タイプはリージョン、リージョンとしてマップ・リージョンであるMapterhornを選択します。


アクションはJavaScriptコードの実行とし、以下のコードを記述します。



マップに表示されている一番高い標高が赤になるように更新されるようになりました。

この状態でマップを表示すると以下になります。


この状態で利根川流域を表示しています。筑波山を含みます。


筑波山を外すと、利根川流域が現れます。


以上でアプリケーションの作成は完了です。

今回作成したAPEXアプリケーションのAPEXlang形式のエクスポートを以下に置きました。

https://github.com/ujnak/APEXlang-exports/tree/main/mapterhorn-pmtiles

今回の記事は以上になります。

Oracle APEXのアプリケーション作成の参考になれば幸いです。

完

2025年2月13日木曜日

国土地理院が試験公開している最適化ベクトルタイルのPMTiles版をマップの背景にする

Oracle APEX 23.2より、開発者が共有コンポーネントとしてマップ背景を設定することができます。このマップ背景として、国土地理院がGitHubで試験公開している最適化ベクトルタイルのPMTiles版を設定してみます。

今回の作業で参照している国土地理院による最適化ベクトルタイル試験公開のページは以下です。

最適化ベクトルタイルは、国土地理院コンテンツ利用規約に従って利用できます。記事に沿って作業を行なう場合は、利用規約について確認してください。問題は無いと思いますが、気になるので今回の記事はAPEXアプリケーションのエクスポートは添付しません。


以下より作成したアプリケーションについて説明します。

空のAPEXアプリケーションを作成します。名前は国土地理院最適化ベクトルタイルとします。


アプリケーションが作成されます。

ページ・デザイナでホーム・ページを開き、マップ・リージョンを作成します。


新規のリージョンを作成します。識別の名前はMap、タイプにマップを選択します。


マップには最低でも1つのレイヤーが必要なので、レイヤーに最低限の設定を行います。

レイヤーの新規を選択し、識別の名前をポイントに変更します。レイヤー・タイプとしてポイントを選びます。

ソースのタイプにSQL問合せを選択し、SQL問合せとして以下のSQLを記述します。東京都の緯度経度を返しています。

select 35.652832 as lat, 139.839478 as lon from dual;

列のマッピングのジオメトリ列のデータ型として経度/緯度を選択し、経度列としてLON、緯度列としてLATを選びます。


マップ・リージョンを選択し、属性タブを開きます。

初期位置およびズームのタイプを静的値とし、経度は139.839478、緯度は35.652832、ズーム・レベルを6として、東京の周辺を最初に表示するようにします。


この時点でアプリケーションを実行すると、デフォルトのマップ背景が表示されます。


Oracle APEXのマップ・リージョンはMapLibreを使用しています。組み込まれているMapLibreのバージョンはAPEXのバージョンにより異なります。それぞれのバージョンに組み込まれている3rd PartyのJavaScriptライブラリのバージョンは、リリース・ノートに記載されています。

今回はAPEX 24.1でアプリケーションを作成しているため、組み込まれているMapLibreのバージョンは4.0.1になります。

APEXそのままの状態では、MapLibreにPMTilesのプロトコル・ハンドラが登録されていません。ページ・プロパティに以下の設定を追加し、MapLibreにPMTilesのプロトコル・ハンドラを追加します。

ページ・プロパティのJavaScriptのファイルURLに以下を設定します。PMTilesのプロトコル・ハンドラの実装です。

https://cdn.jsdelivr.net/npm/pmtiles@4.2.1/dist/pmtiles.min.js

ページ・ロード時に実行に以下を記述します。
let protocol = new pmtiles.Protocol();
maplibregl.addProtocol("pmtiles", protocol.tile);
以上で、MapLibreにPMTilesのプロトコル・ハンドラが追加されます。


マップ背景を作成します。

共有コンポーネントのマップ背景を開きます。


作成をクリックします。


作成するマップ背景の名前は国土地理院 標準地図とします。タイプにベクター・タイル・レイヤーを選択します。

スタイルシートをマップするURLとして、GitHubに保存されている標準地図のstyle.jsonである、std.jsonを参照します。

https://raw.githubusercontent.com/gsi-cyberjapan/optimal_bvmap/refs/heads/main/style/std.json

以上で、マップ背景の作成をクリックします。


同様の手順で白地図のマップ背景を作成します。

名前は国土地理院 白地図、スタイルシートをマップするURLに以下を設定します。

https://raw.githubusercontent.com/gsi-cyberjapan/optimal_bvmap/refs/heads/main/style/skeleton.json


マップ背景として国土地理院 標準地図と国土地理院 白地図が作成されました。


マップ背景を変更します。最初に国土地理院 標準地図を表示します。

マップ・リージョンの属性を開き、背景に共有コンポーネント、標準に国土地理院 標準地図を選択します。


ページを実行すると、以下のように地図の表示が変わります。


ズームなどをして、表示を確認します。


マップ背景を国土地理院 白地図に切り替えます。


表示が白地図に切り替わります。


国土地理院からは地理院地図Vector提供実験として、地理院タイル(ラスタ)と同じ方式で配信しているベクトルタイルもあります。

このページにstyle.jsonが掲載されていますが、APEXのマップ・リージョンで読み込もうとすると、version、sources、layersといったプロパティがないというエラーが発生します。このstyle.jsonはOracle APEXでは扱えないようです。


MapLibreにPMTilesのプロトコル・ハンドラが組み込めたので、国土地理院が提供している地図に限らず、PMTilesのプロトコルで提供している地図で、style.jsonへの参照URLがあれば、マップ背景にできるでしょう。

今回の記事は以上になります。

Oracle APEXのアプリケーション作成の参考になれば幸いです。

完