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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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

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