تتوفر
واجهة برمجة تطبيقات المسارات المفضلة حاليًا لعملاء محددين فقط. يمكنك
التواصل مع فريق المبيعات لمعرفة المزيد من المعلومات.
تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.
ComputeRouteMatrixRequest
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
رسالة طلب ComputeRouteMatrix
| الحقول |
origins[] |
object (RouteMatrixOrigin)
مطلوب. صفيف المصادر الذي يحدّد صفوف مصفوفة الاستجابة تنطبق عدة قيود على الحجم على عدد العناصر في الحقل للمصادر والوجهات:
- يجب ألا يزيد عدد العناصر (المواقع الجغرافية للمحطات × الوجهات) عن 625 في أي حال.
- يجب ألا يزيد عدد العناصر (المصادر × الوجهات) عن 100 إذا تم ضبط routingPreference على
TRAFFIC_AWARE_OPTIMAL.
- يجب ألا يزيد عدد نقاط التوقف (المواقع الجغرافية للنقاط المرجعية + الوجهات) المحدّدة على أنّها
placeId عن 50.
|
destinations[] |
object (RouteMatrixDestination)
مطلوب. صفيف الوجهات الذي يحدّد أعمدة مصفوفة الاستجابة
|
travelMode |
enum (RouteTravelMode)
اختياريّ. تحدِّد وسيلة النقل.
|
routingPreference |
enum (RoutingPreference)
اختياريّ. تُحدِّد كيفية احتساب المسار. يحاول الخادم استخدام تفضيل التوجيه المحدد لاحتساب المسار. إذا أدى تفضيل التوجيه إلى خطأ أو وقت استجابة طويل للغاية، سيتم عرض خطأ. لا يمكنك تحديد هذا الخيار إلا عندما يكون travelMode هو DRIVE أو TWO_WHEELER، وإلا سيتعذّر إكمال الطلب.
|
departureTime |
string (Timestamp format)
اختياريّ. وقت المغادرة في حال عدم ضبط هذه القيمة، سيتم ضبطها تلقائيًا على الوقت الذي قدّمت فيه الطلب. وفي حال ضبط هذه القيمة على وقت قد حدث بالفعل، سيتعذّر الطلب. يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu" وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
|
RouteMatrixOrigin
مصدر واحد لـ ComputeRouteMatrixRequest
| الحقول |
waypoint |
object (Waypoint)
مطلوب. نقطة طريق نقطة الانطلاق
|
routeModifiers |
object (RouteModifiers)
اختياريّ. المُعدِّلات لكل مسار يستخدِم هذا كنقطة منشأ
|
RouteMatrixDestination
وجهة واحدة لطلب ComputeRouteMatrix
| تمثيل JSON |
{
"waypoint": {
object (Waypoint)
}
} |
| الحقول |
waypoint |
object (Waypoint)
مطلوب. نقطة طريق الوجهة
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[],["The core content describes the `ComputeRouteMatrix` request, which calculates routes between multiple origins and destinations. Key actions involve specifying arrays of `origins` and `destinations`, each containing a `waypoint`. Optional parameters include `travelMode`, `routingPreference`, and `departureTime`. Size limitations apply to the number of origins and destinations: their product must not exceed 625 and no more than 50 if they are placeIds. Each `RouteMatrixOrigin` and `RouteMatrixDestination` have a `waypoint`, and `RouteMatrixOrigin` additionally allows for `routeModifiers`.\n"]]