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

‫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، بالإضافة إلى البيانات التي تعرضها.

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

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

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

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

• الحصول على مصفوفة مسارات
• خيارات مصفوفة المسارات المتاحة
• اختيار المعلومات التي تريد إرجاعها
• نقل البيانات من واجهة Distance Matrix API (الإصدار القديم)
• نقل البيانات من الإصدار التجريبي من Routes API إلى الإصدار المتاح للجميع