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 على "صحيح"، سيحتوي هذا الحقل على الترتيب المحسَّن لنقاط الطريق الوسيطة. وإلا، فهذا الحقل فارغ. على سبيل المثال، لنفترض أنّ المُدخل هو Origin: LA؛ الوسطاء: دالاس وبانغور وفينيكس الوجهة: دبي وترتيب النقاط الوسيطة المُحسّن هو: فينيكس ودالاس وبانغور. ثم يحتوي هذا الحقل على القيم [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. يوضح هذا الحقل نوع الخطوط المتعددة. تكون القيمة التلقائية هي Encrypt_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)

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

مثال:

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

RouteLegTravelAdvisory

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

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

object (TollInfo)

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

object (SpeedReadingInterval)

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

مثال:

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