اختصار Plus Code
بالقرب من النقطة المرجعية 47.5 و8.5، يُختصر رمز Plus الكامل 8FVC9G8F+6X إلى 9G8F+6X: تُحذف الأحرف الأربعة الأولى لأن المنطقة القريبة توفرها. ولا يُحذف إلا ما يمكن استعادته بأمان. مجاني في متصفحك.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
مثال محلول
- الرمز
- 8FVC9G8F+6X
- خط العرض
- 47.5
- خط الطول
- 8.5
- الرمز المختصر
- 9G8F+6X
- الرمز الكامل
- 8FVC9G8F+6X
- الأحرف المحذوفة
- 4
- طول الرمز
- 10
تحوّل رموز Open Location Codes، المعروفة أيضًا بـ Plus Codes، خط العرض وخط الطول إلى سلاسل قصيرة يمكن نطقها وكتابتها وطباعتها دون أرقام شوارع. الرمز الكامل مثل eight F V C nine G eight F plus six X فريد عالميًا، لكن المشاركة اليومية تتم غالبًا داخل مدينة أو حي معروفين، حيث تتكرر الأزواج الأولى ويحدد المقطع الختامي النقطة فقط. يقبل مختصِر Plus Code هذا رمزًا كاملًا صالحًا مع خط عرض وخط طول مرجعيين قريبين، ويقيس قرب المرجع من مركز الخلية، ويحذف أكبر عدد من أزواج الأحرف الأولى تسمح به قاعدة الأمان في Open Location Code.
كيف يعمل اختصار Plus Code بالنسبة إلى موقع مرجعي
يرمّز Open Location Code الكامل خلية مستطيلة على الأرض بأبجدية عشرين حرفًا من اثنين إلى تسعة و C F G H J M P Q R V W X، مع فاصل زائد إلزامي بعد ثمانية أحرف. تشكّل الأرقام العشرة الأولى ذات الدلالة أزواج خط عرض وخط طول تصغّر الخلية بعوامل متتالية من عشرين؛ وتزيد أرقام شبكة اختيارية بعد الفاصل من الدقة. عندما تشاركون موقعًا داخل منطقة معروفة، غالبًا ما تتطابق الأحرف الأربعة أو الستة الأولى لكل الأماكن القريبة، فتضيف ضوضاء لا قيمة.
لا يقتصر الاختصار على حذف بادئة ثابتة: يفك الرمز الكامل إلى مركز خليته، ويقارن ذلك المركز بخط العرض وخط الطول المرجعيين بمقياس تشيبيشيف (أقصى فرق مطلق لخط العرض ولخط الطول بالدرجات)، ويمر على جدول دقة ثابت من عشرين، وواحد، وصفر فاصلة صفر خمسة، وصفر فاصلة صفر صفر اثنين خمسة، وصفر فاصلة صفر صفر صفر واحد اثنين خمسة درجات. كلما كان المدى أقل من ثلاثين بالمئة من دقة زوج معيّن، يجوز للخوارزمية حذف الأزواج الأولى المقابلة.
عامل الثلاثين بالمئة هامش أمان متعمّد كي يبقى الرمز القصير الأقرب عند استعادته لاحقًا من مركز مدينة أو قراءة GPS مختلفين قليلًا. إذا كان المرجع بعيدًا لا تُحذف أزواج ويُعاد الرمز الكامل دون تغيير. لا يمكن اختصار الرموز المبطّنة التي تصف منطقة كبيرة فقط (بأصفار قبل الفاصل) لأنها تفتقر إلى أرقام دقة كافية للقص الآمن.
تنفّذ القدرة هذا المسار الحسابي الصرف فقط: لا تبحث عن أسماء أماكن ولا تستدعي واجهات خرائط ولا تخترع تسميات محلية ينبغي أن تضيفوها بأنفسكم.
عقد الإدخال وشكل الاستجابة وسلوك الأخطاء
تُرفض الرموز المبطّنة بأصفار قبل الفاصل برسالة أنها لا تُختصر. يُقيَّد خط العرض بالفترة المغلقة من سالب تسعين إلى تسعين؛ ويُطبَّع خط الطول في الفترة نصف المفتوحة من سالب مئة وثمانين إلى مئة وثمانين. الحقول الناقصة والسلاسل الفارغة والأعداد غير المحدودة تفشل برسائل تسمي الحقل ولا تُحسب.
مثال: الرمز eight F V C nine G eight F plus six X مع خط عرض مرجعي سبعة وأربعين نقطة خمسة وخط طول ثمانية نقطة خمسة ينتج الرمز القصير nine G eight F plus six X بعد حذف الأحرف الأربعة الأولى. اقرنوا الرمز القصير بسلسلة محلية في واجهتكم؛ لا يُصدر هذا الطرف أسماء مدن أبدًا.
أين يثبت مختصِر Plus Code جدواه
تخزّن تطبيقات التوصيل والخدمة الميدانية واللوجستيات بالفعل Open Location Codes كاملة لأبواب بلا أرقام شوارع؛ وعندما تطبع ملصقًا أو ترسل SMS داخل مدينة معروفة تحتاج الشكل القصير الذي يعرفه السائقون من Google Maps وplus.codes. تشارك سير عمل الاستجابة للكوارث والخرائط الإنسانية ملاجئ مؤقتة ونقاط مياه كرموز قصيرة مع اسم مخيم أو حي، ويضمن مختصِر حتمي أن يتفق كل عميل —حزمة جوال دون اتصال أو edge worker أو استيراد جدول— على نفس القص لنفس المرجع.
تستفيد مواقع المحتوى التي تستهدف اختصار plus code أو رمز موقع مفتوح قصير من ودجت مباشر يطابق مساره المجاني في المتصفح المسار الآلي المدفوع بايتًا ببايت على الوحدة الصرفة نفسها. يمكن للمطورين الذين يدمجون OLC في النماذج التحقق والاختصار في استدعاء واحد دون شحن مكتبة open-location-code كاملة لكل عميل. التحقق الفاشل لا يستهلك الرصيد.
حالات الاستخدام
مشاركة عبر SMS وملصقات في مدينة معروفة
حوّلوا Plus Code كاملًا مخزّنًا إلى رمز قصير بجانب اسم مدينة أو حي ليرى السائقون والعملاء الشكل المدمج الذي يستخدمونه بالفعل في تطبيقات الخرائط.
حزم خرائط دون اتصال وإنسانية
ولّدوا نفس الرموز القصيرة دون اتصال للملاجئ ونقاط الإمداد بمرجع lat/lon للمخيم، حتى يستعيد كل جهاز لاحقًا نفس الرمز الكامل الأقرب.
الأسئلة الشائعة
كيف أختصر Plus Code بموقع مرجعي؟
أرسلوا Open Location Code كاملًا في code مع خط عرض وخط طول مرجعيين محدودين.
هل يمكن اختصار رمز قصير أو رمز منطقة مبطّن؟
لا. يجب أن يكون الإدخال رمزًا كاملًا صالحًا بلا أصفار حشو.
ما مدى القرب المطلوب للنقطة المرجعية؟
قريبة من مركز خلية الرمز. لا تُحذف الأزواج الأولى إلا ما دام الفرق، مقيسًا بالأكبر بين فرقي خط العرض وخط الطول، أقل من ثلاثين بالمئة من حجم خلية ذلك الزوج، وهو هامش أمان للاستعادة لاحقًا.
لماذا عاد رمز Plus من دون اختصار؟
لأن النقطة المرجعية بعيدة جدًا عن موقع الرمز بحيث لا يمكن حذف أي شيء بأمان. في هذه الحالة يُعاد الرمز الكامل كما هو، وتوضح النتيجة أنه لم يُحذف أي حرف.
هل أضيف اسم المكان إلى الرمز القصير؟
نعم. لا يعمل الرمز القصير إلا مع المدينة أو الحي الذي اختُصر له، فشاركه مع ذلك الاسم. لا تبحث الأداة عن أسماء الأماكن ولا تخترعها، بل تضيف أنت اسم المنطقة بنفسك.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/geo/plus-code-shorten \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"code":"8FVC9G8F+6X","latitude":47.5,"longitude":8.5}'const res = await fetch("https://api.kit.forhosting.com/geo/plus-code-shorten", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"code": "8FVC9G8F+6X",
"latitude": 47.5,
"longitude": 8.5
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/geo/plus-code-shorten",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"code": "8FVC9G8F+6X",
"latitude": 47.5,
"longitude": 8.5
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/plus-code-shorten", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"code":"8FVC9G8F+6X","latitude":47.5,"longitude":8.5}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"code":"8FVC9G8F+6X","latitude":47.5,"longitude":8.5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/plus-code-shorten", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"code": "8FVC9G8F+6X",
"latitude": 47.5,
"longitude": 8.5
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.plus_code_shorten",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
ملاحظات تقنية
النتيجة رمز قصير مدمج جاهز للربط باسم مكان، بينما تُعيد API أيضًا ما إذا تم الاختصار وعدد الأحرف المحذوفة والمدى الزاوي المستخدم. تفشل الرموز الكاملة غير الصالحة ورموز المناطق المبطّنة والإحداثيات الناقصة بأخطاء invalid_input واضحة بدل اختراع جزء غامض.
عقد الإدخال وشكل الاستجابة وسلوك الأخطاء
أرسلوا عبر POST جسم JSON بثلاثة حقول إلزامية: code سلسلة Open Location Code كاملة مثل eight F V C nine G eight F plus six X؛ وlatitude خط عرض مرجعي محدود بدرجات عشرية موقّعة؛ وlongitude خط طول مرجعي محدود بدرجات عشرية موقّعة. تُقبل أسماء بديلة للراحة: plus_code أو olc أو full_code أو location_code للرمز؛ وlat أو ref_latitude أو reference_latitude لخط العرض؛ وlon أو lng أو ref_longitude أو reference_longitude لخط الطول. يُقص الرمز ويُحوَّل إلى أحرف كبيرة؛ تُرفض الرموز القصيرة (فاصل قبل الموضع الثامن) والسلاسل التي تخالف قواعد صلاحية Open Location Code بـ invalid_input مع تسمية الحقل. عند النجاح يعيد الجسم الرمز الكامل المطَبَّع والإحداثيات المنظّفة وshort_code (قد يساوي الرمز الكامل عند تعذّر قص آمن) وwas_shortened كقيمة منطقية وcharacters_removed كعدد صحيح غير سالب وcode_length بعدد الأرقام ذات الدلالة للإدخال وshort_length لنسخة القصيرة وrange_degrees لمدى تشيبيشيف المقرّب لـ goldens مستقرة وmethod بقيمة olc_shorten.
أين يثبت مختصِر Plus Code جدواه
ولأن التنفيذ parse صرف من المستوى A، تكلف كل مكالمة ناجحة السعر الأساسي المنشور $0.002 بلا رموز نموذج ولا شبكة صادرة. أبقوا الطلبات صغيرة وثبّتوا short_code وcharacters_removed في الاختبارات لتحصلوا على Plus Codes قصيرة قابلة للتكرار للملصقات وروبوتات الدردشة وedge workers دون بنية ترميز جغرافي خاصة بكم.
حالات التكامل
الخدمة الميدانية وتوصيل الميل الأخير
اختصروا رموز OLC على مستوى الباب بالنسبة لمركز مستودع أو منطقة قبل طباعة أوامر العمل، دون استدعاء API خرائط خارجية.
أسئلة تقنية
ماذا لو كان المرجع بعيدًا عن الرمز؟
لا تُحذف أزواج أولى. يساوي short_code الرمز الكامل، وwas_shortened يساوي false، وcharacters_removed يساوي صفرًا، فلا ترسلون جزءًا غامضًا.
هل تضيف API اسم مدينة بعد الرمز القصير؟
لا. تقتطع أحرف OLC الأولى فقط. أضيفوا أنتم تسمية محلية (مدينة أو حي أو مخيم) عند عرض الرمز القصير أو إرساله.
كم يكلف مختصِر Plus Code؟
أداة المتصفح مجانية. تستخدم طلبات API رصيد KIT المدفوع مسبقًا بمبلغ $0.002 لكل استدعاء ناجح؛ الإدخال غير الصالح لا يُحسب.