- طلب HTTP
- نص الطلب
- نص الاستجابة
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- المسار
- RouteLabel
- RouteLeg
- Polyline
- RouteLegStep
- NavigationInstruction
- أداة Manuver
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- StepsOverview
- MultiModalSegment
- إطار العرض
- RouteLocalizedValues
- GeocodingResults
- GeocodedWaypoint
لعرض المسار الأساسي مع مسارات بديلة اختيارية، مع تحديد مجموعة من نقاط الطرق الطرفية والوسطى.
ملاحظة: تتطلب هذه الطريقة تحديد قناع حقل الردّ في الإدخال. يمكنك توفير قناع حقل الاستجابة باستخدام مَعلمة عنوان URL $fields
أو fields
أو باستخدام عنوان HTTP/gRPC X-Goog-FieldMask
(اطّلِع على عناوين ومَعلمات عناوين URL المتوفّرة). ويجب أن تكون القيمة هي قائمة بمسارات الحقول مفصولة بفواصل. اطّلِع على مستندات تفصيلية عن كيفية إنشاء مسارات الحقول.
على سبيل المثال، باستخدام هذه الطريقة:
- كمامة الحقل لجميع الحقول المتاحة (للفحص اليدوي):
X-Goog-FieldMask: *
- قناع الحقل للمدة على مستوى المسار والمسافة والخطوط المتعددة (مثال على إعداد الإنتاج):
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
لا تنصح Google باستخدام قناع حقل الردّ بحرف البدل (*
) أو تحديد قناع الحقل على المستوى الأعلى (routes
)، للسببَين التاليَين:
- ويعمل تحديد الحقول التي تحتاجها فقط على مساعدة الخادم في حفظ دورات الحوسبة، مما يتيح لنا عرض النتيجة لك في وقت استجابة أقل.
- إنّ اختيار الحقول التي تحتاجها فقط في مهمة الإنتاج يضمن أداء وقت الاستجابة مستقرًا. قد نضيف المزيد من حقول الاستجابة في المستقبل، وقد تتطلب هذه الحقول الجديدة وقتًا إضافيًا في العمليات الحسابية. في حال اختيار جميع الحقول أو اختيار جميع الحقول في المستوى الأعلى، قد تواجه تراجعًا في الأداء بسبب تضمين أي حقل جديد نضيفه تلقائيًا في الردّ.
- ويؤدي اختيار الحقول التي تحتاجها فقط إلى تقليل حجم الاستجابة، وبالتالي زيادة سرعة معالجة بيانات الشبكة.
طلب HTTP
POST https://routes.googleapis.com/directions/v2:computeRoutes
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "origin": { object ( |
الحقول | |
---|---|
origin |
مطلوب. نقطة مسار الأصل. |
destination |
مطلوب. النقطة الوسيطة للوجهة. |
intermediates[] |
اختياريّ. مجموعة من نقاط الطريق على طول المسار (باستثناء النقاط النهائية)، سواء للتوقف عند أو للمرور. ويمكن استخدام ما يصل إلى 25 نقطة طريق متوسطة. |
travelMode |
اختياريّ. تحدّد هذه السمة وسيلة النقل. |
routingPreference |
اختياريّ. لتحديد كيفية حساب المسار. يحاول الخادم استخدام تفضيل التوجيه المحدد لاحتساب المسار. إذا أدى تفضيل التوجيه إلى حدوث خطأ أو وقت استجابة طويل جدًا، فسيتم عرض خطأ. لا يمكنك تحديد هذا الخيار إلا إذا كانت قيمة |
polylineQuality |
اختياريّ. لتحديد إعداداتك المفضّلة لجودة الخطوط المتعددة. |
polylineEncoding |
اختياريّ. تحدِّد هذه السياسة الترميز المفضّل للخطوط المتعددة. |
departureTime |
اختياريّ. وقت المغادرة إذا لم يتم ضبط هذه القيمة، سيتم ضبط هذه القيمة تلقائيًا على الوقت الذي قدّمت فيه الطلب. ملاحظة: لا يمكنك تحديد طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
arrivalTime |
اختياريّ. وقت الوصول ملاحظة: لا يمكن ضبط هذا الإعداد إلا عند ضبط طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
computeAlternativeRoutes |
اختياريّ. لتحديد ما إذا كان سيتم حساب المسارات البديلة بالإضافة إلى المسار. لا يتم إرجاع مسارات بديلة للطلبات التي تحتوي على نقاط طريق متوسطة. |
routeModifiers |
اختياريّ. يشير ذلك المصطلح إلى مجموعة من الشروط التي يجب استيفاؤها وتؤثّر في طريقة احتساب المسارات. |
languageCode |
اختياريّ. رمز اللغة BCP-47، مثل en-US أو "sr-Latn". للمزيد من المعلومات، يُرجى الاطّلاع على معرّف لغة يونيكود. يمكنك الانتقال إلى قسم دعم اللغات للاطّلاع على قائمة باللغات المتوافقة. عند عدم تقديم هذه القيمة، يتم استنتاج لغة العرض من موقع طلب المسار. |
regionCode |
اختياريّ. تمثّل هذه السمة رمز المنطقة، ويتم تحديده على أنّه قيمة مؤلفة من حرفَين ("نطاق المستوى الأعلى") ccTLD. لمزيد من المعلومات، راجِع نطاقات المستوى الأعلى التي يتم ترميزها حسب البلد. |
units |
اختياريّ. تحدّد هذه السمة وحدات القياس لحقول العرض. تشمل هذه الحقول الحقل |
optimizeWaypointOrder |
اختياريّ. في حال ضبطها على "صحيح"، تحاول الخدمة تقليل التكلفة الإجمالية للمسار عن طريق إعادة ترتيب نقاط الطريق الوسيطة المحددة. ويتعذّر الطلب إذا كانت أي من نقاط الطريق الوسيطة تمثل نقطة طريق |
requestedReferenceRoutes[] |
اختياريّ. تحدد المسارات المرجعية المطلوب حسابها كجزء من الطلب بالإضافة إلى المسار التلقائي. المسار المرجعي هو مسار له هدف حساب مسار مختلف عن المسار التلقائي. على سبيل المثال، يأخذ حساب المسار المرجعي |
extraComputations[] |
اختياريّ. قائمة بعمليات الحوسبة الإضافية التي يمكن استخدامها لإكمال الطلب ملاحظة: قد تعرض عمليات الحوسبة الإضافية هذه حقولاً إضافية في الردّ. يجب أيضًا تحديد هذه الحقول الإضافية في قناع الحقل ليتم عرضها في الردّ. |
trafficModel |
اختياريّ. تحدد الافتراضات التي يجب استخدامها عند حساب الوقت المستغرق في حركة المرور. يؤثر هذا الإعداد في القيمة التي يتم عرضها في حقل المدة في |
transitPreferences |
اختياريّ. تحدّد هذه السياسة الإعدادات المفضّلة التي تؤثر في المسار المعروض لمسارات |
نص الاستجابة
يوجّه v2.computeRoutes رسالة الرد.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "routes": [ { object ( |
الحقول | |
---|---|
routes[] |
يتضمّن مجموعة من المسارات المحسوبة (ما يصل إلى ثلاثة مسارات) عند تحديد |
fallbackInfo |
في بعض الحالات عندما لا يتمكن الخادم من حساب نتائج المسار مع جميع تفضيلات الإدخال، قد يتراجع عن استخدام طريقة حسابية مختلفة. عند استخدام الوضع الاحتياطي، يحتوي هذا الحقل على معلومات تفصيلية حول الاستجابة الاحتياطية. وبخلاف ذلك، يتم إلغاء ضبط هذا الحقل. |
geocodingResults |
يحتوي على معلومات استجابة الترميز الجغرافي لنقاط الطرق المحددة كعناوين. |
PolylineQuality
مجموعة من القيم التي تحدد جودة الخطوط المتعددة.
عمليات التعداد | |
---|---|
POLYLINE_QUALITY_UNSPECIFIED |
لم يتم تحديد تفضيل جودة الخطوط المتعددة. وتكون القيمة التلقائية هي OVERVIEW . |
HIGH_QUALITY |
تحدّد هذه السياسة خطوطًا متعددة عالية الجودة تتألف من نقاط أكثر من OVERVIEW ، وذلك على حساب زيادة حجم الردّ. استخدِم هذه القيمة عندما تحتاج إلى مزيد من الدقة. |
OVERVIEW |
لتحديد نظرة عامة على الخطوط المتعددة - والتي تتألف من عدد صغير من النقاط. استخدِم هذه القيمة عند عرض نظرة عامة على المسار. يستغرق استخدام هذا الخيار وقت استجابة أقل للطلبات مقارنةً باستخدام الخيار HIGH_QUALITY . |
PolylineEncoding
تحدِّد هذه السياسة النوع المفضّل من الخطوط المتعددة المطلوب عرضها.
عمليات التعداد | |
---|---|
POLYLINE_ENCODING_UNSPECIFIED |
لم يتم تحديد تفضيل لنوع الخطوط المتعددة. وتكون القيمة التلقائية هي ENCODED_POLYLINE . |
ENCODED_POLYLINE |
تحدّد هذه السمة ترميزًا متعدد الخطوط باستخدام خوارزمية الترميز المتعدد الخطوط. |
GEO_JSON_LINESTRING |
لتحديد خط متعدد باستخدام تنسيق GeoJSON LineString |
ReferenceRoute
مسار مرجعي متوافق في ComputeRoutesRequest.
عمليات التعداد | |
---|---|
REFERENCE_ROUTE_UNSPECIFIED |
غير مستخدَم تعذّر تنفيذ الطلبات التي تحتوي على هذه القيمة. |
FUEL_EFFICIENT |
مسار فعّال في استهلاك الوقود إنّ المسارات المصنَّفة باستخدام هذه القيمة قد تم تحسينها لمَعلمات مثل استهلاك الوقود. |
ExtraComputation
إجراء عمليات حسابية إضافية أثناء إكمال الطلب
عمليات التعداد | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
غير مستخدَم سيتعذّر تنفيذ الطلبات التي تحتوي على هذه القيمة. |
TOLLS |
معلومات حول رسوم العبور للمسارات |
FUEL_CONSUMPTION |
استهلاك الوقود المقدَّر للمسارات |
TRAFFIC_ON_POLYLINE |
الخطوط المتعددة الواعية بحركة المرور للمسارات. |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
يتم تقديم NavigationInstructions كسلسلة نصية بتنسيق HTML. من المفترض أن تتم قراءة هذا المحتوى كما هو. هذا المحتوى للعرض فقط. ويُرجى عدم تحليلها آليًا. |
مسار
يحتوي على مسار، يتكون من سلسلة من أجزاء الطرق المتصلة التي تربط نقاط الطريق البداية والنهاية والوسط.
تمثيل JSON |
---|
{ "routeLabels": [ enum ( |
الحقول | |
---|---|
routeLabels[] |
تصنيفات خاصة بـ |
legs[] |
مجموعة من الأرجل (أجزاء المسار بين نقاط الطريق) التي تشكل المسار. تتوافق كل ساق مع الرحلة بين اثنين من |
distanceMeters |
مسافة السفر للمسار، بالأمتار. |
duration |
طول الفترة الزمنية اللازمة للتنقل في المسار. في حال ضبط مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام " |
staticDuration |
مدة التنقّل خلال المسار بدون مراعاة أحوال حركة المرور. مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام " |
polyline |
الخطوط المتعددة للمسار العام. هذا الخطوط المتعددة هو الخطوط المتعددة المجمّعة بين كل خطوط " |
description |
تمثّل هذه السمة وصف المسار. |
warnings[] |
مصفوفة من التحذيرات يتم عرضها عند عرض المسار. |
viewport |
مربّع حدود إطار العرض للخطوط المتعددة |
travelAdvisory |
معلومات إضافية حول المسار |
optimizedIntermediateWaypointIndex[] |
إذا ضبطت |
localizedValues |
تمثيلات نصية لخصائص |
routeToken |
يشير هذا المصطلح إلى رمز مميّز للمسار بترميز base64 وآمن على الويب، ويمكن تمريره إلى حزمة SDK للتنقّل، ويسمح لهذه الحزمة بإعادة إنشاء المسار أثناء التنقّل، وإنجاز الهدف الأصلي في حال إعادة التوجيه عند إنشاء المسار من خلال استدعاء v2.computeRoutes. ويجب أن يتعامل العملاء مع هذا الرمز المميّز على أنّه كائن ثنائي كبير مبهم. لا تقارن قيمته بين الطلبات، حيث قد يتغير هذا الرمز المميز حتى إذا تم إرجاع المسار نفسه بالضبط. ملاحظة: لا يتوفّر |
RouteLabel
تصنيفات خاصة بـ
ومفيدة لتحديد خصائص معيّنة للمسار لمقارنتها مع تصنيفات أخرىRoute
عمليات التعداد | |
---|---|
ROUTE_LABEL_UNSPECIFIED |
تلقائي - غير مُستخدَم. |
DEFAULT_ROUTE |
الإعداد الافتراضي هو "الأفضل" تم إرجاعه لحساب المسار. |
DEFAULT_ROUTE_ALTERNATE |
بديل عن الخيار التلقائي "الأفضل" المسار الصحيح. سيتم عرض مثل هذه المسارات عند تحديد . |
FUEL_EFFICIENT |
مسار فعّال في استهلاك الوقود تم تحديد المسارات التي تحمل هذه القيمة بأنها محسّنة لمَعلمات "درجات حرارة اقتصادية"، مثل استهلاك الوقود. |
RouteLeg
يحتوي على جزء بين نقاط طريق لا تنتمي إلى via
.
تمثيل JSON |
---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
الحقول | |
---|---|
distanceMeters |
مسافة التنقل لمرحلة المسار، بالأمتار. |
duration |
طول الفترة الزمنية اللازمة للتنقل في الساق. وإذا تم ضبط مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام " |
staticDuration |
مدة التنقّل خلال المرحلة، يتم احتسابها بدون وضع أحوال حركة المرور في الاعتبار. مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام " |
polyline |
الخطوط المتعددة العامة لهذه المرحلة التي تتضمن الخطوط المتعددة في كل |
startLocation |
مكان بداية هذه الساق. قد يكون هذا الموقع الجغرافي مختلفًا عن |
endLocation |
تمثّل هذه السمة موضع نهاية هذه الساق. قد يكون هذا الموقع الجغرافي مختلفًا عن |
steps[] |
مصفوفة من الخطوات تشير إلى الأجزاء داخل هذه الساق. تمثل كل خطوة تعليمات تنقل واحدة. |
travelAdvisory |
يحتوي على المعلومات الإضافية التي يجب إطلاع المستخدم عليها، مثل القيود المحتملة في منطقة المرور، على جزء من المسار. |
localizedValues |
تمثيلات نصية لخصائص |
stepsOverview |
تعرض هذه السمة نظرة عامة حول الخطوات في |
خط متعدد
تتضمن هذه السياسة خطوطًا متعددة مشفّرة.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد polyline_type . يوضح هذا الحقل نوع الخطوط المتعددة. تكون القيمة التلقائية هي Encrypt_polyline. يمكن أن يكون polyline_type واحدًا فقط مما يلي: |
|
encodedPolyline |
ترميز سلسلة الخطوط المتعددة باستخدام خوارزمية الترميز المتعدد الخطوط |
geoJsonLinestring |
لتحديد خط متعدد باستخدام تنسيق GeoJSON LineString |
RouteLegStep
يحتوي على شريحة
. تتوافق الخطوة مع تعليمات تنقل واحدة. تتكون أرجل المسار من درجات.RouteLeg
تمثيل JSON |
---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
الحقول | |
---|---|
distanceMeters |
المسافة التي تفصل بين هذه الخطوة والمسافة بالمتر. في بعض الحالات، قد لا يحتوي هذا الحقل على قيمة. |
staticDuration |
مدة التنقّل خلال هذه الخطوة بدون وضع أحوال حركة المرور في الاعتبار. في بعض الحالات، قد لا يحتوي هذا الحقل على قيمة. مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام " |
polyline |
الخطوط المتعددة المرتبطة بهذه الخطوة. |
startLocation |
تمثل هذه السمة موقع البدء لهذه الخطوة. |
endLocation |
تمثّل هذه السمة موقع النهاية لهذه الخطوة. |
navigationInstruction |
تعليمات التنقّل. |
travelAdvisory |
يحتوي على المعلومات الإضافية التي يجب إطلاع المستخدم عليها، مثل القيود المحتملة في منطقة المرور، عند خطوة المسافة. |
localizedValues |
تمثيلات نصية لخصائص |
transitDetails |
التفاصيل المتعلقة بهذه الخطوة إذا كان وضع السفر هو |
travelMode |
وضع السفر المستخدَم في هذه الخطوة. |
مناورة
مجموعة من القيم التي تحدد إجراء التنقّل الذي يجب اتخاذه للخطوة الحالية (على سبيل المثال، الانعطاف إلى اليسار أو الدمج أو وضع مستقيم).
عمليات التعداد | |
---|---|
MANEUVER_UNSPECIFIED |
غير مستخدَم |
TURN_SLIGHT_LEFT |
الاتجاه إلى اليسار قليلاً. |
TURN_SHARP_LEFT |
انعطاف إلى أقصى اليسار. |
UTURN_LEFT |
انعطف إلى اليسار. |
TURN_LEFT |
الاتجاه يسارًا |
TURN_SLIGHT_RIGHT |
استدار إلى اليمين قليلاً. |
TURN_SHARP_RIGHT |
انعطاف إلى أقصى اليمين. |
UTURN_RIGHT |
انعطف إلى اليمين. |
TURN_RIGHT |
الاتجاه نحو اليمين |
STRAIGHT |
انطلِق بشكل مستقيم. |
RAMP_LEFT |
الاتجاه نحو المنحدر الأيسر. |
RAMP_RIGHT |
الاتجاه نحو المنحدر الصحيح |
MERGE |
الدخول في حركة المرور |
FORK_LEFT |
خذ الشوكة اليسرى. |
FORK_RIGHT |
خذ الشوكة اليمنى. |
FERRY |
ركوب المركب. |
FERRY_TRAIN |
استخدِم القطار الذي يقودك إلى العبّارة. |
ROUNDABOUT_LEFT |
الاتجاه يسارًا عند الدوّار |
ROUNDABOUT_RIGHT |
الاتجاه يمينًا عند الدوّار |
DEPART |
مناورة أولية. |
NAME_CHANGE |
يتم استخدامه للإشارة إلى تغيير اسم الشارع. |
RouteLegStepTravelAdvisory
تحتوي على المعلومات الإضافية التي يجب إعلام المستخدم بها، مثل القيود المحتملة في منطقة المرور على خطوة الساق.
تمثيل JSON |
---|
{
"speedReadingIntervals": [
{
object ( |
الحقول | |
---|---|
speedReadingIntervals[] |
ملاحظة: لم تتم تعبئة هذا الحقل حاليًا. |
RouteLegStepLocalizedValues
تمثيلات نصية لسمات معيّنة
تمثيل JSON |
---|
{ "distance": { object ( |
الحقول | |
---|---|
distance |
مسافة السفر ممثلة في شكل نصي. |
staticDuration |
المدة بدون أخذ ظروف الزيارات في الاعتبار، ويتم تمثيلها في شكل نصي. |
RouteLegStepTransitDetails
معلومات إضافية حول RouteLegStep
المتعلّقة بمسارات TRANSIT
تمثيل JSON |
---|
{ "stopDetails": { object ( |
الحقول | |
---|---|
stopDetails |
وتتوقف المعلومات عن الوصول والمغادرة في الخطوة. |
localizedValues |
تمثيلات نصية لخصائص |
headsign |
تحدّد هذه السياسة الاتجاه الذي يجب التنقّل فيه على هذا الخط كما هو موضّح على المركبة أو عند محطة المغادرة. غالبًا ما يكون الاتجاه هو المحطة النهائية. |
headway |
تحدّد الوقت المتوقع كمدة بين رحلات المغادرة من المحطة نفسها في الوقت الحالي. على سبيل المثال، إذا كانت قيمة ثوانٍ العرض 600، يمكنك أن تتوقع الانتظار لمدة عشر دقائق إذا فاتتك الحافلة. مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام " |
transitLine |
معلومات عن خط النقل العام المستخدم في هذه الخطوة. |
stopCount |
عدد محطات التوقف من المغادرة إلى محطة الوصول. ويشمل هذا العدد محطة الوصول، ولكنه يستثنى منها محطة المغادرة. على سبيل المثال، إذا غادر مسارك من المحطة A، ومرّ بالمحطتين B وC، ووصل إلى المحطة D، سيعرض stationCount الرقم 3. |
tripShortText |
النص الذي يظهر في الجداول ولوحات اللافتات لتحديد رحلة نقل عام للمسافرين ويجب أن يحدّد النص رحلة بشكل فريد خلال يوم الخدمة. على سبيل المثال، "538" هو |
TransitStopDetails
تفاصيل حول محطات النقل العام لـ RouteLegStep
.
تمثيل JSON |
---|
{ "arrivalStop": { object ( |
الحقول | |
---|---|
arrivalStop |
معلومات عن محطة الوصول للخطوة. |
arrivalTime |
الوقت المقدّر للوصول للخطوة. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
departureStop |
معلومات عن محطة المغادرة للخطوة. |
departureTime |
الوقت المقدّر لمغادرة الخطوة. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
TransitStop
معلومات حول محطة نقل عام
تمثيل JSON |
---|
{
"name": string,
"location": {
object ( |
الحقول | |
---|---|
name |
اسم محطة النقل العام |
location |
موقع المحطة الموضح بإحداثيات خطوط الطول/العرض. |
TransitDetailsLocalizedValues
أوصاف مترجمة للقيم RouteTransitDetails
.
تمثيل JSON |
---|
{ "arrivalTime": { object ( |
الحقول | |
---|---|
arrivalTime |
يشير ذلك المصطلح إلى الوقت في تمثيل النص المنسَّق مع المنطقة الزمنية المقابلة. |
departureTime |
يشير ذلك المصطلح إلى الوقت في تمثيل النص المنسَّق مع المنطقة الزمنية المقابلة. |
LocalizedTime
وصف مترجم للوقت.
تمثيل JSON |
---|
{
"time": {
object ( |
الحقول | |
---|---|
time |
الوقت المحدَّد كسلسلة في منطقة زمنية معيّنة |
timeZone |
تحتوي على المنطقة الزمنية. القيمة هي اسم المنطقة الزمنية كما هو محدّد في قاعدة بيانات المناطق الزمنية IANA، مثل "أمريكا/نيويورك". |
TransitLine
تحتوي على معلومات عن خط النقل العام المستخدم في هذه الخطوة.
تمثيل JSON |
---|
{ "agencies": [ { object ( |
الحقول | |
---|---|
agencies[] |
مؤسسة (أو الوكالات) للنقل العام التي تدير خط النقل العام هذا |
name |
الاسم الكامل لخط النقل العام هذا، على سبيل المثال، "8 Avenue Local". |
uri |
معرّف الموارد المنتظم (URI) لخط النقل العام هذا على النحو الذي تقدّمه مؤسسة النقل العام. |
color |
اللون الذي يشيع استخدامه في اللافتات لهذا الخط. يتم تمثيلها بنظام العد الست عشري. |
iconUri |
معرّف الموارد المنتظم (URI) للرمز المرتبط بهذا الخط. |
nameShort |
الاسم المختصر لخط النقل العام هذا. يكون هذا الاسم عادةً رقم سطر، مثل "M7" أو "355". |
textColor |
اللون الذي يشيع استخدامه في النص على اللافتات لهذا السطر. يتم تمثيلها بنظام العد الست عشري. |
vehicle |
نوع المركبة التي تعمل على خط النقل العام هذا. |
TransitAgency
مؤسسة نقل عام تدير خطًا للنقل العام
تمثيل JSON |
---|
{ "name": string, "phoneNumber": string, "uri": string } |
الحقول | |
---|---|
name |
اسم مؤسسة النقل العام هذه |
phoneNumber |
رقم الهاتف المنسَّق الخاص بمؤسسة النقل العام |
uri |
معرّف الموارد المنتظم (URI) الخاص بمؤسسة النقل العام |
TransitVehicle
معلومات حول مركبة مُستخدَمة في مسارات النقل العام
تمثيل JSON |
---|
{ "name": { object ( |
الحقول | |
---|---|
name |
تمثّل هذه السمة اسم هذه المركبة، بالأحرف اللاتينية الكبيرة. |
type |
تمثّل هذه السمة نوع المركبة المستخدمة. |
iconUri |
تمثّل هذه السمة معرّف الموارد المنتظم (URI) لرمز مرتبط بنوع المركبة هذا. |
localIconUri |
معرّف الموارد المنتظم (URI) للرمز المرتبط بنوع المركبة هذا، استنادًا إلى لافتات النقل المحلية. |
TransitVehicleType
تمثّل هذه السمة نوع المركبات المستخدمة في مسارات النقل العام.
عمليات التعداد | |
---|---|
TRANSIT_VEHICLE_TYPE_UNSPECIFIED |
غير مُستخدَم. |
BUS |
حافلة |
CABLE_CAR |
مركبة تعمل على كابل، عادةً على الأرض قد تكون العربات الجوية المعلّقة من النوع GONDOLA_LIFT . |
COMMUTER_TRAIN |
قطار سريع. |
FERRY |
العبّارة. |
FUNICULAR |
مركبة ينحدر لأعلى باستخدام كابل يتكون القطار المعلّق عادةً من سيارتين، حيث تعمل كل سيارة كوزن عكسي للأخرى. |
GONDOLA_LIFT |
تلفريك جوي |
HEAVY_RAIL |
قطار ثقيل. |
HIGH_SPEED_TRAIN |
قطار شديد السرعة |
INTERCITY_BUS |
حافلة بين المدن |
LONG_DISTANCE_TRAIN |
قطار المسافات الطويلة |
METRO_RAIL |
النقل العام بالقطار الخفيف |
MONORAIL |
قطار بخط حديدي واحد |
OTHER |
جميع المركبات الأخرى |
RAIL |
السكك الحديدية. |
SHARE_TAXI |
سيارة الأجرة المشتركة هي نوع من الحافلات التي يمكنها النزول ونقل الركاب من أي مكان على طريقها. |
SUBWAY |
قطار خفيف تحت الأرض |
TRAM |
صورة فوق سكة حديدية خفيفة |
TROLLEYBUS |
حافلة ترولي. |
RouteLegTravelAdvisory
تحتوي على المعلومات الإضافية التي يجب إبلاغ المستخدم بها في خطوة الساق، مثل القيود المحتملة في منطقة المرور.
تمثيل JSON |
---|
{ "tollInfo": { object ( |
الحقول | |
---|---|
tollInfo |
تحتوي على معلومات حول رسوم العبور في |
speedReadingIntervals[] |
فواصل زمنية لقراءة السرعة تفصّل كثافة حركة المرور ينطبق ذلك في حال ضبط الإعدادات المفضّلة للتوجيه في مثال:
|
RouteLegLocalizedValues
تمثيلات نصية لسمات معيّنة
تمثيل JSON |
---|
{ "distance": { object ( |
الحقول | |
---|---|
distance |
مسافة السفر ممثلة في شكل نصي. |
duration |
المدة التي يتم فيها وضع ظروف الزيارات في الاعتبار وهي ممثلة في شكل نصي. ملاحظة: إذا لم تطلب معلومات عن الزيارات، ستكون هذه القيمة مماثلة لقيمة staticDuration. |
staticDuration |
المدة بدون أخذ ظروف الزيارات في الاعتبار، ويتم تمثيلها في شكل نصي. |
StepsOverview
يقدّم هذا القسم معلومات نظرة عامة حول قائمة RouteLegStep
.
تمثيل JSON |
---|
{
"multiModalSegments": [
{
object ( |
الحقول | |
---|---|
multiModalSegments[] |
معلومات ملخّصة حول الشرائح المتعدّدة الوسائط المختلفة من |
MultiModalSegment
تقدّم هذه السمة معلومات ملخّصة حول الشرائح المتعدّدة الوسائط المختلفة للسمة RouteLeg.steps
. يتم تعريف الشريحة المتعدّدة الوسائط على أنّها RouteLegStep
واحدة أو أكثر متجاورة تحتوي على سمة RouteTravelMode
نفسها. لا تتم تعبئة هذا الحقل إذا لم تكن السمة RouteLeg
تحتوي على أي شرائح متعددة النماذج في الخطوات.
تمثيل JSON |
---|
{ "navigationInstruction": { object ( |
الحقول | |
---|---|
navigationInstruction |
تعليمات التنقل للشريحة المتعددة الوسائط. |
travelMode |
وضع السفر لقطاع متعدد الوسائط. |
stepStartIndex |
فهرس |
stepEndIndex |
فهرس |
إطار العرض
إطار عرض لخط الطول والعرض، ويتم تمثيله كخطين قطريًا مقابل نقطتين low
وhigh
. يُعتبَر إطار العرض منطقة مغلقة، بمعنى أنه يتضمّن حدوده. يجب أن تتراوح حدود خطوط العرض بين -90 و90 درجة، ويجب أن تتراوح حدود خط الطول بين -180 و180 درجة كحد أقصى. تشمل الحالات المختلفة ما يلي:
إذا كانت
low
=high
، يتكوّن إطار العرض من هذه النقطة الفردية.إذا كان
low.longitude
>high.longitude
، يتم قلب نطاق خط الطول (يتجاوز إطار العرض خط الطول 180 درجة).إذا كانت قيمة
low.longitude
= -180 درجة وhigh.longitude
= 180 درجة، يشمل إطار العرض جميع خطوط الطول.إذا كانت
low.longitude
= 180 درجة وhigh.longitude
= -180 درجة، يكون نطاق خط الطول فارغًا.إذا كان
low.latitude
>high.latitude
، نطاق خط العرض فارغ.
يجب تعبئة كل من low
وhigh
، ولا يمكن أن يكون المربّع الذي يتم تمثيله فارغًا (كما هو محدَّد في التعريفات أعلاه). سيؤدي إطار العرض الفارغ إلى حدوث خطأ.
على سبيل المثال، يشمل إطار العرض هذا مدينة نيويورك بالكامل:
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
تمثيل JSON |
---|
{ "low": { object ( |
الحقول | |
---|---|
low |
مطلوب. النقطة المنخفضة في إطار العرض. |
high |
مطلوب. تمثّل هذه السمة النقطة العليا لإطار العرض. |
RouteLocalizedValues
تمثيلات نصية لسمات معيّنة
تمثيل JSON |
---|
{ "distance": { object ( |
الحقول | |
---|---|
distance |
مسافة السفر ممثلة في شكل نصي. |
duration |
المدة التي تأخذ ظروف الزيارات في الاعتبار، ويتم تمثيلها في شكل نصي. ملاحظة: إذا لم تطلب معلومات عن الزيارات، ستكون هذه القيمة هي القيمة نفسها لـ |
staticDuration |
المدة بدون أخذ ظروف الزيارات في الاعتبار، ويتم تمثيلها في شكل نصي. |
transitFare |
يتم عرض سعر النقل العام في شكل نصي. |
GeocodingResults
تحتوي على
لكل من نقطة الانطلاق والوجهة ونقاط الطريق المتوسطة. تتم تعبئة هذا الحقل فقط لنقاط طريق العنوان.GeocodedWaypoints
تمثيل JSON |
---|
{ "origin": { object ( |
الحقول | |
---|---|
origin |
نقطة الطريق المرمّزة جغرافيًا للأصل. |
destination |
نقطة الطريق المرمّزة جغرافيًا للوجهة. |
intermediates[] |
يشير ذلك المصطلح إلى قائمة بنقاط الطرق الوسيطة المتوسطة جغرافيًا التي تحتوي كل منها على حقل فهرس يقابل الموضع الصفري للنقطة الوسيطة بالترتيب الذي تم تحديده في الطلب. |
GeocodedWaypoint
تفاصيل حول المواقع الجغرافية المستخدمة كنقاط طريق. تتم تعبئة هذا الحقل فقط لنقاط طريق العنوان. يتضمن تفاصيل حول نتائج الترميز الجغرافي لأغراض تحديد العنوان الذي تم ترميز العنوان جغرافيًا إليه.
تمثيل JSON |
---|
{
"geocoderStatus": {
object ( |
الحقول | |
---|---|
geocoderStatus |
يشير إلى رمز الحالة الناتج من عملية الترميز الجغرافي. |
type[] |
نوع(أنواع) النتيجة في شكل علامات نوع صفرية أو أكثر. الأنواع المتوافقة: أنواع العناوين وأنواع مكوّنات العناوين. |
partialMatch |
يشير إلى أن أداة الترميز الجغرافي لم تعرض تطابقًا تامًا للطلب الأصلي، على الرغم من أنه كان قادرًا على مطابقة جزء من العنوان المطلوب. يمكنك مراجعة الطلب الأصلي بحثًا عن أخطاء إملائية و/أو عنوان غير مكتمل. |
placeId |
رقم تعريف المكان الخاص بهذه النتيجة. |
intermediateWaypointRequestIndex |
فهرس النقطة الوسيطة المقابلة في الطلب. لا تتم تعبئة هذا الحقل إلا إذا كانت نقطة الطريق المقابلة نقطة وسيطة متوسطة. |