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

من خط/طول إلى بلاطة خريطة: X/Y ويب ميركاتور، مجانًا

اعرف أي بلاطة خريطة ويب تحتوي نقطة ما: النقطة (51.5074، -0.1278) عند التكبير 12 تقع في البلاطة 12/2046/1362، أي العمود 2046 والصف 1362. وتحصل أيضًا على حواف البلاطة ومسار z/x/y جاهز. مجاني في متصفحك.

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

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

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

مثال محلول

إذا أدخلت

خط العرض: 51.5074
خط الطول: ‎-0.1278
مستوى التكبير: 12

تحصل على

N: 4,096
X: 2,046
Y: 1,362
Z: 12

تجيب حاسبات بلاطات الخريطة عن سؤال نظم معلومات جغرافية يومي: بمعلومية نقطة على الأرض ومستوى تكبير، أي مربع من هرم ويب ميركاتور العالمي يحتوي تلك النقطة؟ تأخذ هذه الأداة خط عرض وطول عشريين مع تكبير صحيح، ثم تُرجع فهارس بلاطة slippy X وY التي تستخدمها OpenStreetMap وMapbox وLeaflet ومعظم خوادم بلاطات XYZ. الرياضيات هي الإسقاط القياسي: تُقاس خط الطول خطيًا عبر عمودين مرفوعين لقوة التكبير، ويُسقط خط العرض عبر الجيب العكسي الزائدي للظل حتى يطابق محور y لمركاتور نفس الشبكة المربعة. تتلقون أيضًا الحدود الجغرافية لتلك البلاطة وسلسلة مسار z/x/y جاهزة لعناوين URL والذاكرة المؤقتة.

كيف يصبح خط العرض/الطول فهرس بلاطة slippy

ويب ميركاتور، وغالبًا ما يُوسم EPSG:3857، يبسط الكرة إلى مربع تتضاعف دقته في كل خطوة تكبير. عند التكبير صفر تغطي بلاطة واحدة العالم المسقط كله. عند التكبير واحد ينقسم المربع إلى شبكة اثنين في اثنين، وعند اثنين إلى أربعة في أربعة، وبشكل عام طول المحور n يساوي اثنين مرفوعًا إلى التكبير.

يُرسم خط الطول خطيًا: أضيفوا مئة وثمانين درجة، اقسموا على ثلاثمئة وستين، اضربوا في n وخذوا الجزء الصحيح الأدنى لفهرس العمود x. خط العرض ليس خطيًا بالدرجات؛ إحداثي y لمركاتور يستخدم الجيب العكسي الزائدي لظل خط العرض بالراديان، أو اللوغاريتم الطبيعي المكافئ للظل زائد القاطع. بعد تطبيع قيمة مركاتور تلك إلى الفترة الوحدوية من صفر عند الحافة الشمالية إلى واحد عند الجنوبية، اضربوا في n وخذوا الجزء الأدنى لفهرس الصف y.

تمتد الفهارس من صفر شاملًا إلى n ناقص واحد شاملًا على كل محور، مطابقة لنمط z/x/y المألوف في OpenStreetMap وشبكات CDN المتوافقة. ولأن ظل خط العرض يتباعد عند القطبين، لا يقبل ويب ميركاتور سوى خطوط عرض داخل نحو زائد أو ناقص خمسة وثمانين فاصل صفر خمسة واحد واحد درجة؛ ترفض هذه الحاسبة القيم خارج ذلك النطاق المغلق بدل القص دون تنبيه. يجب أن يبقى خط الطول في المجال المغلق من سالب مئة وثمانين إلى موجب مئة وثمانين.

يجب أن يكون التكبير عددًا صحيحًا غير سالب لا يتجاوز ثلاثين حتى يبقى اثنان مرفوعًا إلى التكبير عدد بلاطات عمليًا.

أين تظهر تحويلات خط/طول إلى بلاطة في العمل الحقيقي

يحوّل مهندسو الخرائط في الواجهة باستمرار إحداثيات GPS ونتائج التكويد الجغرافي إلى إحداثيات بلاطة لطلب البلاطة النقطية أو المتجهة الصحيحة، وتنقيح الصور الناقصة، ومقارنة مفاتيح الذاكرة المؤقتة عبر شبكات CDN. تحتاج الخدمات الخلفية التي تسخّن ذاكرة بلاطات مسبقًا أو تقسم أحمالًا جغرافية حسب خلية الهرم إلى صيغة مغلقة موثوقة تطابق Leaflet وOpenLayers وMapbox GL دون سحب مكتبة إسقاط كاملة إلى عامل. يريد مؤلفو مناهج نظم المعلومات الجغرافية ورسم الخرائط على الويب أن يرى الطلاب صيغ مركاتور تنتج فهارس صحيحة وحدود بلاطة مقروءة دون قص صامت عند القطبين.

لا تزال أنابيب اللوجستيات وإنترنت الأشياء التي تخزن مفاتيح بلاطة خشنة فقط للخصوصية أو التخزين بحاجة إلى التحويل الأمامي من إحداثيات دقيقة عند الإدخال. إن احتجتم لاحقًا إلى المسألة العكسية لمركز البلاطة أو ترميز quadkey كامل أو جيوديسيات إهليلجية أو نقاط وصول دائرة عظمى، فاعاملوها كنوايا بحث وصفحات هبوط منفصلة بدل إثقال صفحة فهرس بلاطة slippy هذه.

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

