ما هي أهمية نقل البيانات إلى Routes API؟

توفّر Routes API أداءً مُحسَّنًا لحساب الاتجاهات والمسافة ومدّة الرحلة، ما يجعلها مفيدة لاستبدال التطبيقات التي تستخدم حاليًا واجهة برمجة التطبيقات Directions API وواجهة برمجة التطبيقات لمصفوفة المسافات. تتوافق معظم وظائف Routes API مع كل من واجهة برمجة التطبيقات Directions API وواجهة برمجة تطبيقات مصفوفة المسافة.

يمكنك استخدام هذا الدليل لفهم الاختلافات الرئيسية في Routes API مقارنةً بالمنتجات التي يتم استبدالها، بالإضافة إلى كيفية التعامل مع التغييرات الضرورية. للمزيد من التفاصيل حول ميزات Routes API الأخرى، يمكنك الاطّلاع على نظرة عامة على المنتج.

التحسينات الرئيسية

يتناول هذا القسم بعض التحسينات التي يمكنك توقّعها عند استخدام Routes API في تطبيقاتك.

زيادة الحدود القصوى المسموح بها للطلبات

Routes API
  • الحد الأقصى هو 625 عنصرًا، ما لم يتم تحديد TRAFFIC_AWARE_OPTIMAL.
  • الحد الأقصى هو 100 عنصر مع TRAFFIC_AWARE_OPTIMAL. راجِع الإعدادات المفضّلة للتوجيه المحسَّن.
  • الحد الأقصى هو 50 نقطة طريق (المصادر + الوجهات) باستخدام رقم تعريف مكان.
واجهة برمجة التطبيقات لمصفوفة المسافات
  • الحد الأقصى هو 25 وجهة أو 25 وجهة لكل طلب.
  • الحدّ الأقصى هو 100 عنصر (عدد المصادر × عدد الوجهات) لكل طلب من جهة الخادم.

ردود أسرع على الطلبات

تقدم ميزة مصفوفة المسارات الحوسبية تحسينات وقت الاستجابة التالية:

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

تحسينات على التوجيه

تقدم ميزة مسار الحوسبة تحسينات التوجيه التالية:

  • معلومات رسوم المرور بالإضافة إلى المسافة والوقت المقدر للوصول.
  • مسارات المركبات ذات العجلتين.
  • حدِّد نقاط توقفك على الطريق لمراعاة السلامة.
  • زيادة دقة الوقت المقدر للوصول عن طريق تعيين اتجاه السفر وجانب الطريق لنقاط الطريق.

طلب البيانات التي تحتاج إليها فقط

يمكنك الآن تحديد الحقول المطلوب عرضها، ما يقلل وقت المعالجة ورسوم الفوترة.

Routes API يجب أن تستخدم طلباتك قناع حقل لتحديد الحقول التي تريد عرضها في الردّ. يضمن إخفاء الحقول عدم طلب بيانات غير ضرورية، ما يؤدي إلى تجنُّب وقت المعالجة غير الضروري ورسوم الفوترة.
لمزيد من المعلومات، راجِع اختيار الحقول المطلوب عرضها.
Directions API
واجهة برمجة التطبيقات لمصفوفة المسافات 		يتم عرض قائمة تلقائية للحقول، حتى إذا لم يكن تطبيقك بحاجة إليها بشكل صارم. وقد يؤدي ذلك إلى مدة غير ضرورية للمعالجة ورسوم فوترة.

حسابات محسَّنة للمسارات لحركة المرور

تتيح Routes API ثلاثة إعدادات مفضّلة للتوجيه يمكنك استخدامها لتحقيق التوازن بين وقت استجابة الاستجابة وجودة البيانات عند طلب معلومات عن حركة المرور.

لمزيد من المعلومات، يُرجى الاطِّلاع على ضبط الجودة مقابل وقت الاستجابة.

