- طلب HTTP
- نص الطلب
- نص الاستجابة
- PolylineQuality
- PolylineEncoding
- الوحدات
- ReferenceRoute
- ExtraComputation
- المسار
- RouteLabel
- RouteLeg
- الخطوط المتعددة
- RouteLegStep
- NavigationInstruction
- المناورة
- 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 "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
arrivalTime |
اختياريّ. وقت الوصول ملاحظة: لا يمكن الضبط إلا عند ضبط طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
computeAlternativeRoutes |
اختياريّ. لتحديد ما إذا كان سيتم حساب المسارات البديلة بالإضافة إلى المسار. لا يتم عرض أي مسارات بديلة للطلبات التي تحتوي على نقاط طرق وسيطة. |
routeModifiers |
اختياريّ. مجموعة من الشروط التي يجب استيفاؤها والتي تؤثر في طريقة حساب المسارات. |
languageCode |
اختياريّ. رمز اللغة BCP-47، مثل en-US أو sr-Latn لمزيد من المعلومات، يُرجى الاطّلاع على معرّف لغة Unicode. راجِع دعم اللغة للحصول على قائمة اللغات المتاحة. عند عدم توفير هذه القيمة، يتم استنتاج لغة العرض من موقع طلب المسار. |
regionCode |
اختياريّ. تمثّل هذه السمة رمز المنطقة، ويتم تحديده كـ ccTLD ("نطاق المستوى الأعلى") الذي يتكوّن من حرفين. لمزيد من المعلومات، يُرجى الاطّلاع على نطاقات المستوى الأعلى لرمز البلد. |
units |
اختياريّ. تحدد وحدات القياس لحقول العرض. تتضمن هذه الحقول الحقل |
optimizeWaypointOrder |
اختياريّ. في حال ضبطها على "صحيح"، تحاول الخدمة خفض التكلفة الإجمالية للمسار من خلال إعادة ترتيب نقاط الطريق الوسيطة المحددة. يتعذّر إرسال الطلب إذا كانت أي من نقاط الطريق الوسيطة تمثّل نقطة طريق |
requestedReferenceRoutes[] |
اختياريّ. تحدد المسارات المرجعية التي يلزم حسابها كجزء من الطلب بالإضافة إلى المسار الافتراضي. المسار المرجعي هو مسار هدف حسابي مختلف عن المسار الافتراضي. على سبيل المثال، تأخذ عملية احتساب المسار المرجعي |
extraComputations[] |
اختياريّ. تمثّل هذه السمة قائمة بعمليات المعالجة الإضافية التي يمكن استخدامها لإكمال الطلب. ملاحظة: قد تؤدي هذه العمليات الحسابية الإضافية إلى عرض حقول إضافية في الاستجابة. يجب أيضًا تحديد هذه الحقول الإضافية في قناع الحقل لعرضها في الاستجابة. |
trafficModel |
اختياريّ. تحدد الافتراضات المراد استخدامها عند حساب الوقت في حركة المرور. يؤثّر هذا الإعداد في القيمة المعروضة في حقل المدة في |
transitPreferences |
اختياريّ. يحدّد هذا الإعداد الإعدادات المفضّلة التي تؤثر في المسار المعروض لمسارات |
نص الاستجابة
الإصدار 2.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. |
الوحدات
مجموعة من القيم التي تحدد وحدة القياس المستخدمة في العرض.
عمليات التعداد | |
---|---|
UNITS_UNSPECIFIED |
لم يتم تحديد وحدات القياس. يتم استخدام الخيار التلقائي بوحدة القياس المستنتَجة من الطلب. |
METRIC |
وحدات القياس المترية. |
IMPERIAL |
وحدات القياس الإمبراطورية (الإنجليزية). |
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) للتنقل، ويتيح لحزمة تطوير البرامج (SDK) الخاصة بالتنقل إعادة إنشاء المسار أثناء التنقل، وفي حال إعادة التوجيه، يجب مراعاة النية الأصلية عند إنشاء المسار من خلال استدعاء الإصدار 2.computeRoutes. على العملاء التعامل مع هذا الرمز المميّز على أنّه كائن ثنائي كبير (blob) مبهم. وليس مخصصًا للقراءة أو التبديل. ملاحظة: لا يتوفّر |
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 |
عدد محطات التوقف من المغادرة إلى محطة الوصول. يشمل هذا العدد محطة الوصول، ولكنه لا يشمل محطة المغادرة. على سبيل المثال، إذا غادر مسارك من المحطة "أ" ومر عبر المحطتين "ب" و"ج" ووصل إلى المحطتين "د"، فستعرض دالة StopCount 3. |
tripShortText |
النص الذي يظهر في الجداول الزمنية ولوحات اللافتات لتحديد رحلة نقل عام للركاب. ويجب أن يحدّد النص رحلة بشكلٍ فريد خلال يوم تقديم الخدمة. على سبيل المثال، الرقم "538" هو |
TransitStopDetails
تفاصيل حول محطات النقل العام في RouteLegStep
تمثيل JSON |
---|
{ "arrivalStop": { object ( |
الحقول | |
---|---|
arrivalStop |
معلومات عن محطة وصول الخطوة. |
arrivalTime |
الوقت المقدّر للوصول للخطوة. طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
departureStop |
معلومات حول محطة المغادرة للخطوة. |
departureTime |
تمثل هذه السمة الوقت المقدَّر لمغادرة الخطوة. طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
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 شارع الجيزة". |
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 |
فهرس النقطة الوسيطة الوسيطة المناظرة في الطلب. ولا يتم ملء هذا الحقل إلا إذا كانت نقطة الطريق المناظرة هي نقطة طريق وسيطة. |