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

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

‫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'

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

الموارد

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

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

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

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

مكتبات البرامج المتاحة

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

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