Package google.maps.routing.v2

الفهرس

المسارات

‫Routes API

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

تتلقّى هذه الطريقة قائمة بالمواقع الجغرافية للانطلاق والوجهات وتعرض مصدر بيانات يحتوي على معلومات المسار لكل مجموعة من المواقع الجغرافية للانطلاق والوجهات.

ملاحظة: تتطلّب هذه الطريقة تحديد قناع حقل الردّ في الإدخال. يمكنك تقديم قناع حقل الاستجابة باستخدام مَعلمة عنوان URL $fields أو fields، أو باستخدام عنوان HTTP/gRPC X-Goog-FieldMask (راجِع مَعلمات وعناوين URL المتاحة). القيمة هي قائمة بمسارات الحقول مفصولة بفواصل. يمكنك الاطّلاع على هذه المستندات التفصيلية حول كيفية إنشاء مسارات الحقول.

على سبيل المثال، في هذه الطريقة:

  • قناع الحقل لجميع الحقول المتاحة (للفحص اليدوي): X-Goog-FieldMask: *
  • قناع الحقل الخاص بمدد المسارات ومسافاتها وحالة العناصر وحالتها وفهارس العناصر (مثال على إعداد الإنتاج): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

من الضروري تضمين status في قناع الحقل، وإلا ستظهر جميع الرسائل على أنّها صحيحة. لا تنصح Google باستخدام قناع حقل الردّ الذي يتضمّن حرف البدل (*) للأسباب التالية:

  • يساعد اختيار الحقول التي تحتاج إليها فقط الخادم في توفير دورات الحوسبة، ما يسمح لنا بعرض النتيجة لك بزمن انتقال أقل.
  • يضمن اختيار الحقول التي تحتاج إليها فقط في مهمة الإنتاج تحقيق أداء مستقر من حيث وقت الاستجابة. قد نضيف المزيد من حقول الردود في المستقبل، وقد تتطلّب هذه الحقول الجديدة وقتًا إضافيًا للمعالجة. في حال اختيار جميع الحقول، أو إذا اخترت جميع الحقول على المستوى الأعلى، قد ينخفض الأداء لأنّ أي حقل جديد نضيفه سيتم تضمينه تلقائيًا في الردّ.
  • يؤدي اختيار الحقول التي تحتاج إليها فقط إلى تقليل حجم الردّ، وبالتالي زيادة معدل نقل البيانات على الشبكة.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

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

ملاحظة: تتطلّب هذه الطريقة تحديد قناع حقل الردّ في الإدخال. يمكنك تقديم قناع حقل الاستجابة باستخدام مَعلمة عنوان URL $fields أو fields، أو باستخدام عنوان HTTP/gRPC X-Goog-FieldMask (راجِع مَعلمات وعناوين URL المتاحة). القيمة هي قائمة بمسارات الحقول مفصولة بفواصل. اطّلِع على مستندات تفصيلية حول كيفية إنشاء مسارات الحقول.

على سبيل المثال، في هذه الطريقة:

  • قناع الحقل لجميع الحقول المتاحة (للفحص اليدوي): X-Goog-FieldMask: *
  • قناع الحقل الخاص بالمدة والمسافة والمضلّع على مستوى المسار (مثال على إعداد الإنتاج): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

لا تشجّع Google على استخدام قناع حقل الردّ الذي يتضمّن حرف البدل (*) أو تحديد قناع الحقل على المستوى الأعلى (routes)، وذلك للأسباب التالية:

  • يساعد اختيار الحقول التي تحتاج إليها فقط الخادم في توفير دورات الحوسبة، ما يسمح لنا بعرض النتيجة لك بزمن انتقال أقل.
  • يضمن اختيار الحقول التي تحتاج إليها فقط في مهمة الإنتاج تحقيق أداء مستقر من حيث وقت الاستجابة. قد نضيف المزيد من حقول الردود في المستقبل، وقد تتطلّب هذه الحقول الجديدة وقتًا إضافيًا للمعالجة. في حال اختيار جميع الحقول، أو إذا اخترت جميع الحقول على المستوى الأعلى، قد ينخفض الأداء لأنّ أي حقل جديد نضيفه سيتم تضمينه تلقائيًا في الردّ.
  • يؤدي اختيار الحقول التي تحتاج إليها فقط إلى تقليل حجم الردّ، وبالتالي زيادة معدل نقل البيانات على الشبكة.

ComputeRouteMatrixRequest

رسالة طلب ComputeRouteMatrix

الحقول
origins[]

RouteMatrixOrigin

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

  • يجب ألا يزيد مجموع عدد نقاط البداية وعدد نقاط الوجهة المحدّدة على النحو place_id أو address عن 50.
  • يجب ألا يزيد ناتج عدد نقاط البداية × عدد نقاط النهاية عن 625 في أي حال من الأحوال.
  • يجب ألا يزيد ناتج عدد نقاط البداية × عدد نقاط الوجهة عن 100 إذا تم ضبط routing_preference على TRAFFIC_AWARE_OPTIMAL.
  • يجب ألا يزيد ناتج عدد نقاط الأصل × عدد نقاط الوجهة عن 100 إذا تم ضبط travel_mode على TRANSIT.
destinations[]

RouteMatrixDestination

مطلوب. مصفوفة الوجهات التي تحدّد أعمدة مصفوفة الردّ.
travel_mode

RouteTravelMode

اختيارية: تحدّد هذه السمة وسيلة النقل.
routing_preference

RoutingPreference

اختيارية: تحدّد هذه السمة كيفية احتساب المسار. يحاول الخادم استخدام إعدادات التوجيه المفضّلة المحدّدة لحساب المسار. إذا أدّى خيار التوجيه إلى حدوث خطأ أو تأخير طويل جدًا، سيتم عرض رسالة خطأ. يمكنك تحديد هذا الخيار فقط عندما تكون قيمة travel_mode هي DRIVE أو TWO_WHEELER، وإلا سيتعذّر تنفيذ الطلب.
departure_time

Timestamp

اختيارية: وقت المغادرة في حال عدم ضبط هذه القيمة، سيتم تلقائيًا ضبطها على الوقت الذي أرسلت فيه الطلب. ملاحظة: لا يمكنك تحديد departure_time في الماضي إلا عندما يكون RouteTravelMode مضبوطًا على TRANSIT.
arrival_time

Timestamp

اختيارية: وقت الوصول ملاحظة: لا يمكن ضبط هذا الخيار إلا عندما يكون RouteTravelMode مضبوطًا على TRANSIT. يمكنك تحديد departure_time أو arrival_time، ولكن ليس كليهما.
language_code

string

اختيارية: تمثّل هذه السمة رمز اللغة المستخدَمة في وصف المراجعة وفق المعيار BCP-47، مثل "en-US" أو "sr-Latn". لمزيد من المعلومات، يُرجى الاطّلاع على معرّف اللغة في Unicode. اطّلِع على اللغات المتاحة للحصول على قائمة باللغات المتاحة. عندما لا تقدّم هذه القيمة، يتم استنتاج لغة العرض من الموقع الجغرافي للمصدر الأول.
region_code

string

اختيارية: رمز المنطقة، ويتم تحديده كقيمة من حرفين لنطاق المستوى الأعلى لرمز البلد (ccTLD). لمزيد من المعلومات، يُرجى الاطّلاع على نطاقات المستوى الأعلى التي يتم ترميزها حسب البلد.
units

Units

اختيارية: تحدّد هذه السمة وحدات القياس لحقول العرض.
extra_computations[]

ExtraComputation

اختيارية: قائمة بالحسابات الإضافية التي يمكن استخدامها لإكمال الطلب. ملاحظة: قد تؤدي هذه العمليات الحسابية الإضافية إلى عرض حقول إضافية في الردّ. يجب أيضًا تحديد هذه الحقول الإضافية في قناع الحقل ليتم عرضها في الردّ.
traffic_model

TrafficModel

اختيارية: تحدّد هذه السمة الافتراضات التي يجب استخدامها عند حساب الوقت المستغرَق في حركة المرور. يؤثّر هذا الإعداد في القيمة المعروضة في حقل المدة في RouteMatrixElement الذي يحتوي على الوقت المتوقّع في حركة المرور استنادًا إلى المتوسطات السابقة. لا تتوفّر TrafficModel إلا للطلبات التي تم ضبط RoutingPreference فيها على TRAFFIC_AWARE_OPTIMAL وRouteTravelMode على DRIVE. يتم ضبط القيمة تلقائيًا على BEST_GUESS إذا تم طلب الزيارات ولم يتم تحديد TrafficModel.
transit_preferences

TransitPreferences

اختيارية: تحدّد هذه السمة الإعدادات المفضّلة التي تؤثر في المسار الذي يتم عرضه للمسارات من النوع TRANSIT. ملاحظة: لا يمكنك تحديد transit_preferences إلا عندما يتم ضبط RouteTravelMode على TRANSIT.

ExtraComputation

عمليات حسابية إضافية يجب إجراؤها أثناء إكمال الطلب

عمليات التعداد
EXTRA_COMPUTATION_UNSPECIFIED لم يتم استخدامه. ولن يتم تنفيذ الطلبات التي تحتوي على هذه القيمة.
TOLLS معلومات الرسوم الخاصة بعناصر المصفوفة

ComputeRoutesRequest

رسالة طلب ComputeRoutes

الحقول
origin

Waypoint

مطلوب. نقطة طريق المصدر
destination

Waypoint

مطلوب. نقطة الطريق للوجهة
intermediates[]

Waypoint

اختيارية: مجموعة من نقاط المرور على طول المسار (باستثناء نقاط النهاية)، إما للتوقف عندها أو المرور بها يمكن إضافة ما يصل إلى 25 نقطة طريق وسيطة.
travel_mode

RouteTravelMode

اختيارية: تحدّد هذه السمة وسيلة النقل.
routing_preference

RoutingPreference

