حساب مصفوفة مسار

يمكنك احتساب مسافة المسار ومدته لعدة مصادر ووجهات باستخدام طريقة ComputeRouteMatrix في واجهة برمجة التطبيقات Routes Preferred API. يتوافق ComputeRouteMatrix مع كل من طلبات gRPC لبث المحتوى واستدعاءات REST HTTP.

وفقًا لقائمة بأزواج محطات الانطلاق والوجهة، يحتسب ComputeRouteMatrix مسافة المسار ومدته بدءًا من كل نقطة انطلاق وينتهي عند كل وجهة. ويتوافق كل عنصر من عناصر التدفق مع المعلومات الخاصة بمسار واحد.

تتميز طريقة ComputeRouteMatrix بالعديد من المزايا التي تفوق خدمة مصفوفة المسافة:

  • يسمح البث بعرض العناصر قبل حساب المصفوفة بالكامل، مما يقلل من زمن الانتقال.
  • يوفّر ComputeRouteMatrix خيارات أكثر دقة لاحتساب عدد الزيارات، ما يتيح لك اتخاذ قرارات مناسبة بشأن وقت الاستجابة الجيد.
  • يتم تنفيذ الطلبات بأولوية أعلى ضمن بنية Google الأساسية، مما يؤدي إلى توفُّر المزيد من الطلبات.
  • يمكنك تحديد معلومات العنوان (اتجاه السفر) وجانب الطريق لنقاط الطريق.
  • يمكنك طلب إعادة معلومات رسوم العبور، بالإضافة إلى مسافة المسار والوقت المقدر للوصول.

تفعيل طريقة ComputeRouteMatrix

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

استخدام طريقة ComputeRouteMatrix

تتوفر الطريقة ComputeRouteMatrix من خلال نقطة نهاية v1 من المسارات المفضَّلة.

راجِع المستندات التالية للحصول على معلومات أكثر تفصيلاً:

gRPC : https://developers.google.com/maps/documentation/routes_preferred/reference/rpc/google.maps.routes.v1

REST: https://developers.google.com/maps/documentation/routes_preferred/reference/rest/v1/TopLevel/computeRouteMatrix

توضّح الخطوات العامة التالية كيفية استخدام gRPC لاستدعاء طريقة ComputeRouteMatrix:

  1. تحقق من الموارد الاحتياطية الأولية اللازمة من مستودع googleapis:

    https://github.com/googleapis/googleapis/tree/master/google/maps/routes

    تجدر الإشارة إلى أنّ بعض أنظمة التصميم، مثل Go، قد تُجري هذا الإجراء تلقائيًا نيابةً عنك.

  2. باستخدام لغتك المفضّلة ومجموعة أدوات التصميم، يمكنك إنشاء رمز المخزن المؤقت الأولي ذي الصلة.

  3. يُرجى إنشاء طلبك. يجب إرسال اثنين من بيانات التعريف المطلوبة مع الطلب:

    • يجب ضبط 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. لاحظ أن إيقاف الحقول التي لا تحتاج إليها يمكن أن يقلل من وقت الاستجابة لأن هذه الحقول قد تتطلب مزيدًا من العمليات الحسابية. سيظل وقت الاستجابة مستقرًا إذا حددت الحقول التي تحتاجها، وستتم إضافة الحقول الجديدة التي تتطلب المزيد من العمليات الحسابية لاحقًا.

  4. أرسِل طلبك إلى routespreferred.googleapis.com:443.يجب استخدام بروتوكول أمان طبقة النقل (TLS).

للحصول على أمثلة على استخدام طريقة ComputeRouteMatrix، يمكنك الاطّلاع على أمثلة على حوسبة مصفوفة المسارات (إصدار تجريبي).

من بين الميزات المميِّزة لطريقة ComputeRouteMatrix إمكانية عرض رموز الخطأ للبث بأكمله أو للعناصر الفردية. على سبيل المثال، يعرض اتصال البث رسالة خطأ إذا تمت كتابة الطلب بشكل غير صحيح (على سبيل المثال، لا يحتوي الطلب على أي مصادر). ومع ذلك، إذا انطبق خطأ على عدد قليل من عناصر البث (على سبيل المثال، ضبط رقم تعريف مكان غير صالح لمصدر بيانات)، فعندئذٍ تشتمل العناصر المتأثرة بالخطأ فقط على رموز الخطأ.

ليس هناك ما يضمن إرجاع العناصر التي يعرضها البث بأي ترتيب. ولهذا السبب، يحتوي كل عنصر على origin_index وdestination_index. بالنسبة إلى الأصول والوجهات المحددة من خلال الطلب، يعادل مصدر المسار origins[origin_index] عنصرًا معيّنًا ووجهة المسار تعادل destinations[destination_index]. تكون هذه الصفائف مفهرسة بصفر. من المهم تخزين طلبات قائمة المصدر والوجهة.

جارٍ احتساب رسوم العبور

للحصول على معلومات حول طريقة احتساب رسوم العبور، يمكنك الاطّلاع على احتساب رسوم رسوم العبور.

للحصول على أمثلة حول احتساب رسوم العبور، يمكنك الاطّلاع على أمثلة على حوسبة مصفوفة المسارات.