Directions API (الإصدار القديم) هي خدمة ويب تحسب الاتجاهات بين المواقع الجغرافية للقيادة والمشي وركوب الدراجات والنقل العام، بما في ذلك المسارات المتعدّدة الأجزاء التي تتضمّن نقاطًا على المسار، وتعرض المسارات والأقسام والخطوات بتنسيق JSON أو XML. وهي في الحالة "قديمة": اعتبارًا من أكتوبر 2026، لن يكون من الممكن تفعيلها لمشاريع على السحابة الإلكترونية جديدة على Google Cloud، لذا عليك نقل البيانات إلى Routes API.
Directions API: حقائق رئيسية
- المنتج: Directions API
- المعروفة أيضًا باسم: Directions API (القديمة)
- الفئة: المسارات
- المنصة: خدمة ويب (REST)
- يتم تشغيله على: الخادم (رمز الخلفية)
- مرحلة الإطلاق: GA
- دورة الحياة: قديمة
- تم استبدالها بـ: Routes API
- نظرة عامة: نظرة عامة على Directions API
- نطاق التوفّر الجغرافي: على مستوى العالم تختلف التغطية حسب المنطقة ووضع السفر (يعتمد النقل العام على البيانات الواردة من مقدّمي خدمات النقل العام). (تفاصيل التغطية)
Directions API: حالات الاستخدام
استخدِم Directions API في الحالات التالية:
- لديك مشروع حالي على Google Cloud تم فيه تفعيل Directions API (الإصدار القديم) وإجراء طلبات
maps/api/directions. - تحتاج إلى اتجاهات من جهة الخادم للقيادة أو المشي أو ركوب الدراجات أو النقل العام (نقاط على المسار لوسائل النقل غير العام فقط)، بتنسيق JSON أو XML، في مشروع حالي.
لا تستخدِم Directions API في الحالات التالية:
- إذا كنت تبدأ مشروعًا جديدًا على Google Cloud، اعتبارًا من أكتوبر 2026، لن يكون بإمكانك تفعيل Directions API (الإصدار القديم) للمشاريع الجديدة. استخدِم Routes API بدلاً من ذلك.
- تحتاج إلى ميزات توجيه جديدة وأداء محسّن. استخدِم Routes API بدلاً من ذلك.
- تحتاج إلى مُدد الرحلات والمسافات بين العديد من نقاط الانطلاق والوجهات في طلب واحد. استخدِم Routes API بدلاً من ذلك.
Directions API: الإعداد
- الخدمة المطلوب تفعيلها:
directions-backend.googleapis.com - المصادقة: مفتاح واجهة برمجة التطبيقات
- البدء: إعداد Directions API
- المرجع: مرجع Directions API
- الأسعار: استخدام Directions API والفوترة
- السياسات: سياسات Directions API
- ملاحظات الإصدار: ملاحظات إصدار Directions API
Directions API: الأخطاء الشائعة
- المشكلة: يتعذّر تنفيذ الطلبات المُرسَلة إلى Directions API (الإصدار القديم) من مشروع لم يتم فيه تفعيل واجهة برمجة التطبيقات القديمة، ويظهر الخطأ
LegacyApiNotActivatedMapError. الحلّ: إذا كنت تملك التطبيق، عليك نقل البيانات إلى Routes API. كحلّ قصير المدى أثناء نقل البيانات أو انتظار تحديث التطبيق، يمكنك تفعيل واجهة برمجة التطبيقات القديمة من خلال إكمال نموذج تفعيل واجهة برمجة التطبيقات القديمة. يُرجى الاطّلاع على /maps/legacy. - المشكلة: يؤدي استخدام البادئة
via:في النقاط على المسار إلى جعلها نقاط مرور صارمة، ما قد يؤدي إلى حدوث انحرافات شديدة أو ظهور الحالةZERO_RESULTS. الحلّ: استخدِم نقاط توقّف على المسار (بدون البادئةvia:) ما لم تكن هناك حاجة إلى نقطة مرور صارمة. يُرجى الاطّلاع على /maps/documentation/directions/get-directions. - المشكلة: تتم فوترة الطلبات التي تتضمّن من 11 إلى 25 نقطة على المسار، أو
optimize:true، أو مُددًا تراعي حركة المرور (duration_in_traffic)، أو مُعدِّلات الموقع الجغرافيside_of_roadأوheading، وفقًا لرمز التخزين التعريفي الأعلى Directions Advanced (Pro). الحلّ: استخدِم هذه الميزات عند الحاجة إليها فقط، واضبط عدد النقاط على المسار على 10 أو أقل، واحذفoptimize:trueوdeparture_time(للقيادة) وside_of_roadوheadingللبقاء في رمز التخزين التعريفي Essentials. يُرجى الاطّلاع على /maps/billing-and-pricing/sku-details/legacy#directions-advanced-pro-sku. - المشكلة: بالنسبة إلى القيادة، لا يمكن أن يكون
departure_timeفي الماضي (يفشل الطلب معINVALID_REQUEST). بدونdeparture_time، يستخدم المسار والمدة متوسط عدد الزيارات غير المرتبط بالوقت، ولا يتم عرض أيduration_in_traffic. الحلّ: اضبط السمةdeparture_timeعلىnowأو على وقت مستقبلي باستخدام السمةmode=drivingللحصول علىduration_in_traffic. تتم فوترة الطلبات التي تعرضduration_in_trafficوفقًا لرمز التخزين التعريفي Directions Advanced (Pro). يُرجى الاطّلاع على /maps/documentation/directions/get-directions.