ForHosting KIT · أدوات المطورين

تحويل Quadkey إلى بلاطة XYZ: الإحداثيان X وY والتكبير

المفتاح الرباعي ل Bing Maps عنوان مضغوط بأساس أربعة لمربع في هرم بلاطات Web Mercator العالمي الذي تستخدمه Bing Maps وAzure Maps وكثير من مخابئ البلاطات المتوافقة.

● Betaمجاني · داخل متصفحك

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

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

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

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

أدخل القيم في النموذج أعلاه. تتحقق الأداة منها قبل الحساب ثم تعرض النتيجة في الصفحة نفسها.

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

أرسلوا سلسلة إلزامية تحت الحقل quadkey. يجب أن تكون القيمة تسلسلًا غير فارغ من الأرقام صفر وواحد واثنين وثلاثة فقط؛ تُقلَّم المسافات عند الحواف لكن المسافات الداخلية والأحرف تفشل التحقق. تُقبل أسماء مثل quadKey وqk عند التحليل بينما تعيد الاستجابة دائمًا اسم الحقل القياسي. الطول هو مستوى التكبير ويجب ألا يتجاوز ثلاثين حتى يبقى اثنان مرفوعًا إلى التكبير عدد بلاطات صحيحًا عمليًا ل Worker والمتصفح. عند النجاح تُرجع السلسلة المنظفة وفهارسي x وy الصحيحين والتكبير وحقل z مرآة وطول المحور n=2^zoom وسلسلة tile_path بشكل z/x/y ووسم method=bing_maps_quadkey وسلسلة formula مضغوطة للتوثيق. استخدموا نموذج المتصفح المجاني عند فحص مفتاح مخبأ مشبوه من عنوان Bing أو Azure Maps وتحتاجون ثلاثية XYZ فورًا. استدعوا العقد ذاته من السكربتات عند ترحيل مخزن مفاتيح رباعية إلى CDN بلاطات XYZ أو توليد مفاتيح إجابة لمقررات نظم المعلومات الجغرافية أو التأكيد أن معلمًا ثابتًا ما زال يطابق نفس العمود والصف بعد ترقية مكتبة. تسعير طلبات API الناجحة هو القاعدة المنشورة $0.002 لكل عنصر؛ إخفاقات التحقق مثل رقم خمسة وسط المفتاح لا تستهلك الرصيد المدفوع مسبقًا. اقرنوا هذا المفكك بمرمّز منفصل أو هبوط عرض/طول إلى بلاطة عندما يحتاج مساركم الاتجاه العكسي بدل إثقال نموذج واحد.

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

يتلقى مهندسو منصات الخرائط باستمرار عناوين بلاطات Bing أو Azure Maps تتضمن مقطع مسار مفتاح رباعي ويحتاجون العمود والصف المكافئين لمخبأ XYZ أو تراكب تصحيح أو مقارنة مع بلاطات OpenStreetMap لنفس خلية الهرم. ما زالت خدمات الخلفية التي خزنت تاريخيًا مفاتيح رباعية فقط كمفاتيح أولية مدمجة تحتاج شكلًا مغلقًا موثوقًا للربط مع شظايا خرائط منزلقة أو تدفئة مناطق CDN أو تصدير كيانات GeoJSON مفهرسة ب z/x/y. تؤكد فرق ضمان الجودة التي تكتب اختبارات golden لمنتجات الصور أن مفتاح معلم معروف يتوسع دائمًا إلى نفس ثلاثية التكبير وX وY عبر الإصدارات دون الاعتماد على SDK Microsoft كامل في التكامل المستمر. يريد مؤلفو المناهج الذين يعلّمون رسم الخرائط على الويب ونظم المعلومات الجغرافية أن يرى الطلاب تسميات الأرباع بأساس أربعة تنتج فهارس صحيحة بلا قصّ صامت ولا خطوة إسقاط عائم. يمكن لمسارات اللوجستيات والخصوصية التي تحتفظ بمفاتيح هرم خشنة فك دفعة مفاتيح إلى فهارس بلاطات حدودية للتحليلات مع إبقاء التحويل نقيًا ودون اتصال. ولأن هذه القدرة محرك parse خالص، فتسعير API هو القاعدة المنشورة السعر الأساسي المنشور لكل عنصر ناجح والتحقق الفاشل لا يستهلك الرصيد. إن احتجتم لاحقًا الترميز العكسي ل X Y والتكبير إلى مفتاح رباعي أو عرض/طول إلى فهارس بلاطة منزلقة أو نقاط وجهة دائرة عظمى، فاعاملوها كنوايا بحث وصفحات هبوط منفصلة بدل إثقال صفحة مفكك مفتاح Bing Maps الرباعي.

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

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

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

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

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

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

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

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

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

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

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

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

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

يفشل الطلب ب invalid_input يذكر الحرف السيئ والفهرس. القانونية فقط 0 و1 و2 و3. التحقق الفاشل لا يُحاسب.

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

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

كم التكلفة؟

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/geo/quadkey-to-tile

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

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

curl -X POST https://api.kit.forhosting.com/geo/quadkey-to-tile \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"quadkey":"1203"}'

const res = await fetch("https://api.kit.forhosting.com/geo/quadkey-to-tile", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "quadkey": "1203"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/quadkey-to-tile",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "quadkey": "1203"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/quadkey-to-tile", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"quadkey":"1203"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"quadkey":"1203"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/quadkey-to-tile", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "quadkey": "1203"
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.quadkey_to_tile",
  "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`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

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