تنقيح طبقات الخريطة وعناوين البلاطات

حوّلوا خط/طول GPS أو مُكوِّد جغرافي مع تكبير إلى z/x/y لفتح عنوان بلاطة OSM أو XYZ الدقيق ومقارنة مفاتيح الذاكرة المؤقتة بين البيئات.

تسخين ذاكرة البلاطات وتقسيمها

حوّلوا قوائم نقاط المسار دفعة واحدة إلى فهارس خلايا الهرم لمهام تسخين CDN والأقسام الإقليمية والتخزين الخشن الشبيه بـ geohash مع حماية الخصوصية.

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

أي مخطط بلاطات تستخدم هذه الحاسبة؟

متوافق مع OpenStreetMap وMapbox وLeaflet ومعظم خوادم XYZ.

لماذا يُحدَّ خط العرض بنحو ±85.0511°؟

ويب ميركاتور شاذ عند القطبين. النطاق المغلق هو arctan(sinh(π)) ≈ ±85.05112878°.

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

يجب أن يكون التكبير عددًا صحيحًا غير سالب في [0, 30]. التكبير السالب أو الكسري ليس مستوى هرم slippy صالحًا.

هل تتضمن الاستجابة الحدود الجغرافية للبلاطة؟

نعم. بالإضافة إلى x وy وz ومسار z/x/y، تحصلون على حواف الغرب والجنوب والشرق والشمال بالدرجات العشرية لمربع البلاطة المختار.

إلى أي مستوى تكبير تعمل الحاسبة؟

يجب أن يكون التكبير عددًا صحيحًا من 0 إلى 30. ومع كل مستوى يتضاعف عدد الأعمدة والصفوف، فعند التكبير 12 مثلًا يوجد 4096 منها على كل محور.

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/geo/tile-from-latlon

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

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

curl -X POST https://api.kit.forhosting.com/geo/tile-from-latlon \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"latitude":51.5074,"longitude":-0.1278,"zoom":12}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/tile-from-latlon",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "latitude": 51.5074,
    "longitude": -0.1278,
    "zoom": 12
},
)
task_id = res.json()["task_id"]

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

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

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

{
  "latitude": 51.5074,
  "longitude": -0.1278,
  "zoom": 12
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.tile_from_latlon",
  "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 واضحة بدل الالتفاف الصامت.

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

يجب أن يقع خط العرض في النطاق المغلق لويب ميركاتور حوالي سالب خمسة وثمانين فاصل صفر خمسة واحد واحد إلى موجب خمسة وثمانين فاصل صفر خمسة واحد واحد درجة مع شمال موجب. وخط الطول في المجال المغلق من سالب مئة وثمانين إلى موجب مئة وثمانين مع شرق موجب. تشمل الفحوصات الكلاسيكية لندن قرب واحد وخمسين فاصل خمسة صفر سبعة أربعة شمالًا وصفر فاصل واحد اثنين سبعة ثمانية غربًا عند التكبير اثني عشر، والتحقق من تطابق x وy مع مفتشي بلاطات OpenStreetMap المعروفين. وصّلوا نموذج المتصفح المجاني لتنقيح طبقات الخريطة وعروض الصف، ثم استدعوا نفس العقد من البرامج النصية عند الحاجة إلى توليد مفاتيح بلاطة بالجملة أو قوائم تسخين الذاكرة المؤقتة. أرسلوا ثلاثة أعداد منتهية إلزامية في الحقول latitude وlongitude وzoom. يجب أن يكون التكبير عددًا صحيحًا أكبر من أو يساوي صفرًا وعلى الأكثر ثلاثين؛ التكبير السالب أو الكسري أو الهائل يفشل بـ invalid_input ولا يُحسب. تُقبل الأسماء البديلة الشائعة مثل lat وlon وlng وz عند التحليل بينما تعيد الاستجابة دائمًا الأسماء القياسية. عند النجاح تُرجع خط العرض والطول والتكبير المنظفة، وطول المحور n يساوي اثنين مرفوعًا إلى التكبير، وفهارس بلاطة صحيحة x وy، وحقل z مرآة، وسلسلة مسار بلاطة بصيغة z/x/y، وكائن bounds بحواف غرب وجنوب وشرق وشمال لتلك البلاطة بالدرجات، والثابت max_mercator_lat، ووسم الطريقة web_mercator_slippy، وسلسلة صيغة مختصرة للتوثيق. تسعير طلبات API الناجحة هو الأساس المنشور $0.002 لكل عنصر؛ إخفاقات التحقق لا تستهلك الرصيد المدفوع مسبقًا.

أين تظهر تحويلات خط/طول إلى بلاطة في العمل الحقيقي

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

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

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

أنشئوا X/Y بلاطة وحدودًا مستقرة لمعالم الكتب الدراسية حتى يتشارك المعلمون والمصححات الآلية وحزم الانحدار حقيقة ويب ميركاتور واحدة.

أسئلة تقنية

كم التكلفة؟

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

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

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

مثال محلول

كيف يصبح خط العرض/الطول فهرس بلاطة slippy

أين تظهر تحويلات خط/طول إلى بلاطة في العمل الحقيقي

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

تنقيح طبقات الخريطة وعناوين البلاطات

تسخين ذاكرة البلاطات وتقسيمها

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

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

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

أين تظهر تحويلات خط/طول إلى بلاطة في العمل الحقيقي

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

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

أسئلة تقنية

شكرًا