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

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

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

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

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

أسباب استخدام Compute Route Matrix

باستخدام Compute Route Matrix، يمكنك تحديد المسارات الأكثر فعالية لجدولة عمليات الإرسال، مثل:

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

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

المهام التي يمكن تنفيذها باستخدام Compute Route Matrix

باستخدام Compute Route Matrix، يمكنك الحصول على مصفوفة من المسارات المحتملة بين العديد من مواقع البداية والنهاية. يمكنك تحديد مصادر ووجهات متعددة لكل طلب من جهة الخادم، مع مراعاة أنّ عدد المصادر مضروبًا في عدد الوجهات يجب ألا يتجاوز 625. يمكنك بث عناصر الرد قبل احتساب المصفوفة بأكملها، ما يقلّل من وقت استجابة الرد.

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

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

  • مدة الرحلة المقدَّرة في حال الازدحام المروري

طريقة عمل Compute Route Matrix

يقبل الإجراء ComputeRouteMatrix طلب HTTP POST مع نص طلب JSON يحتوي على تفاصيل الطلب. يجب توفير مصدر واحد على الأقل ووجهتَين أو أكثر وtravelMode وقناع حقل لتحديد الحقول المطلوب عرضها.

مثال

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'

يتضمّن الردّ المسارات المحتملة لمجموعة نقاط المرور الخاصة بالمصدر والوجهة.

الموارد

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

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

كيفية استخدام Compute Route Matrix

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

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

للاطّلاع على قائمة بمكتبات البرامج المتاحة لخدمة Compute Route Matrix، يُرجى الرجوع إلى مكتبات البرامج.

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