ForHosting KIT · 開発者向けツール

グリッド別ポイントクラスタリング

グリッド別ポイントクラスタリングは、反復型モデルを使わずに、多数の座標を簡潔な密度情報へまとめます。正方形セルの大きさを十進度で指定し、緯度と経度のレコードを送信すると、使用された各セルの地理的境界、点数、元の配列内のインデックスが返されます。グリッドは世界共通の位置に固定されるため、同じセルサイズの実行結果を比較したり統合したりできます。処理は決定的かつローカルで高速です。地図サービス、ネットワーク検索、乱数、保存済みデータによって結果が変わることはありません。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

目的に合うグリッドサイズをお選びください

グリッドのまとまりは空間を区切った結果であり、含まれる点が自然な集団を形成するという意味ではありません。cell_size は高さと幅を十進度で指定します。値を大きくすると少数の広いセルで全体を把握でき、値を小さくすると局所的な違いが残り、通常は使用セルが増えます。経度1度の実距離は極に近づくほど短くなるため、このセルは角度上の正方形であり、地表面積が等しい正方形ではありません。離れた緯度同士の密度を比較する場合は、この性質にご注意ください。都市規模のデータでは適度な1度未満の値から始め、返された境界を確認しながら調整してください。世界規模で同じ実面積が必要な場合は、適切な投影座標系へ変換して別の処理をご利用ください。本機能は通常の地理緯度・経度のみを受け付けます。基準点は緯度 -90、経度 -180 に固定されるため、同じサイズなら境界も常に同じになり、定期レポート、キャッシュ、テスト、分割処理を再現できます。

セル数、境界、所属点をご確認ください

各セルには、0から始まる行番号と列番号、南・西・北・東の境界、count、member_indices が含まれます。インデックスは送信した points 配列内の位置を0から示すため、ラベルなどを結果へ複製せずに元レコードを取得できます。セルは南から北、次に西から東の順で並び、メンバーは入力順を保ちます。内部境界上の座標は直ちに北側または東側のセルへ入り、緯度 90 と経度 180 は最後の有効な行または列へ収められます。point_count は処理点数を、occupied_cell_count は空でないセル数を示します。空セルは巨大な世界グリッドを作らないよう省略されます。サイズが 180 または 360 を割り切らない場合、北端や東端のセルだけ幅が狭くなることがあります。矩形の描画やレポート作成では、浮動小数点計算で境界を再構成せず、返された境界値をそのままお使いください。

再現可能な密度分析と分割処理を構築できます

グリッド集計は、地図、センサー、配送記録、現地観測、座標品質確認の最初の処理として便利です。点の割り当ては線形時間で行われ、その後は使用セルだけを安定した順序に並べます。不規則な形状の発見よりも、素早い密度表が必要な場面に適しています。ダッシュボードでは点数に応じて矩形を着色でき、パイプラインでは行と列でレコードを振り分けられます。テストではバージョン間のセルを比較でき、高コストな分析を密集地域だけに適用できます。本アルゴリズムは重心、点間距離、隣接関係、密度しきい値を計算せず、隣り合うセルも統合しません。地名検索、入れ替わった座標の修正、経度の折り返し、重複判定も行いません。無効値は拒否します。複数バッチを統合する際は同じ cell_size を使い、同じ行・列の count を加算してください。ブラウザーでは無料で、正常なAPI実行の公開基本料金は $0.002 です。ネットワーク、乱数、時刻、共有可変状態を使わないため、同じJSON入力には常に同じ結果が返ります。

活用例

地図の密度レイヤーを作成します

イベント座標を使用セルの矩形へ変換し、返された点数に応じて各セルを色分けできます。

位置レコードを分割します

安定した行番号と列番号を使い、近いレコードを再現可能な処理区画へ振り分けられます。

大規模な空間データを確認します

密集地域と疎な地域を素早く見つけ、選択した部分だけに距離分析を適用できます。

よくある質問

APIリクエストの料金はいくらですか？

正常なAPIリクエストは $0.002 です。同じ決定的な計算をブラウザーで無料実行することもできます。

セルサイズはキロメートル単位ですか？

いいえ。緯度と経度の十進度ですので、実際の横幅は緯度によって変わります。

グリッドの基準点はどこですか？

行は緯度 -90、列は経度 -180 から始まります。リクエスト間で基準点は変わりません。

境界上の点はどう処理されますか？

内部境界上の点は北側または東側のセルへ入ります。緯度 90 と経度 180 は最後の有効セルへ入ります。

空のセルも返されますか？

いいえ。細かなグリッドでも結果を簡潔に保つため、使用されたセルだけを返します。

不規則な形や距離に基づくクラスタも見つけられますか？

いいえ。固定された角度セル内の点数だけを数え、隣接セルの統合や点間距離の計算は行いません。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/geo/point-cluster-grid

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/geo/point-cluster-grid \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"points":[{"lat":40.7128,"lon":-74.006},{"lat":40.7306,"lon":-73.9352},{"lat":34.0522,"lon":-118.2437}],"cell_size":1}'

const res = await fetch("https://api.kit.forhosting.com/geo/point-cluster-grid", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "points": [
      {
        "lat": 40.7128,
        "lon": -74.006
      },
      {
        "lat": 40.7306,
        "lon": -73.9352
      },
      {
        "lat": 34.0522,
        "lon": -118.2437
      }
    ],
    "cell_size": 1
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/point-cluster-grid",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "points": [
        {
            "lat": 40.7128,
            "lon": -74.006
        },
        {
            "lat": 40.7306,
            "lon": -73.9352
        },
        {
            "lat": 34.0522,
            "lon": -118.2437
        }
    ],
    "cell_size": 1
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/point-cluster-grid", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"points":[{"lat":40.7128,"lon":-74.006},{"lat":40.7306,"lon":-73.9352},{"lat":34.0522,"lon":-118.2437}],"cell_size":1}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"points":[{"lat":40.7128,"lon":-74.006},{"lat":40.7306,"lon":-73.9352},{"lat":34.0522,"lon":-118.2437}],"cell_size":1}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/point-cluster-grid", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "points": [
    {
      "lat": 40.7128,
      "lon": -74.006
    },
    {
      "lat": 40.7306,
      "lon": -73.9352
    },
    {
      "lat": 34.0522,
      "lon": -118.2437
    }
  ],
  "cell_size": 1
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.point_cluster_grid",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

制限

max_points 100000

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

KITの完全なドキュメントを見る →