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

Compute Routes هي طريقة في خدمة Routes API تقبل طلب HTTPS وتُرجع المسار المثالي بين موقعَين جغرافيَّين. يجب تقديم اتجاهات مع كثافة حركة المرور في الوقت الفعلي للنقل العام أو ركوب الدراجات أو القيادة أو المركبات ذات العجلتين أو المشي بين مواقع جغرافية متعددة.

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

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

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

باستخدام ميزة "حساب المسارات"، يمكنك توجيه المركبات أو الطرود وفقًا لإعداداتك المفضّلة مع تحسين التكلفة والجودة من خلال استخدام مجموعة كبيرة من تفاصيل المسارات.

ما هي الإجراءات التي يمكنك اتّخاذها باستخدام Compute Routes؟

باستخدام طريقة Compute Routes في Routes API، يمكنك تنفيذ الإجراءات التالية:

  • الحصول على الاتجاهات لطرق سفر مختلفة ولوجهة واحدة أو عدة وجهات:

    • وسائل النقل: النقل العام أو القيادة أو المركبات ذات العجلتين أو المشي أو ركوب الدراجات

    • سلسلة من نقاط الطريق التي يمكنك تحسينها لتحديد الترتيب الأكثر فعالية للتنقّل بينها

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

    • سلاسل نصية على سبيل المثال: "القاهرة، مصر" أو "الإسكندرية، مصر" أو "1800 Amphitheatre Parkway, Mountain View, CA 94043" أو "CWF6+FWX Mountain View, California"

    • أرقام تعريف الأماكن

    • إحداثيات خط العرض وخط الطول، مع الاتجاه المقصود للمركبة اختياريًا

  • تحسين خيارات المسار استنادًا إلى احتياجاتك وأهدافك:

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

آلية عمل Compute Routes

تقبل طريقة ComputeRoutes في Routes API طلب HTTP POST مع نص طلب JSON يحتوي على تفاصيل الطلب. يجب إدخال نقطة الانطلاق، وجهة، travelMode، وقناع حقل لتحديد الحقول التي سيتم عرضها.

مثال

curl -X POST -d '{
    "origin": {
      "address": "1800 Amphitheatre Parkway, Mountain View, CA 94043"
    },
    "destination": {
      "address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132"
    },
  "travelMode": "DRIVE"
  }' \
  -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
  -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \
  'https://routes.googleapis.com/directions/v2:computeRoutes'

بعد ذلك، تحتسب الخدمة المسار المطلوب، وتُرجع الحقول التي طلبتها.

الموارد

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

مصادر البيانات البيانات التي تم عرضها تنسيق الإرجاع
ComputeRoutes عرض المسارات والمراحل والخطوات الخاصة بمسار معيّن، مع مسارات بديلة، إذا طُلب ذلك JSON

كيفية استخدام Compute Routes

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

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

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

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