ComputeCustomRoutesRequest

رسالة طلب 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 وTWO_WHEELER فقط.

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" لمزيد من المعلومات، يُرجى الاطّلاع على معرّف لغة Unicode. اطّلِع على اللغات المتاحة للاطّلاع على قائمة اللغات المتاحة. في حال عدم تقديم هذه القيمة، يتم استنتاج لغة العرض من الموقع الجغرافي لطلب المسار.

units

enum (Units)

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

RouteObjective

تُحاط بإطار هدف محسّن من أجله حسب ComputeCustomRoutes.

تمثيل JSON
{

  // Union field objective can be only one of the following:
  "rateCard": {
    object (RateCard)
  }
  // End of list of possible types for union field objective.
}
الحقول
حقل الربط objective هدف المسار يمكن أن يكون objective واحدًا فقط مما يلي:
rateCard

object (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

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