مراجعة استجابة مصفوفة المسار

يأخذ طلب مصفوفة المسارات مصفوفة من نقاط المسار لنقطة الانطلاق والوجهة كإدخال. بعد ذلك، تحتسب Routes API المسار من كل نقطة على المسار في نقطة الانطلاق إلى كل نقطة على المسار في الوجهة. على سبيل المثال، إذا حدّدت نقطتَين على المسار لنقطة الانطلاق ونقطتَين على المسار للوجهة، ستحسب واجهة برمجة التطبيقات أربعة مسارات منفصلة.

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

باستخدام الردّ، يمكنك تزويد عملائك بخيارات مسارات مختلفة ثم السماح للمستخدم باختيار المسار المناسب لمتطلباته.

لمحة عن أقنعة الحقول

عند استدعاء طريقة لحساب مسار، يجب تحديد قناع حقل يحدّد الحقول التي تريد عرضها في الاستجابة. لا توجد قائمة تلقائية بالحقول التي يتم عرضها. إذا حذفت هذه القائمة، ستعرض الطرق خطأ.

تعرض الأمثلة في هذا المستند عنصر الاستجابة بالكامل بدون أخذ أقنعة الحقول في الاعتبار. في بيئة التشغيل الفعلي، لن يتضمّن ردّك سوى الحقول التي تحدّدها صراحةً في قناع الحقل.

لمزيد من المعلومات، يُرجى الاطّلاع على اختيار المعلومات التي تريد عرضها.

لمحة عن عرض حقوق الطبع والنشر

يجب تضمين بيان حقوق الطبع والنشر التالي عند عرض النتائج للمستخدمين:

Powered by Google, ©YEAR Google

على سبيل المثال:

Powered by Google, ©2023 Google

تحديد المسار في الردّ

استخدِم السمتَين originIndex وdestinationIndex في الردّ لتحديد كل مسار في الردّ. تحتوي هذه السمات على الفهرس المستند إلى الصفر لنقاط المسار الخاصة بنقطة الانطلاق والوجهة التي تم إدخالها والمستخدَمة لاحتساب المسار. وهذا يعني أنّ أول نقطة مسار للموقع الجغرافي للانطلاق وأول نقطة مسار للموقع الجغرافي للوجهة في الطلب تقعان في فهرس الصفيف 0.

على سبيل المثال، يحتوي المسار في الردّ على ما يلي:

"originIndex": 1,
"destinationIndex": 0

تشير هذه السمات إلى أنّه تم احتساب المسار من نقطة المسار الخاصة بنقطة الانطلاق عند الفهرس 1 في مصفوفة الإدخال، ومن نقطة المسار الخاصة بالوجهة عند الفهرس 0.

بالنسبة إلى المسار التالي:

"originIndex": 4,
"destinationIndex": 1

تم احتساب المسار من نقطة الانطلاق على المسار في الفهرس 4 في مصفوفة الإدخال، ومن نقطة الوجهة على المسار في الفهرس 1 في مصفوفة الإدخال.

لمحة عن معلومات المسار في الردّ

يحتوي الردّ من واجهة برمجة التطبيقات على مصفوفة، حيث يحدّد كل عنصر في المصفوفة المسار من نقطة انطلاق واحدة إلى نقطة وجهة واحدة. هذه العناصر هي RouteMatrixElements في طريقة gRPC أو نص الاستجابة في استجابة HTTP.

بالإضافة إلى السمتَين originIndex وdestinationIndex، يحتوي كل عنصر على معلومات أساسية خاصة بهذا المسار فقط، مثل distanceMeters وduration وtravelAdvisory. للحصول على معلومات أكثر تفصيلاً عن مسار معيّن، مثل خطوط متعدّدة، استخدِم computeRoutes.

يكون الردّ على النحو التالي:

[
  // One array element for each combination of origin and destination waypoints.
  {
    // The route for source waypoint 0 and destination waypoint 0.
    "originIndex": 0,
    "destinationIndex": 0,
    "status": {
      object (Status)
    },
    "condition": enum (RouteMatrixElementCondition),
    "distanceMeters": integer,
    "duration": string,
    "staticDuration": string,
    "travelAdvisory": {
      object (RouteTravelAdvisory)
    },
    "fallbackInfo": {
      object (FallbackInfo)
    }
  }
  {
    // The route for source waypoint 0 and destination waypoint 1.
    "originIndex": 0,
    "destinationIndex": 1,
    "status": {
      object (Status)
    },
    "condition": enum (RouteMatrixElementCondition),
    "distanceMeters": integer,
    "duration": string,
    "staticDuration": string,
    "travelAdvisory": {
      object (RouteTravelAdvisory)
    },
    "fallbackInfo": {
      object (FallbackInfo)
    }
  }
  …
]