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