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

وجه مكعب S2 من lat/lon: أي وجه يحتوي الإحداثي

اعرف على أي وجه من الأوجه الستة لمكعب S2 تقع نقطة ما: سان فرانسيسكو عند (37.7749، -122.4194) تقع على الوجه 4، أي الوجه -Y، بقيمة u تبلغ -0.918061185048 وقيمة v تبلغ -0.635094359374. إنها الخطوة الأولى قبل بناء خلايا S2. مجاني في متصفحك.

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

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

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

مثال محلول

إذا أدخلت

خط العرض: 37.7749
خط الطول: ‎-122.4194

تحصل على

الوجه: 4
اسم الوجه: -Y
X: ‎-0.4237560025
Y: ‎-0.6672331383

تقسّم مكتبة هندسة S2 من Google الأرض عبر إسقاط الكرة الوحدوية على مكعب ثم تقسيم كل وجه بشكل تكراري إلى تسلسل هرمي من الخلايا. قبل ترميز معرّف خلية S2 أو حساب تغطية أو دراسة تقاطع المناطق، يلزم معرفة أيٍّ من أوجه ذلك المكعب الستة يحتوي خط عرض وخط طول معيّنين. تقبل هذه القدرة خط العرض والطول وفق WGS84 وتحوّلهما إلى متجه اتجاه وحدوي وتعيد فهرس وجه S2 (من 0 إلى 5) واسمًا مقروءًا مثل +X أو -Z والمكوّنات الديكارتية الوحدوية وإحداثيات UV للنقطة على ذلك الوجه في المجال الاصطلاحي من ناقص واحد إلى زائد واحد. استخدمها عند بناء فهارس مكانية أو تعليم الهندسة الكروية أو التحقق من أن ربطات S2 الخاصة بكم تختار الوجه نفسه الذي تختاره المكتبة المرجعية في الحالات الحدّية قرب حدود الأوجه.

كيف يتحوّل خط العرض/الطول إلى وجه مكعب S2

ابدأ بخط العرض وخط الطول بالدرجات العشرية على كرة WGS84. حوّل خط العرض إلى زاوية قطبية من خط الاستواء وخط الطول إلى سمت من خط الزوال الأول، وكلاهما بالراديان. يصبح متجه الاتجاه الوحدوي عندئذٍ x يساوي cos(خط العرض) cos(خط الطول) و y يساوي cos(خط العرض) sin(خط الطول) و z يساوي sin(خط العرض)، مع z موجب نحو القطب الشمالي و x موجب نحو خط عرض صفر وخط طول صفر.

تتوافق أوجه مكعب S2 الستة مع أنصاف الفراغات الستة التي يحددها المحور الديكارتي السائد: الوجه صفر هو وجه زائد X والواحد زائد Y والاثنان زائد Z والثلاثة ناقص X والأربعة ناقص Y والخمسة ناقص Z. يتبع التنفيذ قاعدة المكوّن ذي أكبر قيمة مطلقة نفسها المستخدمة في مكتبة S2 من Google: قارن القيم المطلقة لـ x و y و z؛ يقرر المحور ذو أكبر مقدار زوج الأوجه؛ ويقرر إشارة ذلك المكوّن أيًّا من الوجهين المتقابلين يُختار.

عند التعادل التام يفوز فهرس المحور الأعلى، مطابقًا لترتيب LargestAbsComponent في S2، بحيث تُحلّ النقاط على اللحامات بين الأوجه بشكل حتمي. بعد معرفة الوجه تُحصل إحداثيات UV عليه بقسمة المكوّنين غير السائدين على السائد مع تقلبات الإشارة الخاصة بكل وجه والمنشورة في ValidFaceXYZToUV لدى S2، فتنتج قيمًا في الفترة المغلقة من ناقص واحد إلى زائد واحد تموضع النقطة داخل الوجه المربع قبل تطبيق أي تسلسل هرمي إضافي للخلايا.

أين تثبت جدوى استعلام وجه S2

تحتاج منصات الخرائط ونظم المعلومات الجغرافية التي تعرض معرّفات خلايا S2 لتغطية المناطق إلى خطوة أولى للتحقق من الوجه تطابق المكتبة المستخدمة في الإنتاج؛ وتجنّب واجهة parse صغيرة شحن ربط C++ أو Java كامل في كل عامل حافة لمجرد معرفة أي وجه من المكعب يقع عليه دبوس. يمكن لمولّدات التعليم والامتحانات التي تدرّس الشبكات العالمية المنفصلة أن تطلب من الطلاب وجه مدينة وتقيّم مقابل عرافة حتمية بدل دفاتر معلّمين غير مستقرة.

خطوط تحليل السجلات التي تجمّع عينات GPS حسب وجه S2 للتوجيه الخشن أو تقسيمات الجغرافيا A/B تستدعي مرة لكل حدث وتخزّن عدد الوجه الصحيح بجانب الإحداثيات الخام. تستفيد مواقع المحتوى التي تتنافس على وجه مكعب S2 من lat lon من ودجة مجانية مباشرة رياضياتها مطابقة لمسار الأتمتة المدفوع مسبقًا. التحقق الفاشل لا يستهلك الرصيد.

أبقِ الطلبات صغيرة وثبّت عدد الوجه الصحيح و UV المقرّب في الاختبارات لتحصل على تعيين وجه قابل لإعادة الإنتاج للفهارس والدروس وعوامل الحافة دون إقامة حزمة هندسة كروية كاملة خاصة بكم.

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

