タイル タイプおよびタイル ID で機能を取得します interactive
API では、次のタイルタイプがサポートされています。
メルカトル図法の Web (OpenStreetMaps 、 Google Maps 、 Bing Maps などで使用 ) の形式 : level_x_y 。例 : 10_100_100 はレベル 10.x 座標 100 、 y 座標 100 を意味します オープンソース地理空間 Foundation 形式で開発されたタイルマップサービスの TMS : level_x_y 。例: 10_100_100 は、レベル 10 の x 座標 100 、 * y 座標 100 を意味します Bing マップ ( 以前の Virtual Earth) およびその他の形式で使用されている 4 つのキーの quadkey 。たとえば、レベル 10 の場合は 0123031233 です HERE for the スキーマ tiling HERE GET /< Base path for the interactive API from the API Lookup Service > /layers/< Layer ID > /tile/< Tile Type > /< Tile ID >
Host: < Hostname for the interactive API from the API Lookup Service >
Authorization: Bearer < Authorization Token >
Cache-Control: no-cache
注 代わりに、認可ヘッダーで OAuth ベアラトークン の代わりに API キー を使用することもできます。
応答タイプには、次の 2 つがあります。
GeoJSON FeatureCollection の応答の例 :
レスポンス {
"type" : "FeatureCollection" ,
"features" :
[
{
"type" : "Feature" ,
"id" : "BfiimUxHjj" ,
"geometry" :
{
"type" : "Point" ,
"coordinates" :
[
-2.960847 ,
53.430828
]
} ,
"properties" :
{
"name" : "Anfield" ,
"@ns:com:here:xyz" :
{
"createdAt" : 1517504700726 ,
"updatedAt" : 1517504700726
} ,
"amenity" : "Football Stadium" ,
"capacity" : 54074 ,
"popupContent" : "Home of Liverpool Football Club"
}
}
]
}
タイルでクラスタ化された機能を利用できます このセクションでは、クラスタ化されたフォームで対話型マップ レイヤーからデータを取得する方法について説明します。 hexbin
とquadbin
の 2 つのクラスタリングモードを使用できます 。
hexbin
- 六角形のタイルでのフィーチャの量を計算します。 さらに、ユーザー定義のプロパティに関する統計情報 ( 最小、最大、平均、中央値 ) を提供します。 quadbin
- タイルおよびサブタイルのフィーチャーの量を計算します。 データセットの場所をより低いズームレベルですばやく確認できます。 四つ目のビンは、 Webmercator のタイリング方式に対応しています。 hexbin タイル内のレイヤーからフィーチャーを取得する際 hexbin
に、クラスタリングを使用してデータを六角形として表示できます。 各六角形は、カバーする領域のフィーチャーを表します。 データの 1 つのプロパティに関する追加の統計情報を評価し、返された六角形のフィーチャのプロパティとして返すことができます。
hexbin アルゴリズムは、指定した解像度で六角形の「ビン」で世界を分割します。 各六角形には、 H3 アドレッシング方式で記述されるアドレスがあります。 このトピックの詳細については 、 https://eng.uber.com/h3/ を参照してください
図 1. 火災データ リクエスト GET /< Base path for the interactive API from the API Lookup Service > /layers/< Layer ID > /tile/< Tile Type > /< Tile ID > ?clustering=hexbin&clustering.resolution=< #number> &clustering.property=< Property name >
次のクラスタリング関連のパラメータを渡して、他のパラメータと組み合わせることができます ( タグ、クリップ、機能のフィルタリングなど ) 。
パラメーター タイプ 必須項目 意味 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": {
"< Property name > ": { // only if a clustering.property=< Property name > 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 のデフォルトの解像度です このパラメータ clusterning.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
クァッドビン 図 2. 火災データ quadbin アルゴリズムは、リクエストのジオメトリ入力 ( 例 : quadkey / bbox.. ) を取得し、レイヤーに含まれているフィーチャーの推定数を計算します。 このクラスタリングモードは、非常に大きいレイヤーにも使用でき、特定のレイヤー内でデータの地理位置が設定されている概要を取得するために使用できます。 さらに、 1 つのプロパティにプロパティフィルタを適用できます。
quadbin アルゴリズムでは、いくつかのパラメーターが必要です。 1 つのプロパティフィルターを組み合わせて使用できます。
リクエスト GET /< Base path for the interactive API from the API Lookup Service > /layers/< Layer ID > /tile/< Tile Type > /< Tile ID > ?clustering=quadbin&clustering.relativeResolution=< #number> &clustering.countmode=< cmode>
次のクラスタリング関連のパラメータを渡すことができます
パラメーター タイプ 必須項目 意味 relativeResolution 数 いいえ 整数、 4 分割解像度 [0,4] NoBuffer ブール型 いいえ 4 つのポリゴンの周囲にバッファを置かないでください。デフォルトは false です 国モード 文字列 いいえ [ 実数、推定、混合 ] 実数 = 実際のフィーチャー数最も正確 ですが、速度は遅くなります。 大きな結果のセットにはお勧め しません。 sestimed= 推定された機能数低い精度ですが、大きな結果のセットには非常に高速に再構成されます。 xed( デフォルト ) = 推定された機能数と実際の機能の組み合わせ概算値が少ない場合は、実際の数が適用されます。 ほとんどのユースケースに適合します
レスポンス {
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {
"qk": "12002323333", // tile quadkey
"xyz": "(639,1071,11)", // tile row/col/level
"count": 30393, // count of features in tile
"estimated": true,
"total_count": 33521484, // total feature count in related layer
"equipartition_count": 511 // total_count/#Nr_Of_All_Level_Tiles
},
"geometry": {...}
},
......
......
{
"type": "Feature",
"type": "Feature",
"properties": {
"qk": "12002323331",
"xyz": "(638,1071,11)",
....
},
"geometry": {...}
}
]
}
注 バージョン対応のインタラクティブマップ レイヤー を使用している場合、「バージョン」クエリ パラメーター を使用して、レイヤーの特定のバージョンをタイルに要求できます。