Leaflet

どのようなものか

Leafletは、ウェブページ内の一つの要素を、人が移動、拡大縮小、クリッ
クできる地図にする、オープンソースのJavaScriptライブラリーです。プロ
ジェクトは、JavaScriptが約42
KBで、外部への依存がないと説明します。Volodymyr
Agafonkinが作成し、今は貢献者のコミュニティーが開発しています。BSD
2-Clauseライセンスで公開しています。

プロジェクトの概要は、誰に対しても何でも提供するのでなく、基本機能の
完成度を高めることに集中すると述べます。`L.map`は、要素と一連の設定
を受け取り、地図を作成します。タイルレイヤーは、`{z}`、`{x}`、`{y}`
を含むURLテンプレートから正方形の画像を取得し、画像要素の格子に並べ
ます。WMS版は、Web
Map
Serviceに対して同じことをします。折れ線、多角形、円、長方形は、既定
ではSVGとして描き、地図の作成時に`preferCanvas`を指定すれば、一つの
キャンバス（canvas）へ描きます。マーカーは、画像か単純な`div`を使う
アイコンで、ポップアップやツールチップを付けられます。GeoJSONレイ
ヤーは、各フィーチャーを、それらのレイヤーの一つに変えます。点は、別
の指定がなければマーカーになります。操作部は、拡大縮小ボタン、出典表
示、レイヤー切り替え、縮尺表示です。既定の座標参照系はEPSG:3857で、
参照文書は、オンライン地図で最も一般的なものと呼びます。

その一覧を超えるものは、すべてプラグインで加えます。プロジェクトのプ
ラグイン一覧は、Leafletをできるだけ軽量に保つ方針を説明し、数百の第
三者製プラグインへ案内します。ベクトルタイル、クラスタリング、ヒート
マップ、図形編集、経路探索、ジオコーディングなどに分類しています。

執筆時点では、二つのリリース系列があります。安定版は、2023年5月18日
公開の1.9.4で、プロジェクトのサイトにあるAPI参照も、この版です。先行
版は、2025年8月16日の2.0.0-alpha.1です。Internet
Explorerへの対応をやめ、ESモジュールとして配布します。グローバルの
`L`を残すのは、バンドルした`leaflet-global.js`だけです。ファクトリー
関数をコンストラクターに変えるため、`L.marker(latlng)`は`new
Marker(latlng)`になります。入力は、ポインターイベントで受け取りま
す。

なぜ重要なのか

ページに地図を置くときは、二つの判断を、一つと間違えやすくなります。
ブラウザーで地図を描くコードと、地図画像の取得元です。Leafletは、そ
れを分けており、選ぶ主な理由も、この分離を維持できることです。

Leafletは、描画します。タイルは、URLテンプレートが指す先から届くた
め、背景地図は、料金、条件、所有者が別の、独立した選択です。機能を
作っている間はOpenStreetMapのタイルサーバー、本番では商用提供者、あ
るいは自身で運用するタイルサーバーや、`TileLayer.WMS`経由の自治体の
WMSを使えます。切り替えるときは、文字列と出典表示の一行を変えるだけ
で、地図の周囲のアプリケーションコードは、そのままです。

大きさとライセンスが、Leafletの向く場所を決めます。約42
KBで依存もないため、ピンを置くフォームや、レコードの位置を示す管理画
面など、地図が多くの要素の一つであるページに向きます。BSD
2-Clauseのライブラリー自体をページで使うために、アカウント、鍵、利用
量の計測を挟む必要はありません。

小さな中核を保つ代償は、重い機能が、別のパッケージになることです。そ
れぞれに保守担当者とリリースの速さがあり、六つのプラグインに頼る地図
では、その六つそれぞれの更新を追う必要があります。2.0アルファは、そ
の意味を示します。移行文書は、古いプラグインが、グローバルの`L`と
ファクトリー関数を期待するため、V1互換のポリフィルを案内します。どの
拡大率でも、ブラウザーでスタイルを付けるベクトルタイルが必要なら、そ
れを中心に作ったライブラリーの方が向きます。六つのプラグインで地図を
支える前に、決めたいことです。

実際の活用例

Leafletは、このサイトの二つのページに登場します。どちらも、2015年か
ら2022年のGISソフトウェア開発チーム責任者の職務に関するもので、いず
れも、フロントエンドではMapboxと併用していました。

その職務では、三十件を超えるGISプロジェクトを、構築からデプロイまで
指揮しました。フロント側には、Mapbox
GLとLeafletで作るウェブ地図があり、ときにはArcGISやHEREのAPIを使いま
した。アプリケーション層は、JavaScript、Python、PHP、SQLです。その下
に、PostGISを備えたPostgreSQLがあり、GDAL/OGRが、shapefile、
GeoJSON、GeoTIFF、KML、ベクトルタイルの間でデータを動かしました。責
任範囲は、公開で終わらず、本番のサポートまで続きました。

