يمكنك احتساب مسافة المسار ومدته لعدة مصادر ووجهات باستخدام طريقة ComputeRouteMatrix
في واجهة برمجة التطبيقات Routes Preferred API. يتوافق ComputeRouteMatrix
مع كل من طلبات gRPC لبث المحتوى واستدعاءات REST HTTP.
وفقًا لقائمة بأزواج محطات الانطلاق والوجهة، يحتسب ComputeRouteMatrix
مسافة المسار ومدته بدءًا من كل نقطة انطلاق
وينتهي عند كل وجهة. ويتوافق كل عنصر من عناصر التدفق
مع المعلومات الخاصة بمسار واحد.
تتميز طريقة ComputeRouteMatrix
بالعديد من المزايا التي تفوق
خدمة مصفوفة المسافة:
- يسمح البث بعرض العناصر قبل حساب المصفوفة بالكامل، مما يقلل من زمن الانتقال.
- يوفّر
ComputeRouteMatrix
خيارات أكثر دقة لاحتساب عدد الزيارات، ما يتيح لك اتخاذ قرارات مناسبة بشأن وقت الاستجابة الجيد. - يتم تنفيذ الطلبات بأولوية أعلى ضمن بنية Google الأساسية، مما يؤدي إلى توفُّر المزيد من الطلبات.
- يمكنك تحديد معلومات العنوان (اتجاه السفر) وجانب الطريق لنقاط الطريق.
- يمكنك طلب إعادة معلومات رسوم العبور، بالإضافة إلى مسافة المسار والوقت المقدر للوصول.
تفعيل طريقة ComputeRouteMatrix
قبل أن تتمكّن من استخدام طريقة ComputeRouteMatrix
في الرمز، يجب
تفعيلها. لمزيد من المعلومات حول تفعيل طرق واجهة برمجة التطبيقات المفضلة للمسارات،
راجع البدء.
استخدام طريقة ComputeRouteMatrix
تتوفر الطريقة ComputeRouteMatrix
من خلال نقطة نهاية v1 من المسارات المفضَّلة.
راجِع المستندات التالية للحصول على معلومات أكثر تفصيلاً:
توضّح الخطوات العامة التالية كيفية استخدام gRPC لاستدعاء
طريقة ComputeRouteMatrix
:
تحقق من الموارد الاحتياطية الأولية اللازمة من مستودع googleapis:
https://github.com/googleapis/googleapis/tree/master/google/maps/routes
تجدر الإشارة إلى أنّ بعض أنظمة التصميم، مثل Go، قد تُجري هذا الإجراء تلقائيًا نيابةً عنك.
باستخدام لغتك المفضّلة ومجموعة أدوات التصميم، يمكنك إنشاء رمز المخزن المؤقت الأولي ذي الصلة.
يُرجى إنشاء طلبك. يجب إرسال اثنين من بيانات التعريف المطلوبة مع الطلب:
- يجب ضبط X-Goog-Api-Key على مفتاح واجهة برمجة التطبيقات الخاص بك.
يجب ضبط X-Goog-Fieldmask على قائمة مفصولة بفواصل للحقول التي تطلبها من الاستجابة. على سبيل المثال، X-Goog-FieldMask: assetIndex,destinationIndex,duration,distanceMeters,status. يمكنك استخدام حرف البدل (*) للإشارة إلى جميع الحقول، ولكن لا يُنصح بذلك. استخدِم حرف البدل لاختبار استجابة واجهة برمجة التطبيقات وفهمها، ولكن أدرِج الحقول التي تريدها بوضوح في قناع الحقل في رمز الإنتاج.
لمزيد من المعلومات حول كيفية إنشاء سلسلة قناع الحقل، يُرجى الاطّلاع على https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/field_mask.proto. لاحظ أن إيقاف الحقول التي لا تحتاج إليها يمكن أن يقلل من وقت الاستجابة لأن هذه الحقول قد تتطلب مزيدًا من العمليات الحسابية. سيظل وقت الاستجابة مستقرًا إذا حددت الحقول التي تحتاجها، وستتم إضافة الحقول الجديدة التي تتطلب المزيد من العمليات الحسابية لاحقًا.
أرسِل طلبك إلى
routespreferred.googleapis.com:443
.يجب استخدام بروتوكول أمان طبقة النقل (TLS).
للحصول على أمثلة على استخدام طريقة ComputeRouteMatrix
، يمكنك الاطّلاع على
أمثلة على حوسبة مصفوفة المسارات (إصدار تجريبي).
من بين الميزات المميِّزة لطريقة ComputeRouteMatrix
إمكانية عرض رموز الخطأ للبث بأكمله أو للعناصر الفردية. على سبيل المثال، يعرض اتصال البث رسالة خطأ إذا تمت كتابة الطلب بشكل غير صحيح (على سبيل المثال، لا يحتوي الطلب على أي مصادر). ومع ذلك، إذا انطبق خطأ على عدد قليل من عناصر البث (على سبيل المثال، ضبط رقم تعريف مكان غير صالح
لمصدر بيانات)، فعندئذٍ تشتمل العناصر المتأثرة بالخطأ فقط على رموز الخطأ.
ليس هناك ما يضمن إرجاع العناصر التي يعرضها البث
بأي ترتيب. ولهذا السبب، يحتوي كل عنصر على origin_index
وdestination_index
. بالنسبة إلى الأصول والوجهات المحددة
من خلال الطلب، يعادل مصدر المسار origins[origin_index]
عنصرًا معيّنًا ووجهة المسار تعادل destinations[destination_index]
. تكون هذه الصفائف مفهرسة بصفر. من المهم تخزين طلبات قائمة المصدر والوجهة.
جارٍ احتساب رسوم العبور
للحصول على معلومات حول طريقة احتساب رسوم العبور، يمكنك الاطّلاع على احتساب رسوم رسوم العبور.
للحصول على أمثلة حول احتساب رسوم العبور، يمكنك الاطّلاع على أمثلة على حوسبة مصفوفة المسارات.