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

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

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

للطريقة ComputeRouteMatrix مزايا عديدة أكثر من خدمة مصفوفة المسافة:

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

تفعيل طريقة ComputeRouteMatrix

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

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

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

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

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

راحة: 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]. تكون هذه الصفائف مفهرسة بصفر. أُنشأها جون هنتر، الذي كان متخصصًا مهم لتخزين طلبات قائمة الانطلاق والوجهة.

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

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

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