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

مفكك مفتاح Bing الرباعي

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

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

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

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

مثال محلول

إذا أدخلت

مفتاح رباعي: 213

تحصل على

X: 3
Y: 5
التكبير: 3
Z: 3

المفتاح الرباعي لـ Bing Maps عنوان مضغوط بأساس أربعة لمربع في هرم بلاطات Web Mercator العالمي الذي تستخدمه Bing Maps وAzure Maps وكثير من مخابئ البلاطات المتوافقة. بدل ثلاثة أعداد صحيحة منفصلة للتكبير والعمود والصف، ترّمز سلسلة واحدة من الأرقام من صفر إلى ثلاثة المسار الكامل من بلاطة الجذر إلى ورقة. تأخذ هذه الأداة تلك السلسلة وتُرجع البلاطة الصحيحة X وY ومستوى التكبير الذي تمثله، مع طول المحور اثنين مرفوعًا إلى التكبير ومسار جاهز z شرطة مائلة x شرطة مائلة y لعناوين URL ومراجع الانحدار.

كيف يصبح مفتاح Bing Maps الرباعي بلاطة X وY وتكبيرًا

يبني نظام بلاطات Microsoft Bing Maps هرمًا مربعًا في Web Mercator. عند التكبير واحد ينقسم العالم إلى أربعة أرباع أبناء مرقّمة صفر وواحد واثنان وثلاثة؛ وكل تكبير أعمق يضيف رقمًا بتقسيم الأب. قراءة السلسلة من اليسار إلى اليمين تسير إذن من أخشن بت إلى أدقه في فهارس البلاطة.

التكبير يساوي طول السلسلة: مفتاح بثلاثة أحرف مثل اثنين واحد ثلاثة دائمًا تكبير ثلاثة، ومفتاح بستة عشر حرفًا دائمًا تكبير ستة عشر. لاستعادة X وY صفّروا الإحداثيين ثم لكل موضع بت من الأكثر أهمية إلى الأقل طبّقوا قناعًا ثنائيًا من واحد مُزاح يسارًا بعمق المتبقي. الرقم صفر يترك البتين صافيين، وواحد يضبط بت X، واثنان بت Y، وثلاثة كليهما.

بعد تطبيق كل رقم يكون X وY عددين غير سالبين في المجال نصف المفتوح من صفر إلى اثنين مرفوعًا إلى التكبير ناقص واحد، مطابقين لمخطط z شرطة مائلة x شرطة مائلة y المألوف في خوادم أسلوب OpenStreetMap بعد معرفة التكبير.

ما ترسلونه وما تستلمونه

أرسلوا سلسلة إلزامية تحت الحقل quadkey. يجب أن تكون القيمة تسلسلًا غير فارغ من الأرقام صفر وواحد واثنين وثلاثة فقط؛ تُقلَّم المسافات عند الحواف لكن المسافات الداخلية والأحرف تفشل التحقق. تُقبل أسماء مثل quadKey وqk عند التحليل بينما تعيد الاستجابة دائمًا اسم الحقل القياسي.

استخدموا نموذج المتصفح المجاني عند فحص مفتاح مخبأ مشبوه من عنوان Bing أو Azure Maps وتحتاجون ثلاثية XYZ فورًا. استدعوا العقد ذاته من السكربتات عند ترحيل مخزن مفاتيح رباعية إلى CDN بلاطات XYZ أو توليد مفاتيح إجابة لمقررات نظم المعلومات الجغرافية أو التأكيد أن معلمًا ثابتًا ما زال يطابق نفس العمود والصف بعد ترقية مكتبة. اقرنوا هذا المفكك بمرمّز منفصل أو هبوط عرض/طول إلى بلاطة عندما يحتاج مساركم الاتجاه العكسي بدل إثقال نموذج واحد.

أين يظهر فك مفتاح Bing الرباعي في العمل الحقيقي

يتلقى مهندسو منصات الخرائط باستمرار عناوين بلاطات Bing أو Azure Maps تتضمن مقطع مسار مفتاح رباعي ويحتاجون العمود والصف المكافئين لمخبأ XYZ أو تراكب تصحيح أو مقارنة مع بلاطات OpenStreetMap لنفس خلية الهرم. ما زالت خدمات الخلفية التي خزنت تاريخيًا مفاتيح رباعية فقط كمفاتيح أولية مدمجة تحتاج شكلًا مغلقًا موثوقًا للربط مع شظايا خرائط منزلقة أو تدفئة مناطق CDN أو تصدير كيانات GeoJSON مفهرسة بـ z/x/y.

يريد مؤلفو المناهج الذين يعلّمون رسم الخرائط على الويب ونظم المعلومات الجغرافية أن يرى الطلاب تسميات الأرباع بأساس أربعة تنتج فهارس صحيحة بلا قصّ صامت ولا خطوة إسقاط عائم. يمكن لمسارات اللوجستيات والخصوصية التي تحتفظ بمفاتيح هرم خشنة فك دفعة مفاتيح إلى فهارس بلاطات حدودية للتحليلات مع إبقاء التحويل نقيًا ودون اتصال. إن احتجتم لاحقًا الترميز العكسي لـ X Y والتكبير إلى مفتاح رباعي أو عرض/طول إلى فهارس بلاطة منزلقة أو نقاط وجهة دائرة عظمى، فاعاملوها كنوايا بحث وصفحات هبوط منفصلة بدل إثقال صفحة مفكك مفتاح Bing Maps الرباعي.

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

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

