ForHosting KIT · السفر والجغرافيا

بلاطة إلى مفتاح Bing الرباعي

احصل على مفتاح Bing Maps الرباعي لأي بلاطة: العمود 3 والصف 5 عند التكبير 3 يعطيان 213، وهي الأرقام نفسها في عناوين البلاطات ومفاتيح الذاكرة المؤقتة الحقيقية. يقبل مستويات التكبير من 1 إلى 23. مجاني في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

مثال محلول

إذا أدخلت

عمود البلاطة: 3
صف البلاطة: 5
التكبير: 3

تحصل على

مفتاح رباعي: 213
الطول: 3
أقصى فهرس: 7

تعرّف Bing Maps وكثير من مسارات بلاطات Azure Maps كل مربع على شبكة Web Mercator بسلسلة مدمجة بأساس 4 تُدعى المفتاح الرباعي. مع عمود بلاطة صحيح X وصف Y ومستوى تكبير تفصيلي، تبني هذه القدرة تلك السلسلة بنفس قواعد طي البتات المنشورة في توثيق نظام بلاطات Bing Maps من Microsoft، فالأرقام التي تحصلون عليها تطابق عناوين بلاطات الإنتاج ومفاتيح المخبأ. تفشل فهارس البلاطات خارج النطاق للتكبير المختار بخطأ إدخال غير صالح واضح بدل اختراع لفّ صامت.

ما مفتاح Bing Maps الرباعي وأي X وY وتكبير ترسلون

المفتاح الرباعي سلسلة أرقام من صفر إلى ثلاثة طولها يساوي مستوى التكبير. يرمّز كل رقم خطوة تقسيم رباعي متكرر للعالم: صفر الابن الشمالي الغربي، وواحد الشمالي الشرقي، واثنان الجنوبي الغربي، وثلاثة الجنوبي الشرقي، مطابقًا تشابك بِتّات البلاطة X وY من أهم بت تكبير إلى الأقل. أرسلوا الحقول الصحيحة الإلزامية x وy لعمود وصف البلاطة في شبكة Bing Maps، وzoom لمستوى التفصيل بين واحد وثلاثة وعشرين.

عند التكبير z النطاق الصالح لـ x وy هو المجال المغلق من صفر إلى اثنين مرفوعًا إلى z ناقص واحد. ذلك نفس الحد الذي يفرضه كل خادم بلاطات متوافق قبل بناء مسار URL.

حالات الاستخدام

بناة عناوين بلاطات Bing وAzure

تحوّل الخلفيات التي تجمع مسارات بلاطات Bing أو Azure أعداد X/Y/تكبير صحيحة إلى سلسلة مفتاح رباعي تطابق مفاتيح CDN الإنتاج وتقسيمات المخبأ.

الأسئلة الشائعة

كيف أحوّل بلاطة X وY والتكبير إلى مفتاح Bing Maps الرباعي؟

تتضمن الاستجابة سلسلة المفتاح الرباعي (213 لذلك المثال الكلاسيكي).

ماذا يحدث إن كان فهرس البلاطة خارج النطاق الصالح؟

عند التكبير z يجب أن يقع x وy في [0, 2^z − 1]. الفهارس خارج النطاق تُرفض ولا تُحاسب.

هل يطابق TileXYToQuadKey من Microsoft؟

نعم. يتبع الترميز قواعد طي البتات في نظام بلاطات Bing Maps: لكل بت تكبير أضيفوا 1 إن كان لـ X البت و2 إن كان لـ Y.

ما مستويات التكبير التي يمكنني استخدامها؟

أي عدد صحيح من 1 إلى 23. وفي كل مستوى يجب أن تبقى قيمتا X وY بين 0 و2 مرفوعًا إلى قوة التكبير ناقص 1، فعند التكبير 3 يكون أكبر رقم مسموح هو 7.

ماذا يعني كل رقم في المفتاح الناتج؟

يدل كل رقم على الربع المختار في مستوى تكبير واحد: 0 للشمال الغربي، و1 للشمال الشرقي، و2 للجنوب الغربي، و3 للجنوب الشرقي. الرقم الأول هو أكبر تقسيم والأخير أدقّه.

أدوات ذات صلة

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/geo/quadkey-encode

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر 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"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

ملاحظات تقنية

يمكن للطلاب ومهندسي نظم المعلومات الجغرافية وخدمات الخلفية تثبيت JSON الحتمي في الاختبارات دون تضمين SDK خرائط كامل.

ما مفتاح Bing Maps الرباعي وأي X وY وتكبير ترسلون

تُقبل aliases tile_x وtileX وcol لـ x؛ وtile_y وtileY وrow لـ y؛ وz وlevel وlevel_of_detail أو lod لـ zoom عندما يستخدم عميلكم تلك الأسماء. تفشل الحقول الناقصة وغير الصحيحة والتكبير خارج واحد إلى ثلاثة وعشرين والفهارس السالبة أو المفرطة بـ invalid_input حتى لا تقبل مصححات الواجبات والمسارات إحداثية مقطوعة بصمت. المدخلات المتطابقة تنتج دائمًا JSON متطابقًا لأن المسار حساب بتات خالص بلا شبكة ولا بذرة عشوائية ولا ساعة جدار.

