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

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

مقدمة

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

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