توفّر Routes API أداءً مُحسَّنًا لحساب الاتجاهات والمسافة ومدّة الرحلة، ما يجعلها مفيدة لاستبدال التطبيقات التي تستخدم حاليًا واجهة برمجة التطبيقات Directions API وواجهة برمجة التطبيقات لمصفوفة المسافات. تتوافق معظم وظائف Routes API مع كل من واجهة برمجة التطبيقات Directions API وواجهة برمجة تطبيقات مصفوفة المسافة.
يمكنك استخدام هذا الدليل لفهم الاختلافات الرئيسية في Routes API مقارنةً بالمنتجات التي يتم استبدالها، بالإضافة إلى كيفية التعامل مع التغييرات الضرورية. للمزيد من التفاصيل حول ميزات Routes API الأخرى، يمكنك الاطّلاع على نظرة عامة على المنتج.
التحسينات الرئيسية
يتناول هذا القسم بعض التحسينات التي يمكنك توقّعها عند استخدام Routes API في تطبيقاتك.
زيادة الحدود القصوى المسموح بها للطلبات
Routes API |
|
واجهة برمجة التطبيقات لمصفوفة المسافات |
|
ردود أسرع على الطلبات
تقدم ميزة مصفوفة المسارات الحوسبية تحسينات وقت الاستجابة التالية:
- استلام عناصر بث الرد قبل أن يتم حساب المصفوفة بالكامل.
- استخدِم أقنعة ميدانية لتخصيص تفاصيل الاستجابة، مع طلب البيانات التي تحتاجها فقط، وهو أفضل الممارسات التي تساعد أيضًا في تقليل التكلفة.
- عمليات حسابية محسّنة للمسارات المتعلّقة بحركة المرور، حتى تتمكّن من إجراء موازنة بين جودة البيانات ووقت الاستجابة.
تحسينات على التوجيه
تقدم ميزة مسار الحوسبة تحسينات التوجيه التالية:
- معلومات رسوم المرور بالإضافة إلى المسافة والوقت المقدر للوصول.
- مسارات المركبات ذات العجلتين.
- حدِّد نقاط توقفك على الطريق لمراعاة السلامة.
- زيادة دقة الوقت المقدر للوصول عن طريق تعيين اتجاه السفر وجانب الطريق لنقاط الطريق.
طلب البيانات التي تحتاج إليها فقط
يمكنك الآن تحديد الحقول المطلوب عرضها، ما يقلل وقت المعالجة ورسوم الفوترة.
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_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 واجهة برمجة التطبيقات لمصفوفة المسافات |
---|---|---|
لا تكون حركة المرور على دراية، والوقت المقدر للوصول غير مدرَّب. | اضبط باستخدام
|
يتطابق مع عدم ضبط
|
الوقت المقدر للوصول الذي يأخذ في عين الاعتبار حركة المرور في الوقت الفعلي. | اضبط باستخدام
|
يتم الضبط باستخدام
|
نقاط الطرق المتعددة الخطوط
لم تعُد بحاجة إلى تحويل إحداثيات خط العرض/خط الطول إلى نقاط طرق متعددة باستخدام هذه الخدمة التي تتيح نص طلب POST، وبالتالي لم تعد تتأثر بحدود سلسلة عنوان URL. عالج بعض مستخدمي واجهة برمجة تطبيقات مصفوفة المسافة مشكلة حدود الطلب من خلال تحويل نقاط خطوط الطول/العرض إلى نقاط طرق متعددة الخطوط.
العناوين المنسَّقة (الترميز الجغرافي العكسي)
لم تقدّم Routes API عناوين منسّقة في الردّ. وللحصول على عناوين منسَّقة، استخدِم واجهة برمجة تطبيقات الترميز الجغرافي التي تم إنشاؤها لحالة الاستخدام هذه، كما تقدّم نتائج ذات جودة أعلى.
وسائل النقل المتاحة
كما هي الحال مع واجهة برمجة تطبيقات الاتجاهات، تستخدم Routes API DRIVE كوضع تلقائي عندما لا يحدّد طلب المسار وضع سفر. ومع ذلك، عندما يحدّد أحد الطلبات وضع سفر لمسار ما، لا تعرض Routes API مجموعة من أوضاع السفر المتاحة كاختيارات بديلة للطلب. إذا كانت حالة استخدامك للميزة تعتمد على هذه الميزة، يُرجى الإبلاغ عن مشكلة مع وصف طريقة استخدامك للميزة، حتى نتمكّن من المتابعة.
XML كتنسيق رد
لا توفّر Routes API تنسيق XML. يمكنك العثور على عدد من برامج تحويل JSON إلى XML على الإنترنت والتي تناسب أغراضك.