نظرة عامة على Routes API

Routes API هي خدمة تقبل طلبات HTTPS تعرض إما المسار المثالي بين موقعين، أو المسافات والسفر الأوقات لمصفوفة من المسارات بين مواقع المنشأ والوجهة المختلفة.

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

باستخدام Routes API، يمكنك الحصول على معلومات دقيقة حول المسارات والرحلات. باستخدام تفاصيل النقل وأحدث المعلومات عن حركة المرور وأحوال الطرق والمسار التفضيلات:

  • أنواع وسائل النقل المختلفة وإمكاناتها

  • في أي اتجاه تتجه المركبة

  • جانب الطريق المخصّص للنقل أو التسليم

  • أحوال حركة المرور وإغلاق الطرق

  • مخاوف تتعلق بالسلامة، مثل تجنُّب المناطق الخطرة أو توفير خدمة الالتقاط بشكل آمن المناطق

  • يمكنك تحقيق التوازن بين وقت الاستجابة والجودة والتكلفة في مختلف احتياجات التوجيه، بالإضافة إلى الإجراءات الاختيارية. ميزات مثل رسوم العبور والبيانات الوصفية للرحلة، مثل الوقت والمسافة والوقود الكفاءة

يمكنك أيضًا تحديد المسارات الأكثر كفاءة لجدولة الإرسال، مثل كـ:

  • أفضل طريقة لتعيين مجموعة من العمال لاستلام سلسلة من الحزم

  • تحديد أفضل مستودع لشحن الحزم منه إلى النهائي الوجهة

ما أهمية واجهة برمجة تطبيقات Routes API؟

باستخدام Routes API، يمكنك الحصول على فئتَين أساسيتَين من التوجيه. المعلومات:

  • المسارات من موقع جغرافي إلى وجهة واحدة أو وجهات متعددة

  • مصفوفة من المسارات المحتملة بين العديد من مواقع البدء والانتهاء.

الحصول على مسارات لوجهات واحدة أو وجهات متعددة

باستخدام طريقة Compute Routes في Routes API التي يمكنك حسابها بين المواقع:

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

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

    • سلسلة من نقاط الطريق، التي يمكنك تحسينها للحصول على ترتيب أكثر كفاءة السفر إليها.

  • طرق متعددة لتحديد المصادر والوجهات ونقاط الطريق:

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

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

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

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

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

الحصول على مصفوفة للمسارات المحتملة

توفّر الطريقة Compute Route Matrix في Routes API مصفوفة من المعلومات للمسارات الموصى بها بين نقاط البداية والنهاية المتعددة نقاط الوصول، بما في ذلك المسافة وأوقات الوصول المقدّرة، لمساعدتك في اختيار أفضل نقاط الانطلاق والوجهات استنادًا إلى لاحتياجات العمل المختلفة. يمكنك طلب هذه الأنواع من بيانات المسافة:

  • المسافة لوضع السفر الذي تم اختياره

  • المسافة بالكيلومتر أو الأميال

  • الوقت التقديري للسفر في حركة المرور

باستخدام بيانات المسافة، يمكنك تحديد الطريقة الأكثر فعالية للمسار بالركاب أو الشحنات أو العمال بين عدة أصول المقصودة.

يمكنك تدفق عناصر الاستجابة قبل الانتهاء من تعديل المصفوفة بالكامل ما يقلل من وقت استجابة الاستجابة.

يمكنك تحديد مصادر ووجهات متعددة لكل طلب من جهة الخادم باستخدام عدد المصادر مضروبًا في عدد الوجهات لتصل إلى 625.

آلية عمل Routes API

تستخدم واجهة برمجة التطبيقات Routes API طريقتَين: ComputeRoutes و ComputeRouteMatrix

ComputeRoutes

تقبل طريقة Routes API ComputeRoutes طلب 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'

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

ComputeRouteMatrix

تقبل واجهة برمجة التطبيقات Routes API ComputeRouteMatrix طلب HTTP POST مع نص طلب JSON يحتوي على تفاصيل الطلب. يجب ملء حقل واحد على الأقل الأصل، ووجهتين أو أكثر، travelMode، وقناع حقل لتحديد الحقول المطلوب إرجاعها.

مثال

curl -X POST -d '{
  "origins": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420761,
            "longitude": -122.081356
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.403184,
            "longitude": -122.097371
          }
        }
      }
    }
  ],
  "destinations": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420999,
            "longitude": -122.086894
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.383047,
            "longitude": -122.044651
          }
        }
      }
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \
'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'

يحتوي الردّ على المسارات المحتمَلة لتركيبة كل المصادر. نقاط الطريق والوجهة.

الموارد

يلخص الجدول التالي الموارد المتاحة من خلال Routes API مع البيانات التي تعرضها.

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

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

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

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

للاطّلاع على قائمة بمكتبات العملاء المتوفرة لواجهة Routes API، يمكنك الاطّلاع على مكتبات العميل:

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