يمكنك حساب مسافة ومدة المسار لعدة
مصادر ووجهات باستخدام طريقة ComputeRouteMatrix
في Routes Preferred API. يتيح ComputeRouteMatrix بث طلبات gRPC ومكالمات REST HTTP على حد سواء.
استنادًا إلى قائمة بأزواج نقطة الانطلاق والوجهة، يحتسب ComputeRouteMatrix
المسافة والمدة في مسار يبدأ من كل نقطة انطلاق
وينتهي عند كل وجهة. يتوافق كل عنصر من عناصر التدفق
مع المعلومات الخاصة بمسار واحد.
تتمتع طريقة ComputeRouteMatrix بالعديد من المزايا
على خدمة مصفوفة المسافة:
- يتيح البث عرض العناصر قبل حساب المصفوفة بأكملها، مما يقلل من زمن الانتقال.
- يتضمن
ComputeRouteMatrixخيارات دقيقة لحساب عدد الزيارات، ما يتيح لك اتخاذ قرارات بشأن مفاضلات وقت الاستجابة المتعلقة بالجودة. - يتم تشغيل الطلبات بأولوية أعلى ضمن بنية Google الأساسية، مما يؤدي إلى زيادة التوافر.
- يمكنك تحديد العنوان (اتجاه السفر) والمعلومات على جانب الطريق لنقاط الطريق.
- يمكنك طلب إرجاع معلومات الرسوم، بالإضافة إلى مسافة المسار والوقت المقدر للوصول.
تفعيل طريقة ComputeRouteMatrix
قبل أن تتمكّن من استخدام طريقة ComputeRouteMatrix في الرمز، عليك تفعيلها. للمزيد من المعلومات عن تفعيل طُرق واجهة برمجة تطبيقات Routes Preferred،
يمكنك الاطّلاع على البدء.
استخدام طريقة ComputeRouteMatrix
تتوفّر طريقة ComputeRouteMatrix من خلال نقطة نهاية
Routes Preferred
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:
راجِع النماذج الأوّلية اللازمة من مستودع googleapis:
https://github.com/googleapis/googleapis/tree/master/google/maps/routes
يُرجى العلم أنّ بعض أنظمة الإصدار، مثل Go، قد تنفّذ هذا الإجراء تلقائيًا نيابةً عنك.
باستخدام لغتك المفضّلة ومجموعة أدوات الإنشاء، أنشئ رمز النموذج الأوّلي ذا الصلة.
أنشئ طلبك. يجب إرسال جزأين مطلوبين من بيانات التعريف مع الطلب:
- يجب ضبط X-Goog-Api-Key على مفتاح واجهة برمجة التطبيقات.
يجب ضبط X-Goog-Fieldmask على قائمة مفصولة بفواصل للحقول التي تطلبها من الاستجابة. على سبيل المثال، X-Goog-FieldMask: originIndex,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]. تمت فهرسة هذه الصفائف بصفر. من المهم
تخزين طلبات قائمة المصدر والوجهة.
احتساب رسوم العبور
للحصول على معلومات حول احتساب رسوم العبور، يمكنك الاطّلاع على حساب رسوم العبور.
للحصول على أمثلة لحساب رسوم الرسوم، راجع أمثلة على حساب مصفوفة المسار.