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

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

مقدمة

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

هل تحتاج إلى مصفوفات مسارات؟ إذا كنت مهتمًا بمصفوفة مسارات، يمكنك الاطّلاع على نظرة عامة حول Compute Route Matrix.

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

أسباب استخدام Compute Routes

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

ما يمكنك فعله باستخدام 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'

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

الموارد

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

موارد البيانات البيانات التي تم عرضها تنسيق القيمة التي يتم إرجاعها
ComputeRoutes تعرض هذه الطريقة المسارات وأجزاءها وخطواتها، بالإضافة إلى المسارات البديلة، إذا طُلب ذلك. JSON

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

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

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

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

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