مرجع سريع حول Directions API

‫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 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.