اختيارية: تحدّد هذه السمة كيفية احتساب المسار. يحاول الخادم استخدام إعدادات التوجيه المفضّلة المحدّدة لحساب المسار. إذا أدّى خيار التوجيه المفضّل إلى حدوث خطأ أو تأخير طويل جدًا، سيتم عرض خطأ. يمكنك تحديد هذا الخيار فقط عندما تكون قيمة travel_mode هي DRIVE أو TWO_WHEELER، وإلا سيتعذّر تنفيذ الطلب.
polyline_quality

PolylineQuality

اختيارية: تحدّد هذه السمة إعداداتك المفضّلة لجودة الخط المتعدد الأضلاع.
polyline_encoding

PolylineEncoding

اختيارية: تحدّد هذه السمة الترميز المفضّل للخط المتعدد الأضلاع.
departure_time

Timestamp

اختيارية: وقت المغادرة في حال عدم ضبط هذه القيمة، سيتم تلقائيًا ضبطها على الوقت الذي أرسلت فيه الطلب. ملاحظة: لا يمكنك تحديد departure_time في الماضي إلا عندما يكون RouteTravelMode مضبوطًا على TRANSIT. تتوفّر رحلات النقل العام لمدة تصل إلى 7 أيام في الماضي أو 100 يوم في المستقبل.
arrival_time

Timestamp

اختيارية: وقت الوصول ملاحظة: يتم تجاهل هذا الحقل عندما تحدّد الطلبات RouteTravelMode غير TRANSIT. يمكنك تحديد departure_time أو arrival_time، ولكن ليس كليهما. تتوفّر رحلات النقل العام لمدة تصل إلى 7 أيام في الماضي أو 100 يوم في المستقبل.
compute_alternative_routes

bool

اختيارية: تحدّد هذه السمة ما إذا كان سيتم احتساب المسارات البديلة بالإضافة إلى المسار. لا يتم عرض طرق بديلة للطلبات التي تتضمّن نقاط توقّف وسيطة.
route_modifiers

RouteModifiers

اختيارية: مجموعة من الشروط التي يجب استيفاؤها والتي تؤثر في طريقة احتساب المسارات
language_code

string

اختيارية: تمثّل هذه السمة رمز اللغة المستخدَمة في وصف المراجعة وفق المعيار BCP-47، مثل "en-US" أو "sr-Latn". لمزيد من المعلومات، يُرجى الاطّلاع على معرّف اللغة في Unicode. اطّلِع على اللغات المتاحة للحصول على قائمة باللغات المتاحة. عندما لا تقدّم هذه القيمة، يتم استنتاج لغة العرض من الموقع الجغرافي لطلب المسار.
region_code

string

اختيارية: رمز المنطقة، ويتم تحديده كقيمة من حرفين لنطاق المستوى الأعلى لرمز البلد (ccTLD). لمزيد من المعلومات، يُرجى الاطّلاع على نطاقات المستوى الأعلى التي يتم ترميزها حسب البلد.
units

Units

اختيارية: تحدّد هذه السمة وحدات القياس لحقول العرض. تتضمّن هذه الحقول الحقل instruction في NavigationInstruction. لا تتأثر وحدات القياس المستخدَمة للمسار والجزء والخطوة والمسافة والمدة بهذه القيمة. في حال عدم توفير هذه القيمة، يتم استنتاج وحدات العرض من موقع المصدر الأول.
optimize_waypoint_order

bool

اختيارية: إذا تم ضبطها على "صحيح"، تحاول الخدمة تقليل التكلفة الإجمالية للمسار من خلال إعادة ترتيب نقاط المرور الوسيطة المحدّدة. يتعذّر تنفيذ الطلب إذا كانت أي من نقاط الطريق الوسيطة هي نقطة طريق via. استخدِم ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index للعثور على الترتيب الجديد. إذا لم يتم طلب ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index في العنوان X-Goog-FieldMask، سيتعذّر تنفيذ الطلب. إذا تم ضبط optimize_waypoint_order على "خطأ"، سيكون ComputeRoutesResponse.optimized_intermediate_waypoint_index فارغًا.
requested_reference_routes[]

ReferenceRoute

اختيارية: تحدّد هذه السمة مسارات المراجع المطلوب احتسابها كجزء من الطلب بالإضافة إلى المسار التلقائي. المسار المرجعي هو مسار يختلف عن المسار التلقائي في هدف احتساب المسار. على سبيل المثال، تأخذ FUEL_EFFICIENT عملية حساب المسار المرجعي في الاعتبار معلَمات مختلفة من شأنها إنشاء مسار مثالي موفّر للوقود. عند استخدام هذه الميزة، ابحث عن route_labels في المسارات الناتجة.
extra_computations[]

ExtraComputation

اختيارية: قائمة بالحسابات الإضافية التي يمكن استخدامها لإكمال الطلب. ملاحظة: قد تؤدي هذه العمليات الحسابية الإضافية إلى عرض حقول إضافية في الردّ. يجب أيضًا تحديد هذه الحقول الإضافية في قناع الحقل ليتم عرضها في الردّ.
traffic_model

TrafficModel

اختيارية: تحدّد هذه السمة الافتراضات التي يجب استخدامها عند حساب الوقت المستغرَق في حركة المرور. يؤثر هذا الإعداد في القيمة المعروضة في حقل المدة في Route وRouteLeg، والذي يحتوي على الوقت المتوقّع في حركة المرور استنادًا إلى المتوسطات السابقة. لا تتوفّر TrafficModel إلا للطلبات التي تم ضبط RoutingPreference فيها على TRAFFIC_AWARE_OPTIMAL وRouteTravelMode على DRIVE. يتم ضبط القيمة تلقائيًا على BEST_GUESS إذا تم طلب الزيارات ولم يتم تحديد TrafficModel.
transit_preferences

TransitPreferences

اختيارية: تحدّد هذه السمة الإعدادات المفضّلة التي تؤثر في المسار الذي يتم عرضه للمسارات من النوع TRANSIT. ملاحظة: لا يمكنك تحديد transit_preferences إلا عندما يتم ضبط RouteTravelMode على TRANSIT.

ExtraComputation

عمليات حسابية إضافية يجب إجراؤها أثناء إكمال الطلب

عمليات التعداد
EXTRA_COMPUTATION_UNSPECIFIED لم يتم استخدامه. ولن يتم تنفيذ الطلبات التي تحتوي على هذه القيمة.
TOLLS تعرض هذه السمة معلومات عن رسوم المرور على الطرق.
FUEL_CONSUMPTION استهلاك الوقود المقدَّر للمسارات
TRAFFIC_ON_POLYLINE خطوط متعدّدة الأضلاع تراعي حركة المرور للطرق
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions معروضة كسلسلة نصية منسَّقة بتنسيق HTML. يجب قراءة هذا المحتوى كما هو، وهو مخصّص للعرض فقط. لا تحلّلها آليًا.
FLYOVER_INFO_ON_POLYLINE معلومات عن المسارات الجوية يجب تحديد routes.polyline_details.flyover_info fieldmask لعرض هذه المعلومات. في الوقت الحالي، لن يتم ملء هذه البيانات إلا لبعض المدن الكبرى في الهند. هذه الميزة تجريبية، وقد يتغير رمز التخزين التعريفي/الرسوم.
NARROW_ROAD_INFO_ON_POLYLINE معلومات عن الطرق الضيقة للمسارات يجب تحديد routes.polyline_details.narrow_road_info fieldmask لعرض هذه المعلومات. في الوقت الحالي، لن يتم ملء هذه البيانات إلا لبعض المدن الكبرى في الهند. هذه الميزة تجريبية، وقد يتغير رمز التخزين التعريفي/الرسوم.

ReferenceRoute

مسار مرجعي متوافق في ComputeRoutesRequest

عمليات التعداد
REFERENCE_ROUTE_UNSPECIFIED لم يتم استخدامه. لن يتم تنفيذ الطلبات التي تحتوي على هذه القيمة.
FUEL_EFFICIENT مسار أقل استهلاكًا للوقود
SHORTER_DISTANCE

مسار بمسافة سفر أقصر هذه ميزة تجريبية.

بالنسبة إلى طلبات DRIVE، تعطي هذه الميزة الأولوية للمسافة الأقصر على حساب راحة القيادة. على سبيل المثال، قد يفضّل الطرق المحلية بدلاً من الطرق السريعة، أو يسلك الطرق الترابية، أو يمرّ عبر مواقف السيارات، وما إلى ذلك. ولا تعرض هذه الميزة أي مناورات تعرف "خرائط Google" أنّها غير قانونية.

بالنسبة إلى طلبات BICYCLE وTWO_WHEELER، تعرض هذه الميزة طرقًا مشابهة لتلك التي يتم عرضها عند عدم تحديد requested_reference_routes.

لا تتوافق هذه الميزة مع أي وسائل نقل أخرى أو نقاط توقّف وسيطة أو optimize_waypoint_order، وستتعذّر معالجة هذه الطلبات. ومع ذلك، يمكنك استخدامه مع أي routing_preference.

ComputeRoutesResponse

ComputeRoutes هي رسالة الرد.

الحقول
routes[]

Route

تحتوي على مصفوفة من المسارات المحسوبة (بحد أقصى ثلاثة) عند تحديد compute_alternatives_routes، وتحتوي على مسار واحد فقط عند عدم تحديدها. عندما تحتوي هذه المصفوفة على إدخالات متعددة، يكون الإدخال الأول هو المسار الأكثر اقتراحًا. إذا كانت المصفوفة فارغة، يعني ذلك أنّه لم يتم العثور على أي مسار.
fallback_info

FallbackInfo

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

GeocodingResults

يحتوي على معلومات استجابة الترميز الجغرافي لنقاط الطريق المحدّدة كعناوين.

FallbackInfo

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

الحقول
routing_mode

FallbackRoutingMode

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

FallbackReason

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

