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

مقياس خريطة الويب

تحوّل حاسبة مقياس خريطة الويب ثلاث مدخلات يومية لعارض الخريطة — مستوى الزوم وخط العرض وDPI الشاشة — إلى مقام المقياس الخرائطي التمثيلي الذي يسمّي خريطة منزلقة واحدًا إلى N.

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

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

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

تتشارك خرائط الويب في Leaflet وOpenLayers وMapbox وGoogle Maps وOpenStreetMap نموذج بلاط Web Mercator (EPSG:3857): تتقلص أمتار الأرض لكل بكسل مع نمو الزوم ومع الابتعاد عن خط الاستواء بسبب جيب تمام خط العرض. يطبّق هذا الأداة تلك الصيغة المغلقة بنصف قطر أرض وحجم بلاط مُعلَنين، ثم يضرب بـ DPI على أمتار لكل بوصة حتى يطابق المقياس المطبوع أو على الشاشة ما تسميه كتب GIS الكسر التمثيلي. يقارن المصممون نص الأسطورة في مشاهد المدينة مقابل القطبية؛ ويتحقق المعلمون من الواجبات عن مقياس يعتمد على الزوم؛ ويؤكد المطورون قيم golden في اختبارات الوحدة دون تشغيل محرك خريطة. المسار حساب حتمي نقي — بلا شبكة ولا بذور عشوائية ولا اعتماد على ساعة الجدار — فيعيد منفّذ المتصفح المجاني وAPI المدفوعة مسبقًا نفس JSON بعد تقريب ثابت في كل استدعاء.

طريقة الاستخدام

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

راجع بياناتك

اتبع التسميات والوحدات الموضحة بجانب كل حقل. إذا كانت قيمة مفقودة أو خارج النطاق، توضح الصفحة الحقل الذي يحتاج إلى تصحيح.

أعد الحساب أو نفّذه آليًا

استخدم أداة الويب للفحوص الفردية، واستخدم الواجهة البرمجية عند دمج الإمكانية نفسها في سير عمل آلي.

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

احصل على النتيجة الآن

أدخل مجموعة من القيم وشاهد النتيجة من دون إعداد جدول بيانات أو برنامج نصي.

قارن السيناريوهات

غيّر قيمة واحدة في كل مرة وأعد الحساب لمعرفة ما الذي يؤثر في النتيجة.

أتمت العمل المتكرر

استخدم الواجهة البرمجية عندما تحتاج إلى تشغيل الحساب نفسه داخل منتجك أو سير عملك.

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

كيف يُحسب مقياس خريطة الويب من الزوم؟

أمتار الأرض لكل بكسل تساوي cos(latitude)×2πR÷(256×2^zoom) حيث R=6378137 m. مقام المقياس هو تلك القيمة ×DPI÷0.0254 m/بوصة.

لماذا يجب أن يكون الزوم وDPI موجبين؟

الزوم الصفري أو السالب يقلب أو يُلغي هرم البلاط؛ وDPI الصفري أو السالب ليس كثافة شاشة فيزيائية. كلا الحالتين يُرجع invalid_input.

هل يغيّر خط العرض المقياس عند نفس الزوم؟

نعم. تُضرب دقة أرض Web Mercator في cos(latitude)، فنفس الزوم مقياس أرض أخشن قرب القطبين منه عند خط الاستواء.

هل يُدعم الزوم الكسري؟

نعم. الزوم عدد منتهٍ موجب حتى 30، فقيم مثل 12.5 تطابق زوم الكاميرا المستمر في محركات خرائط الويب الحديثة.

هل حاسبة مقياس خريطة الويب مجانية؟

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/geo/map-scale

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

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

curl -X POST https://api.kit.forhosting.com/geo/map-scale \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"zoom":10,"latitude":40.7128,"dpi":96}'

const res = await fetch("https://api.kit.forhosting.com/geo/map-scale", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "zoom": 10,
    "latitude": 40.7128,
    "dpi": 96
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/map-scale",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "zoom": 10,
    "latitude": 40.7128,
    "dpi": 96
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"zoom":10,"latitude":40.7128,"dpi":96}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/map-scale", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "zoom": 10,
  "latitude": 40.7128,
  "dpi": 96
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.map_scale",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

الأسعار

لكل طلب$0.002

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

الحدود

`min_lat`	-90
`max_lat`	90
`min_zoom`	1e-12
`max_zoom`	30
`min_dpi`	1e-12
`max_dpi`	1000000

الأخطاء

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

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

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