مقدمة ترميز خلايا S2

حدّد أيًّا من أوجه المكعب الستة يحتوي lat/lon قبل حساب معرّفات خلايا S2 الهرمية أو تغطيات المناطق في عامل لا يستطيع تحميل مكتبة S2 كاملة.

تعليم الشبكات العالمية المنفصلة

اسمح للطلاب بإرسال إحداثيات مدن والتحقق من فهرس الوجه مقابل عرافة تطابق قاعدة أكبر مكوّن مطلق لدى Google، بما في ذلك القطبين ولحامات الأوجه.

تجميع جغرافي خشن

جمّع أحداث GPS حسب وجه S2 للوحات التوجيه أو تقسيمات الجغرافيا A/B دون حساب معرّفات خلايا كاملة لكل عينة.

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

كيف أحدد وجه مكعب S2 لخط عرض وخط طول؟

أرسل lat منتهيًا في [-90, 90] و lon في [-180, 180].

ماذا تعني الأوجه من 0 إلى 5؟

تطابق اصطلاح S2 لدى Google: 0=+X، 1=+Y، 2=+Z (شمال)، 3=-X، 4=-Y، 5=-Z (جنوب). الاختيار هو أكبر مكوّن ديكارتي مطلق للمتجه الوحدوي.

ما u و v في الاستجابة؟

تُموضع إحداثيات UV النقطة على وجه المكعب المختار في المجال [-1, 1] باستخدام اصطلاحات الإشارة ValidFaceXYZToUV نفسها لدى S2.

ماذا يحدث إذا كان خط العرض أو الطول خارج النطاق؟

يجب أن يكون خط العرض في [-90, 90] وخط الطول في [-180, 180]؛ الطلبات غير الصالحة لا تُفوتر.

أي وجه تأخذه نقطة تقع تمامًا على الحافة بين وجهين؟

يُحسم التعادل دائمًا بالطريقة نفسها: إذا تساوى مكوّنان من المتجه الأحادي في الكبر، يفوز المحور ذو الرقم الأعلى. وهكذا لا تتنقل نقاط الحواف بين وجهين من حساب إلى آخر.

أدوات ذات صلة

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

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

الـEndpoint

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

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

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

curl -X POST https://api.kit.forhosting.com/geo/s2-face-from-latlon \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat":37.7749,"lon":-122.4194}'

const res = await fetch("https://api.kit.forhosting.com/geo/s2-face-from-latlon", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "lat": 37.7749,
    "lon": -122.4194
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/s2-face-from-latlon",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "lat": 37.7749,
    "lon": -122.4194
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"lat":37.7749,"lon":-122.4194}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/s2-face-from-latlon", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "lat": 37.7749,
  "lon": -122.4194
}

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

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

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

الخوارزمية رياضيات تحليلية خالصة بلا استدعاءات شبكة ولا حالة عشوائية، لذا يتطابق المسار المجاني في المتصفح ومسار API المدفوع دائمًا.

عقد الإدخال وحقول الاستجابة وأخطاء التحقق

مثال: سان فرانسيسكو قرب خط عرض 37.7749 وخط طول سالب 122.4194 تقع على الوجه أربعة (ناقص Y) لأن أكبر مكوّن مطلق للمتجه الوحدوي هو y سالب. القطب الشمالي (خط عرض 90، خط طول 0) يقع على الوجه اثنين (زائد Z). خط الطول صفر عند خط الاستواء (خط عرض 0، خط طول 0) يقع على الوجه صفر (زائد X). اقرن هذه الاستجابة بمشفّر خلايا S2 خاص بكم إن احتجتم معرّفات خلايا كاملة؛ هذه النقطة الطرفية تحدد الوجه وموضع UV عليه فحسب. أرسل عبر POST جسم JSON يحتوي عددين منتهيين إلزاميين: lat (أو الاسم البديل latitude) بين ناقص تسعين وتسعين شمولًا، و lon (أو البدائل lng و longitude) بين ناقص مئة وثمانين ومئة وثمانين شمولًا. تُقبل السلاسل الرقمية كما تُقبل أعداد JSON. الحقول الناقصة والسلاسل الفارغة والقيم غير المنتهية مثل NaN أو Infinity وخطوط العرض أو الطول خارج النطاق تفشل بـ invalid_input ولا تُفوتر. عند النجاح تعيد الاستجابة lat و lon منظّفين والعدد الصحيح face من صفر إلى خمسة و face_name واحدًا من +X أو +Y أو +Z أو -X أو -Y أو -Z ومكوّنات المتجه الوحدوي x و y و z وزوج UV المحلي للوجه u و v و method مضبوطًا على s2_face_from_unit_sphere ليوثّق العملاء الإسقاط المستخدم.

أين تثبت جدوى استعلام وجه S2

ولأن التنفيذ parse خالص من المستوى A، يكلف كل استدعاء ناجح السعر الأساسي المنشور $0.002 بلا رموز نموذج ولا شبكة صادرة.

أسئلة تقنية

كم تكلفة أداة وجه مكعب S2 من lat/lon؟

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

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

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

مثال محلول

كيف يتحوّل خط العرض/الطول إلى وجه مكعب S2

أين تثبت جدوى استعلام وجه S2

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

مقدمة ترميز خلايا S2

تعليم الشبكات العالمية المنفصلة

تجميع جغرافي خشن

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

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

عقد الإدخال وحقول الاستجابة وأخطاء التحقق

أين تثبت جدوى استعلام وجه S2

أسئلة تقنية

شكرًا