FallbackReason

أسباب استخدام الرد الاحتياطي

عمليات التعداد
FALLBACK_REASON_UNSPECIFIED لم يتم تحديد سبب احتياطي.
SERVER_ERROR حدث خطأ في الخادم أثناء احتساب المسارات باستخدام وضع التوجيه المفضّل لديك، ولكن تمكّنا من عرض نتيجة تم احتسابها باستخدام وضع بديل.
LATENCY_EXCEEDED لم نتمكّن من إنهاء عملية الحساب باستخدام وضع التوجيه المفضّل لديك في الوقت المناسب، ولكن تمكّنا من عرض نتيجة محسوبة باستخدام وضع بديل.

FallbackRoutingMode

وضع التوجيه الفعلي المستخدَم للرد الاحتياطي الذي تم إرجاعه.

عمليات التعداد
FALLBACK_ROUTING_MODE_UNSPECIFIED لم يتم استخدامه.
FALLBACK_TRAFFIC_UNAWARE يشير إلى أنّه تم استخدام TRAFFIC_UNAWARE RoutingPreference لاحتساب الردّ.
FALLBACK_TRAFFIC_AWARE يشير إلى أنّه تم استخدام TRAFFIC_AWARE RoutingPreference لاحتساب الردّ.

GeocodedWaypoint

تفاصيل حول المواقع الجغرافية المستخدَمة كنقاط توقّف تتم تعبئة هذا الحقل لنقاط الطريق التي تتضمّن عناوين فقط. تتضمّن تفاصيل حول نتائج الترميز الجغرافي لتحديد الموقع الجغرافي الذي تم ترميز العنوان إليه.

الحقول
geocoder_status

Status

تشير إلى رمز الحالة الناتج من عملية الترميز الجغرافي.
type[]

string

أنواع النتيجة، في شكل علامات نوع واحدة أو أكثر الأنواع المتوافقة: أنواع العناوين وأنواع عناصر العناوين
partial_match

bool

يشير إلى أنّ أداة الترميز الجغرافي لم تعرض تطابقًا تامًا للطلب الأصلي، على الرغم من أنّها تمكّنت من مطابقة جزء من العنوان المطلوب. ننصحك بمراجعة الطلب الأصلي بحثًا عن أخطاء إملائية و/أو عنوان غير مكتمل.
place_id

string

رقم تعريف المكان لهذه النتيجة.
intermediate_waypoint_request_index

int32

فهرس نقطة الطريق الوسيطة المقابلة في الطلب. لا تتم تعبئة هذا الحقل إلا إذا كانت نقطة الطريق المقابلة هي نقطة طريق وسيطة.

GeocodingResults

تحتوي على GeocodedWaypoints لنقطة الانطلاق والوجهة ونقاط المرور الوسيطة. تتم تعبئة هذا الحقل لنقاط الطريق التي تتضمّن عناوين فقط.

الحقول
origin

GeocodedWaypoint

نقطة طريق جغرافية تم ترميزها جغرافيًا
destination

GeocodedWaypoint

نقطة طريق تم ترميزها جغرافيًا في الوجهة
intermediates[]

GeocodedWaypoint

قائمة بنقاط الطريق الوسيطة التي تم ترميزها جغرافيًا، ويحتوي كل منها على حقل فهرس يتوافق مع الموضع المستند إلى الصفر لنقطة الطريق بالترتيب الذي تم تحديده في الطلب.

LocalizedTime

الوصف المترجَم للوقت

الحقول
time

LocalizedText

الوقت المحدّد كسلسلة في منطقة زمنية معيّنة
time_zone

string

تحتوي هذه السمة على المنطقة الزمنية. القيمة هي اسم المنطقة الزمنية كما هو محدّد في قاعدة بيانات المناطق الزمنية IANA، مثل "America/New_York".

الموقع الجغرافي

تتضمّن هذه السمة موقعًا جغرافيًا (نقطة جغرافية واتجاهًا اختياريًا).

الحقول
lat_lng

LatLng

الإحداثيات الجغرافية لنقطة الطريق
heading

Int32Value

تمثّل هذه السمة اتجاه البوصلة المرتبط باتجاه حركة المرور. تحدّد هذه القيمة جهة الطريق التي سيتم فيها الاستلام والتسليم. يمكن أن تتراوح قيم الاتجاه من 0 إلى 360، حيث يشير 0 إلى اتجاه الشمال، ويشير 90 إلى اتجاه الشرق، وهكذا. يمكنك استخدام هذا الحقل فقط مع DRIVE وTWO_WHEELER RouteTravelMode.

Maneuver

مجموعة من القيم التي تحدّد إجراء التنقّل الذي يجب اتّخاذه في الخطوة الحالية (على سبيل المثال، الانعطاف إلى اليسار أو الدمج أو الاستمرار في السير بشكل مستقيم)

عمليات التعداد
MANEUVER_UNSPECIFIED لم يتم استخدامه.
TURN_SLIGHT_LEFT يُرجى الانعطاف قليلاً إلى اليسار.
TURN_SHARP_LEFT انعطف بشدة إلى اليسار.
UTURN_LEFT يُرجى الدوران إلى اليسار والاتجاه المعاكس.
TURN_LEFT اتّجه يسارًا.
TURN_SLIGHT_RIGHT يُرجى الانحراف قليلاً إلى اليمين.
TURN_SHARP_RIGHT اتّجه يمينًا بشكل حاد.
UTURN_RIGHT يُرجى الدوران للاتجاه المعاكس نحو اليمين.
TURN_RIGHT انعطِف يمينًا.
STRAIGHT مواصلة السير بشكل مستقيم
RAMP_LEFT اتّبِعوا الطريق المنحدر الأيسر.
RAMP_RIGHT اتّبِع المنحدر الأيمن.
MERGE الدمج مع حركة المرور
FORK_LEFT اتّبِعوا الطريق المتفرّع على اليسار.
FORK_RIGHT اتّبِع الطريق المتفرّع على اليمين.
FERRY استقلّ العبّارة.
FERRY_TRAIN استقلّ القطار الذي يؤدي إلى العبّارة.
ROUNDABOUT_LEFT اتّجِه يسارًا عند المستديرة.
ROUNDABOUT_RIGHT اتّجِه يمينًا عند الدوّار.
DEPART المناورة الأولية
NAME_CHANGE تُستخدَم للإشارة إلى تغيير في اسم الشارع.

تتضمّن هذه السمة تعليمات التنقّل الخاصة بـ RouteLegStep.

الحقول
maneuver

Maneuver

تتضمّن هذه السمة تعليمات التنقّل للخطوة الحالية (على سبيل المثال، الانعطاف إلى اليسار أو الدمج أو المتابعة بشكل مستقيم). يحدّد هذا الحقل الرمز الذي سيتم عرضه.
instructions

string

تعليمات التنقّل في هذه الخطوة

خط متعدد

تغليف خط متعدد الأضلاع مشفّر

الحقول
حقل الدمج polyline_type تضم هذه السمة نوع الخط المتعدد. القيمة التلقائية هي encoded_polyline. يمكن أن تكون polyline_type إحدى القيم التالية فقط:
encoded_polyline

string

تمثّل هذه السمة الترميز السلسلي لخط متعدد الأضلاع باستخدام خوارزمية ترميز الخطوط المتعددة الأضلاع.
geo_json_linestring

Struct

تحدّد هذه السمة خطًا متعدد الأجزاء باستخدام تنسيق GeoJSON LineString.

PolylineDetails

تفاصيل تتوافق مع فهرس معيّن أو جزء متجاور من خط متعدد الانحناءات بمعلومية خط متعدد الأضلاع يتضمّن النقاط P_0 وP_1 و... وP_N (فهرس يبدأ من الصفر)، يحدّد PolylineDetails فترة زمنية وبيانات وصفية مرتبطة بها.

الحقول
flyover_info[]

FlyoverInfo

تفاصيل التحليق فوق المسار على طول الخط المتعدد
narrow_road_info[]

NarrowRoadInfo

تفاصيل الطريق الضيق على طول الخط المتعدد الأضلاع

FlyoverInfo

تغليف المعلومات حول الرحلات الجوية فوق خطوط متعددة الأضلاع

الحقول
flyover_presence

RoadFeatureState

النتائج فقط. تشير إلى ما إذا كان هناك جسر علوي لجزء معيّن من الخط المتعدد الأضلاع.
polyline_point_index

PolylinePointIndex

تمثّل هذه السمة الموقع الجغرافي للمعلومات ذات الصلة بالتحليق فوق المعالم على طول الخط المتعدد.

NarrowRoadInfo

تغلف هذه السمة معلومات حول الطرق الضيقة على طول الخط المتعدد الأضلاع.

الحقول
narrow_road_presence

RoadFeatureState

النتائج فقط. تشير هذه السمة إلى ما إذا كانت هناك طريق ضيقة في جزء معيّن من الخط المتعدد الأضلاع.
polyline_point_index

PolylinePointIndex

تمثّل هذه السمة موقع المعلومات ذات الصلة بالطرق الضيقة على طول الخط المتعدد.

PolylinePointIndex

تتضمّن هذه السمة فهارس البدء والانتهاء لتفاصيل الخط المتعدد الأضلاع. في الحالات التي تتوافق فيها البيانات مع نقطة واحدة، ستكون قيمة start_index مساوية لقيمة end_index.

الحقول
start_index

int32

فهرس البدء لهذه التفاصيل في الخط المتعدد الأضلاع
end_index

int32

الفهرس النهائي لهذه التفاصيل في الخط المتعدد الأضلاع

RoadFeatureState

تغليف حالات عناصر الطرق على طول جزء من خط متعدد

عمليات التعداد
ROAD_FEATURE_STATE_UNSPECIFIED لم يتم احتساب حالة عنصر الطريق (القيمة التلقائية).
EXISTS تتوفّر ميزة الطريق.
DOES_NOT_EXIST لا تتوفّر ميزة الطريق.