قراءة استجابة المفتاح الرباعي والتحقق من حدود البلاطة

فضّلوا الحقول المنظمة على تحليل المفتاح يدويًا عندما تحتاجون فقط بيانات حدود؛ واحتفظوا بالسلسلة عند بناء مسارات بلاطات Bing أو Azure تضمّن المفتاح مباشرة. عند النجاح تعيد الاستجابة x وy وzoom المطبَّعة، وتُرجع سلسلة المفتاح الرباعي، وتضبط length مساويًا للتكبير ليؤكد العملاء عدد الأرقام دون عدّ الأحرف يدويًا، وتتضمن max_index مساويًا لاثنين مرفوعًا إلى التكبير ناقص واحد كحد أعلى شامل طُبّق أثناء التحقق. تسمية method دائمًا bing_maps_tile_xy_to_quadkey حتى يتفرع الكود اللاحق دون استنشاق الأشكال عند خلط هذا المرمّز مع geohash أو مفاتيح مكانية أخرى. عندما تفشل طلب لأن x أو y خارج صفر إلى max_index، تسمّي رسالة الخطأ المحور السيئ والنطاق الصالح لذلك التكبير، مما يسهّل تصحيح أخطاء الواحد في محوّلات العرض/الطول إلى بلاطة.

استخدام API والتسعير ومسارات الخرائط والحدود العملية

اقرنوا هذه النقطة بمحوّلات عرض/طول إلى بلاطة في مكدسكم ثم ثبّتوا المفتاح الناتج في المراجع حتى لا تنحرف إعادة هيكلة الإسقاط عن شبكة Bing. تتبع مدخلات المصدر نفس قواعد الاحتفاظ بعناصر parse الأخرى في KIT، والنتائج آمنة للتثبيت في مراجع التكامل المستمر لأن الخوارزمية حتمية بالكامل. صيغة صورة التي تستخدمها نقاط بلاطات Bing الكلاسيكية. أرسلوا جسم JSON بالأعداد الصحيحة الإلزامية x وy وzoom. استدعوا الأداة المجانية في المتصفح من بلاطة إلى مفتاح Bing الرباعي لعروض المحاضرات وفحوصات TMS الذهنية السريعة والتحقق المحلي دون تثبيت SDK خرائط. استخدموا API المدفوعة مسبقًا عندما يحتاج مخبأ بلاطات أو منظّف CDN أو مهمة ETL لنظم المعلومات الجغرافية أو معبّئ دون اتصال للجوال أو منصة تعليمية عقدًا مستقرًا تحت رصيد KIT بـ $0.002 لكل عنصر ناجح؛ إخفاقات التحقق لا تستهلك الرصيد أبدًا بعد رفض المحرك. التكبير محدود بثلاثة وعشرين لتغطية مستويات تفصيل خرائط عملية مع إبقاء حلقة البتات محدودة على Worker. يمكن لمؤلفي SDK ربط حقل المفتاح الرباعي مباشرة بقوالب URL من شكل مسار/مفتاح.

حالات التكامل

مراجع مسارات نظم المعلومات الجغرافية وأوراكل التكامل المستمر

تثبّت الفرق بلاطات معروفة مثل x=3 وy=5 وzoom=3 → 213 حتى لا تغيّر إعادة هيكلة الإسقاط وTMS العنونة المكانية بصمت.

تعليم نظام بلاطات Bing Maps

يشفّر المدربون والطلاب مستويات تكبير صغيرة يدويًا ويقارنون مع API ويتعلمون كيف تُطوى بِتّات X وY إلى أرقام بأساس 4.

أسئلة تقنية

أي مستويات تكبير مدعومة؟

يجب أن يكون zoom (aliases z وlevel وlevel_of_detail وlod) عددًا صحيحًا من 1 إلى 23. طول المفتاح الرباعي يساوي التكبير دائمًا.

هل أداة البلاطة إلى مفتاح Bing Maps الرباعي مجانية؟

أداة المتصفح تعمل مجانًا على جهازكم. تستعمل استدعاءات API رصيد KIT المدفوع مسبقًا بـ $0.002 لكل عنصر ناجح؛ إخفاقات التحقق لا تُحاسب.

اطّلع على توثيق KIT الكامل ←

شغّل الأداة مجانًا

مثال محلول

ما مفتاح Bing Maps الرباعي وأي X وY وتكبير ترسلون

حالات الاستخدام

بناة عناوين بلاطات Bing وAzure

الأسئلة الشائعة

أدوات ذات صلة

للمطوّرين — الوصول عبر API

الـEndpoint

استدعِ الخدمة من بيئتك

مثال على الطلب

مثال على الاستجابة

الأسعار

الأخطاء

ملاحظات تقنية

ما مفتاح Bing Maps الرباعي وأي X وY وتكبير ترسلون

قراءة استجابة المفتاح الرباعي والتحقق من حدود البلاطة

استخدام API والتسعير ومسارات الخرائط والحدود العملية

حالات التكامل

مراجع مسارات نظم المعلومات الجغرافية وأوراكل التكامل المستمر

تعليم نظام بلاطات Bing Maps

أسئلة تقنية

شكرًا