Method: computeRoutes

{
  "routeLabels": [
    enum (RouteLabel)
  ],
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ],
  "localizedValues": {
    object (RouteLocalizedValues)
  },
  "routeToken": string
}

enum (RouteLabel)

تصنيفات خاصة بـ Route ومفيدة لتحديد خصائص معيّنة للمسار لمقارنتها مع تصنيفات أخرى

object (RouteLeg)

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

integer

مسافة السفر للمسار، بالأمتار.

string (Duration format)

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

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

string (Duration format)

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

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

object (Polyline)

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

string

تمثّل هذه السمة وصف المسار.

string

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

object (Viewport)

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

object (RouteTravelAdvisory)

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

integer

إذا ضبطت optimizeWaypointOrder على "صحيح"، سيحتوي هذا الحقل على الترتيب المحسّن لنقاط الطريق الوسيطة. وبخلاف ذلك، هذا الحقل فارغ. على سبيل المثال، إذا قدّمت مدخلاً للمصدر: LA، نقاط الطريق المتوسطة: دالاس، بانغور، فينكس؛ الوجهة: دبي وترتيب النقاط الوسيطة المُحسّن هو Phoenix, Dallas, Bangor، يحتوي هذا الحقل على القيم [2, 0, 1]. يبدأ الفهرس بـ 0 لأول نقطة وسيطة وسيطة مقدمة في الإدخال.

object (RouteLocalizedValues)

تمثيلات نصية لخصائص Route.

string

يشير هذا المصطلح إلى رمز مميّز للمسار بترميز base64 وآمن على الويب، ويمكن تمريره إلى حزمة SDK للتنقّل، ويسمح لهذه الحزمة بإعادة إنشاء المسار أثناء التنقّل، وإنجاز الهدف الأصلي في حال إعادة التوجيه عند إنشاء المسار من خلال استدعاء v2.computeRoutes. ويجب أن يتعامل العملاء مع هذا الرمز المميّز على أنّه كائن ثنائي كبير مبهم. لا تقارن قيمته بين الطلبات، حيث قد يتغير هذا الرمز المميز حتى إذا تم إرجاع المسار نفسه بالضبط. ملاحظة: لا يتوفّر Route.route_token إلا للطلبات التي تم ضبط ComputeRoutesRequest.routing_preference على TRAFFIC_AWARE أو TRAFFIC_AWARE_OPTIMAL. لا يمكن استخدام Route.route_token مع الطلبات التي تحتوي على نقاط مسار Via.

{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegLocalizedValues)
  },
  "stepsOverview": {
    object (StepsOverview)
  }
}

integer

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

string (Duration format)

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

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

string (Duration format)

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

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

object (Polyline)

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

object (Location)

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

object (Location)

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

object (RouteLegStep)

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

object (RouteLegTravelAdvisory)

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

object (RouteLegLocalizedValues)

تمثيلات نصية لخصائص RouteLeg.

object (StepsOverview)

تعرض هذه السمة نظرة عامة حول الخطوات في RouteLeg. يتم ملء هذا الحقل لمسارات TRANSIT فقط.

{

  // 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.
}

string

ترميز سلسلة الخطوط المتعددة باستخدام خوارزمية الترميز المتعدد الخطوط

object (Struct format)

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

{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegStepLocalizedValues)
  },
  "transitDetails": {
    object (RouteLegStepTransitDetails)
  },
  "travelMode": enum (RouteTravelMode)
}

integer

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

string (Duration format)

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

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

object (Polyline)

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

object (Location)

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

object (Location)

تمثّل هذه السمة موقع النهاية لهذه الخطوة.

object (NavigationInstruction)

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

object (RouteLegStepTravelAdvisory)

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

object (RouteLegStepLocalizedValues)

تمثيلات نصية لخصائص RouteLegStep.

object (RouteLegStepTransitDetails)

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

enum (RouteTravelMode)

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

{
  "maneuver": enum (Maneuver),
  "instructions": string
}

enum (Maneuver)

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

string

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

{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}

object (SpeedReadingInterval)

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

{
  "distance": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}

object (LocalizedText)

مسافة السفر ممثلة في شكل نصي.

object (LocalizedText)

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

{
  "stopDetails": {
    object (TransitStopDetails)
  },
  "localizedValues": {
    object (TransitDetailsLocalizedValues)
  },
  "headsign": string,
  "headway": string,
  "transitLine": {
    object (TransitLine)
  },
  "stopCount": integer,
  "tripShortText": string
}

object (TransitStopDetails)

وتتوقف المعلومات عن الوصول والمغادرة في الخطوة.

object (TransitDetailsLocalizedValues)

تمثيلات نصية لخصائص RouteLegStepTransitDetails.

string

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

string (Duration format)

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

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

object (TransitLine)

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

integer

عدد محطات التوقف من المغادرة إلى محطة الوصول. ويشمل هذا العدد محطة الوصول، ولكنه يستثنى منها محطة المغادرة. على سبيل المثال، إذا غادر مسارك من المحطة A، ومرّ بالمحطتين B وC، ووصل إلى المحطة D، سيعرض stationCount الرقم 3.

