Route

تُحاط بمسار يتألف من سلسلة من أجزاء الطريق المتصلة التي تربط نقاط الطريق الأساسية والوسيطة والنهائية.

تمثيل JSON 
{
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ]
}
الحقول
legs[]

object (RouteLeg)

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

integer

مسافة التنقّل في المسار، بالمتر
duration

string (Duration format)

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

المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".
staticDuration

string (Duration format)

مدة التنقّل في المسار بدون مراعاة أحوال حركة المرور

المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".
polyline

object (Polyline)

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

string

وصف للمسار
warnings[]

string

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

object (Viewport)

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

object (RouteTravelAdvisory)

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

integer

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

RouteLeg

تُغلِّف هذه السمة جزءًا بين نقاط طريق غير via.

تمثيل JSON 
{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  }
}
الحقول
distanceMeters

integer

مسافة التنقل لمرحلة المسار، بالأمتار.
duration

string (Duration format)

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

المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".
staticDuration

string (Duration format)

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

المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".
polyline

object (Polyline)

الخطوط المتعددة الإجمالية لهذه المرحلة ويشمل ذلك كلّ مضلّع في step.
startLocation

object (Location)

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

object (Location)

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

object (RouteLegStep)

مصفوفة من الخطوات تشير إلى الأجزاء داخل هذه الساق. تمثل كل خطوة تعليمات تنقل واحدة.
travelAdvisory

object (RouteLegTravelAdvisory)

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

خط متعدد

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

تمثيل JSON 
{

  // Union field polyline_type can be only one of the following:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of list of possible types for union field polyline_type.
}
الحقول
حقل الاتحاد polyline_type. تُحاط بنوع الخطوط المتعددة. القيمة التلقائية هي encoded_polyline. يمكن أن يكون polyline_type واحدًا فقط مما يلي:
encodedPolyline

string

يشير ذلك المصطلح إلى ترميز سلسلة الخطوط المتعددة باستخدام خوارزمية الترميز المتعدد الخطوط.
geoJsonLinestring

object (Struct format)

لتحديد خط متعدد باستخدام تنسيق GeoJSON LineString

RouteLegStep

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

تمثيل JSON 
{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  }
}
الحقول
distanceMeters

integer

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

string (Duration format)

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

المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".
polyline

object (Polyline)

الخطوط المتعددة المرتبطة بهذه الخطوة.
startLocation

object (Location)

تمثل هذه السمة موقع البدء لهذه الخطوة.
endLocation

object (Location)

الموقع الجغرافي لنهاية هذه الخطوة.
navigationInstruction

object (NavigationInstruction)

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

object (RouteLegStepTravelAdvisory)

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

RouteLegStepTravelAdvisory

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

تمثيل JSON 
{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
الحقول
speedReadingIntervals[]

object (SpeedReadingInterval)

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

RouteLegTravelAdvisory

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

تمثيل JSON 
{
  "tollInfo": {
    object (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
الحقول
tollInfo

object (TollInfo)

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

object (SpeedReadingInterval)

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

مثال:

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