@geolonia/maps-core 0.4.2 → 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/npm/index.cjs +375 -14
- package/dist/npm/index.d.cts +709 -44
- package/dist/npm/index.d.ts +709 -44
- package/dist/npm/index.js +374 -14
- package/package.json +8 -2
package/dist/npm/index.js
CHANGED
|
@@ -227,6 +227,11 @@ var ATTRIBUTION_CSS = `
|
|
|
227
227
|
}
|
|
228
228
|
`;
|
|
229
229
|
var CustomAttributionControl = class {
|
|
230
|
+
/**
|
|
231
|
+
* コントロールを生成します。
|
|
232
|
+
*
|
|
233
|
+
* @param options 帰属表示の挙動を指定するオプションです。省略した場合は空のオブジェクトが使われます。
|
|
234
|
+
*/
|
|
230
235
|
constructor(options = {}) {
|
|
231
236
|
this.options = options;
|
|
232
237
|
bindAll(
|
|
@@ -239,9 +244,24 @@ var CustomAttributionControl = class {
|
|
|
239
244
|
this
|
|
240
245
|
);
|
|
241
246
|
}
|
|
247
|
+
/**
|
|
248
|
+
* このコントロールの既定の表示位置を返します。
|
|
249
|
+
*
|
|
250
|
+
* @returns 既定の表示位置である `"bottom-right"` を返します。
|
|
251
|
+
*/
|
|
242
252
|
getDefaultPosition() {
|
|
243
253
|
return "bottom-right";
|
|
244
254
|
}
|
|
255
|
+
/**
|
|
256
|
+
* コントロールが地図に追加されるときに呼び出されます。
|
|
257
|
+
*
|
|
258
|
+
* Shadow DOM を持つコンテナ要素を生成し、その内部に帰属表示用の要素と CSS を組み立てます。
|
|
259
|
+
* あわせて帰属表示の内容を初期化し、地図の各種イベント(`styledata`、`sourcedata`、`terrain`、
|
|
260
|
+
* `resize`、`drag`)や印刷メディアクエリの変化を監視するリスナーを登録します。
|
|
261
|
+
*
|
|
262
|
+
* @param map このコントロールを追加する対象の地図です。
|
|
263
|
+
* @returns 地図に挿入するコントロールのルート要素を返します。
|
|
264
|
+
*/
|
|
245
265
|
onAdd(map) {
|
|
246
266
|
this._map = map;
|
|
247
267
|
this._compact = this.options.compact;
|
|
@@ -284,6 +304,12 @@ var CustomAttributionControl = class {
|
|
|
284
304
|
this.printQuery.addEventListener("change", this.onMediaPrintChange);
|
|
285
305
|
return this._container;
|
|
286
306
|
}
|
|
307
|
+
/**
|
|
308
|
+
* コントロールが地図から取り除かれるときに呼び出されます。
|
|
309
|
+
*
|
|
310
|
+
* 生成したコンテナ要素を DOM から削除し、`onAdd` で登録した地図のイベントリスナーと
|
|
311
|
+
* 印刷メディアクエリのリスナーを解除したうえで、内部で保持している状態を破棄します。
|
|
312
|
+
*/
|
|
287
313
|
onRemove() {
|
|
288
314
|
if (this._container) {
|
|
289
315
|
DOM.remove(this._container);
|
|
@@ -405,6 +431,14 @@ var attribution_default = CustomAttributionControl;
|
|
|
405
431
|
|
|
406
432
|
// src/lib/controls/geolonia-logo.ts
|
|
407
433
|
var GeoloniaControl = class {
|
|
434
|
+
/**
|
|
435
|
+
* コントロールの DOM 要素を生成して返します。
|
|
436
|
+
*
|
|
437
|
+
* `IControl` の実装として、`Map.addControl` で地図に追加された際に MapLibre から呼び出されます。
|
|
438
|
+
* Geolonia のロゴ画像を含み、`https://geolonia.com/` へのリンクが設定された要素を組み立てて返します。
|
|
439
|
+
*
|
|
440
|
+
* @returns このコントロールのコンテナとなる `HTMLDivElement`。
|
|
441
|
+
*/
|
|
408
442
|
onAdd() {
|
|
409
443
|
this.container = document.createElement("div");
|
|
410
444
|
this.container.className = "maplibregl-ctrl";
|
|
@@ -425,9 +459,22 @@ var GeoloniaControl = class {
|
|
|
425
459
|
this.container.appendChild(link);
|
|
426
460
|
return this.container;
|
|
427
461
|
}
|
|
462
|
+
/**
|
|
463
|
+
* コントロールの DOM 要素を地図から除去します。
|
|
464
|
+
*
|
|
465
|
+
* `IControl` の実装として、`Map.removeControl` で地図から取り除かれた際に MapLibre から呼び出されます。
|
|
466
|
+
* `onAdd` で生成したコンテナを親ノードから削除します。
|
|
467
|
+
*/
|
|
428
468
|
onRemove() {
|
|
429
469
|
this.container.parentNode?.removeChild(this.container);
|
|
430
470
|
}
|
|
471
|
+
/**
|
|
472
|
+
* このコントロールの既定の表示位置を返します。
|
|
473
|
+
*
|
|
474
|
+
* `Map.addControl` で位置を明示しなかった場合に使用されます。
|
|
475
|
+
*
|
|
476
|
+
* @returns 既定の表示位置 `"bottom-left"`。
|
|
477
|
+
*/
|
|
431
478
|
getDefaultPosition() {
|
|
432
479
|
return "bottom-left";
|
|
433
480
|
}
|
|
@@ -447,6 +494,19 @@ var MARKER_SVG = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 52 67">
|
|
|
447
494
|
</svg>`;
|
|
448
495
|
var DEFAULT_COLOR = "#E4402F";
|
|
449
496
|
var GeoloniaMarker = class extends maplibregl2.Marker {
|
|
497
|
+
/**
|
|
498
|
+
* Geolonia マーカーを作成します。
|
|
499
|
+
*
|
|
500
|
+
* `options.element` が指定されていない場合は、Geolonia デフォルトの SVG マーカー
|
|
501
|
+
* 要素を生成して `options.element` に設定し、`options.color`(未指定時は `#E4402F`)で
|
|
502
|
+
* マーカーの色を適用したうえで、`options.offset` を `[0, -15]` に設定します。
|
|
503
|
+
* `options.element` が指定されている場合は、これらの処理を行わず指定された要素を
|
|
504
|
+
* そのまま使用します。
|
|
505
|
+
*
|
|
506
|
+
* @param options `maplibregl.Marker` の `MarkerOptions` です。`element` を省略すると
|
|
507
|
+
* Geolonia デフォルトのマーカーが生成され、`color` でその色を指定できます。
|
|
508
|
+
* 省略した場合は空のオブジェクトが使われます。
|
|
509
|
+
*/
|
|
450
510
|
constructor(options = {}) {
|
|
451
511
|
if (!options.element) {
|
|
452
512
|
const markerElement = document.createElement("div");
|
|
@@ -479,38 +539,91 @@ import turfCenter from "@turf/center";
|
|
|
479
539
|
import maplibregl3 from "maplibre-gl";
|
|
480
540
|
|
|
481
541
|
// src/lib/keyring.ts
|
|
542
|
+
var DEFAULT_STAGE = "v1";
|
|
482
543
|
var _apiKey, _stage, _isGeoloniaStyle;
|
|
483
544
|
var Keyring = class {
|
|
484
545
|
constructor() {
|
|
485
546
|
__privateAdd(this, _apiKey, "");
|
|
486
|
-
__privateAdd(this, _stage,
|
|
547
|
+
__privateAdd(this, _stage, DEFAULT_STAGE);
|
|
487
548
|
__privateAdd(this, _isGeoloniaStyle, true);
|
|
488
549
|
}
|
|
550
|
+
/**
|
|
551
|
+
* 現在設定されている API キーを返します。
|
|
552
|
+
*
|
|
553
|
+
* 未設定の場合は空文字列を返します。
|
|
554
|
+
*
|
|
555
|
+
* @returns API キーの文字列を返します。
|
|
556
|
+
*/
|
|
489
557
|
get apiKey() {
|
|
490
558
|
return __privateGet(this, _apiKey);
|
|
491
559
|
}
|
|
560
|
+
/**
|
|
561
|
+
* 現在設定されているステージを返します。
|
|
562
|
+
*
|
|
563
|
+
* 初期値は {@link DEFAULT_STAGE}(`"v1"`)です。
|
|
564
|
+
*
|
|
565
|
+
* @returns ステージを表す文字列を返します。
|
|
566
|
+
*/
|
|
492
567
|
get stage() {
|
|
493
568
|
return __privateGet(this, _stage);
|
|
494
569
|
}
|
|
570
|
+
/**
|
|
571
|
+
* 現在のスタイルが Geolonia スタイル(API キーが必要なスタイル)かどうかを返します。
|
|
572
|
+
*
|
|
573
|
+
* @returns Geolonia スタイルの場合は `true`、それ以外の場合は `false` を返します。
|
|
574
|
+
*/
|
|
495
575
|
get isGeoloniaStyle() {
|
|
496
576
|
return __privateGet(this, _isGeoloniaStyle);
|
|
497
577
|
}
|
|
578
|
+
/**
|
|
579
|
+
* 現在のスタイルが Geolonia スタイルかどうかを設定します。
|
|
580
|
+
*
|
|
581
|
+
* @param value Geolonia スタイルとして扱う場合は `true`、それ以外の場合は `false` を指定します。
|
|
582
|
+
*/
|
|
498
583
|
set isGeoloniaStyle(value) {
|
|
499
584
|
__privateSet(this, _isGeoloniaStyle, value);
|
|
500
585
|
}
|
|
586
|
+
/**
|
|
587
|
+
* API キーを設定します。
|
|
588
|
+
*
|
|
589
|
+
* @param key 設定する API キーの文字列を指定します。
|
|
590
|
+
*/
|
|
501
591
|
setApiKey(key) {
|
|
502
592
|
__privateSet(this, _apiKey, key);
|
|
503
593
|
}
|
|
594
|
+
/**
|
|
595
|
+
* ステージを設定します。
|
|
596
|
+
*
|
|
597
|
+
* @param stage 設定するステージの文字列を指定します。
|
|
598
|
+
*/
|
|
504
599
|
setStage(stage) {
|
|
505
600
|
__privateSet(this, _stage, stage);
|
|
506
601
|
}
|
|
602
|
+
/**
|
|
603
|
+
* API キー、ステージ、Geolonia スタイル判定をすべて初期状態に戻します。
|
|
604
|
+
*
|
|
605
|
+
* API キーは空文字列、ステージは {@link DEFAULT_STAGE}、Geolonia スタイル判定は `true` にリセットされます。
|
|
606
|
+
*/
|
|
507
607
|
reset() {
|
|
508
608
|
__privateSet(this, _apiKey, "");
|
|
509
|
-
__privateSet(this, _stage,
|
|
609
|
+
__privateSet(this, _stage, DEFAULT_STAGE);
|
|
510
610
|
__privateSet(this, _isGeoloniaStyle, true);
|
|
511
611
|
}
|
|
512
612
|
/**
|
|
513
|
-
*
|
|
613
|
+
* 与えられたスタイルが Geolonia スタイル(API キーが必要なスタイル)かどうかを判定します。
|
|
614
|
+
*
|
|
615
|
+
* 判定は次のロジックで行われます。
|
|
616
|
+
*
|
|
617
|
+
* - 空文字列(未指定)の場合は `true` を返します。
|
|
618
|
+
* - `https://cdn.geolonia.com/style/` または `https://api.geolonia.com/` で始まる URL の場合は `true` を返します。
|
|
619
|
+
* - 上記以外で `http://` または `https://` で始まる外部 URL の場合は `false` を返します。
|
|
620
|
+
* - `geolonia://` で始まる場合は Geolonia 独自プロトコルのため `true` を返します。
|
|
621
|
+
* - それ以外のプロトコル(`xxx://` 形式)で始まる場合は `false` を返します。
|
|
622
|
+
* - `.json` で終わる場合は `false` を返します。
|
|
623
|
+
* - 上記のいずれにも該当しない場合は、`geolonia/basic` のような Geolonia の論理名とみなして `true` を返します。
|
|
624
|
+
*
|
|
625
|
+
* @param style 判定対象のスタイル(URL、プロトコル付き文字列、または論理名)を指定します。
|
|
626
|
+
* @returns Geolonia スタイルの場合は `true`、それ以外の場合は `false` を返します。
|
|
514
627
|
*/
|
|
515
628
|
isGeoloniaStyleCheck(style) {
|
|
516
629
|
if (!style || style === "") {
|
|
@@ -673,6 +786,16 @@ var template = {
|
|
|
673
786
|
features: []
|
|
674
787
|
};
|
|
675
788
|
var SimpleStyle = class {
|
|
789
|
+
/**
|
|
790
|
+
* SimpleStyle を作成します。
|
|
791
|
+
*
|
|
792
|
+
* `geojson` に URL 文字列を渡した場合は、その URL から GeoJSON を非同期に取得します。
|
|
793
|
+
* 取得の完了は `_loadingPromise` で待つことができます。
|
|
794
|
+
*
|
|
795
|
+
* @param geojson 表示する GeoJSON です。{@link FeatureCollection} または GeoJSON を返す URL 文字列を指定します。
|
|
796
|
+
* @param options 表示オプションです。指定した項目のみが既定値を上書きします。既定値は
|
|
797
|
+
* `id: "geolonia-simple-style"`、`cluster: true`、`heatmap: false`、`clusterColor: "#ff0000"` です。
|
|
798
|
+
*/
|
|
676
799
|
constructor(geojson, options) {
|
|
677
800
|
this.callFitBounds = false;
|
|
678
801
|
this._eventHandlers = [];
|
|
@@ -686,6 +809,16 @@ var SimpleStyle = class {
|
|
|
686
809
|
...options
|
|
687
810
|
};
|
|
688
811
|
}
|
|
812
|
+
/**
|
|
813
|
+
* 表示中のデータを新しい GeoJSON で差し替えます。
|
|
814
|
+
*
|
|
815
|
+
* フィーチャーをポイントとそれ以外(ポリゴン、ライン)に振り分け、
|
|
816
|
+
* それぞれ対応するソースの内容を更新します。レイヤー自体の追加は行わないため、
|
|
817
|
+
* あらかじめ {@link SimpleStyle.addTo | addTo} で地図に追加されている必要があります。
|
|
818
|
+
*
|
|
819
|
+
* @param geojson 差し替える {@link FeatureCollection} です。
|
|
820
|
+
* @returns メソッドチェーンのための `this` を返します。
|
|
821
|
+
*/
|
|
689
822
|
updateData(geojson) {
|
|
690
823
|
this.setGeoJSON(geojson);
|
|
691
824
|
const features = this.geojson.features;
|
|
@@ -707,6 +840,24 @@ var SimpleStyle = class {
|
|
|
707
840
|
);
|
|
708
841
|
return this;
|
|
709
842
|
}
|
|
843
|
+
/**
|
|
844
|
+
* 地図にソースとレイヤーを追加して GeoJSON を表示します。
|
|
845
|
+
*
|
|
846
|
+
* ポリゴンとラインのソース、ポイント用のソース(クラスタリング設定付き)を追加し、
|
|
847
|
+
* ポリゴンとラインのラベル用シンボルレイヤーを配置したうえで、
|
|
848
|
+
* {@link SimpleStyle.setPolygonGeometries | setPolygonGeometries}、
|
|
849
|
+
* {@link SimpleStyle.setLineGeometries | setLineGeometries}、
|
|
850
|
+
* {@link SimpleStyle.setPointGeometries | setPointGeometries}、
|
|
851
|
+
* {@link SimpleStyle.setCluster | setCluster} を呼び出して各ジオメトリのレイヤーを設定します。
|
|
852
|
+
*
|
|
853
|
+
* @param map 表示先の地図です。
|
|
854
|
+
* @returns メソッドチェーンのための `this` を返します。
|
|
855
|
+
*
|
|
856
|
+
* @example
|
|
857
|
+
* ```typescript
|
|
858
|
+
* new SimpleStyle(geojson).addTo(map);
|
|
859
|
+
* ```
|
|
860
|
+
*/
|
|
710
861
|
addTo(map) {
|
|
711
862
|
this.map = map;
|
|
712
863
|
const features = this.geojson.features;
|
|
@@ -784,6 +935,17 @@ var SimpleStyle = class {
|
|
|
784
935
|
this.setCluster();
|
|
785
936
|
return this;
|
|
786
937
|
}
|
|
938
|
+
/**
|
|
939
|
+
* データ全体の範囲に地図をフィットさせます。
|
|
940
|
+
*
|
|
941
|
+
* 現在の GeoJSON のフィーチャーからバウンディングボックスを算出し、そこへ地図を移動します。
|
|
942
|
+
* フィーチャーが存在しない場合は何もしません。データを URL から取得中に呼び出した場合は、
|
|
943
|
+
* フィット要求を保持しておき、取得完了後に自動でフィットします。
|
|
944
|
+
*
|
|
945
|
+
* @param options `map.fitBounds` に渡すオプションです。既定値は `duration: 3000`、`padding: 30` で、
|
|
946
|
+
* 指定した項目のみがこれらを上書きします。
|
|
947
|
+
* @returns メソッドチェーンのための `this` を返します。
|
|
948
|
+
*/
|
|
787
949
|
fitBounds(options = {}) {
|
|
788
950
|
this.callFitBounds = true;
|
|
789
951
|
const _options = {
|
|
@@ -800,7 +962,12 @@ var SimpleStyle = class {
|
|
|
800
962
|
return this;
|
|
801
963
|
}
|
|
802
964
|
/**
|
|
803
|
-
*
|
|
965
|
+
* ポリゴンの塗りレイヤーを設定します。
|
|
966
|
+
*
|
|
967
|
+
* `$type` が `Polygon` のフィーチャーを対象に塗りレイヤーを追加し、
|
|
968
|
+
* `fill`、`fill-opacity`、`stroke`(輪郭色)の各 simplestyle プロパティを反映します。
|
|
969
|
+
* あわせて {@link SimpleStyle.setPopup | setPopup} でこのレイヤーにポップアップを設定します。
|
|
970
|
+
* 通常は {@link SimpleStyle.addTo | addTo} から呼び出されます。
|
|
804
971
|
*/
|
|
805
972
|
setPolygonGeometries() {
|
|
806
973
|
this.map.addLayer({
|
|
@@ -817,7 +984,12 @@ var SimpleStyle = class {
|
|
|
817
984
|
this.setPopup(this.map, `${this.options.id}-polygon`);
|
|
818
985
|
}
|
|
819
986
|
/**
|
|
820
|
-
*
|
|
987
|
+
* ラインのレイヤーを設定します。
|
|
988
|
+
*
|
|
989
|
+
* `$type` が `LineString` のフィーチャーを対象にラインレイヤーを追加し、
|
|
990
|
+
* `stroke-width`(線幅)、`stroke`(線色)、`stroke-opacity`(不透明度)の各 simplestyle プロパティを反映します。
|
|
991
|
+
* 線端と結合は丸めて描画します。あわせて {@link SimpleStyle.setPopup | setPopup} でこのレイヤーにポップアップを設定します。
|
|
992
|
+
* 通常は {@link SimpleStyle.addTo | addTo} から呼び出されます。
|
|
821
993
|
*/
|
|
822
994
|
setLineGeometries() {
|
|
823
995
|
this.map.addLayer({
|
|
@@ -838,7 +1010,15 @@ var SimpleStyle = class {
|
|
|
838
1010
|
this.setPopup(this.map, `${this.options.id}-linestring`);
|
|
839
1011
|
}
|
|
840
1012
|
/**
|
|
841
|
-
*
|
|
1013
|
+
* ポイントのレイヤーを設定します。
|
|
1014
|
+
*
|
|
1015
|
+
* クラスターに属さないポイントを対象に、2 種類のレイヤーを追加します。
|
|
1016
|
+
* `marker-symbol` を持たないポイントには円レイヤーを、
|
|
1017
|
+
* `marker-symbol` を持つポイントにはアイコンとラベルのシンボルレイヤーを使います。
|
|
1018
|
+
* `marker-size`(`small`、`large`、その他)に応じて円の半径やラベルのオフセットを変え、
|
|
1019
|
+
* `marker-color`、`stroke`、`title`、`text-color` などの simplestyle プロパティを反映します。
|
|
1020
|
+
* あわせて円レイヤーとシンボルレイヤーの双方に {@link SimpleStyle.setPopup | setPopup} でポップアップを設定します。
|
|
1021
|
+
* 通常は {@link SimpleStyle.addTo | addTo} から呼び出されます。
|
|
842
1022
|
*/
|
|
843
1023
|
setPointGeometries() {
|
|
844
1024
|
this.map.addLayer({
|
|
@@ -898,6 +1078,17 @@ var SimpleStyle = class {
|
|
|
898
1078
|
this.setPopup(this.map, `${this.options.id}-circle-points`);
|
|
899
1079
|
this.setPopup(this.map, `${this.options.id}-symbol-points`);
|
|
900
1080
|
}
|
|
1081
|
+
/**
|
|
1082
|
+
* 指定したレイヤーにクリックでポップアップを表示するイベントハンドラーを設定します。
|
|
1083
|
+
*
|
|
1084
|
+
* クリックされたフィーチャーが `description` プロパティを持つ場合、その中心座標に
|
|
1085
|
+
* サニタイズ済みの HTML を表示するポップアップを追加します。あわせてホバー時に
|
|
1086
|
+
* カーソルを変えるハンドラーも設定します。登録したハンドラーは `_eventHandlers` に記録され、
|
|
1087
|
+
* {@link SimpleStyle.remove | remove} でまとめて解除されます。
|
|
1088
|
+
*
|
|
1089
|
+
* @param map ポップアップを表示する地図です。
|
|
1090
|
+
* @param source ハンドラーを設定する対象のレイヤー ID です。
|
|
1091
|
+
*/
|
|
901
1092
|
async setPopup(map, source) {
|
|
902
1093
|
const clickHandler = async (e) => {
|
|
903
1094
|
if (!e.features?.[0]) return;
|
|
@@ -926,7 +1117,15 @@ var SimpleStyle = class {
|
|
|
926
1117
|
);
|
|
927
1118
|
}
|
|
928
1119
|
/**
|
|
929
|
-
*
|
|
1120
|
+
* クラスタリング用のレイヤーを設定します。
|
|
1121
|
+
*
|
|
1122
|
+
* `point_count` を持つクラスターを対象に、クラスターを表す円レイヤーと、
|
|
1123
|
+
* 件数(`point_count_abbreviated`)を表示するラベルのシンボルレイヤーを追加します。
|
|
1124
|
+
* 円の色は `clusterColor` オプションを使います。クラスターをクリックすると、
|
|
1125
|
+
* そのクラスターが展開するズームレベルまで地図を移動します。あわせてホバー時に
|
|
1126
|
+
* カーソルを変えるハンドラーも設定します。登録したハンドラーは `_eventHandlers` に記録され、
|
|
1127
|
+
* {@link SimpleStyle.remove | remove} でまとめて解除されます。通常は
|
|
1128
|
+
* {@link SimpleStyle.addTo | addTo} から呼び出されます。
|
|
930
1129
|
*/
|
|
931
1130
|
setCluster() {
|
|
932
1131
|
this.map.addLayer({
|
|
@@ -991,6 +1190,15 @@ var SimpleStyle = class {
|
|
|
991
1190
|
}
|
|
992
1191
|
);
|
|
993
1192
|
}
|
|
1193
|
+
/**
|
|
1194
|
+
* 追加したソース、レイヤー、イベントハンドラーを地図から除去します。
|
|
1195
|
+
*
|
|
1196
|
+
* {@link SimpleStyle.setPopup | setPopup} や {@link SimpleStyle.setCluster | setCluster}
|
|
1197
|
+
* で登録したイベントハンドラーをすべて解除し、ポリゴン、ライン、ポイント、クラスターの各レイヤーと、
|
|
1198
|
+
* それらのソースを削除します。カーソルのスタイルも元に戻します。まだ地図に追加されていない場合は何もしません。
|
|
1199
|
+
*
|
|
1200
|
+
* @returns メソッドチェーンのための `this` を返します。
|
|
1201
|
+
*/
|
|
994
1202
|
remove() {
|
|
995
1203
|
if (!this.map) return this;
|
|
996
1204
|
const id = this.options.id;
|
|
@@ -1021,6 +1229,18 @@ var SimpleStyle = class {
|
|
|
1021
1229
|
this.map.getCanvas().style.cursor = "";
|
|
1022
1230
|
return this;
|
|
1023
1231
|
}
|
|
1232
|
+
/**
|
|
1233
|
+
* 内部で保持する GeoJSON を設定します。
|
|
1234
|
+
*
|
|
1235
|
+
* `geojson` が URL 文字列の場合は、いったん空のデータを設定したうえで、その URL から GeoJSON を
|
|
1236
|
+
* 非同期に取得します。取得中の Promise は `_loadingPromise` に保持され、取得完了後に
|
|
1237
|
+
* {@link SimpleStyle.updateData | updateData} で表示を更新します。フィット要求が保留されていれば
|
|
1238
|
+
* あわせてフィットします。応答が 2xx 以外の場合は空のデータとして扱い、通信や JSON の解析で
|
|
1239
|
+
* 例外が発生した場合はエラーをコンソールに出力します。
|
|
1240
|
+
* `geojson` が {@link FeatureCollection} の場合は、そのまま内部データとして設定します。
|
|
1241
|
+
*
|
|
1242
|
+
* @param geojson 設定する {@link FeatureCollection} または GeoJSON を返す URL 文字列です。
|
|
1243
|
+
*/
|
|
1024
1244
|
setGeoJSON(geojson) {
|
|
1025
1245
|
if (typeof geojson === "string" && isURL(geojson)) {
|
|
1026
1246
|
this.geojson = template;
|
|
@@ -1053,10 +1273,32 @@ var textHaloColor2 = "#FFFFFF";
|
|
|
1053
1273
|
var backgroundColor2 = "rgba(255, 0, 0, 0.4)";
|
|
1054
1274
|
var strokeColor2 = "#FFFFFF";
|
|
1055
1275
|
var SimpleStyleVector = class {
|
|
1276
|
+
/**
|
|
1277
|
+
* @param url 表示するベクトルタイルソースの TileJSON(tiles.json)URL です。
|
|
1278
|
+
*/
|
|
1056
1279
|
constructor(url) {
|
|
1057
1280
|
this.url = url;
|
|
1058
1281
|
this.sourceName = "vt-geolonia-simple-style";
|
|
1059
1282
|
}
|
|
1283
|
+
/**
|
|
1284
|
+
* 地図にベクトルタイルソースと各レイヤーを追加し、simplestyle の規約に沿って表示します。
|
|
1285
|
+
*
|
|
1286
|
+
* ソースを追加したうえで、ポリゴン(塗り潰しとラベル)、ライン(線とラベル)、
|
|
1287
|
+
* ポイント(円、アイコン、ラベル)の各レイヤーを設定します。あわせて、ポリゴンの塗り潰し、
|
|
1288
|
+
* ラインの線、ポイントの円とアイコンの各レイヤーにクリック時のポップアップを登録します
|
|
1289
|
+
* (ポリゴンやラインのラベル用シンボルレイヤーには登録しません)。
|
|
1290
|
+
*
|
|
1291
|
+
* 地図コンテナの `data-lng` および `data-lat` 属性がいずれも指定されていない場合は、
|
|
1292
|
+
* ソースの読み込み完了を待って、そのソースの `bounds` に一度だけ地図の表示範囲を合わせます
|
|
1293
|
+
* (`padding` は 30、アニメーションなし)。
|
|
1294
|
+
*
|
|
1295
|
+
* @param map レイヤーを追加する対象の地図インスタンスです。
|
|
1296
|
+
*
|
|
1297
|
+
* @example
|
|
1298
|
+
* ```typescript
|
|
1299
|
+
* new SimpleStyleVector(url).addTo(map);
|
|
1300
|
+
* ```
|
|
1301
|
+
*/
|
|
1060
1302
|
addTo(map) {
|
|
1061
1303
|
const container = map.getContainer();
|
|
1062
1304
|
if (!container.dataset || !container.dataset.lng && !container.dataset.lat) {
|
|
@@ -1139,9 +1381,14 @@ var SimpleStyleVector = class {
|
|
|
1139
1381
|
this.setPointGeometries(map);
|
|
1140
1382
|
}
|
|
1141
1383
|
/**
|
|
1142
|
-
*
|
|
1384
|
+
* ポリゴンジオメトリ用のレイヤーを設定します。
|
|
1385
|
+
*
|
|
1386
|
+
* `$type` が `Polygon` のフィーチャーに対して塗り潰しレイヤー(`fill` タイプ)を追加します。
|
|
1387
|
+
* 塗り色はフィーチャーの `fill` プロパティ、不透明度は `fill-opacity`、
|
|
1388
|
+
* 外周線の色は `stroke` プロパティを用い、いずれも未指定の場合は既定値を適用します。
|
|
1389
|
+
* あわせて、このポリゴンレイヤーにクリック時のポップアップを登録します。
|
|
1143
1390
|
*
|
|
1144
|
-
* @param map
|
|
1391
|
+
* @param map レイヤーを追加する対象の地図インスタンスです。
|
|
1145
1392
|
*/
|
|
1146
1393
|
setPolygonGeometries(map) {
|
|
1147
1394
|
map.addLayer({
|
|
@@ -1159,9 +1406,15 @@ var SimpleStyleVector = class {
|
|
|
1159
1406
|
this.setPopup(map, "vt-geolonia-simple-style-polygon");
|
|
1160
1407
|
}
|
|
1161
1408
|
/**
|
|
1162
|
-
*
|
|
1409
|
+
* ラインジオメトリ用のレイヤーを設定します。
|
|
1163
1410
|
*
|
|
1164
|
-
*
|
|
1411
|
+
* `$type` が `LineString` のフィーチャーに対して線レイヤー(`line` タイプ)を追加します。
|
|
1412
|
+
* 線幅はフィーチャーの `stroke-width` プロパティ、線色は `stroke`、
|
|
1413
|
+
* 不透明度は `stroke-opacity` を用い、いずれも未指定の場合は既定値を適用します。
|
|
1414
|
+
* 線の端点と結合部はいずれも丸め(`round`)で描画します。
|
|
1415
|
+
* あわせて、このラインレイヤーにクリック時のポップアップを登録します。
|
|
1416
|
+
*
|
|
1417
|
+
* @param map レイヤーを追加する対象の地図インスタンスです。
|
|
1165
1418
|
*/
|
|
1166
1419
|
setLineGeometries(map) {
|
|
1167
1420
|
map.addLayer({
|
|
@@ -1183,9 +1436,16 @@ var SimpleStyleVector = class {
|
|
|
1183
1436
|
this.setPopup(map, "vt-geolonia-simple-style-linestring");
|
|
1184
1437
|
}
|
|
1185
1438
|
/**
|
|
1186
|
-
*
|
|
1439
|
+
* ポイントジオメトリ用のレイヤーを設定します。
|
|
1440
|
+
*
|
|
1441
|
+
* 2 つのレイヤーを追加します。1 つは `marker-symbol` を持たないポイント向けの円レイヤー
|
|
1442
|
+
* (`circle` タイプ)で、半径はフィーチャーの `marker-size`(`small` は 7、`large` は 13、
|
|
1443
|
+
* それ以外は 9)に応じて変化し、色は `marker-color`、外周線は `stroke` 系プロパティを用います。
|
|
1444
|
+
* もう 1 つはすべてのポイント向けのシンボルレイヤー(`symbol` タイプ)で、`marker-symbol` を
|
|
1445
|
+
* アイコン画像として、`title` をラベルとして表示します。ラベルの位置は `marker-size` に応じて調整します。
|
|
1446
|
+
* あわせて、円レイヤーとシンボルレイヤーの両方にクリック時のポップアップを登録します。
|
|
1187
1447
|
*
|
|
1188
|
-
* @param map
|
|
1448
|
+
* @param map レイヤーを追加する対象の地図インスタンスです。
|
|
1189
1449
|
*/
|
|
1190
1450
|
setPointGeometries(map) {
|
|
1191
1451
|
map.addLayer({
|
|
@@ -1246,6 +1506,19 @@ var SimpleStyleVector = class {
|
|
|
1246
1506
|
this.setPopup(map, "vt-circle-simple-style-points");
|
|
1247
1507
|
this.setPopup(map, "vt-geolonia-simple-style-points");
|
|
1248
1508
|
}
|
|
1509
|
+
/**
|
|
1510
|
+
* 指定したレイヤーにクリック時のポップアップ表示を設定します。
|
|
1511
|
+
*
|
|
1512
|
+
* 対象レイヤーのフィーチャーがクリックされると、そのフィーチャーの中心座標
|
|
1513
|
+
* (`@turf/center` で算出)にポップアップを表示します。ポップアップの内容は、
|
|
1514
|
+
* フィーチャーの `description` プロパティをサニタイズした HTML です。`description` を
|
|
1515
|
+
* 持たないフィーチャーではポップアップを表示しません。あわせて、`description` を持つ
|
|
1516
|
+
* フィーチャーにマウスが乗ったときはカーソルをポインターに変更し、離れたときに元へ戻します。
|
|
1517
|
+
*
|
|
1518
|
+
* @param map イベントを登録する対象の地図インスタンスです。
|
|
1519
|
+
* @param source ポップアップを設定する対象のレイヤー ID です。
|
|
1520
|
+
* @returns イベントリスナーの登録が完了すると解決する Promise です。
|
|
1521
|
+
*/
|
|
1249
1522
|
async setPopup(map, source) {
|
|
1250
1523
|
map.on("click", source, async (e) => {
|
|
1251
1524
|
if (!e.features?.[0]) return;
|
|
@@ -1378,6 +1651,36 @@ function ensurePMTiles() {
|
|
|
1378
1651
|
maplibregl5.addProtocol("pmtiles", protocol.tile);
|
|
1379
1652
|
}
|
|
1380
1653
|
var GeoloniaMap = class extends maplibregl5.Map {
|
|
1654
|
+
/**
|
|
1655
|
+
* 地図を生成します。
|
|
1656
|
+
*
|
|
1657
|
+
* `apiKey` や `stage` が指定されていればキーリングに設定し、スタイル
|
|
1658
|
+
* (既定は `"geolonia/basic-v2"`)を実際の style.json の URL に解決してから
|
|
1659
|
+
* MapLibre GL JS の `Map` を初期化します。あわせて Geolonia のロゴ、出典表示、
|
|
1660
|
+
* ナビゲーションなどのコントロールを追加し、読み込み完了後にはローディング表示の
|
|
1661
|
+
* 除去、デフォルトマーカーの配置、ジェスチャ操作やスタイル拡張の適用を行います。
|
|
1662
|
+
*
|
|
1663
|
+
* `arg` にコンテナを直接指定する後方互換の形式では、そのコンテナの `data-*`
|
|
1664
|
+
* 属性から設定を読み込みます。指定したコンテナに既に地図が生成済みの場合は、
|
|
1665
|
+
* 新規生成せず既存のインスタンスを返します。
|
|
1666
|
+
*
|
|
1667
|
+
* @param arg 地図の設定です。{@link GeoloniaMapOptions} オブジェクトのほか、
|
|
1668
|
+
* 後方互換としてコンテナを指す CSS セレクタ文字列や `HTMLElement` も指定できます。
|
|
1669
|
+
* @throws コンテナ要素が見つからない場合に `Error` を投げます。
|
|
1670
|
+
* @throws Geolonia のスタイルを API キーなしで使おうとした場合に `Error` を投げます。
|
|
1671
|
+
* @throws MapLibre GL JS の `Map` の初期化に失敗した場合、コンテナにエラー表示を
|
|
1672
|
+
* 行ったうえで、その例外を再スローします。
|
|
1673
|
+
*
|
|
1674
|
+
* @example
|
|
1675
|
+
* ```typescript
|
|
1676
|
+
* const map = new GeoloniaMap({
|
|
1677
|
+
* container: "#map",
|
|
1678
|
+
* apiKey: "YOUR-API-KEY",
|
|
1679
|
+
* center: [139.7671, 35.6812],
|
|
1680
|
+
* zoom: 14,
|
|
1681
|
+
* });
|
|
1682
|
+
* ```
|
|
1683
|
+
*/
|
|
1381
1684
|
// biome-ignore lint/correctness/noUnreachableSuper: intentional singleton pattern - returns existing map instance before super()
|
|
1382
1685
|
constructor(arg) {
|
|
1383
1686
|
const options = normalizeConstructorArg(arg);
|
|
@@ -1628,6 +1931,28 @@ var GeoloniaMap = class extends maplibregl5.Map {
|
|
|
1628
1931
|
container.geoloniaMap = this;
|
|
1629
1932
|
return this;
|
|
1630
1933
|
}
|
|
1934
|
+
/**
|
|
1935
|
+
* 地図のスタイルを差し替えます。
|
|
1936
|
+
*
|
|
1937
|
+
* `style` が文字列の場合は、Geolonia のスタイル論理名(`"geolonia/basic-v2"`
|
|
1938
|
+
* など)、style.json の URL、相対パスのいずれかとして解釈し、実際の URL に
|
|
1939
|
+
* 解決してから適用します。解決の際の言語はブラウザ言語に従い、API キーは
|
|
1940
|
+
* キーリングに設定済みの値を使います。`StyleSpecification` オブジェクトを
|
|
1941
|
+
* 直接渡した場合はそのまま適用します。
|
|
1942
|
+
*
|
|
1943
|
+
* @param style 新しいスタイルです。スタイル論理名や URL などの文字列、または
|
|
1944
|
+
* `StyleSpecification` オブジェクトを指定します。
|
|
1945
|
+
* @param options MapLibre GL JS に渡すスタイル差し替えオプションです。
|
|
1946
|
+
* 既定は空のオブジェクトです。
|
|
1947
|
+
* @returns メソッドチェーンのために自身を返します。
|
|
1948
|
+
* @throws Geolonia のスタイルを API キーなしで使おうとした場合に `Error` を投げます。
|
|
1949
|
+
*
|
|
1950
|
+
* @example
|
|
1951
|
+
* ```typescript
|
|
1952
|
+
* const map = new GeoloniaMap({ container: "#map", apiKey: "YOUR-API-KEY" });
|
|
1953
|
+
* map.setStyle("geolonia/gsi");
|
|
1954
|
+
* ```
|
|
1955
|
+
*/
|
|
1631
1956
|
setStyle(style, options = {}) {
|
|
1632
1957
|
if (style !== null && typeof style === "string") {
|
|
1633
1958
|
style = getStyle(style, { lang: getLang(), apiKey: keyring.apiKey });
|
|
@@ -1636,11 +1961,45 @@ var GeoloniaMap = class extends maplibregl5.Map {
|
|
|
1636
1961
|
super.setStyle.call(this, style, options);
|
|
1637
1962
|
return this;
|
|
1638
1963
|
}
|
|
1964
|
+
/**
|
|
1965
|
+
* 地図を破棄し、関連するリソースやイベントリスナーを解放します。
|
|
1966
|
+
*
|
|
1967
|
+
* MapLibre GL JS の破棄処理に加えて、コンテナ要素に保持している地図インスタンスへの
|
|
1968
|
+
* 参照(`geoloniaMap`)も削除します。これにより、同じコンテナで再度
|
|
1969
|
+
* {@link GeoloniaMap} を生成した際に、破棄済みのインスタンスが返されることを防ぎます。
|
|
1970
|
+
*
|
|
1971
|
+
* @example
|
|
1972
|
+
* ```typescript
|
|
1973
|
+
* const map = new GeoloniaMap({ container: "#map", apiKey: "YOUR-API-KEY" });
|
|
1974
|
+
* // 不要になったら破棄します
|
|
1975
|
+
* map.remove();
|
|
1976
|
+
* ```
|
|
1977
|
+
*/
|
|
1639
1978
|
remove() {
|
|
1640
1979
|
const container = this.getContainer();
|
|
1641
1980
|
super.remove.call(this);
|
|
1642
1981
|
delete container.geoloniaMap;
|
|
1643
1982
|
}
|
|
1983
|
+
/**
|
|
1984
|
+
* 画像を読み込みます。
|
|
1985
|
+
*
|
|
1986
|
+
* `callback` を渡した場合は後方互換のコールバック形式で結果を受け取り、戻り値は
|
|
1987
|
+
* `undefined` になります。`callback` を省略した場合は `Promise` を返します。
|
|
1988
|
+
*
|
|
1989
|
+
* @param url 読み込む画像の URL です。
|
|
1990
|
+
* @param callback 省略可能です。指定した場合はコールバック形式で結果を受け取ります。
|
|
1991
|
+
* @returns `callback` を省略した場合は、読み込んだ画像を含むレスポンスに解決される
|
|
1992
|
+
* `Promise` を返します。`callback` を指定した場合は `undefined` を返します。
|
|
1993
|
+
*
|
|
1994
|
+
* @example
|
|
1995
|
+
* ```typescript
|
|
1996
|
+
* const map = new GeoloniaMap({ container: "#map", apiKey: "YOUR-API-KEY" });
|
|
1997
|
+
* map.on("load", async () => {
|
|
1998
|
+
* const image = await map.loadImage("https://example.com/marker.png");
|
|
1999
|
+
* map.addImage("custom-marker", image.data);
|
|
2000
|
+
* });
|
|
2001
|
+
* ```
|
|
2002
|
+
*/
|
|
1644
2003
|
loadImage(url, callback) {
|
|
1645
2004
|
const promise = super.loadImage(url);
|
|
1646
2005
|
if (callback) {
|
|
@@ -1652,9 +2011,10 @@ var GeoloniaMap = class extends maplibregl5.Map {
|
|
|
1652
2011
|
};
|
|
1653
2012
|
|
|
1654
2013
|
// src/version.ts
|
|
1655
|
-
var VERSION = "0.
|
|
2014
|
+
var VERSION = "0.5.0";
|
|
1656
2015
|
export {
|
|
1657
2016
|
attribution_default as CustomAttributionControl,
|
|
2017
|
+
DEFAULT_STAGE,
|
|
1658
2018
|
GeoloniaControl,
|
|
1659
2019
|
GeoloniaMap,
|
|
1660
2020
|
GeoloniaMarker,
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@geolonia/maps-core",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.5.0",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"main": "dist/npm/index.cjs",
|
|
6
6
|
"module": "dist/npm/index.js",
|
|
@@ -37,6 +37,8 @@
|
|
|
37
37
|
"jsdom": "^29.0.1",
|
|
38
38
|
"maplibre-gl": "5.7.0",
|
|
39
39
|
"tsup": "^8",
|
|
40
|
+
"typedoc": "^0.28.20",
|
|
41
|
+
"typedoc-plugin-markdown": "^4.12.0",
|
|
40
42
|
"typescript": "^5.8",
|
|
41
43
|
"vite": "^8.0.16",
|
|
42
44
|
"vitest": "^4.1.2"
|
|
@@ -44,13 +46,17 @@
|
|
|
44
46
|
"scripts": {
|
|
45
47
|
"build": "tsup",
|
|
46
48
|
"build:umd": "vite build --config vite.umd.config.ts",
|
|
49
|
+
"check:externals": "node scripts/check-externals.mjs",
|
|
50
|
+
"smoke": "node scripts/smoke.mjs",
|
|
51
|
+
"verify": "npm run build && npm run check:externals && npm run smoke",
|
|
47
52
|
"test": "vitest run",
|
|
48
53
|
"test:watch": "vitest",
|
|
49
54
|
"test:coverage": "vitest run --coverage",
|
|
50
55
|
"dev": "vite --config vite.config.ts",
|
|
51
56
|
"e2e": "playwright test",
|
|
52
57
|
"lint": "biome check src/ test/ e2e/ example/",
|
|
53
|
-
"lint:fix": "biome check --write src/ test/ e2e/ example/"
|
|
58
|
+
"lint:fix": "biome check --write src/ test/ e2e/ example/",
|
|
59
|
+
"docs:api": "typedoc"
|
|
54
60
|
},
|
|
55
61
|
"license": "MIT",
|
|
56
62
|
"repository": {
|