TRAFFIC_UNAWARE
(الخيار التلقائي)		 يتم استخدام متوسط بيانات حركة المرور التي لا تعتمد على الوقت، وليس بيانات حركة المرور المباشرة، لاحتساب المسار، ما يؤدي إلى تقليل وقت الاستجابة للاستجابة. يعادل هذا الإعداد الحالات التي لا تُستخدم فيها الزيارات في واجهة برمجة التطبيقات Directions API وواجهة برمجة التطبيقات لمصفوفة المسافات.
TRAFFIC_AWARE
(جديدة)		 جودة الزيارات المباشرة محسَّنة للأداء بهدف تقليل وقت الاستجابة. على عكس TRAFFIC_AWARE_OPTIMAL، يطبِّق هذا الإعداد تحسينات لتقليل وقت الاستجابة بشكل كبير. هذا الإعداد جديد أيضًا في Routes API بدون مكافئ في واجهة برمجة التطبيقات Directions API أو واجهة برمجة التطبيقات لمصفوفة المسافات.
TRAFFIC_AWARE_OPTIMAL بيانات عالية الجودة وشاملة عن عدد الزيارات ينتج عن هذا الإعداد أعلى وقت استجابة ويعادل الإعداد departure_time في واجهة برمجة التطبيقات Directions API وواجهة برمجة التطبيقات لمصفوفة المسافات.
هذا الخيار المفضّل مكافئ للوضع المستخدَم في maps.google.com وتطبيق "خرائط Google" المتوافق مع الأجهزة الجوّالة.

مقارنة العمليات الحسابية للمسارات

يقارن الجدول التالي خيارات التوجيه بين خدمات Routes API وDirections API وواجهة برمجة التطبيقات لمصفوفة المسافات.

خيار حركة المرور Routes API Directions API
واجهة برمجة التطبيقات لمصفوفة المسافات		 وقت الاستجابة
ما مِن حركة مرور في الوقت الفعلي TRAFFIC_UNAWARE لم يتم ضبط سمة واحدة (departure_time). أسرع وقت استجابة بين الأوضاع الثلاثة.
تم تطبيق ظروف حركة المرور المباشرة TRAFFIC_AWARE بدون مكافئ

تمت إضافة الوضع الجديد من خلال Routes API. إنّها وقت استجابة أطول قليلاً من TRAFFIC_UNAWARE مع تكلفة ضئيلة لجودة الوقت المقدّر للوصول.

ويستغرق وقت الاستجابة أقل بكثير من TRAFFIC_AWARE_OPTIMAL.
تطبيق بيانات عالية الجودة وشاملة عن الزيارات المباشرة TRAFFIC_AWARE_OPTIMAL تم ضبط سمة واحدة (departure_time).

يعادل الوضع المستخدم في maps.google.com وتطبيق "خرائط Google" المتوافق مع الأجهزة الجوّالة.

بالنسبة إلى مصفوفة مسار Compute، لا يمكن أن يتجاوز عدد العناصر في الطلب (عدد المصادر × عدد الوجهات) 100.

الاختلافات الرئيسية

يتناول هذا القسم الاختلافات الرئيسية بين Routes API والخدمات التي تحل محلها، بالإضافة إلى طرق معالجة هذه الاختلافات عند نقل البيانات من هذه الخدمات في تطبيقاتك الحالية.

الاتصال بخدمة واحدة بدلاً من خدمتَين

Routes API يُرجى تفعيل خدمة واحدة فقط في وحدة تحكُّم واجهة برمجة التطبيقات لتطبيقك من أجل استخدام Compute Routes وCompute Route Matrix.
لمزيد من المعلومات، يُرجى الاطّلاع على عملية الإعداد في وحدة التحكم في واجهة Google API.
Directions API
واجهة برمجة التطبيقات لمصفوفة المسافات 		فعِّل خدمتَين: واجهة برمجة التطبيقات للاتجاهات وواجهة برمجة التطبيقات لمصفوفة المسافات كخدمتَين منفصلتَين في وحدة تحكّم واجهة برمجة التطبيقات.

يستخدم HTTPS POST طلبات.