PolylineEncoding

تحدّد هذه السمة النوع المفضّل من الخطوط المتعددة التي سيتم عرضها.

عمليات التعداد
POLYLINE_ENCODING_UNSPECIFIED لم يتم تحديد أي إعدادات مفضّلة لنوع الخط المتعدد. القيمة التلقائية هي ENCODED_POLYLINE.
ENCODED_POLYLINE تحدّد هذه السمة خطًا متعدد الأضلاع تم ترميزه باستخدام خوارزمية ترميز الخطوط المتعددة الأضلاع.
GEO_JSON_LINESTRING تحدّد هذه السمة خطًا متعدد الأضلاع باستخدام تنسيق GeoJSON LineString

PolylineQuality

مجموعة من القيم التي تحدّد جودة الخط المتعدد الأضلاع.

عمليات التعداد
POLYLINE_QUALITY_UNSPECIFIED لم يتم تحديد أي إعدادات مفضّلة لجودة الخطوط المتعددة. القيمة التلقائية هي OVERVIEW.
HIGH_QUALITY تحدّد هذه السمة خطًا متعدد الأضلاع عالي الجودة، ويتألف من نقاط أكثر من OVERVIEW، ولكنّ ذلك يؤدي إلى زيادة حجم الردّ. استخدِم هذه القيمة عندما تحتاج إلى المزيد من الدقة.
OVERVIEW تحدّد هذه السمة خطًا متعدد الأضلاع يقدّم نظرة عامة، وهو يتألف من عدد صغير من النقاط. استخدِم هذه القيمة عند عرض نظرة عامة على المسار. يؤدي استخدام هذا الخيار إلى تقليل وقت استجابة الطلب مقارنةً باستخدام الخيار HIGH_QUALITY.

مسار

يحتوي على مسار يتألف من سلسلة من مقاطع الطرق المتصلة التي تربط بين نقاط الطريق في البداية والنهاية والمنتصف.

الحقول
route_labels[]

RouteLabel

تصنيفات Route مفيدة لتحديد خصائص معيّنة للطريق من أجل مقارنتها بغيرها
legs[]

RouteLeg

مجموعة من الأجزاء (أجزاء المسار بين نقاط المرور) التي تشكّل المسار يتوافق كل جزء مع الرحلة بين نقطتَين غير via Waypoints. على سبيل المثال، لا يحتوي المسار الذي لا يتضمّن نقاط توقّف وسيطة إلا على جزء واحد. يتضمّن المسار الذي يتضمّن نقطة طريق وسيطة واحدة غير via جزأين. يتضمّن المسار الذي يشمل نقطة طريق وسيطة واحدة via جزءًا واحدًا. يتطابق ترتيب الأجزاء مع ترتيب نقاط الطريق من origin إلى intermediates إلى destination.
distance_meters

int32

تمثّل هذه السمة مسافة الرحلة على طول المسار، وذلك بالمتر.
duration

Duration

هي المدة الزمنية اللازمة للتنقّل على طول المسار. إذا ضبطت قيمة routing_preference على TRAFFIC_UNAWARE، ستكون هذه القيمة هي نفسها قيمة static_duration. إذا ضبطت routing_preference على TRAFFIC_AWARE أو TRAFFIC_AWARE_OPTIMAL، يتم احتساب هذه القيمة مع أخذ حالة حركة المرور في الاعتبار.
static_duration

Duration

تمثّل هذه السمة مدة السفر عبر المسار بدون أخذ أحوال حركة المرور في الاعتبار.
polyline

Polyline

الخطوط المتعددة للمسار بشكل عام هذا الخط المتعدد هو الخط المتعدد المدمج لجميع legs.
description

string

تمثّل هذه السمة وصفًا للمسار.
warnings[]

string

مصفوفة من التحذيرات التي يجب عرضها عند عرض المسار.
viewport

Viewport

مربّع حدود إطار العرض للخط المتعدد
travel_advisory

RouteTravelAdvisory

معلومات إضافية حول المسار
optimized_intermediate_waypoint_index[]

int32

في حال ضبط optimize_waypoint_order على "صحيح"، يحتوي هذا الحقل على الترتيب المحسّن لنقاط المرور الوسيطة. وفي ما عدا ذلك، يكون هذا الحقل فارغًا. على سبيل المثال، إذا أدخلت "نقطة الانطلاق: لوس أنجلوس" و"نقاط التوقف الوسيطة: دالاس، بانغور، فينيكس" و"نقطة الوصول: نيويورك" وكان ترتيب نقاط التوقف الوسيطة المحسّن هو "فينيكس، دالاس، بانغور"، سيحتوي هذا الحقل على القيم [2, 0, 1]. يبدأ الفهرس بالرقم 0 لنقطة الطريق الوسيطة الأولى المقدَّمة في الإدخال.
localized_values

RouteLocalizedValues

تمثيلات نصية لسمات Route
route_token

string

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

ملاحظة: لا يتوفّر Route.route_token إلا للطلبات التي تم ضبط ComputeRoutesRequest.routing_preference فيها على TRAFFIC_AWARE أو TRAFFIC_AWARE_OPTIMAL. لا تتوافق Route.route_token مع الطلبات التي تتضمّن نقاط توقّف.
polyline_details

PolylineDetails

تحتوي على معلومات حول التفاصيل على طول الخط المتعدد.

RouteLocalizedValues

تمثيلات نصية لبعض السمات

الحقول
distance

LocalizedText

المسافة المقطوعة ممثّلة في شكل نص.
duration

LocalizedText

المدة، ويتم تمثيلها في شكل نصي وتتم ملاءمتها مع المنطقة التي تم فيها البحث. تأخذ في الاعتبار أحوال حركة المرور ملاحظة: إذا لم تطلب معلومات حول حركة المرور، ستكون هذه القيمة هي نفسها قيمة static_duration.
static_duration

LocalizedText

المدة بدون أخذ أحوال حركة المرور في الاعتبار، ويتم عرضها في شكل نص.
transit_fare

LocalizedText

تمثّل هذه السمة أجرة النقل العام في شكل نص.

RouteLabel

تصنيفات Route مفيدة لتحديد خصائص معيّنة للطريق من أجل مقارنتها بغيرها

عمليات التعداد
ROUTE_LABEL_UNSPECIFIED تلقائي - غير مستخدَم
DEFAULT_ROUTE المسار "الأفضل" التلقائي الذي تم عرضه عند احتساب المسار
DEFAULT_ROUTE_ALTERNATE مسار بديل للمسار "الأفضل" التلقائي سيتم عرض مسارات مشابهة عند تحديد compute_alternative_routes.
FUEL_EFFICIENT مسار أقل استهلاكًا للوقود يتم تحديد المسارات المصنّفة بهذه القيمة على أنّها محسّنة لمَعلمات الوضع الاقتصادي، مثل استهلاك الوقود.
SHORTER_DISTANCE مسار أقصر من حيث مسافة السفر هذه ميزة تجريبية.

RouteLeg

يحتوي على جزء بين نقاط طريق غير via

الحقول
distance_meters

int32

تمثّل هذه السمة مسافة التنقّل في جزء من المسار، وذلك بالأمتار.
duration

Duration

تمثّل هذه السمة المدة الزمنية اللازمة للتنقّل في الجزء من الرحلة. إذا تم ضبط route_preference على TRAFFIC_UNAWARE، تكون هذه القيمة هي نفسها static_duration. إذا كانت قيمة route_preference هي TRAFFIC_AWARE أو TRAFFIC_AWARE_OPTIMAL، يتم احتساب هذه القيمة مع أخذ حالة حركة المرور في الاعتبار.
static_duration

Duration

مدة التنقّل خلال الجزء من الرحلة، ويتم احتسابها بدون أخذ ظروف حركة المرور في الاعتبار
polyline

Polyline

الخطوط المتعددة الإجمالية لهذه المرحلة التي تتضمّن الخطوط المتعددة لكل step
start_location

Location

الموقع الجغرافي لبداية هذا الجزء من الرحلة قد يختلف هذا الموقع الجغرافي عن origin المقدَّم. على سبيل المثال، عندما لا تكون قيمة origin المقدَّمة بالقرب من طريق، تكون هذه نقطة على الطريق.
end_location

Location

تمثّل هذه السمة الموقع الجغرافي النهائي لهذه الرحلة. قد يختلف هذا الموقع الجغرافي عن destination المقدَّم. على سبيل المثال، عندما لا تكون قيمة destination المقدَّمة بالقرب من طريق، تكون هذه نقطة على الطريق.
steps[]

RouteLegStep

مصفوفة من الخطوات تشير إلى الأقسام ضمن هذه الرحلة تمثّل كل خطوة تعليمات تنقّل واحدة.
travel_advisory

RouteLegTravelAdvisory

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

RouteLegLocalizedValues

تمثيلات نصية لسمات RouteLeg
steps_overview

StepsOverview

معلومات عامة عن الخطوات الواردة في RouteLeg لا تتم تعبئة هذا الحقل إلا لمسارات النقل العام.

RouteLegLocalizedValues

تمثيلات نصية لبعض السمات

الحقول
distance

LocalizedText

المسافة المقطوعة ممثّلة في شكل نص.
duration

LocalizedText

المدة، ويتم تمثيلها في شكل نصي وتتم ملاءمتها مع المنطقة التي تم فيها البحث. تأخذ في الاعتبار أحوال حركة المرور ملاحظة: إذا لم تطلب معلومات حول حركة المرور، ستكون هذه القيمة هي القيمة نفسها التي تم تعيينها لـ static_duration.
static_duration

LocalizedText

المدة بدون أخذ أحوال حركة المرور في الاعتبار، ويتم عرضها في شكل نص.

StepsOverview

يوفّر معلومات عامة عن قائمة RouteLegStep.

الحقول
multi_modal_segments[]

MultiModalSegment

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