فكّوا مفاتيح Bing أو Azure Maps الرباعية المخزّنة إلى z/x/y لتدفئة CDN ومخابئ بأسلوب OpenStreetMap ومقارنات بلاطات عبر المزودين.

تصحيح عناوين الصور ومفاتيح المخبأ

الصقوا مفتاحًا رباعيًا من عنوان بلاطة إنتاج واستعيدوا فورًا بلاطة X وY والتكبير لفتح خلية الهرم المطابقة في عميل خرائط آخر.

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

ما مفتاح Bing Maps الرباعي؟

سلسلة بأساس أربعة من الأرقام 0–3 ترمّز المسار من بلاطة الجذر إلى ورقة في هرم Web Mercator لـ Bing Maps / Azure Maps. طولها هو مستوى التكبير.

ماذا يحدث إن احتوى المفتاح رقمًا غير 0–3؟

القانونية فقط 0 و1 و2 و3. التحقق الفاشل لا يُحاسب.

هل يحوّل هذا العرض والطول إلى بلاطة؟

لا. هذه الصفحة تفك فقط مفتاحًا موجودًا إلى X وY وتكبير. عرض/طول إلى بلاطة منزلقة نية بحث وأداة مختلفتان.

ما العلاقة بين مستوى التكبير وطول المفتاح الرباعي؟

هما الرقم نفسه. المفتاح المكوّن من ثلاثة أرقام مثل 213 يكون دائمًا عند التكبير 3، والمكوّن من ستة عشر رقمًا عند التكبير 16. ويمكن أن يصل طول المفتاح إلى 30 رقمًا.

كيف أحصل على مسار z/x/y من المفتاح الرباعي؟

يعرضه المفكك مباشرة مع النتيجة: المفتاح 213 يعطي 3/3/5، أي التكبير ثم العمود ثم الصف. وهذا هو تنسيق خوادم البلاطات على طريقة OpenStreetMap بعد معرفة التكبير.

أدوات ذات صلة

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

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

الـEndpoint

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

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

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

الأسعار

لكل طلب$0.002

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

الأخطاء

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

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

تفشل الأرقام خارج صفر إلى ثلاثة والسلاسل الفارغة والمفاتيح الطويلة جدًا برسالة invalid_input واضحة بدل اختراع لفّ صامت.

كيف يصبح مفتاح Bing Maps الرباعي بلاطة X وY وتكبيرًا

فحوصات توثيق كلاسيكية تشمل المفتاح اثنين واحد ثلاثة الذي يُفك إلى X=3 وY=5 عند التكبير 3، والرقم الواحد الذي يُفك إلى X=1 وY=0 عند التكبير 1. يُرفض الإدخال الفارغ وأي حرف خارج الأرقام الأربعة القانونية بـ invalid_input قبل حساب أي فهرس.

ما ترسلونه وما تستلمونه

الطول هو مستوى التكبير ويجب ألا يتجاوز ثلاثين حتى يبقى اثنان مرفوعًا إلى التكبير عدد بلاطات صحيحًا عمليًا لـ Worker والمتصفح. عند النجاح تُرجع السلسلة المنظفة وفهارسي x وy الصحيحين والتكبير وحقل z مرآة وطول المحور n=2^zoom وسلسلة tile_path بشكل z/x/y ووسم method=bing_maps_quadkey وسلسلة formula مضغوطة للتوثيق. تسعير طلبات API الناجحة هو القاعدة المنشورة $0.002 لكل عنصر؛ إخفاقات التحقق مثل رقم خمسة وسط المفتاح لا تستهلك الرصيد المدفوع مسبقًا.

أين يظهر فك مفتاح Bing الرباعي في العمل الحقيقي

ولأن هذه القدرة محرك parse خالص، فتسعير API هو القاعدة المنشورة $0.002 لكل عنصر ناجح والتحقق الفاشل لا يستهلك الرصيد.

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

واجبات نظم المعلومات الجغرافية ومراجع golden

ولّدوا ثلاثيات X/Y/تكبير مستقرة من مفاتيح كتب دراسية ليشترك المدرّسون والمصححات الآلية وحزم الانحدار في حقيقة واحدة لنظام بلاطات Bing.

أسئلة تقنية

كيف يرتبط التكبير بالسلسلة؟

التكبير يساوي عدد الأحرف. مثلًا «213» دائمًا تكبير 3 ويُفك إلى بلاطة X=3 وY=5.

كم التكلفة؟

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

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

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

مثال محلول

كيف يصبح مفتاح Bing Maps الرباعي بلاطة X وY وتكبيرًا

ما ترسلونه وما تستلمونه

أين يظهر فك مفتاح Bing الرباعي في العمل الحقيقي

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

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

تصحيح عناوين الصور ومفاتيح المخبأ

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

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

كيف يصبح مفتاح Bing Maps الرباعي بلاطة X وY وتكبيرًا

ما ترسلونه وما تستلمونه

أين يظهر فك مفتاح Bing الرباعي في العمل الحقيقي

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

واجبات نظم المعلومات الجغرافية ومراجع golden

أسئلة تقنية

شكرًا