ForHosting KIT · 開発者向けツール

ポリゴンのバウンディングボックス計算

ポリゴンのバウンディングボックスとは、指定されたすべての頂点を含み、緯度軸と経度軸に平行な最小の長方形です。この計算ツールは地図サービスへ問い合わせずに座標を走査し、南西に相当する最小角と北東に相当する最大角を返します。地図表示範囲の設定、空間データの絞り込み、索引作成、形状検証、地理的範囲の要約に利用できます。処理は決定論的で、一般的な十進度座標に対応し、ブラウザーと API で同じロジックを使用します。

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

無料で実行 API仕様を見る

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

ポリゴンの頂点を準備します

3個以上の頂点を指定し、各頂点を十進度の数値 lat と lon で表してください。緯度は -90 から 90、経度は -180 から 180 の範囲である必要があります。凸ポリゴンと凹ポリゴンのどちらにも対応し、リングを閉じるために先頭点を末尾へ繰り返しても構いません。面積や重心の計算とは異なり、バウンディングボックスは頂点の時計回り・反時計回りという順序に依存しません。各点を独立に比較して極値を求めます。ただし、任意の点群ではなくポリゴンを入力する契約のため、3点が必要です。度記号、方位記号、コンマ区切り文字列ではなく数値を使用してください。不正なレコード、欠けた座標、有限でない値、範囲外の座標は明確なエラーになります。1回のリクエストでは最大 10,000 頂点を処理でき、詳細な境界でも予測可能な実行時間を保ちます。

返される2つの角を確認します

結果には min_corner と max_corner が含まれます。最小角は一覧内の最小緯度と最小経度を組み合わせ、最大角は最大緯度と最大経度を組み合わせます。この2点が緯度・経度平面で軸に平行な長方形を表します。最小緯度と最小経度が別々の点に現れる場合があるため、返される角が元のポリゴンの頂点とは限りません。余白、投影、丸め、測地学的な拡張は行わず、入力された数値の極値をそのまま保持します。経度は標準的な -180 から 180 の範囲で文字どおり比較します。このため、日付変更線をまたぐポリゴンでは -179 から 179 度のような幅広いボックスになる場合があります。これは意図した仕様であり、循環する地図表示範囲を自動選択するものではありません。必要に応じて、取得後に循環経度の代替範囲と比較できます。

地図やデータ処理で境界を活用します

バウンディングボックスはコンパクトな要約なので、多くの空間処理の最初に適しています。地図画面では2つの角から初期表示範囲を設定できます。データベースへの取り込み時には4つの極値をポリゴンと一緒に保存し、より高コストな点包含判定や形状交差判定の前に候補を高速で絞り込めます。検証処理では想定するサービス地域と送信された形状を比較でき、分析処理では境界をおおまかな地理的範囲で分類できます。ただし、ボックスはポリゴンを含んでも形状そのものではありません。長方形内の点が凹ポリゴンの外側にある場合や、2つのボックスが重なってもポリゴン同士が交差しない場合があります。また、投影座標系ではなく緯度・経度を直接扱うため、度単位の幅は場所によって実距離が異なります。個別確認はブラウザーで無料実行でき、API では1項目あたり $0.002 で自動化できます。

活用例

地図の表示範囲を合わせる

頂点を最小角と最大角へ変換し、地図クライアントで境界全体を表示します。

空間レコードを事前に絞り込む

単純な極値を保存し、厳密なポリゴン交差判定の前に候補を選別します。

地理的な対象範囲を検証する

取り込み時に送信された境界の範囲を許可済みの緯度・経度範囲と比較します。

よくある質問

計算料金はいくらですか？

API は1項目あたり $0.002 で、このページのブラウザー計算ツールは無料です。

頂点の順序は影響しますか？

いいえ。最小・最大の緯度と経度をそれぞれ独立に求めます。

末尾に先頭頂点を繰り返す必要がありますか？

いいえ。極値が同じであれば、開いた一覧と閉じた一覧は同じ境界を返します。

日付変更線をまたぐポリゴンはどう扱いますか？

経度を -180 から 180 の数値として比較するため、循環せず幅広いボックスになる場合があります。

厳密なポリゴン包含判定ですか？

いいえ。長方形は全頂点を含みますが、その内側の点がポリゴン外にある場合があります。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/geo/polygon-bounding-box

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

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

curl -X POST https://api.kit.forhosting.com/geo/polygon-bounding-box \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"vertices":[{"lat":40.7128,"lon":-74.006},{"lat":34.0522,"lon":-118.2437},{"lat":41.8781,"lon":-87.6298}]}'

const res = await fetch("https://api.kit.forhosting.com/geo/polygon-bounding-box", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "vertices": [
      {
        "lat": 40.7128,
        "lon": -74.006
      },
      {
        "lat": 34.0522,
        "lon": -118.2437
      },
      {
        "lat": 41.8781,
        "lon": -87.6298
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/polygon-bounding-box",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "vertices": [
        {
            "lat": 40.7128,
            "lon": -74.006
        },
        {
            "lat": 34.0522,
            "lon": -118.2437
        },
        {
            "lat": 41.8781,
            "lon": -87.6298
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/polygon-bounding-box", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"vertices":[{"lat":40.7128,"lon":-74.006},{"lat":34.0522,"lon":-118.2437},{"lat":41.8781,"lon":-87.6298}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"vertices":[{"lat":40.7128,"lon":-74.006},{"lat":34.0522,"lon":-118.2437},{"lat":41.8781,"lon":-87.6298}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/polygon-bounding-box", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "vertices": [
    {
      "lat": 40.7128,
      "lon": -74.006
    },
    {
      "lat": 34.0522,
      "lon": -118.2437
    },
    {
      "lat": 41.8781,
      "lon": -87.6298
    }
  ]
}

レスポンス例

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

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

料金

1リクエストあたり$0.002

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

制限

max_items 10000

エラー

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

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