MultiModalSegment

تقدّم هذه السمة معلومات موجزة حول الأقسام المختلفة المتعددة الوسائط الخاصة بـ RouteLeg.steps. يتم تعريف المقطع المتعدد الوسائط على أنّه RouteLegStep واحد أو أكثر متجاورين يتضمّنان RouteTravelMode نفسه. لا تتم تعبئة هذا الحقل إذا لم يتضمّن RouteLeg أي أجزاء متعددة الوسائط في الخطوات.

الحقول
navigation_instruction

NavigationInstruction

NavigationInstruction لشريحة الوسائط المتعددة
travel_mode

RouteTravelMode

تمثّل هذه السمة وسيلة النقل المستخدَمة في جزء الرحلة المتعدد الوسائط.
step_start_index

int32

فهرس RouteLegStep المقابل الذي يمثّل بداية مقطع متعدد الوسائط.
step_end_index

int32

فهرس RouteLegStep المقابل الذي يمثّل نهاية مقطع متعدد الوسائط.

RouteLegStep

يحتوي على جزء من RouteLeg. تمثّل الخطوة تعليمات تنقّل واحدة. تتكوّن أجزاء المسار من خطوات.

الحقول
distance_meters

int32

تمثّل هذه السمة مسافة التنقّل لهذه الخطوة بالمتر. في بعض الحالات، قد لا يحتوي هذا الحقل على قيمة.
static_duration

Duration

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

Polyline

الخط المتعدد الأضلاع المرتبط بهذه الخطوة
start_location

Location

الموقع الجغرافي لبداية هذه الخطوة
end_location

Location

تمثّل هذه السمة الموقع الجغرافي النهائي لهذه الخطوة.
navigation_instruction

NavigationInstruction

تعليمات التنقّل
travel_advisory

RouteLegStepTravelAdvisory

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

RouteLegStepLocalizedValues

تمثيلات نصية لسمات RouteLegStep
transit_details

RouteLegStepTransitDetails

تفاصيل متعلقة بهذه الخطوة إذا كان وضع السفر هو TRANSIT
travel_mode

RouteTravelMode

وضع السفر المستخدَم في هذه الخطوة

RouteLegStepLocalizedValues

تمثيلات نصية لبعض السمات

الحقول
distance

LocalizedText

المسافة المقطوعة ممثّلة في شكل نص.
static_duration

LocalizedText

المدة بدون أخذ أحوال حركة المرور في الاعتبار، ويتم عرضها في شكل نص.

RouteLegStepTransitDetails

معلومات إضافية عن RouteLegStep ذات صلة بمسارات TRANSIT

الحقول
stop_details

TransitStopDetails

معلومات عن محطات الوصول والمغادرة للخطوة
localized_values

TransitDetailsLocalizedValues

تمثيلات نصية لسمات RouteLegStepTransitDetails
headsign

string

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

Duration

تحدّد هذه السمة الوقت المتوقّع كمدة زمنية بين مواعيد المغادرة من المحطة نفسها في هذا الوقت. على سبيل المثال، إذا كانت قيمة "الفاصل الزمني بالثواني" هي 600، من المتوقّع أن تنتظر عشر دقائق إذا فاتتك الحافلة.
transit_line

TransitLine

معلومات حول خط النقل العام المستخدَم في هذه الخطوة
stop_count

int32

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

stop_count

تعرض القيمة 3.
trip_short_text

string

النص الذي يظهر في الجداول الزمنية ولوحات الإعلانات لتحديد رحلة نقل عام للمسافرين يجب أن يحدّد النص رحلة بشكل فريد خلال يوم الخدمة. على سبيل المثال، "538" هو trip_short_text لقطار Amtrak الذي يغادر سان خوسيه، كاليفورنيا في الساعة 15:10 في أيام الأسبوع إلى ساكرامنتو، كاليفورنيا.

TransitDetailsLocalizedValues

أوصاف مترجَمة للقيم في RouteTransitDetails

الحقول
arrival_time

LocalizedTime

الوقت في تمثيله النصي المنسَّق مع منطقة زمنية مقابلة
departure_time

LocalizedTime

الوقت في تمثيله النصي المنسَّق مع منطقة زمنية مقابلة

TransitStopDetails

تعرض هذه السمة تفاصيل حول محطات النقل العام الخاصة بـ RouteLegStep.

الحقول
arrival_stop

TransitStop

معلومات عن محطة الوصول الخاصة بالخطوة
arrival_time

Timestamp

الوقت المقدَّر للوصول إلى الخطوة
departure_stop

TransitStop

تمثّل هذه السمة معلومات حول محطة المغادرة للخطوة.
departure_time

Timestamp

الوقت المقدَّر للمغادرة في هذه الخطوة

RouteLegStepTravelAdvisory

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

الحقول
speed_reading_intervals[]

SpeedReadingInterval

ملاحظة: لم تتم تعبئة هذا الحقل حاليًا.

RouteLegTravelAdvisory

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

الحقول
toll_info

TollInfo

تحتوي هذه السمة على معلومات حول رسوم المرور على RouteLeg المحدّد. لا يتم ملء هذا الحقل إلا إذا كنّا نتوقّع وجود رسوم مرور على RouteLeg. إذا تم ضبط هذا الحقل ولكن لم تتم تعبئة الحقل الفرعي estimated_price، نتوقّع أن يحتوي الطريق على رسوم ولكن لا نعرف السعر المقدّر. إذا لم يكن هذا الحقل متوفّرًا، يعني ذلك أنّه لا توجد رسوم مرور على RouteLeg.
speed_reading_intervals[]

SpeedReadingInterval

فواصل القراءة السريعة التي توضّح كثافة حركة المرور ينطبق ذلك في حال إعدادات التوجيه المفضّلة لـ "TRAFFIC_AWARE" و"TRAFFIC_AWARE_OPTIMAL". تغطّي الفواصل الزمنية خطوطًا متعددة الأضلاع كاملة RouteLeg بدون تداخل. تكون نقطة بداية فاصل زمني محدّد هي نفسها نقطة نهاية الفاصل الزمني السابق.

مثال:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).

RouteMatrixDestination

وجهة واحدة لطلب ComputeRouteMatrixRequest

الحقول
waypoint

Waypoint

مطلوب. نقطة الطريق للوجهة

RouteMatrixElement

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

الحقول
status

Status

رمز حالة الخطأ لهذا العنصر.
condition

RouteMatrixElementCondition

تشير إلى ما إذا تم العثور على المسار أم لا. بغض النظر عن الحالة
distance_meters

int32

تمثّل هذه السمة مسافة الرحلة على طول المسار، وذلك بالمتر.
duration

Duration

هي المدة الزمنية اللازمة للتنقّل على طول المسار. إذا ضبطت قيمة routing_preference على TRAFFIC_UNAWARE، ستكون هذه القيمة هي نفسها قيمة static_duration. إذا ضبطت routing_preference على TRAFFIC_AWARE أو TRAFFIC_AWARE_OPTIMAL، يتم احتساب هذه القيمة مع أخذ حالة حركة المرور في الاعتبار.
static_duration

Duration

تمثّل هذه السمة مدة التنقّل على طول المسار بدون أخذ أحوال حركة المرور في الاعتبار.
travel_advisory

RouteTravelAdvisory

معلومات إضافية حول المسار على سبيل المثال: معلومات عن القيود ومعلومات عن رسوم المرور
fallback_info

FallbackInfo

في بعض الحالات التي لا يتمكّن فيها الخادم من احتساب المسار باستخدام الإعدادات المفضّلة المحدّدة لزوج نقطة الأصل/نقطة الوجهة هذا، قد يعود إلى استخدام طريقة احتساب مختلفة. عند استخدام وضع التراجع، يحتوي هذا الحقل على معلومات تفصيلية حول الردّ الاحتياطي. وفي ما عدا ذلك، يتم إلغاء ضبط هذا الحقل.
localized_values

LocalizedValues

تمثيلات نصية لسمات RouteMatrixElement
origin_index

int32

فهرس مستند إلى الصفر للأصل في الطلب
destination_index

int32

فهرس الوجهة المستند إلى الصفر في الطلب

LocalizedValues

تمثيلات نصية لبعض السمات

الحقول
distance

LocalizedText

المسافة المقطوعة ممثّلة في شكل نص.
duration

LocalizedText

المدة ممثّلة في شكل نصي مع أخذ أحوال حركة المرور في الاعتبار ملاحظة: إذا لم يتم طلب معلومات حول حركة المرور، ستكون هذه القيمة هي القيمة نفسها التي تم ضبطها في static_duration.
static_duration

LocalizedText

المدة ممثّلة في شكل نصي بدون أخذ حالة حركة المرور في الاعتبار
transit_fare

LocalizedText

تمثّل هذه السمة أجرة النقل العام في شكل نص.

RouteMatrixElementCondition

تعرض هذه السمة حالة المسار الذي يتم عرضه.

عمليات التعداد
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED يتم استخدامها فقط عندما تكون قيمة status للعنصر غير صالحة.
ROUTE_EXISTS تم العثور على مسار، وتم ملء المعلومات ذات الصلة بالعنصر.
ROUTE_NOT_FOUND لم يتم العثور على أي مسار. لن يتم ملء الحقول التي تحتوي على معلومات المسار، مثل distance_meters أو duration، في العنصر.

RouteMatrixOrigin

مصدر واحد لـ ComputeRouteMatrixRequest

الحقول
waypoint

Waypoint

مطلوب. نقطة طريق المصدر
route_modifiers

RouteModifiers

اختيارية: معدِّلات لكل مسار يستخدِم هذا الموقع الجغرافي كأصل

RouteModifiers

تتضمّن مجموعة من الشروط الاختيارية التي يجب استيفاؤها عند احتساب المسارات.

الحقول
avoid_tolls

bool

