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

الأمتار لكل بكسل في Web Mercator

تجيب الدقة الأرضية في Web Mercator عن سؤال عملي في رسم الخرائط: عند مستوى التكبير هذا وخط العرض هذا، كم مترًا على سطح الأرض يمثل بكسل واحد من الخريطة؟ تحتاج خوادم البلاطات وحزم SDK للجوال ودفاتر نظم المعلومات الجغرافية جميعها إلى ذلك الرقم لتحديد أحجام المناطق العازلة، ورسم أشرطة المقياس، واختيار أنصاف أقطار تجميع معقولة، وتحويل المسافات على الشاشة إلى مسافات جغرافية دون المرور عبر مكتبة إسقاط كاملة. تضرب الصيغة الكلاسيكية محيط خط الاستواء لكرة WGS84 التي يستخدمها EPSG:3857 في جيب تمام خط العرض، ثم تقسم الناتج على عدد البكسلات التي تغطي العالم عند ذلك التكبير، أي مئتين وستة وخمسين مضروبة في اثنين أس مستوى التكبير. عند خط الاستواء ومستوى التكبير صفر تستعيد الثابت المعروف البالغ نحو مئة وستة وخمسين ألفًا وخمسمئة وثلاثة وأربعين مترًا لكل بكسل؛ وتنصف كل خطوة تكبير تلك القيمة، وتقللها خطوط العرض الأعلى بمعامل cos(خط العرض). تعيد هذه القدرة الأمتار لكل بكسل إضافة إلى أدوات مساعدة مثل الأمتار لكل حافة بلاطة والمحيط عند خط العرض، بحيث يمكنك تغذية واجهة المقياس وعتبات الانجذاب وحمولات API من مسار parse حتمي واحد. أما التكبير السالب وخط العرض خارج النطاق الجغرافي فيُرفضان برسالة تحقق واضحة بدلًا من اختلاق دقة وهمية.

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

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

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

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

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

راجع بياناتك

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

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

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

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

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

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

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

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

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

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

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

ما الصيغة التي تستخدمها حاسبة الأمتار لكل بكسل هذه؟

الدقة الأرضية في Web Mercator: mpp = cos(φ) · 2πR / (tile_size · 2^z) مع R = 6378137 m وtile_size = 256، بما يوافق اصطلاحات EPSG:3857 / OSM / Mapbox.

ماذا يحدث إذا كان التكبير سالبًا؟

يفشل الطلب مع invalid_input. التكبير السالب غير معرّف في أهرامات الخرائط الانزلاقية؛ يجب أن يكون التكبير عددًا صحيحًا غير سالب (عمليًا من 0 إلى 30).

ما نطاق خط العرض المقبول؟

يجب أن يقع خط العرض في الفترة المغلقة [-90, 90] درجة. تُرفض القيم خارج ذلك النطاق بوصفها خارج النطاق. وقرب القطبين يدفع cos(φ) الأمتار لكل بكسل نحو الصفر.

لماذا نصف قطر الأرض 6378137 مترًا؟

هذا هو نصف القطر الاستوائي WGS84 الذي يستخدمه Web Mercator (EPSG:3857). الثابت الكلاسيكي ~156543.0339 m/px عند التكبير 0 على خط الاستواء يفترض هذا نصف القطر وبلاطات من 256 px.

كم التكلفة؟

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/geo/meters-per-pixel

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

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

curl -X POST https://api.kit.forhosting.com/geo/meters-per-pixel \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"zoom":12,"latitude":0}'

const res = await fetch("https://api.kit.forhosting.com/geo/meters-per-pixel", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "zoom": 12,
    "latitude": 0
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/meters-per-pixel",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "zoom": 12,
    "latitude": 0
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"zoom":12,"latitude":0}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/meters-per-pixel", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "zoom": 12,
  "latitude": 0
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.meters_per_pixel",
  "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 الكامل ←

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