ComputeCustomRoutesRequest

رسالة طلب v1alpha.computeCustomRoutes.

تمثيل JSON
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "intermediates": [
    {
      object (Waypoint)
    }
  ],
  "travelMode": enum (RouteTravelMode),
  "routingPreference": enum (RoutingPreference),
  "polylineQuality": enum (PolylineQuality),
  "polylineEncoding": enum (PolylineEncoding),
  "departureTime": string,
  "routeModifiers": {
    object (RouteModifiers)
  },
  "routeObjective": {
    object (RouteObjective)
  },
  "languageCode": string,
  "units": enum (Units)
}
الحقول
origin

object (Waypoint)

مطلوبة. نقطة الانطلاق لنقطة الانطلاق

destination

object (Waypoint)

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

intermediates[]

object (Waypoint)

اختياريّ. مجموعة من نقاط الطريق على طول المسار (باستثناء النقاط النهائية)، إما للتوقف عند أو المرور. يُسمح باستخدام ما يصل إلى 25 نقطة طريق وسيطة.

travelMode

enum (RouteTravelMode)

اختياريّ. تحدّد هذه السمة وسيلة النقل. لا يتوفّر الآن سوى DRIVE.

routingPreference

enum (RoutingPreference)

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

polylineQuality

enum (PolylineQuality)

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

polylineEncoding

enum (PolylineEncoding)

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

departureTime

string (Timestamp format)

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

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

routeModifiers

object (RouteModifiers)

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

routeObjective

object (RouteObjective)

مطلوبة. هدف المسار الذي يجب التحسين من أجله.

languageCode

string

اختياريّ. رمز اللغة BCP-47، مثل en-US أو sr-Latn لمزيد من المعلومات، يُرجى الاطّلاع على http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. راجِع دعم اللغة للحصول على قائمة اللغات المتاحة. عند عدم توفير هذه القيمة، يتم استنتاج لغة العرض من موقع طلب المسار.

units

enum (Units)

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

RouteObjective

تضمين هدف لتحسينه من خلال v1alpha.computeCustomRoutes.

تمثيل JSON
{
  "rateCard": {
    object (RateCard)
  }
}
الحقول
rateCard

object (RateCard)

هدف RateCard

RateCard

تضمين هدف مسار RateCard

تمثيل JSON
{
  "costPerMinute": {
    object (MonetaryCost)
  },
  "costPerKm": {
    object (MonetaryCost)
  },
  "includeTolls": boolean
}
الحقول
costPerMinute

object (MonetaryCost)

اختياريّ. التكلفة في الدقيقة

costPerKm

object (MonetaryCost)

اختياريّ. التكلفة لكل كيلومتر

includeTolls

boolean

اختياريّ. ما إذا كان ينبغي تضمين رسوم العبور في التكلفة الإجمالية.

MonetaryCost

يتم تضمين التكلفة المستخدمة في بطاقة السعر.

تمثيل JSON
{
  "value": number
}
الحقول
value

number

مطلوبة. قيمة التكلفة بالعملة المحلية التي يتم استنتاجها من الطلب.