عند ضبطها على "صحيح"، تتجنّب الطرق ذات رسوم العبور حيثما كان ذلك معقولاً، مع إعطاء الأولوية للمسارات التي لا تحتوي على طرق ذات رسوم عبور. لا ينطبق هذا الإعداد سوى على DRIVE وTWO_WHEELER RouteTravelMode.
avoid_highways

bool

عند ضبطها على "صحيح"، يتم تجنُّب الطرق السريعة حيثما كان ذلك معقولاً، مع إعطاء الأولوية للمسارات التي لا تحتوي على طرق سريعة. لا ينطبق هذا الإعداد سوى على DRIVE وTWO_WHEELER RouteTravelMode.
avoid_ferries

bool

عند ضبطها على "صحيح"، يتم تجنُّب العبّارات حيثما كان ذلك معقولاً، مع إعطاء الأولوية للمسارات التي لا تحتوي على عبّارات. لا ينطبق هذا الإعداد سوى على DRIVE وTWO_WHEELER RouteTravelMode.
avoid_indoor

bool

عند ضبطها على "صحيح"، يتم تجنُّب التنقّل في الأماكن المغلقة حيثما كان ذلك معقولاً، مع إعطاء الأولوية للمسارات التي لا تتضمّن التنقّل في الأماكن المغلقة. ينطبق هذا الإجراء على WALK RouteTravelMode فقط.
vehicle_info

VehicleInfo

تحدّد هذه السمة معلومات المركبة.
toll_passes[]

TollPass

تتضمّن هذه الفئة معلومات حول بطاقات المرور. في حال توفير بطاقات عبور، تحاول واجهة برمجة التطبيقات عرض سعر البطاقة. في حال عدم توفير بطاقات عبور، ستتعامل واجهة برمجة التطبيقات مع بطاقة العبور على أنّها غير معروفة وستحاول عرض سعر الدفع نقدًا. لا ينطبق هذا الإعداد سوى على DRIVE وTWO_WHEELER RouteTravelMode.

RouteTravelAdvisory

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

الحقول
toll_info

TollInfo

يحتوي على معلومات حول رسوم المرور على الطريق. لا تتم تعبئة هذا الحقل إلا إذا كان من المتوقّع دفع رسوم على طول المسار. في حال ضبط هذا الحقل، ولكن لم تتم تعبئة الحقل الفرعي estimatedPrice، يعني ذلك أنّ المسار يتضمّن رسومًا، ولكن السعر المقدّر غير معروف. في حال عدم ضبط هذا الحقل، يعني ذلك أنّه لا يُتوقّع فرض رسوم على طول المسار.
speed_reading_intervals[]

SpeedReadingInterval

فواصل القراءة السريعة التي توضّح كثافة حركة المرور ينطبق ذلك في حال إعدادات التوجيه المفضّلة لـ "TRAFFIC_AWARE" و"TRAFFIC_AWARE_OPTIMAL". تغطّي الفواصل الزمنية خطوطًا متعددة الأضلاع للمسار بالكامل بدون تداخل. تكون نقطة بداية فاصل زمني محدّد هي نفسها نقطة نهاية الفاصل الزمني السابق.

مثال:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).
fuel_consumption_microliters

int64

استهلاك الوقود المتوقّع بالمايكرولتر
route_restrictions_partially_ignored

bool

قد يتضمّن المسار الذي تم عرضه قيودًا لا تتناسب مع وسيلة النقل أو معدّلات المسار المطلوبة.
transit_fare

Money

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

RouteTravelMode

مجموعة من القيم تُستخدَم لتحديد وسيلة النقل. ملاحظة: إنّ المسارات WALK وBICYCLE وTWO_WHEELER في مرحلة تجريبية وقد لا تتضمّن أحيانًا أرصفة واضحة أو مسارات للمشاة أو مسارات لركوب الدراجات. يجب عرض هذا التحذير للمستخدم على جميع مسارات المشي وركوب الدراجات والدراجات ذات العجلتين التي تعرضها في تطبيقك.

عمليات التعداد
TRAVEL_MODE_UNSPECIFIED لم يتم تحديد وضع السفر. القيمة التلقائية هي DRIVE.
DRIVE السفر بسيارة ركاب
BICYCLE السفر بالدراجة
WALK التنقّل سيرًا على الأقدام
TWO_WHEELER مركبة آلية ذات عجلتين على سبيل المثال، دراجة نارية. يُرجى العلم أنّ هذا يختلف عن BICYCLE وسيلة النقل التي تشمل وسائل النقل التي تعمل بالطاقة البشرية.
TRANSIT التنقّل باستخدام مسارات وسائل النقل العام، حيثما توفّرت

RoutingPreference

مجموعة من القيم التي تحدّد العوامل التي يجب أخذها في الاعتبار عند احتساب المسار.

عمليات التعداد
ROUTING_PREFERENCE_UNSPECIFIED لم يتم تحديد أي إعدادات مفضّلة للتوجيه. القيمة التلقائية هي TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE تحسب المسارات بدون أخذ ظروف حركة المرور في الوقت الفعلي في الاعتبار. مناسبة عندما لا تكون أحوال حركة المرور مهمة أو لا تنطبق. يؤدي استخدام هذه القيمة إلى تحقيق أقل وقت استجابة. ملاحظة: بالنسبة إلى RouteTravelMode وDRIVE وTWO_WHEELER، يستند المسار والمدة المحدّدان إلى شبكة الطرق ومتوسط حالات المرور غير المرتبطة بالوقت، وليس إلى حالات الطرق الحالية. نتيجةً لذلك، قد تتضمّن المسارات طرقًا مغلقة مؤقتًا. قد تختلف نتائج طلب معيّن بمرور الوقت بسبب التغييرات في شبكة الطرق، ومتوسط أحوال حركة المرور المعدَّل، وطبيعة الخدمة الموزَّعة. قد تختلف النتائج أيضًا بين المسارات المتكافئة تقريبًا في أي وقت أو تكرار.
TRAFFIC_AWARE تحسب المسارات مع أخذ ظروف حركة المرور في الوقت الفعلي في الاعتبار. على عكس TRAFFIC_AWARE_OPTIMAL، يتم تطبيق بعض التحسينات لتقليل وقت الاستجابة بشكل كبير.
TRAFFIC_AWARE_OPTIMAL تحسب هذه الطريقة المسارات مع أخذ ظروف حركة المرور في الوقت الفعلي في الاعتبار، بدون تطبيق معظم تحسينات الأداء. يؤدي استخدام هذه القيمة إلى حدوث أعلى وقت استجابة.

SpeedReadingInterval

مؤشر كثافة حركة المرور على جزء متجاور من خط متعدد أو مسار بالنظر إلى مسار يتضمّن النقاط P_0 وP_1 و... وP_N (فهرس يبدأ من الصفر)، يحدّد SpeedReadingInterval فترة زمنية ويصف حركة المرور فيها باستخدام الفئات التالية.

الحقول
start_polyline_point_index

int32

فهرس بداية هذا الفاصل الزمني في الخط المتعدد
end_polyline_point_index

int32

فهرس نهاية هذا الفاصل الزمني في الخط المتعدد الأضلاع

حقل الدمج speed_type

يمكن أن تكون speed_type إحدى القيم التالية فقط:
speed

Speed

سرعة حركة المرور في هذه الفترة

السرعة

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

عمليات التعداد
SPEED_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
NORMAL السرعة العادية، بدون تأخير في حركة المرور
SLOW تم رصد تباطؤ في حركة المرور، وعدد المركبات متوسط.
TRAFFIC_JAM تأخيرات في حركة المرور

TollInfo

تتضمّن معلومات عن رسوم المرور على Route أو RouteLeg.

الحقول
estimated_price[]

Money

المبلغ النقدي لرسوم المرور الخاصة بالرمز Route أو RouteLeg. تحتوي هذه القائمة على مبلغ مالي لكل عملة من المتوقع أن يتم تحصيله من محطات تحصيل الرسوم. عادةً ما تحتوي هذه القائمة على عنصر واحد فقط للمسارات التي تتضمّن رسومًا بعملة واحدة. بالنسبة إلى الرحلات الدولية، قد تحتوي هذه القائمة على عناصر متعددة لتعكس رسوم المرور بعملات مختلفة.

TollPass

قائمة ببطاقات المرور على الطرق السريعة حول العالم التي تتيحها Google