string

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

{
  "arrivalStop": {
    object (TransitStop)
  },
  "arrivalTime": string,
  "departureStop": {
    object (TransitStop)
  },
  "departureTime": string
}

object (TransitStop)

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

string (Timestamp format)

الوقت المقدّر للوصول للخطوة.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

object (TransitStop)

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

string (Timestamp format)

الوقت المقدّر لمغادرة الخطوة.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

{
  "name": string,
  "location": {
    object (Location)
  }
}

string

اسم محطة النقل العام

object (Location)

موقع المحطة الموضح بإحداثيات خطوط الطول/العرض.

{
  "arrivalTime": {
    object (LocalizedTime)
  },
  "departureTime": {
    object (LocalizedTime)
  }
}

object (LocalizedTime)

يشير ذلك المصطلح إلى الوقت في تمثيل النص المنسَّق مع المنطقة الزمنية المقابلة.

object (LocalizedTime)

يشير ذلك المصطلح إلى الوقت في تمثيل النص المنسَّق مع المنطقة الزمنية المقابلة.

{
  "time": {
    object (LocalizedText)
  },
  "timeZone": string
}

object (LocalizedText)

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

string

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

{
  "agencies": [
    {
      object (TransitAgency)
    }
  ],
  "name": string,
  "uri": string,
  "color": string,
  "iconUri": string,
  "nameShort": string,
  "textColor": string,
  "vehicle": {
    object (TransitVehicle)
  }
}

object (TransitAgency)

مؤسسة (أو الوكالات) للنقل العام التي تدير خط النقل العام هذا

string

الاسم الكامل لخط النقل العام هذا، على سبيل المثال، "8 Avenue Local".

string

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

string

اللون الذي يشيع استخدامه في اللافتات لهذا الخط. يتم تمثيلها بنظام العد الست عشري.

string

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

string

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

string

اللون الذي يشيع استخدامه في النص على اللافتات لهذا السطر. يتم تمثيلها بنظام العد الست عشري.

object (TransitVehicle)

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

{
  "name": string,
  "phoneNumber": string,
  "uri": string
}

string

اسم مؤسسة النقل العام هذه

string

رقم الهاتف المنسَّق الخاص بمؤسسة النقل العام

string

معرّف الموارد المنتظم (URI) الخاص بمؤسسة النقل العام

{
  "name": {
    object (LocalizedText)
  },
  "type": enum (TransitVehicleType),
  "iconUri": string,
  "localIconUri": string
}

object (LocalizedText)

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

enum (TransitVehicleType)

تمثّل هذه السمة نوع المركبة المستخدمة.

string

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

string

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

{
  "tollInfo": {
    object (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}

object (TollInfo)

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

object (SpeedReadingInterval)

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

مثال:

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

{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}

object (LocalizedText)

مسافة السفر ممثلة في شكل نصي.

object (LocalizedText)

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

object (LocalizedText)

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

{
  "multiModalSegments": [
    {
      object (MultiModalSegment)
    }
  ]
}

object (MultiModalSegment)

معلومات ملخّصة حول الشرائح المتعدّدة الوسائط المختلفة من RouteLeg.steps لا تتم تعبئة هذا الحقل إذا لم تكن السمة RouteLeg تحتوي على أي شرائح متعددة النماذج في الخطوات.

{
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelMode": enum (RouteTravelMode),
  "stepStartIndex": integer,
  "stepEndIndex": integer
}

object (NavigationInstruction)

تعليمات التنقل للشريحة المتعددة الوسائط.

enum (RouteTravelMode)

وضع السفر لقطاع متعدد الوسائط.

integer

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

integer

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

{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}

object (LatLng)

مطلوب. النقطة المنخفضة في إطار العرض.

object (LatLng)

مطلوب. تمثّل هذه السمة النقطة العليا لإطار العرض.

{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  },
  "transitFare": {
    object (LocalizedText)
  }
}

object (LocalizedText)

مسافة السفر ممثلة في شكل نصي.

object (LocalizedText)

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

object (LocalizedText)

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

object (LocalizedText)

يتم عرض سعر النقل العام في شكل نصي.

{
  "origin": {
    object (GeocodedWaypoint)
  },
  "destination": {
    object (GeocodedWaypoint)
  },
  "intermediates": [
    {
      object (GeocodedWaypoint)
    }
  ]
}

object (GeocodedWaypoint)

نقطة الطريق المرمّزة جغرافيًا للأصل.

object (GeocodedWaypoint)

نقطة الطريق المرمّزة جغرافيًا للوجهة.

object (GeocodedWaypoint)

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

{
  "geocoderStatus": {
    object (Status)
  },
  "type": [
    string
  ],
  "partialMatch": boolean,
  "placeId": string,
  "intermediateWaypointRequestIndex": integer
}

object (Status)

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

string

نوع(أنواع) النتيجة في شكل علامات نوع صفرية أو أكثر. الأنواع المتوافقة: أنواع العناوين وأنواع مكوّنات العناوين.

boolean

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

string

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

integer

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