نظرة عامة على مصفوفة مسارات الحساب

المطوّرون في المنطقة الاقتصادية الأوروبية

Compute Route Matrix هي طريقة في خدمة Routes API تقبل طلب HTTPS وتُرجع المسافات وأوقات التنقّل لمصفوفة من المسارات بين مواقع المصدر والوجهة المختلفة. احتساب أوقات التنقّل ومسافات الوجهات المتعددة لما يصل إلى 625 عنصر مسار

هل تحتاج إلى مسارات القيادة؟ إذا كنت مهتمًا باتجاهات المسار، يمكنك الاطّلاع على نظرة عامة على مسارات الحوسبة.

هل يتم نقل البيانات؟ إذا كنت بصدد نقل البيانات من Distance Matrix API (الإصدار القديم)، اطّلِع على تعليمات نقل البيانات بدءًا من أسباب نقل البيانات إلى Routes API.

مزايا استخدام "مصفوفة مسارات الحوسبة"

باستخدام "مصفوفة مسارات الحوسبة"، يمكنك تحديد المسارات الأكثر فعالية لتحديد جداول الشحن، مثل:

  • أفضل طريقة لتعيين مجموعة من العمال لجمع سلسلة من الطرود

  • تحديد أفضل مستودع لشحن الطرود إلى وجهتها النهائية

ما هي الإجراءات التي يمكنك اتّخاذها باستخدام "مصفوفة مسارات الحوسبة"؟

باستخدام "مصفوفة مسارات الحساب"، يمكنك الحصول على مصفوفة من المسارات المحتملة بين العديد من المواقع الجغرافية لنقاط البداية والنهاية. يمكنك تحديد مصادر ووجهات متعددة لكل طلب من جانب الخادم بعدد مصادر ومَعلمات وجهة يصل إلى 625. يمكنك بث عناصر الاستجابة قبل احتساب المصفوفة بأكملها، ما يقلل من وقت استجابة البث.

يمكنك طلب هذه الأنواع من بيانات المسارات لتحديد الطريقة الأكثر فعالية لتوجيه ركّاب أو شحنات أو عمال بين عدة نقاط منشأ ونقاط مقصودة:

  • المسافة بالكيلومترات أو الأميال لوسيلة نقل محدّدة

  • الوقت المقدَّر للسفر في ظلّ كثافة حركة المرور

آلية عمل "مصفوفة مسارات الحوسبة"

تقبل الطريقة ComputeRouteMatrix طلب HTTP POST مع نص طلب JSON يحتوي على تفاصيل الطلب. يجب توفير نقطة منشأ واحدة على الأقل ووجهتين أو أكثر ووضع التنقّل وقناع حقل لتحديد الحقول التي سيتم عرضها.

مثال

curl -X POST -d '{
  "origins": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420761,
            "longitude": -122.081356
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.403184,
            "longitude": -122.097371
          }
        }
      }
    }
  ],
  "destinations": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420999,
            "longitude": -122.086894
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.383047,
            "longitude": -122.044651
          }
        }
      }
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \
'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'

يحتوي الردّ على المسارات المحتملة لتركيبة جميع نقاط الطريق في نقطة المغادرة والوجهة.

الموارد

يلخِّص الجدول التالي الموارد المتاحة من خلال أسلوب حساب مصفوفة المسارات في واجهة برمجة التطبيقات Routes API، بالإضافة إلى البيانات التي يعرضها.

موارد البيانات البيانات التي تم عرضها تنسيق الإرجاع
ComputeRouteMatrix لعرض صفيف من المسارات من نقطة بدء واحدة إلى نقطة وجهة واحدة. JSON

كيفية استخدام "مصفوفة مسارات الحوسبة"

1 الإعداد ابدأ بـ إعداد مشروعك على Google Cloud وأكمِل تعليمات الإعداد التالية.
2 التعرّف على كيفية إصدار فواتير Routes API للحصول على معلومات، يُرجى الاطّلاع على الاستخدام والفوترة.
3 حساب مصفوفة المسارات ومراجعة الاستجابة لمزيد من المعلومات، يُرجى الاطّلاع على مقالتَي الحصول على مصفوفة مسارات ومراجعة استجابة مصفوفة المسارات.

مكتبات العملاء المتاحة

للحصول على قائمة بمكتبات البرامج المتاحة لجدول مسار الشبكة، يُرجى الاطّلاع على مكتبات البرامج.

الخطوات التالية