コンテンツにスキップ

Vector Tiles

0.10.0

Mapray JS は Mapray Cloud にアップロードされたベクトルタイルを表示できます。 また、ベクトルタイルのスタイルをカスタマイズして、ズーム範囲を設定したり表示を調整できます。

ベクトルタイルとは

ベクトルタイルは、ポイントやライン、ポリゴンなどの地理空間データを格納する軽量なデータ形式です。 Mapray では、 Mapbox のベクトルタイル仕様 に則って地図データを表示や操作を行います。

Mapray Cloud へのアップロード

詳細は Mapray Cloud ドキュメント を参照してください。

サンプルコード

Mapray Cloud にアップロードしたベクトルタイルを表示するサンプルを以下に示します。

Mapray Cloud からデータを取得するには CloudApiV2 を利用します。

Note

CloudApiを使わなくてもVectorTilesを利用することができます。v0.9.6ではVectorTiles用のCloudApiがないため、v0.9.6を使ったVectorTilesサンプルを参考に実装をしてください。

CloudApiV2getVectileDatasetAsResource に利用したいデータセットの ID を指定することで、 Mapray Cloud を利用するためのリソースが取得できます。

styleJson は、ベクトルタイルのスタイルの設定で、 Airports データを地図上に表示するための設定をしています。 tiles 配列内の URL は、ベクトルタイルを提供するサーバーの URL です。 Mapray Cloud にベクトルタイルをアップロードすると、基本的なスタイル設定が含まれる styleJson が生成されます。

TileJsonProviderFactory クラスは、TileProviderSpriteProvider を生成するファクトリクラスです。 これにより、先ほどの styleJson からメタデータを読み取り適切なタイルプロバイダが生成されます。

TileJsonProvider クラスは、タイルデータをリクエストするためのカスタムプロバイダです。 requestMeta メソッドでタイルのメタデータ(ズームレベルなど)を取得し、 requestTile メソッドで指定されたエリアのタイルデータを取得します。 CloudApiV2 で取得したリソースから Mapray Cloud にアクセスし、タイルデータを取得して地図に表示されます。

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
<!DOCTYPE html>
<html>
    <head>
        <script src="./v0.10.0/mapray.min.js"></script>
        <script src="./v0.10.0/maprayui.min.js"></script>
        <link rel="stylesheet" href="./v0.10.0/mapray.css">
        <style>
            html, body, div#mapray-container { margin: 0; padding: 0; height: 100%; }
        </style>
    </head>

    <body>
        <div id="mapray-container"></div>
    </body>
</html>

<script>
    const styleJson = {
        "layers": [
            {
                "id": "layer 1",
                "source": "Airports",
                "source-layer": "airport",
                "layout": {
                    "icon-image": ["image", "airport"],
                    "icon-size": 1.5,
                    "icon-anchor": "top",
                    "icon-offset": [0, -23],
                    "text-field": [
                        "concat",
                        ["get", "C28_005"]
                    ]
                },
                "paint": {
                    "icon-color": ["rgb", 96, 194, 255],
                    "icon-halo-color": ["rgb", 0, 0, 0],
                    "icon-halo-width": 1,
                    "text-color": ["rgb", 242, 242, 242],
                    "text-halo-color": ["rgb", 0, 0, 0],
                    "text-halo-width": 1.5
                },
                "type": "symbol"
            }
        ],
        "sources": {
            "Airports": {
                "minzoom": 0,
                "maxzoom": 2,
                "tiles": [
                    "https://api.mapray.com/vectile/6247673678004224/mvt/{z}/{x}/{y}"
                ],
                "type": "vector"
            }
        },
        "sprite": "https://opentiles.mapray.com/sprite/maki/sprite"
    }

    class TileJsonProvider extends mapray.vectile.TileProvider {
        constructor(resource) {
            super();
            this.resource = resource;
        }

        requestMeta() {
            const controller = new AbortController();
            return {
                promise: this.getMetaData(),
                canceller: () => { controller.abort(); },
            };
        }

        requestTile(area) {
            const controller = new AbortController();
            return {
                promise: this.getTileBinary(area),
                canceller: () => { controller.abort(); },
            };
        }

        init(source) {
            if (source && source['tiles']) {
                this.prefix = source['tiles'][0];
                this.minLevel = (source?.minzoom) ?? 0;
                this.maxLevel = (source?.maxzoom) ?? 22;
            }
        }

        getMetaData() {
            return Promise.resolve({
                min_level: Number(this.minLevel),
                max_level: Number(this.maxLevel),
            });
        }

        async getTileBinary(area) {
            const url = this.makeTileDataURL(area);
            const response = (await this.resource.resolveResource(url).load({ type: mapray.Resource.Type.BINARY }));
            if (response.ok) {
                return response.arrayBuffer();
            } else {
                throw new Error(response.statusText);
            }
        }

        makeTileDataURL(area) {
            return this.prefix.replace('{z}', `${area.z}`).replace('{x}', `${area.x}`).replace('{y}', `${area.y}.mvt`);
        }
    }

    class TileJsonProviderFactory extends mapray.vectile.ProviderFactory {
        constructor(resource) {
            super();
            this.provider = new TileJsonProvider(resource);
        }

        createTileProvider(_sourceId, jsonSource) {
            if (this.provider) {
                this.provider.init(jsonSource);
            }
            return this.provider;
        }

        createSpriteProvider(location) {
            return location ? new mapray.vectile.StandardSpriteProvider(location) : null;
        }
    }

    async function main() {
        const cloudApi = new mapray.cloud.CloudApiV2({
            tokenType: mapray.cloud.CloudApi.TokenType.ACCESS_TOKEN,
            token: "<YOUR_MAPRAY_ACCESS_TOKEN>"
        });

        // The StandardUIView in the ui package includes mouse-based camera manipulation.
        const uiviewer = new maprayui.StandardUIViewer( "mapray-container", {
            dem_provider: new mapray.StandardDemProvider( cloudApi.getDefaultDemAsResource() )
        } );

        // Wait for the initialization process to complete.
        await uiviewer.viewer.init_promise;

        uiviewer.setCameraPosition({
            longitude: 140.458835,
            latitude: 34.084404,
            height: 852099
        });

        uiviewer.setLookAtPosition({
            longitude: 139.972255,
            latitude: 36.375981,
            height: 50
        });

        const maprayApi = new mapray.cloud.CloudApiV2({
            tokenType: mapray.cloud.CloudApi.TokenType.API_KEY,
            token: apikey,
        });

        // Set up your dataset id, which can be created in Mapray Cloud.
        const datasetId = "5162077542940672";
        const resource = maprayApi.getVectileDatasetAsResource( datasetId );

        const style = mapray.vectile.StyleManager.create( uiviewer.viewer, styleJson, new TileJsonProviderFactory( resource ) );
        const manager = await style.promise;
        uiviewer.viewer.setVectileManager( manager );
    }

    main();
</script>

Info

このサンプルコードは、<YOUR_MAPRAY_ACCESS_TOKEN>を、あなたのMapray CloudアカウントのOrganization Tokenに置き換えるまで、期待通りに動作しません。

Info

datasetIdは、あなたがアップロードしたデータセットのIDに置き換えて下さい。