- طلب 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 |
اختياريّ. يحدّد الإعداد الإعدادات المفضّلة التي تؤثر في المسار الذي يتم عرضه لمسارات |
نص الاستجابة
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 للتنقل، ويسمح لحزمة SDK الخاصة بالتنقل بإعادة إنشاء المسار أثناء التنقل، وفي حالة إعادة التوجيه، يتم الالتزام بالهدف الأصلي عند إنشاء المسار من خلال طلب v2.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 تتضمن نوع الخطوط المتعددة. يكون الإعداد التلقائي هو ترميز_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 |
عدد المحطات من وقت المغادرة إلى محطة الوصول يشمل هذا العدد محطة الوصول، لكنه يستثني محطة المغادرة. على سبيل المثال، إذا غادر مسارك من المحطة "أ" ومرّ عبر المحطتين "ب" و"ج" ووصل إلى المحطة "د"، ستعرض دالة stationCount الرقم 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، مثل "America/New_York". |
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 |
فهرس نقطة الطريق المتوسطة المقابلة في الطلب. ولا تتم تعبئة هذا الحقل إلا إذا كانت نقطة الطريق المقابلة نقطة طريق وسيطة. |