タイルからBingクアッドキー
どのタイルでもBing Mapsのクアッドキーが分かります。列3・行5・ズーム3なら213で、実際のタイルの住所やキャッシュキーと同じ数字です。ズームは1から23まで指定でき、ブラウザで無料で使えます。
- 無料
- ブラウザで動作
- 登録不要
- データは端末の外に出ません
無料で実行
計算例
- タイル列
- 3
- タイル行
- 5
- ズーム
- 3
- クアッドキー
- 213
- 長さ
- 3
- 最大指数
- 7
Bing Mapsと多くのAzure Mapsタイルパイプラインは、Web Mercator格子上の各平方をクアッドキーというコンパクトな四進文字列で識別します。整数タイル列X、行Y、詳細ズームが与えられると、本機能はMicrosoftのBing Mapsタイルシステム文書と同じビット折りたたみ規則でその文字列を組み立て、得られる数字は本番タイルURLとキャッシュキーに一致します。選んだズームの範囲外タイル指数は黙った折り返しではなく明確な無効入力エラーで失敗します。
Bing Mapsクアッドキーとは何か、送るX・Y・ズーム
クアッドキーは長さがズームに等しい0〜3の数字列です。各数字は世界の再帰四分分割の一歩を符号化し、0は北西、1は北東、2は南西、3は南東の子で、最上位ズームビットから最下位へのX・Yビットのインターリーブと一致します。Bing Maps格子のタイル列・行として必須整数xとy、詳細レベル1〜23としてzoomを送ってください。
ズームzではxとyの有効範囲は0以上2^z−1以下の閉区間で、準拠タイルサーバーがURLパス構築前に課す境界と同じです。
使う場面と入力できる範囲
検証失敗は拒否後に残高を消費しません。自前スタックの緯度経度→タイル変換と組み合わせ、結果クアッドキーをフィクスチャに固定して投影リファクタがBing格子からずれないようにします。ズーム上限23は実用地図詳細を覆いつつWorker上のビットループを有界に保ちます。
入力は他のKIT parse項目と同じ保持規則で、アルゴリズムが完全に決定的なため結果はCIフィクスチャに安全です。画像形式テンプレへquadkeyを直接写せます。
活用例
BingとAzureのタイルURL組み立て
Bing/Azureタイルパスを組み立てるバックエンドは整数X/Y/ズームを本番CDNキーとキャッシュ分割に合うクアッドキーへ変換します。
よくある質問
タイルX・Y・ズームをBing Mapsクアッドキーにどう変換しますか?
応答にクアッドキー文字列(その古典例では213)が含まれます。
タイル指数が有効範囲外の場合は?
ズームzではxとyは[0, 2^z − 1]内でなければなりません。範囲外は拒否され課金されません。
MicrosoftのTileXYToQuadKeyと一致しますか?
はい。 符号化はBing Mapsタイルシステムのビット折りたたみ規則に従い、各ズームビットでXにビットがあれば1、Yにあれば2を加えます。
使えるズームレベルはいくつまでですか?
1から23までの整数です。どのズームでも、XとYは0から2のズーム乗マイナス1までに収める必要があり、ズーム3なら最大は7です。
できたクアッドキーの各桁は何を表しますか?
各桁は、そのズームで選ばれた区画を表します。0は北西、1は北東、2は南西、3は南東です。最初の桁が最も大まかな分割で、最後の桁が最も細かい分割です。
関連ツール
開発者向け — APIアクセス
このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。
エンドポイント
Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。
お使いのスタックから呼び出す
curl -X POST https://api.kit.forhosting.com/geo/quadkey-encode \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"x":3,"y":5,"zoom":3}'const res = await fetch("https://api.kit.forhosting.com/geo/quadkey-encode", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"x": 3,
"y": 5,
"zoom": 3
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/geo/quadkey-encode",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"x": 3,
"y": 5,
"zoom": 3
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/quadkey-encode", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"x":3,"y":5,"zoom":3}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"x":3,"y":5,"zoom":3}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/quadkey-encode", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)リクエスト例
{
"x": 3,
"y": 5,
"zoom": 3
}レスポンス例
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.quadkey_encode",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。
料金
単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。
エラー
| HTTP | コード | 意味 |
|---|---|---|
401 | unauthorized | APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。 |
402 | insufficient_balance | 残高が不足しています。チャージ後に再度お試しください。 |
404 | unknown_type | 指定されたタスクタイプは存在しません。タイプ名を確認してください。 |
429 | rate_limited | リクエストが多すぎます。しばらく待ってから再度お試しください。 |
技術的な注記
学生、GIS技術者、バックエンドは完全な地図SDKを埋め込まずに決定的JSONをテストへ固定できます。
Bing Mapsクアッドキーとは何か、送るX・Y・ズーム
xにはtile_x、tileX、col、yにはtile_y、tileY、row、zoomにはz、level、level_of_detail、lodの別名を受け付けます。欠落・非整数・1〜23外のズーム・負または過大なタイル指数はinvalid_inputで失敗し、宿題チェッカーやパイプラインが黙って切り取られた座標を受け入れません。経路はネットワークも乱数種も壁時計もない純粋ビット演算のため、同一入力は常に同一JSONを生みます。
クアッドキー応答の読み方とタイル境界の検証
成功時は正規化済みx・y・zoomをエコーし、クアッドキー文字列を返し、手で文字数を数えずに桁数を断言できるようlength=zoom、検証で適用した包括的上限としてmax_index=2^zoom−1を含めます。methodは常にbing_maps_tile_xy_to_quadkeyで、geohashなどと混在しても形状を嗅がずに分岐できます。xまたはyが0〜max_index外で失敗するときは、悪い軸とそのズームの有効範囲をエラーが示し、緯度経度→タイル変換器のオフバイワンを追いやすくします。境界メタだけが必要なときは構造化フィールドを優先し、キーを埋め込むBing/Azureタイルパス構築時は文字列を残してください。
API利用・料金・地図ワークフローと実用制限
必須整数x・y・zoomのJSONボディを送ってください。講義デモ、TMS座標の素早い確認、地図SDKなしのローカル検証には無料ブラウザ「タイルからBingクアッドキー」を使います。タイルキャッシュ、CDNパージ、GIS ETL、モバイルオフライン梱包、教育基盤がKIT残高下で安定契約を必要とするときは前払いAPIを使い、成功項目ごとに$0.002です。SDK作者は古典Bingタイル端点のパス/クアッドキー.
連携の活用例
GISパイプラインのフィクスチャとCIオラクル
x=3,y=5,zoom=3→213のような既知タイルを固定し、投影やTMSのリファクタが空間アドレスを静かに変えないようにします。
Bing Mapsタイルシステムの教育
教官と学生は小さなズームを手計算しAPIと比較し、X・Yビットが四進数字に折りたたまれる仕組みを学びます。
技術的な質問
どのズームがサポートされますか?
zoom(別名z, level, level_of_detail, lod)は1〜23の整数です。クアッドキー長は常にズームに等しいです。
タイルからBing Mapsクアッドキーは無料ですか?
ブラウザツールは端末上で無料です。APIは成功項目ごとに前払いKIT残高から$0.002で、検証失敗は課金されません。