عمليات التعداد
TOLL_PASS_UNSPECIFIED لم يتم استخدامه. وفي حال استخدام هذه القيمة، سيتعذّر تنفيذ الطلب.
AU_ETOLL_TAG بطاقة لرسوم العبور في سيدني يمكنك الاطّلاع على تفاصيل إضافية على https://www.myetoll.com.au.
AU_EWAY_TAG بطاقة لرسوم العبور في سيدني يمكنك الاطّلاع على تفاصيل إضافية على https://www.tollpay.com.au.
AU_LINKT بطاقة لرسوم العبور في جميع أنحاء أستراليا يمكنك الاطّلاع على تفاصيل إضافية على الرابط https://www.linkt.com.au/.
AR_TELEPASE بطاقة رسوم العبور في الأرجنتين يمكنك الاطّلاع على تفاصيل إضافية على https://telepase.com.ar
BR_AUTO_EXPRESO بطاقة رسوم العبور في البرازيل يمكنك الاطّلاع على تفاصيل إضافية على https://www.autoexpreso.com
BR_CONECTCAR بطاقة رسوم العبور في البرازيل يمكنك الاطّلاع على تفاصيل إضافية على الرابط https://conectcar.com.
BR_MOVE_MAIS بطاقة رسوم العبور في البرازيل يمكنك الاطّلاع على تفاصيل إضافية على https://movemais.com.
BR_PASSA_RAPIDO بطاقة رسوم العبور في البرازيل يمكنك الاطّلاع على تفاصيل إضافية على https://pasorapido.gob.do/
BR_SEM_PARAR بطاقة رسوم العبور في البرازيل يمكنك الاطّلاع على تفاصيل إضافية على الرابط https://www.semparar.com.br.
BR_TAGGY بطاقة رسوم العبور في البرازيل يمكنك الاطّلاع على تفاصيل إضافية على https://taggy.com.br.
BR_VELOE بطاقة رسوم العبور في البرازيل يمكنك الاطّلاع على تفاصيل إضافية على الرابط https://veloe.com.br/site/onde-usar.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD معبر الحدود بين كندا والولايات المتحدة
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD معبر الحدود بين كندا والولايات المتحدة
CA_US_BLUE_WATER_EDGE_PASS معبر حدودي من أونتاريو، كندا إلى ميشيغان، الولايات المتحدة
CA_US_CONNEXION معبر حدودي من أونتاريو، كندا إلى ميشيغان، الولايات المتحدة
CA_US_NEXUS_CARD معبر الحدود بين كندا والولايات المتحدة
ID_E_TOLL إندونيسيا بطاقة إلكترونية تقدّمها عدة مصارف وتُستخدم لدفع رسوم المرور يتم تحصيل الرسوم نفسها من جميع البطاقات الإلكترونية الصادرة عن البنوك، لذا لا يلزم سوى قيمة تعدادية واحدة. مثلاً: - Bank Mandiri https://www.bankmandiri.co.id/e-money - BCA https://www.bca.co.id/flazz - BNI https://www.bni.co.id/id-id/ebanking/tapcash
IN_FASTAG India.
IN_LOCAL_HP_PLATE_EXEMPT الإعفاء من لوحات المركبات في ولاية هيماشال براديش في الهند
JP_ETC نظام لاسلكي إلكتروني في اليابان لجمع رسوم المرور https://www.go-etc.jp/
JP_ETC2 اليابان ETC2.0. إصدار جديد من نظام ETC يوفّر خصمًا إضافيًا ويتيح التواصل في اتجاهين بين الأجهزة في المركبات والهوائيات على الطريق. https://www.go-etc.jp/etc2/index.html
MX_IAVE رسوم العبور في المكسيك: https://iave.capufe.gob.mx/#/
MX_PASE المكسيك https://www.pase.com.mx
MX_QUICKPASS المكسيك https://operadoravial.com/quick-pass/
MX_SISTEMA_TELEPEAJE_CHIHUAHUA http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
MX_TAG_IAVE المكسيك
MX_TAG_TELEVIA شركة بطاقات رسوم العبور في المكسيك وهي إحدى الشركات العديدة التي تعمل في مكسيكو سيتي. يمكنك الاطّلاع على تفاصيل إضافية على https://www.televia.com.mx.
MX_TELEVIA شركة بطاقات رسوم العبور في المكسيك إحدى الشركات العديدة التي تعمل في مكسيكو سيتي https://www.televia.com.mx
MX_VIAPASS بطاقة رسوم العبور في المكسيك يمكنك الاطّلاع على تفاصيل إضافية على https://www.viapass.com.mx/viapass/web_home.aspx.
US_AL_FREEDOM_PASS ألاباما، الولايات المتحدة
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS ألاسكا، الولايات المتحدة الأمريكية
US_CA_FASTRAK كاليفورنيا، الولايات المتحدة
US_CA_FASTRAK_CAV_STICKER يشير إلى أنّ السائق لديه أي بطاقة FasTrak بالإضافة إلى ملصق Clean Air Vehicle (CAV) الصادر عن إدارة المركبات (DMV). https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL كولورادو، الولايات المتحدة الأمريكية
US_CO_GO_PASS كولورادو، الولايات المتحدة الأمريكية
US_DE_EZPASSDE ألمانيا والولايات المتحدة
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS فلوريدا، الولايات المتحدة الأمريكية
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD فلوريدا، الولايات المتحدة الأمريكية
US_FL_EPASS فلوريدا، الولايات المتحدة الأمريكية
US_FL_GIBA_TOLL_PASS فلوريدا، الولايات المتحدة الأمريكية
US_FL_LEEWAY فلوريدا، الولايات المتحدة الأمريكية
US_FL_SUNPASS فلوريدا، الولايات المتحدة الأمريكية
US_FL_SUNPASS_PRO فلوريدا، الولايات المتحدة الأمريكية
US_IL_EZPASSIL إلينوي، الولايات المتحدة الأمريكية
US_IL_IPASS إلينوي، الولايات المتحدة الأمريكية
US_IN_EZPASSIN IN, USA.
US_KS_BESTPASS_HORIZON كانساس، الولايات المتحدة الأمريكية
US_KS_KTAG كانساس، الولايات المتحدة الأمريكية
US_KS_NATIONALPASS كانساس، الولايات المتحدة الأمريكية
US_KS_PREPASS_ELITEPASS كانساس، الولايات المتحدة الأمريكية
US_LA_GEAUXPASS لوس أنجلوس، الولايات المتحدة الأمريكية
US_LA_TOLL_TAG لوس أنجلوس، الولايات المتحدة الأمريكية
US_MA_EZPASSMA ماساتشوستس، الولايات المتحدة الأمريكية
US_MD_EZPASSMD MD، الولايات المتحدة الأمريكية
US_ME_EZPASSME الولايات المتحدة الأمريكية
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD ميشيغان، الولايات المتحدة الأمريكية
US_MI_BCPASS ميشيغان، الولايات المتحدة الأمريكية
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG ميشيغان، الولايات المتحدة الأمريكية
US_MI_IQ_PROX_CARD

ميشيغان، الولايات المتحدة الأمريكية تم إيقاف هذا النوع من البطاقات نهائيًا.
US_MI_IQ_TAG ميشيغان، الولايات المتحدة الأمريكية
US_MI_MACKINAC_BRIDGE_MAC_PASS ميشيغان، الولايات المتحدة الأمريكية
US_MI_NEXPRESS_TOLL ميشيغان، الولايات المتحدة الأمريكية
US_MN_EZPASSMN مينيسوتا، الولايات المتحدة الأمريكية
US_NC_EZPASSNC NC, USA.
US_NC_PEACH_PASS NC, USA.
US_NC_QUICK_PASS NC, USA.
US_NH_EZPASSNH نيو هامبشير، الولايات المتحدة الأمريكية
US_NJ_DOWNBEACH_EXPRESS_PASS نيوجيرسي، الولايات المتحدة الأمريكية
US_NJ_EZPASSNJ نيوجيرسي، الولايات المتحدة الأمريكية
US_NY_EXPRESSPASS نيويورك، الولايات المتحدة الأمريكية
US_NY_EZPASSNY نيويورك، الولايات المتحدة الأمريكية
US_OH_EZPASSOH أوهايو، الولايات المتحدة الأمريكية
US_PA_EZPASSPA بنسلفانيا، الولايات المتحدة
US_RI_EZPASSRI رود آيلاند، الولايات المتحدة الأمريكية
US_SC_PALPASS كارولاينا الجنوبية، الولايات المتحدة الأمريكية
US_TX_AVI_TAG تكساس، الولايات المتحدة الأمريكية
US_TX_BANCPASS تكساس، الولايات المتحدة الأمريكية
US_TX_DEL_RIO_PASS تكساس، الولايات المتحدة الأمريكية
US_TX_EFAST_PASS تكساس، الولايات المتحدة الأمريكية
US_TX_EAGLE_PASS_EXPRESS_CARD تكساس، الولايات المتحدة الأمريكية
US_TX_EPTOLL تكساس، الولايات المتحدة الأمريكية
US_TX_EZ_CROSS تكساس، الولايات المتحدة الأمريكية
US_TX_EZTAG تكساس، الولايات المتحدة الأمريكية
US_TX_FUEGO_TAG تكساس، الولايات المتحدة الأمريكية
US_TX_LAREDO_TRADE_TAG تكساس، الولايات المتحدة الأمريكية
US_TX_PLUSPASS تكساس، الولايات المتحدة الأمريكية
US_TX_TOLLTAG تكساس، الولايات المتحدة الأمريكية
US_TX_TXTAG تكساس، الولايات المتحدة الأمريكية
US_TX_XPRESS_CARD تكساس، الولايات المتحدة الأمريكية
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD يوتا، الولايات المتحدة الأمريكية
US_VA_EZPASSVA ولاية فرجينيا، الولايات المتحدة الأمريكية
US_WA_BREEZEBY واشنطن، الولايات المتحدة الأمريكية
US_WA_GOOD_TO_GO واشنطن، الولايات المتحدة الأمريكية
US_WV_EZPASSWV WV, USA.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, USA.
US_WV_MOV_PASS WV, USA
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, USA.

TrafficModel

تحدّد هذه السمة الافتراضات التي يجب استخدامها عند حساب الوقت المستغرَق في حركة المرور. يؤثّر هذا الإعداد في القيمة المعروضة في الحقل duration في الاستجابة، والذي يحتوي على الوقت المتوقّع في حركة المرور استنادًا إلى المتوسطات السابقة.

عمليات التعداد
TRAFFIC_MODEL_UNSPECIFIED غير مستخدَم إذا تم تحديدها، سيتم ضبط القيمة التلقائية على BEST_GUESS.
BEST_GUESS تشير إلى أنّ duration المعروض يجب أن يكون أفضل تقدير لمدة السفر استنادًا إلى المعلومات المتوفّرة عن كلّ من حالات حركة المرور السابقة وحركة المرور الحالية. تزداد أهمية بيانات حركة المرور في الوقت الفعلي كلما اقترب الوقت departure_time من الوقت الحالي.
PESSIMISTIC تشير إلى أنّ المدة التي يتم عرضها يجب أن تكون أطول من مدة السفر الفعلية في معظم الأيام، على الرغم من أنّ بعض الأيام التي تشهد ازدحامًا مروريًا سيئًا بشكل خاص قد تتجاوز هذه القيمة.
OPTIMISTIC تشير إلى أنّ المدة التي يتم عرضها يجب أن تكون أقصر من مدة السفر الفعلية في معظم الأيام، على الرغم من أنّ بعض الأيام التي تكون فيها حركة المرور جيدة بشكل خاص قد تكون أسرع من هذه القيمة.

