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

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

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

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

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

زيادة حدود الطلبات

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

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

توفّر ميزة Compute Route Matrix التحسينات التالية في وقت الاستجابة:

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

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

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

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

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

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

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

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

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

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

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

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

يقارن الجدول التالي خيارات التوجيه بين Routes API وخدمتَي Directions API وDistance Matrix API.

خيار حركة المرور	Routes API	‫Directions API Distance Matrix API	وقت الاستجابة
لا تتوفّر حركة المرور في الوقت الفعلي	TRAFFIC_UNAWARE	لم يتم ضبط السمة departure_time	أسرع وقت استجابة من بين الأوضاع الثلاثة
تم تطبيق ظروف حركة المرور المباشرة	TRAFFIC_AWARE	بدون مكافئ	وضع جديد أضافته Routes API يوفّر هذا الوضع وقت استجابة أطول قليلاً من TRAFFIC_UNAWARE مع تكلفة صغيرة لجودة الوقت المقدَّر للوصول. ويكون وقت الاستجابة أقل بكثير من TRAFFIC_AWARE_OPTIMAL.
تم تطبيق بيانات حركة مرور شاملة ومباشرة وعالية الجودة	TRAFFIC_AWARE_OPTIMAL	تم ضبط السمة departure_time	يتطابق هذا الوضع مع الوضع الذي يستخدمه كلٌّ من maps.google.com وتطبيق "خرائط Google" للأجهزة الجوّالة. بالنسبة إلى Compute Route Matrix، لا يمكن أن يتجاوز عدد العناصر في الطلب (عدد نقاط الانطلاق × عدد الوجهات) 100.

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

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

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

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

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

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

الاختلافات في ردّ الوقت المقدَّر للوصول

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

نوع الوقت المقدَّر للوصول	Routes API	‫Directions API Distance Matrix 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. لقد عالج بعض مستخدمي Distance Matrix API مشكلة حدود الطلبات من خلال تحويل نقاط خطوط الطول والعرض إلى نقاط مرور الخطوط المتعددة.

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

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

أوضاع السفر المتاحة

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

تنسيق XML كشكل للردّ

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