خرائط ياندكس
خريطة الأسطول والعمل مع العناوين عبر خرائط ياندكس. يستخدم الترميز الجغرافي على الخادم والخريطة في المتصفح مفتاحين مختلفين.
افتح Integrations → إضافة تكامل → خرائط ياندكس. للاتصال المثبّت مسبقًا استخدم إعداد.
التحضير
- في حساب مطوّر Yandex أنشئ مفتاح JavaScript API ومفتاح API الخادم المطلوب.
- قيّد مفتاح المتصفح بالنطاقات/Referer، ومفتاح الخادم بشبكات IP، إذا كانت الباقة وAPI تدعمان ذلك.
- حدّد لغة الخريطة بصيغة language_REGION والمنطقة الافتراضية والحد اليومي.
- احفظ المفاتيح وتحقق من الخريطة ومن بحث العناوين على الخادم كلًّا على حدة.
المعلمات
| الحقل | النوع | الغرض وقواعد التعبئة |
|---|---|---|
| المنطقة الافتراضية | إعداد | رمز المنطقة الذي تستخدمه الواجهة لترجيح النتائج، مثل MD. |
| لغة الخريطة | إعداد | اللغة والمنطقة بصيغة language_REGION، مثل ru_RU أو en_US، مما تدعمه Yandex Maps API. |
| الحد اليومي | إعداد | الحد الأقصى للطلبات يوميًا: عدد صحيح من 1 إلى 100000، لا يتجاوز حصة باقتكم لدى Yandex. |
| شبكات IP المسموح بها للخادم | إعداد | أدخل كل شبكة في سطر جديد بصيغة CIDR، مثل 8.8.8.8/32. اعرف عناوين الخادم العامة من مسؤول البنية التحتية. |
| عناوين لوحة الإدارة المسموح بها | إعداد | أدخل كل عنوان في سطر جديد، مثل https://admin.example.com، بدون مسار ومعلمات؛ ويجب أن تطابق قيد Referer. |
| مفتاح API للخادم | سر | المفتاح السري لـ Yandex API على الخادم، مثل Geocoder API؛ لا تستخدمه في المتصفح. |
| مفتاح API للمتصفح | سر | مفتاح Yandex Maps JavaScript API المقيّد بالنطاقات/Referer. |
الحفظ والتعديل
املأ المعلمات وانقر «حفظ». عند إعادة الفتح لا تُعرض الأسرار: مؤشر وجود السر ليس قيمته. الحقل الفارغ لسر موجود يحتفظ بالقيمة السابقة؛ والقيمة الجديدة تستبدلها. بعد التعديل تحقق من الاتصال من جديد.
نوع خرائط ياندكس متاح في كتالوج التكاملات الكامل.
التحقق من النتيجة
- تحقق من ظهور الخريطة في بطاقة الجهاز.
- تحقق من بحث العناوين على حدة: ظهور الخريطة بنجاح لا يثبت عمل Geocoder API.
- طابق نطاقات/Referer لمفتاح المتصفح وشبكات الإخراج العامة لمفتاح الخادم مع معلمات حساب ياندكس.
تعني الحالة «Configured» أن الإعدادات محفوظة. قيّم نتيجة فحص الاتصال ونتيجة العملية المستهدفة كلًّا على حدة. تتوفر تفاصيل الفحص في بطاقة الاتصال.
القيود والتبعيات
الحد اليومي في النموذج عدد صحيح من 1 إلى 100000. ويسري ضمن حصة المزوّد. تُدخل قائمة العناوين وCIDR بقيمة واحدة في كل سطر. اللغات المتاحة: ru_RU وen_US وen_RU وuk_UA وbe_BY وtr_TR.
عند عدم العمل
| العرض | ما يجب فحصه |
|---|---|
| خلفية الخريطة فارغة | تحقق من مفتاح المتصفح والوصول إلى JavaScript API وقيود Referer. |
| خطأ في بحث العناوين | تحقق من مفتاح الخادم والوصول إلى Geocoder API وCIDR والحصص. |
| توقف العمل بعد نقل لوحة الإدارة | حدّث العناوين المسموح بها في MDM وعند المزوّد؛ فمسار الصفحة ليس origin. |