同じ職務では、プロジェクトのユーザーインターフェースの設計過程にも参
加しました。MapboxとLeafletの地図の上に、React、Angular、Vueのフロン
トエンドがありました。ページは、どの地図ライブラリーを使うときも忘れ
たくない点を示します。ウェブ地図の製品では、地図は簡単な部分で、操作
部や絞り込み、その周囲の操作の流れで、人が迷います。使いやすさは、
データセットの絞り方や、屋内地図で階を移る方法など、細部にありまし
た。その差の大半は、公開後でなく、設計中にそれを問うたためだと、ペー
ジは説明します。

問題が起きるところ

Leafletは小さいため、問題の大半は、周囲のページか、接続先のサービス
から生まれます。

灰色の枠や、ばらばらなタイルの帯が出ます。
Leafletは、コンテナーから大きさを得ます。クイックスタートは、地図の
コードを動かす前に行う、二つの準備を挙げます。JavaScriptより前に
LeafletのCSSを組み込み、コンテナーの高さを指定します。高さのない
`div`からは、高さのない地図ができます。さらに分かりにくいのは、その
とき隠れているタブやダイアログの中で、地図を作る場合です。大きさをゼ
ロと測り、表示されても、そのまま保ちます。Leaflet
1.xは、`trackResize`で、ブラウザーウィンドウの大きさの変更を追いま
す。コンテナー自身の大きさが変わっても、コードが`invalidateSize()`を
呼ぶまで気付きません。参照文書は、地図の大きさが変わった後で呼ぶよう
述べます。2.0アルファは、ウィンドウのサイズ変更（resize）イベントに
代えて、`ResizeObserver`を使います。

点が、数千キロメートル離れた場所に出ます。 RFC
7946が定めるGeoJSONは、位置を、経度から先に書きます。Leafletの
`LatLng`と、その代わりに使える配列は、緯度が先です。`L.geoJSON`は、
座標の順序を自動で変換するため、GeoJSONから手で座標を取り出し、その
ままマーカーや折れ線へ渡すと、不具合が生まれます。コペンハーゲンの点
の座標を入れ替えると、アラビア海へ移ります。境界で、名前を付けて二つ
を取り出します。

```js
const res = await fetch("/api/sites/42");
const site = await res.json();
const [lon, lat] = site.geometry.coordinates; // GeoJSON: lon, lat
L.marker([lat, lon]).addTo(map); // Leaflet: lat, lng
```

データが増えると、地図の移動が引っ掛かります。
SVGレンダラーでは、各線や多角形が、それぞれ文書の要素になり、既定の
各マーカーも、個別の画像です。何千ものフィーチャーを持つレイヤーで
は、移動や拡大縮小のたびに、何千もの要素を、ブラウザーが動かします。
`preferCanvas:
true`は、一つのキャンバスへパスを描きますが、対象はパスだけです。そ
のため、点は、`L.circleMarker`、つまり自身もパスである、ピクセル半径
が固定の円に変える必要があります。それを行うのが、GeoJSONレイヤーの
`pointToLayer`オプションです。それでも足りなければ、送るデータを減ら
します。クラスタリングプラグインか、現在の範囲と拡大率に収まるものだ
けを返すAPIを使います。

公開後に、タイルが届かなくなります。
クイックスタートは、OpenStreetMapのタイルサーバーで最初の地図を作り
ます。開発には使えても、本番前にタイル利用規則を読むよう、明記しま
す。規則は、見える出典表示、アプリケーションを特定するUser-Agent、
ウェブページからの有効なReferer、HTTPヘッダーに従うキャッシュを求
め、一括ダウンロードと先読みを禁じます。サービス水準合意はなく、予告
なくアクセスを止める場合もあります。多くの通信がある本番地図は、その
量に合う条件の提供者か、自身のタイルサーバーで運用します。Leafletな
ら、移行に必要なのは、URLテンプレートと出典の文言の変更です。

参考資料

  * Leaflet — プロジェクトの概要、機能一覧、数行で作る最初の地図で
す。

  * Leaflet API参照 —
`preferCanvas`、`invalidateSize`、GeoJSONの設定を含む、1.9.4のすべて
のクラス、設定、メソッドです。

  * Leafletクイックスタート — CSS、コンテナーの高さ、最初のタイルレ
イヤーを、順に説明します。

  * Leaflet 2.0アルファ公開 — 2.0の変更点と、コードやプラグインの移
行方法です。

  * タイル利用規則 — openstreetmap.orgのタイルサーバーを使う条件で
す。

  * RFC 7946：GeoJSON形式 — 経度を先にする位置の順序も含む、GeoJSON
の標準です。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/leaflet/	engineer.company	70
