クラスタリングを使用 - hexbin
ここでは、データ ハブクラスタ化フォームで hexbin から機能を取得する方法について説明します。 「 hexbin 」と「 quadbin 」の 2 つの異なるクラスタリングモードを使用できます。
- "quadbin" - タイルおよびサブタイルのフィーチャーの量を指定します。 Purpuse は、より低いズームレベルのデータセットの場所についての概要をすばやく表示するためのものです。 四つ目のビンは、 Webmercator のタイリング方式に対応しています。
- 「 hexbin 」 - 六角形のタイルに含まれる豊富な機能を提供します。 hexbin ごとの機能の量のほかに、ユーザー定義のプロパティについての統計情報 ( 最小、最大、平均、中央値 ) を提供します。
hexbin
図 1. 火災データ タイルでクラスタ化された機能を利用できます
タイル内のスペースから機能を取得する際に、「 hexbin 」クラスタリングを使用してデータを六角形として表示できます。 各六角形は、カバーする領域のフィーチャーを表します。 データの 1 つのプロパティに関する追加の統計情報を評価し、返された六角形のフィーチャのプロパティとして返すことができます。
hexbin アルゴリズムは、指定した解像度で六角形の「ビン」で世界を分割します。 各六角形には、 H3 アドレッシング方式で記述されるアドレスがあります。 このトピックの詳細については 、 https://eng.uber.com/h3/ を参照してください
リクエスト
Swagger で試してください
GET /spaces/{spaceId}/tile/{type}/{tileId}?clustering=hexbin&clustering.resolution={aNumber}&clustering.property={aPropertyName}
次のクラスタリング関連のパラメータを渡して、他のパラメータと組み合わせることができます ( タグ、クリップ、機能のフィルタリングなど ) 。
パラメーター | タイプ | 必須です | 意味 |
absoluteResolution | 数 | いいえ | 整数、 H3 の六角形の解像度 [0,13] 、デフォルト : (S.B zoomlevel のデフォルトの解像度 ) |
relativeResolution | 数 | いいえ | 現在使用されている解像度に追加される整数値 [-2,2] |
プロパティ | 文字列 | いいえ | 統計情報を計算する元のフィーチャのプロパティ |
ポイントモード | ブール型 | いいえ | 六角形の中心点を GeoJSON フィーチャーとして再結合します |
シングルコースト | ブール型 | いいえ | 最初のオブジェクトの座標のみを評価するように強制します ( デフォルト : false) |
サンプリング | 文字列 | いいえ | 基礎となるデータセット値のサンプル [off 、 low 、 lowmed 、 med 、 medhigh 、 高 ] ( デフォルト : オフ ) オフ ~(1/1) 、 低 ~ (1/8) 、 中 ~ (1/32) 、 中 ~ (1/128) 、 中 ~ (1/1024) 、高 ~ (1/4096)
|
応答
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {
"kind" : "H3",
"kind_detail" : "858b1303fffffff",
"resolution": 5,
"level": 7,
"aggregation": {
"aPropertyName": { // only if a clustering.property={aPropertyName} is specified. If not specified field "qty" is
// written on this object-level (e.g. properties.aggregation.qty )
"avg": 30.05000,
"max": 44.1,
"min": 16,
"qty": 2,
"sum": 60.1
}
},
"centroid": [ ... ], // only if clustering.pointmode = false|null
"hexagon": [ ... ] // only if clustering.pointmode = true
},
"geometry": {...},
},
......
......
{
"type": "Feature",
"properties": {
"kind" : "H3",
"kind_detail" : "881f1d4a81fffff",
....
},
"geometry": {...}
}
]
}
雑則
zoomlevel のデフォルトの解像度です
clustering.absoluteResolution パラメータは、必要な六角形のサイズを指定します。 (s. https://h3geo.org/docs/core-library/restable ) 既定の解像度は、タイルごとの hexbin 計算のサイズとパフォーマンスに合わせて、通常の量のデータに合わせて調整されます。 量、密度、分布、オブジェクトサイズなどのさまざまなパラメータが、パフォーマンス時間に役割を果たします。 より高い分解能の特定のタイルレベルで、実験ベースで ( デフォルト +2) まで指定できます ( データサイズによって異なります ) 。 クラスタ化解決の値がタイルレベルの最大値を超える場合は、代わりに最大解決が使用されます。
ズームレベル | 既定の H3 解決方法 |
0 | 2 |
1 | 2 |
2 | 2 |
3 | 2 |
4 | 3 |
5 | 4 |
6 | 4 |
7 | 5 |
8 | 6 |
9 | 6 |
10 | 7 |
11 | 8 |
12 | 9 |
13 | 9 |
14 | 10 |
15 | 11 |
16 | 11 |
17 | 12 |
18 | 13 |
19 | 13 |
20 | 13 |
21 | 13 |
22 | 13 |