Bingクアッドキー復号
Bing Mapsのクアッドキーが指すタイルを求めます。213なら列3・行5・ズーム3で、そのまま3/3/5のパスとして使えます。キャッシュキーの確認やXYZサーバーへの移行に便利で、ブラウザで無料で使えます。
- 無料
- ブラウザで動作
- 登録不要
- データは端末の外に出ません
無料で実行
計算例
- クアッドキー
- 213
- X
- 3
- Y
- 5
- ズーム
- 3
- Z
- 3
Bing Mapsのクアッドキーは、Bing Maps、Azure Maps、互換タイルキャッシュが使う世界Web Mercatorタイルピラミッド上の一平方のコンパクトな四進住所です。ズーム・列・行の三つの整数の代わりに、0から3の数字だけの文字列が根タイルから葉までの全経路を符号化します。本ツールはその文字列を受け取り、表す整数タイルX・Y・ズーム、軸長2^zoom、URLと回帰フィクスチャ用のz/x/yパスを返します。
Bing MapsクアッドキーがタイルX・Y・ズームになる仕組み
Microsoft Bing MapsタイルシステムはWeb Mercator上に正方形ピラミッドを築きます。ズーム1で世界は0・1・2・3とラベルされた四つの子四分に分かれ、深いズームは親を細分して数字を追加します。文字列を左から右へ読むとタイル指数の粗いビットから細かいビットへ歩きます。
ズームは文字列長に等しく、213のような三文字は常にズーム3、十六文字は常にズーム16です。XとYを得るには両座標を0で初期化し、最上位から最下位へ各ビット位置で残り深さ分左シフトした1のマスクを適用します。数字0は両ビットを立てず、1はX、2はY、3は両方を立てます。
全数字適用後、XとYは0以上2^zoom−1未満の非負整数で、ズームが分かればOpenStreetMap風のz/x/yと同じです。
送る内容と返ってくる内容
値は0・1・2・3のみの非空列で、端の空白は切り詰めますが内部空白や文字は検証失敗です。長さがズームで、Workerとブラウザで実用的な整数タイル数のため最大30です。
BingやAzure MapsのURLから怪しいキャッシュキーを見て直ちにXYZが必要なときは無料ブラウザフォームを、クアッドキーストアをXYZタイルCDNへ移す・GIS課題の答え・固定ランドマークの列行がライブラリ更新後も同じかを確認するときはスクリプトから同一契約を呼び出します。
逆方向が必要なら別の符号化や緯度経度→タイルのランディングと組み合わせ、単一フォームを過負荷にしないでください。
実務でBingクアッドキー復号が現れる場面
地図プラットフォーム技術者はクアッドキー経路を含むBing/AzureタイルURLを絶えず受け取り、XYZキャッシュ・デバッグ重ね・同一ピラミッドセルのOSMタイル比較用に相当列行が必要です。歴史的に主キーをクアッドキーだけにしていたバックエンドは、スリッピーマップシャード結合、CDN暖気、z/x/yキーのGeoJSON出力に信頼できる閉形式が今も要ります。
ウェブ地図とGISを教える教材著者は、四進四分ラベルが静かなクランプや浮動投影なしで整数指数になる様子を学生に見せたいと考えます。粗いピラミッドキーを保つ物流・プライバシーパイプラインは、変換を純粋オフラインに保ったままバッチを分析用境界タイル指数へ復号できます。
後でX Y ズーム→クアッドキー、緯度経度→スリッピータイル、大圏到着点が必要なら、このBing Mapsクアッドキー復号ページを過負荷にせず別意図として扱ってください。
活用例
BingクアッドキーをXYZタイルパスへ移行
保存済みBing/Azureのクアッドキー主キーをz/x/yに復号し、CDN暖気、OSM風キャッシュ、事業者横断のタイル比較に使います。
画像URLとキャッシュキーのデバッグ
本番タイルURLのクアッドキーを貼り付け、タイルX・Y・ズームを即取得して他の地図クライアントで同じピラミッドセルを開きます。
よくある質問
Bing Mapsクアッドキーとは何ですか？
Bing Maps / Azure MapsのWeb Mercatorピラミッドで根タイルから葉までの経路を符号化する0–3の四進文字列です。長さがズームです。
緯度経度をタイルに変換しますか？
いいえ。 本ランディングは既存クアッドキーをX・Y・ズームに復号するだけです。緯度経度→スリッピータイルは別ツールです。
ズームレベルとクアッドキーの桁数はどう関係しますか？
同じ数になります。213のような3桁のキーは必ずズーム3、16桁のキーは必ずズーム16です。キーは最大30桁まで入力できます。
クアッドキーからz/x/yのタイルパスを得るには？
復号すると、パスも一緒に表示されます。213なら3/3/5で、ズーム、列、行の順です。ズームが分かれば、OpenStreetMap形式のタイルサーバーでそのまま使えます。
0から3以外の文字が含まれているとどうなりますか？
計算は行われず、理由を示すメッセージが表示されます。前後の空白は自動で取り除かれますが、途中の空白や英字、4以上の数字は使えません。
関連ツール
開発者向け — APIアクセス
このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。
エンドポイント
Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。
お使いのスタックから呼び出す
curl -X POST https://api.kit.forhosting.com/geo/quadkey-decode \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"quadkey":"213"}'const res = await fetch("https://api.kit.forhosting.com/geo/quadkey-decode", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"quadkey": "213"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/geo/quadkey-decode",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"quadkey": "213"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/quadkey-decode", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"quadkey":"213"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"quadkey":"213"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/quadkey-decode", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)リクエスト例
{
"quadkey": "213"
}レスポンス例
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.quadkey_decode",
"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 | リクエストが多すぎます。しばらく待ってから再度お試しください。 |
技術的な注記
0–3外の数字、空文字、異常に長いキーは黙った折り返しではなく明確なinvalid_inputで失敗します。
Bing MapsクアッドキーがタイルX・Y・ズームになる仕組み
古典例はキー213がズーム3でX=3,Y=5、単独の1がズーム1でX=1,Y=0です。空入力と合法四数字外の文字は指数計算前にinvalid_inputで拒否されます。
送る内容と返ってくる内容
必須文字列をフィールドquadkeyに送ってください。quadKeyやqkなどの別名は解析時に受け付け、応答は常に正規フィールド名をエコーします。成功時は整形クアッドキー、整数x・y、zoomと鏡のz、n=2^zoom、z/x/y形のtile_path、method=bing_maps_quadkey、短いformulaを返します。成功APIは公開ベース$0.002/項目で、キー中の5などの検証失敗は前払い残高を消費しません。
実務でBingクアッドキー復号が現れる場面
本機能は純粋なparseエンジンのため、API料金は成功項目あたり公開ベース$0.002で、検証失敗は残高を消費しません。
連携の活用例
GIS宿題とgoldenフィクスチャ
教科書のクアッドキーから安定したX/Y/ズームを生成し、教官・自動採点・回帰がBingタイルシステムの一つの真実を共有します。
技術的な質問
ズームと文字列の関係は？
ズームは文字数に等しいです。例えば「213」は常にズーム3でタイルX=3,Y=5に復号されます。
0–3以外の数字がある場合は？
不正文字と位置を示すinvalid_inputで失敗します。合法は0,1,2,3のみ。検証失敗は課金されません。
費用はいくらですか？
ブラウザツールは無料でローカル実行です。APIは成功項目ごとに前払いKIT残高から$0.002で、無効入力は課金されません。