Routes API تمرير المعلَمات في نص الطلب أو في العناوين كجزء من طلب HTTP POST
للحصول على أمثلة، راجِع:
- حساب مسار
- حساب مصفوفة مسار
Directions API
واجهة برمجة التطبيقات لمصفوفة المسافات 		تمرير مَعلمات عناوين URL باستخدام طلب HTTP GET

الاختلافات في استجابة الوقت المقدر للوصول

تعرض Routes API معلومات الوقت المقدّر للوصول وتستخدم خاصية الاستجابة duration بشكل مختلف عن خدمتَي واجهة برمجة التطبيقات Directions API وواجهة برمجة التطبيقات لمصفوفة المسافات كما هو موضّح في الجدول أدناه.

نوع الوقت المقدّر للوصول Routes API Directions API
واجهة برمجة التطبيقات لمصفوفة المسافات
لا تكون حركة المرور على دراية، والوقت المقدر للوصول غير مدرَّب.

اضبط باستخدام TRAFFIC_UNAWARE.

  • تم تضمين الوقت المقدّر للوصول في سمة الاستجابة duration.
  • تحتوي سمتا الاستجابة duration وstaticDuration على القيمة نفسها.

يتطابق مع عدم ضبط departure_time في الطلب.

  • تم تضمين الوقت المقدّر للوصول في سمة الاستجابة duration.
  • لا يتم عرض سمة الاستجابة duration_in_traffic.
الوقت المقدر للوصول الذي يأخذ في عين الاعتبار حركة المرور في الوقت الفعلي.

اضبط باستخدام TRAFFIC_AWARE أو TRAFFIC_AWARE_OPTIMAL.

  • ويتم تضمين الوقت المقدر للوصول مع مراعاة حركة المرور في الوقت الفعلي في خاصية الاستجابة duration.
  • تتضمن سمة الاستجابة staticDuration مدة التنقّل في المسار بدون مراعاة أحوال حركة المرور.
  • لم تعُد السمة duration_in_traffic يتم عرضها.

يتم الضبط باستخدام departure_time في الطلب.

  • ويتم تضمين الوقت المقدر للوصول مع مراعاة حركة المرور في الوقت الفعلي في خاصية الاستجابة duration_in_traffic.

نقاط الطرق المتعددة الخطوط

لم تعُد بحاجة إلى تحويل إحداثيات خط العرض/خط الطول إلى نقاط طرق متعددة باستخدام هذه الخدمة التي تتيح نص طلب POST، وبالتالي لم تعد تتأثر بحدود سلسلة عنوان URL. عالج بعض مستخدمي واجهة برمجة تطبيقات مصفوفة المسافة مشكلة حدود الطلب من خلال تحويل نقاط خطوط الطول/العرض إلى نقاط طرق متعددة الخطوط.

العناوين المنسَّقة (الترميز الجغرافي العكسي)

لم تقدّم Routes API عناوين منسّقة في الردّ. وللحصول على عناوين منسَّقة، استخدِم واجهة برمجة تطبيقات الترميز الجغرافي التي تم إنشاؤها لحالة الاستخدام هذه، كما تقدّم نتائج ذات جودة أعلى.

وسائل النقل المتاحة

كما هي الحال مع واجهة برمجة تطبيقات الاتجاهات، تستخدم Routes API DRIVE كوضع تلقائي عندما لا يحدّد طلب المسار وضع سفر. ومع ذلك، عندما يحدّد أحد الطلبات وضع سفر لمسار ما، لا تعرض Routes API مجموعة من أوضاع السفر المتاحة كاختيارات بديلة للطلب. إذا كانت حالة استخدامك للميزة تعتمد على هذه الميزة، يُرجى الإبلاغ عن مشكلة مع وصف طريقة استخدامك للميزة، حتى نتمكّن من المتابعة.

XML كتنسيق رد

لا توفّر Routes API تنسيق XML. يمكنك العثور على عدد من برامج تحويل JSON إلى XML على الإنترنت والتي تناسب أغراضك.