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

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

مقدمة

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

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

الموارد

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

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

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

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

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

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

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