TransitAgency

هي مؤسسة نقل عام تشغّل خط نقل عام.

الحقول
name

string

تمثّل هذه السمة اسم مؤسسة النقل العام.
phone_number

string

رقم الهاتف الخاص بهيئة النقل العام بتنسيق خاص بمكان معيّن
uri

string

معرّف الموارد الموحّد (URI) لمؤسسة النقل العام

TransitLine

تحتوي على معلومات حول خط النقل العام المستخدَم في هذه الخطوة.

الحقول
agencies[]

TransitAgency

مؤسسة (أو مؤسسات) النقل العام التي تشغّل خط النقل هذا
name

string

الاسم الكامل لخط النقل العام هذا، مثل "الخط المحلي في الجادة 8"
uri

string

تمثّل هذه السمة معرّف الموارد المنتظم (URI) لخط النقل العام هذا كما تقدّمه مؤسسة النقل العام.
color

string

اللون المستخدَم عادةً في اللافتات الخاصة بهذا الخط يتم تمثيله بنظام الأرقام السداسية العشرية.
icon_uri

string

تمثّل هذه السمة معرّف الموارد المنتظم (URI) للرمز المرتبط بهذا السطر.
name_short

string

الاسم المختصر لخط النقل العام هذا سيكون هذا الاسم عادةً رقم خط، مثل "M7" أو "355".
text_color

string

اللون المستخدَم عادةً في النص على اللوحات الإرشادية لهذا الخط يتم تمثيله بنظام الأرقام السداسية العشرية.
vehicle

TransitVehicle

نوع المركبة التي تعمل على خط النقل العام هذا

TransitPreferences

الإعدادات المفضّلة للمسارات المستندة إلى TRANSIT والتي تؤثر في المسار الذي يتم عرضه

الحقول
allowed_travel_modes[]

TransitTravelMode

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

TransitRoutingPreference

أحد خيارات التوجيه التي تؤثّر في المسار TRANSIT الذي يتم عرضه عند تحديدها.

TransitRoutingPreference

تحدّد هذه السمة إعدادات التوجيه المفضّلة لمسارات النقل العام.

عمليات التعداد
TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED لم يتم تحديد أي إعدادات مفضَّلة.
LESS_WALKING تشير إلى أنّ المسار المحسوب يجب أن يفضّل السير لمسافات محدودة.
FEWER_TRANSFERS تشير إلى أنّ المسار المحسوب يجب أن يفضّل عددًا محدودًا من عمليات النقل.

TransitTravelMode

مجموعة من القيم المستخدَمة لتحديد وسيلة النقل العام.

عمليات التعداد
TRANSIT_TRAVEL_MODE_UNSPECIFIED لم يتم تحديد وضع السفر بوسائل النقل العام.
BUS التنقّل بالحافلة
SUBWAY استخدِم مترو الأنفاق للتنقّل.
TRAIN التنقّل بالقطار
LIGHT_RAIL استخدِم القطار الخفيف أو الترام.
RAIL السفر بالقطار وهذا يعادل مزيجًا من SUBWAY وTRAIN وLIGHT_RAIL.

TransitStop

تعرض هذه السمة معلومات عن محطة توقّف لوسائل النقل العام.

الحقول
name

string

تمثّل هذه السمة اسم محطة النقل العام.
location

Location

موقع المحطة الجغرافية معبَّرًا عنه بإحداثيات خط العرض/خط الطول

TransitVehicle

تعرض هذه السمة معلومات عن مركبة مستخدَمة في مسارات النقل العام.

الحقول
name

LocalizedText

تمثّل هذه السمة اسم المركبة بالأحرف الكبيرة.
type

TransitVehicleType

نوع المركبة المستخدَمة
icon_uri

string

معرّف الموارد الموحّد لرمز مرتبط بنوع المركبة هذا.
local_icon_uri

string

تمثّل هذه السمة معرّف الموارد الموحّد (URI) للرمز المرتبط بنوع المركبة هذا، استنادًا إلى لوحات الإشارات الخاصة بوسائل النقل المحلية.

TransitVehicleType

تعرض هذه السمة نوع المركبات التي تسير على مسارات النقل العام.

عمليات التعداد
TRANSIT_VEHICLE_TYPE_UNSPECIFIED غير مستخدَم
BUS حافلة
CABLE_CAR مركبة تعمل على كابل، وعادةً ما تكون على الأرض قد تكون عربات التلفريك المعلّقة من النوع GONDOLA_LIFT.
COMMUTER_TRAIN قطارات سريعة
FERRY عبّارة
FUNICULAR مركبة يتم سحبها إلى أعلى منحدر شديد بواسطة كابل يتألف القطار المعلق عادةً من عربتَين، وتعمل كل عربة كوزن موازن للأخرى.
GONDOLA_LIFT عربة تلفريك معلّقة
HEAVY_RAIL السكك الحديدية الثقيلة
HIGH_SPEED_TRAIN قطار عالي السرعة
INTERCITY_BUS حافلة بين المدن
LONG_DISTANCE_TRAIN قطار مسافات طويلة
METRO_RAIL نظام النقل بالقطارات الخفيفة
MONORAIL قطار بخط حديدي واحد
OTHER جميع المركبات الأخرى
RAIL السكك الحديدية
SHARE_TAXI سيارة الأجرة المشتركة هي نوع من الحافلات يمكنها إقلال الركاب وتوصيلهم في أي مكان على مسارها.
SUBWAY قطار خفيف تحت الأرض
TRAM قطار خفيف فوق الأرض
TROLLEYBUS ترولي باص

الوحدات

مجموعة من القيم التي تحدّد وحدة القياس المستخدَمة في العرض.

عمليات التعداد
UNITS_UNSPECIFIED لم يتم تحديد وحدات القياس. القيمة التلقائية هي وحدة القياس المستنتَجة من الطلب.
METRIC وحدات القياس المترية
IMPERIAL وحدات القياس الإمبراطورية (الإنجليزية)

VehicleEmissionType

مجموعة من القيم التي تصف نوع انبعاثات المركبة ينطبق هذا الإجراء على DRIVE RouteTravelMode فقط.

عمليات التعداد
VEHICLE_EMISSION_TYPE_UNSPECIFIED لم يتم تحديد نوع الانبعاثات. القيمة التلقائية هي GASOLINE.
GASOLINE مركبة تعمل بالبنزين
ELECTRIC مركبة تعمل بالكهرباء
HYBRID مركبة تعمل بالوقود الهجين (مثل البنزين والكهرباء)
DIESEL مركبة تعمل بالديزل

VehicleInfo

تحتوي على معلومات المركبة، مثل نوع انبعاثات المركبة.

الحقول
emission_type

VehicleEmissionType

تصف هذه السمة نوع الانبعاثات للمركبة. ينطبق هذا الإجراء على DRIVE RouteTravelMode فقط.

النقطة الوسيطة

تغليف نقطة طريق تشير نقاط الطريق إلى بداية المسار ونهايته، وتشمل محطات توقّف وسيطة على طول المسار.

الحقول
via

bool

يضع علامة على نقطة الطريق هذه كمعلم رئيسي بدلاً من نقطة توقّف. بالنسبة إلى كل نقطة طريق غير وسيطة في الطلب، يضيف الردّ إدخالاً إلى مصفوفة legs لتقديم تفاصيل عن محطات التوقف في هذا الجزء من الرحلة. اضبط هذه القيمة على "صحيح" عندما تريد أن يمرّ المسار بنقطة الطريق هذه بدون التوقف فيها. لا تؤدي نقاط الطريق إلى إضافة إدخال إلى مصفوفة legs، ولكنها توجّه الرحلة عبر نقطة الطريق. يمكنك ضبط هذه القيمة فقط على نقاط الطريق التي تكون وسيطة. يتعذّر تنفيذ الطلب إذا ضبطت هذا الحقل على نقاط توقّف نهائية. في حال ضبط ComputeRoutesRequest.optimize_waypoint_order على "صحيح"، لا يمكن ضبط هذا الحقل على "صحيح"، وإلا سيفشل الطلب.
vehicle_stopover

bool

تشير إلى أنّ نقطة الطريق مخصّصة لتوقّف المركبات، حيث يكون الهدف هو إما الاستلام أو التسليم. عند ضبط هذه القيمة، لن يتضمّن المسار المحسوب نقاط طريق غير via على الطرق غير المناسبة للاستلام والتسليم. لا يعمل هذا الخيار إلا مع وسيلتَي النقل DRIVE وTWO_WHEELER، وعندما تكون قيمة location_type هي Location.
side_of_road

bool

تشير إلى أنّ الموقع الجغرافي لنقطة الطريق هذه يهدف إلى أن يكون للمركبة خيار التوقف على جانب معيّن من الطريق. عند ضبط هذه القيمة، سيمرّ المسار بالموقع الجغرافي لكي تتمكّن المركبة من التوقف على جانب الطريق الذي يميل إليه الموقع الجغرافي من وسط الطريق. لا يعمل هذا الخيار إلا على DRIVE وTWO_WHEELER RouteTravelMode.
حقل الدمج location_type طرق مختلفة لتمثيل موقع جغرافي يمكن أن تكون location_type إحدى القيم التالية فقط:
location

Location

تمثّل هذه السمة نقطة محدّدة باستخدام الإحداثيات الجغرافية، بما في ذلك عنوان اختياري.
place_id

string

تمثّل هذه السمة معرّف المكان الخاص بنقطة الاهتمام المرتبط بنقطة الطريق.
address

string

عنوان يمكن لشخص عادي قراءته أو رمز Plus Code لمزيد من التفاصيل، يمكنك الانتقال إلى https://plus.codes.