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)

مجموعة من الأرجل (أجزاء المسار بين نقاط الطريق) التي تشكل المسار. تتوافق كل رِجلة مع الرحلة بين سمتَين غير via لـ Waypoints. فعلى سبيل المثال، المسار بدون نقاط طريق وسيطة يحتوي على ساق واحدة فقط. يشمل المسار الذي يتضمّن نقطة طريق وسيطة واحدة غير 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، نقاط طريق وسيطة: دالاس، بانغور، وفينيكس، الوجهة: نيويورك، وترتيب نقاط الطريق المتوسط المحسّن هو فينيكس، دالاس، بانغور، فإن هذا الحقل يحتوي على القيم [2، 0، 1]. ويبدأ الفهرس بـ 0 لأول نقطة طريق وسيطة يتم توفيرها في الإدخال.

object (RouteLocalizedValues)

تمثيلات نصية لسمات Route

string

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

{
  "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 هذا. تتم تعبئة هذا الحقل لمسارات النقل العام فقط.

{

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

عدد محطات التوقف من المغادرة إلى محطة الوصول. يشمل هذا العدد محطة الوصول، ولكنه لا يشمل محطة المغادرة. على سبيل المثال، إذا غادر مسارك من المحطة "أ" ومر عبر المحطتين "ب" و"ج" ووصل إلى المحطتين "د"، فستعرض دالة StopCount 3.

string

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

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

object (TransitStop)

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

string (Timestamp format)

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

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

object (TransitStop)

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

string (Timestamp format)

تمثل هذه السمة الوقت المقدَّر لمغادرة الخطوة.

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

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

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