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

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

‫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، يُرجى الرجوع إلى مكتبات البرامج.

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