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

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

مقدمة

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

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

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

مزايا استخدام 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 API، يُرجى مراجعة مكتبات العملاء.

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