الحصول على الاتجاهات من خلال واجهة برمجة التطبيقات Directions API (القديمة)

باستخدام Directions API (الإصدار القديم)، يمكنك إجراء ما يلي:

• ابحث عن الاتجاهات لعدة وسائل نقل، بما في ذلك النقل العام أو القيادة أو المشي أو ركوب الدراجات.
• عرض اتجاهات متعددة الأجزاء باستخدام سلسلة من النقاط على المسار
• حدِّد نقاط الانطلاق والوجهات والنقاط على المسار كسلاسل نصية (مثل "القاهرة، مصر" أو "الرياض، المملكة العربية السعودية") أو كأرقام تعريف للأماكن أو كإحداثيات خطوط العرض/الطول.

تعرض واجهة برمجة التطبيقات المسارات الأكثر كفاءة عند احتساب الاتجاهات. تُعدّ مدة الرحلة العامل الأساسي الذي يتم تحسينه، ولكن قد تأخذ واجهة برمجة التطبيقات في الاعتبار أيضًا عوامل أخرى مثل المسافة وعدد المنعطفات وغيرها الكثير عند تحديد المسار الأكثر كفاءة.

قبل البدء

قبل البدء في استخدام Directions API (الإصدار القديم)، تحتاج إلى مشروع يتضمّن حساب فوترة وتكون Directions API (الإصدار القديم) مفعَّلة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على الإعداد في وحدة تحكّم Cloud.

إنشاء طلبات Directions API (الإصدار القديم)

يتّخذ طلب Directions API (الإصدار القديم) الشكل التالي:

https://maps.googleapis.com/maps/api/directions/outputFormat?parameters

حيث يمكن أن تكون قيمة outputFormat أيًا مما يلي:

• json (يُنصح به) يشير إلى الإخراج بتنسيق JavaScript Object Notation ‏ (JSON)
• ‫xml يشير إلى أنّ الناتج بتنسيق XML

ملاحظة: يجب أن تكون عناوين URL مشفّرة بشكل صحيح لتكون صالحة، ويجب ألا تتجاوز 16,384 حرفًا لجميع خدمات الويب. يُرجى الانتباه إلى هذا الحدّ عند إنشاء عناوين URL.

كما هو معتاد في عناوين URL، يتم الفصل بين جميع المَعلمات باستخدام رمز العطف اللاتيني (&). يجب أن تكون جميع الأحرف المحجوزة (مثل علامة الجمع "+") مرمَّزة بعنوان URL. في ما يلي قائمة بالمَعلمات وقيمها المحتملة.

المعلمات المطلوبة

الوجهة

رقم تعريف المكان أو العنوان أو قيمة خط العرض/خط الطول النصية التي تريد حساب الاتجاهات إليها تكون خيارات مَعلمة الوجهة هي نفسها خيارات مَعلمة نقطة الانطلاق.

الأصل

رقم تعريف المكان أو العنوان أو قيمة خط العرض/خط الطول النصية التي تريد حساب الاتجاهات منها.

• يجب أن تبدأ أرقام تعريف الأماكن بـ place_id:. يمكنك استرداد أرقام تعريف الأماكن من Geocoding API وPlaces API (بما في ذلك ميزة "الإكمال التلقائي للأماكن"). للاطّلاع على مثال يستخدم أرقام تعريف الأماكن من ميزة "الإكمال التلقائي للأماكن"، يُرجى مراجعة ميزة الإكمال التلقائي للأماكن والاتجاهات. لمزيد من المعلومات عن أرقام تعريف الأماكن، يُرجى الاطّلاع على نظرة عامة على رقم تعريف المكان.

  origin=place_id:ChIJ3S-JXmauEmsRUcIaWtf4MzE
  

• إذا مرّرت عنوانًا، ستعمل خدمة "الاتجاهات" على ترميز السلسلة جغرافيًا وتحويلها إلى إحداثيات خطوط العرض/الطول لاحتساب الاتجاهات. قد تختلف هذه الإحداثيات عن تلك التي تعرضها Geocoding API، على سبيل المثال، مدخل المبنى بدلاً من وسطه.

  origin=24+Sussex+Drive+Ottawa+ON
  

  يُفضَّل استخدام أرقام تعريف الأماكن بدلاً من العناوين أو إحداثيات خطوط العرض/الطول. سيؤدي استخدام الإحداثيات دائمًا إلى تثبيت النقطة على الطريق الأقرب إلى تلك الإحداثيات، وقد لا يكون هذا الطريق نقطة وصول إلى الموقع الجغرافي أو حتى طريقًا يؤدي بسرعة أو بأمان إلى الوجهة.

• إذا مرّرت إحداثيات، ستتم محاذاة النقطة مع أقرب طريق. ويُفضَّل تمرير رقم تعريف المكان. إذا كنت تريد تمرير الإحداثيات، تأكَّد من عدم وجود مسافة بين قيمتَي خط العرض وخط الطول.

  origin=41.43206,-81.38992
  

• يجب تنسيق رموز Plus Codes كرمز عالمي أو رمز مركّب. يجب تنسيق رموز Plus Codes كما هو موضّح هنا (يتم إلغاء علامات الجمع في عنوان URL إلى %2B ويتم إلغاء المسافات في عنوان URL إلى %20).

  • الرمز العالمي هو رمز منطقة مكوّن من 4 أحرف ورمز محلي مكوّن من 6 أحرف أو أكثر (849VCWC8+R9 هو 849VCWC8%2BR9).
  • الرمز المركّب هو رمز محلي يتألف من 6 أحرف أو أكثر مع موقع جغرافي صريح (CWC8+R9 Mountain View, CA, USA هو CWC8%2BR9%20Mountain%20View%20CA%20USA).

المعلمات الاختيارية

بدائل

في حال ضبطها على true، تحدّد أنّ خدمة الاتجاهات قد توفّر أكثر من مسار بديل في الردّ. يُرجى العِلم أنّ توفير مسارات بديلة قد يؤدي إلى زيادة وقت الاستجابة من الخادم. لا تتوفّر هذه الميزة إلا للطلبات التي لا تتضمّن نقاطًا وسيطة على المسار. لمزيد من المعلومات، يُرجى الاطّلاع على دليل النقاط على المسار.

arrival_time

تحدّد وقت الوصول المفضّل لاتجاهات النقل العام، بالثواني منذ منتصف الليل، 1 يناير 1970 بالتوقيت العالمي المنسق. يمكنك تحديد departure_time أو arrival_time، ولكن ليس كليهما. يُرجى العِلم أنّه يجب تحديد السمة arrival_time كعدد صحيح.

تجنُّب

يشير إلى أنّ المسارات المحسوبة يجب أن تتجنّب الميزات المشار إليها. تتيح هذه المَعلمة استخدام الوسيطات التالية:

• تشير السمة tolls إلى أنّ المسار المحسوب يجب أن يتجنّب الطرق أو الجسور التي تفرض رسوم عبور.
• تشير السمة highways إلى أنّ المسار المحسوب يجب أن يتجنّب الطرق السريعة.
• تشير السمة ferries إلى أنّه يجب أن يتجنّب المسار المحسوب العبّارات.
• تشير السمة indoor إلى أنّ المسار المحسوب يجب أن يتجنّب السلالم الداخلية في اتجاهات المشي والنقل العام.

يمكن طلب مسار يتجنّب أي مجموعة من رسوم العبور والطرق السريعة والعبّارات من خلال تمرير قيود متعددة إلى المَعلمة avoid. على سبيل المثال:

avoid=tolls|highways|ferries.

departure_time

تحدّد وقت المغادرة المفضّل. يمكنك تحديد الوقت كعدد صحيح بالثواني منذ منتصف ليل 1 يناير 1970 بالتوقيت العالمي المنسق. إذا تم تحديد departure_time بعد 31-12-9999T23:59:59.999999999Z، ستعيد واجهة برمجة التطبيقات departure_time إلى 31-12-9999T23:59:59.999999999Z. بدلاً من ذلك، يمكنك تحديد قيمة "now"، والتي تضبط وقت المغادرة على الوقت الحالي (صحيح إلى أقرب ثانية). يمكن تحديد وقت المغادرة في حالتَين:

• بالنسبة إلى الطلبات التي يكون فيها وضع السفر هو النقل العام: يمكنك اختياريًا تحديد departure_time أو arrival_time. إذا لم يتم تحديد أي وقت، يتم ضبط departure_time تلقائيًا على الوقت الحالي (أي يتم ضبط وقت المغادرة تلقائيًا على الوقت الحالي).
• بالنسبة إلى الطلبات التي يكون فيها وضع السفر هو القيادة: يمكنك تحديد departure_time لتلقّي مسار ومدة الرحلة (حقل الاستجابة: duration_in_traffic) مع مراعاة أحوال حركة المرور. يجب ضبط السمة departure_time على الوقت الحالي أو على وقت في المستقبل. ولا يمكن أن يكون في الماضي.

language

اللغة التي سيتم عرض النتائج بها يُرجى العِلم أنّ هذا ينطبق فقط على العناوين التي تم ترميزها جغرافيًا في start_address وend_address، والنص المترجَم في الحقلَين distance وduration (في الأقسام والخطوات)، ووصف المناورات في html_instructions، ولكن ليس على الأسماء والعناوين في html_instructions، والتي يتم تنسيقها بلغتها المحلية ونصها.

• اطّلِع على قائمة اللغات المتاحة. تعدّل Google اللغات المتاحة بشكل متكرر، لذا قد لا تكون هذه القائمة شاملة.
• في حال عدم توفير language، تحاول واجهة برمجة التطبيقات استخدام اللغة المفضّلة كما هو محدّد في العنوان Accept-Language.
• تبذل واجهة برمجة التطبيقات قصارى جهدها لتوفير عنوان شارع يمكن قراءته لكل من المستخدم والسكان المحليين. لتحقيق هذا الهدف، تعرض عناوين الشوارع باللغة المحلية، ويتم تحويلها صوتيًا إلى نص يمكن للمستخدم قراءته إذا لزم الأمر، مع مراعاة اللغة المفضّلة. ويتم عرض جميع العناوين الأخرى باللغة المفضّلة. يتم عرض جميع مكوّنات العنوان باللغة نفسها، والتي يتم اختيارها من المكوّن الأول.
• إذا لم يكن الاسم متاحًا باللغة المفضّلة، تستخدم واجهة برمجة التطبيقات أقرب نتيجة مطابقة.
• تؤثر اللغة المفضّلة بشكل بسيط في مجموعة النتائج التي تختار واجهة برمجة التطبيقات عرضها، وفي ترتيب عرضها. تفسّر أداة الترميز الجغرافي الاختصارات بشكل مختلف حسب اللغة، مثل اختصارات أنواع الشوارع أو المرادفات التي قد تكون صالحة في لغة واحدة ولكن ليس في لغة أخرى. على سبيل المثال، utca وtér هما مرادفان لكلمة "شارع" باللغة الهنغارية.

الوضع

لحساب المسافات والاتجاهات، يمكنك تحديد وسيلة النقل التي تريد استخدامها. يتم استخدام وضع "driving" تلقائيًا. يتم احتساب الاتجاهات تلقائيًا كاتجاهات قيادة. تتوفّر وسائل النقل التالية:

• تشير القيمة driving (تلقائية) إلى اتجاهات القيادة العادية أو المسافة باستخدام شبكة الطرق.
• يطلب "walking" اتجاهات المشي أو المسافة عبر مسارات المشاة والأرصفة (حيثما كان ذلك متاحًا).
• يطلب bicycling اتجاهات ركوب الدراجات أو المسافة عبر مسارات الدراجات والشوارع المفضّلة (حيثما كان ذلك متاحًا).
• transit يطلب الاتجاهات أو المسافة باستخدام مسارات النقل العام (حيثما تتوفر). إذا ضبطت الوضع على "النقل"، يمكنك تحديد departure_time أو arrival_time بشكل اختياري. إذا لم يتم تحديد أي وقت، يتم ضبط departure_time تلقائيًا على الوقت الحالي (أي يتم ضبط وقت المغادرة تلقائيًا على الوقت الحالي). يمكنك أيضًا تضمين transit_mode و/أو transit_routing_preference اختياريًا. تتوفّر رحلات النقل العام لمدة تصل إلى 7 أيام في الماضي أو 100 يوم في المستقبل، وذلك حسب توفّر معلومات النقل العام التي يقدّمها مزوّدو البيانات. تتغيّر جداول النقل العام بشكل متكرّر، وقد تتغيّر رحلات النقل العام المتاحة بمرور الوقت، ولا يمكن ضمان تقديم نتائج متّسقة للتوقّعات قبل وقت طويل.

المنطقة

رمز المنطقة، ويتم تحديده كقيمة مكوّنة من حرفَين لنطاق المستوى الأعلى الذي يتم ترميزه حسب البلد (ccTLD). تتطابق معظم رموز نطاقات المستوى الأعلى لرمز البلد (ccTLD) مع رموز المنظمة الدولية للمعايير (ISO) 3166-1، مع بعض الاستثناءات الملحوظة. على سبيل المثال، نطاق مستوى أعلى يتم ترميزه حسب البلد (ccTLD) في المملكة المتحدة هو "uk"‏ (‎.co.uk)، في حين أنّ رمز المنظمة الدولية للمعايير (ISO) 3166-1 هو "gb" (من الناحية الفنية لكيان "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية").

traffic_model

تحدّد الافتراضات التي يجب استخدامها عند احتساب الوقت في حركة المرور. يؤثر هذا الإعداد في القيمة المعروضة في حقل duration_in_traffic في الاستجابة، والذي يحتوي على الوقت المتوقّع في حركة المرور استنادًا إلى المتوسطات السابقة. لا يمكن تحديد المَعلمة traffic_model إلا لاتجاهات القيادة عندما يتضمّن الطلب departure_time. القيم المتاحة لهذه المَعلمة هي:

• best_guess (تلقائي) تشير إلى أنّ قيمة duration_in_traffic التي يتم عرضها يجب أن تكون أفضل تقدير لمدة الرحلة استنادًا إلى ما هو معروف عن كلّ من أحوال حركة المرور السابقة وحركة المرور المباشرة. تزداد أهمية معلومات الكثافة في حركة المرور في الوقت الفعلي كلما اقترب departure_time من الوقت الحالي.
• تشير السمة pessimistic إلى أنّ قيمة duration_in_traffic التي يتم عرضها يجب أن تكون أطول من مدة الرحلة الفعلية في معظم الأيام، مع أنّ بعض الأيام التي تشهد أحوال حركة مرور سيئة بشكل خاص قد تتجاوز هذه القيمة.
• تشير السمة optimistic إلى أنّ قيمة duration_in_traffic التي يتم عرضها يجب أن تكون أقصر من مدة الرحلة الفعلية في معظم الأيام، مع أنّ الأيام التي تكون فيها أحوال حركة المرور جيدة بشكل خاص قد تكون أسرع من هذه القيمة.

ستوفّر القيمة التلقائية لـ best_guess التوقّعات الأكثر فائدة للغالبية العظمى من حالات الاستخدام. من المحتمل أن تكون مدة الرحلة المتوقّعة في best_guess أقصر من optimistic، أو أطول من pessimistic، وذلك بسبب الطريقة التي يدمج بها نموذج التنبؤي في best_guess معلومات حركة المرور المباشرة.

transit_mode

تحدّد هذه السمة وسيلة نقل واحدة أو أكثر مفضّلة. لا يمكن تحديد هذه المَعلمة إلا لاتجاهات النقل العام. تتيح المَعلمة استخدام الوسيطات التالية:

• تشير السمة bus إلى أنّ المسار المحسوب يجب أن يفضّل السفر بالحافلة.
• تشير السمة subway إلى أنّ المسار المحسوب يجب أن يفضّل التنقّل باستخدام مترو الأنفاق.
• تشير السمة train إلى أنّ المسار المحسوب يجب أن يفضّل السفر بالقطار.
• تشير السمة tram إلى أنّ المسار المحسوب يجب أن يفضّل السفر بالترام والقطار الخفيف.
• تشير السمة rail إلى أنّ المسار المحسوب يجب أن يفضّل السفر بالقطار والترام والقطار الخفيف ومترو الأنفاق. وهذا يعادل transit_mode=train|tram|subway.

transit_routing_preference

تحدّد هذه السمة الإعدادات المفضّلة لمسارات النقل العام. باستخدام هذه المَعلمة، يمكنك تفضيل الخيارات التي يتم عرضها، بدلاً من قبول أفضل مسار تلقائي تختاره واجهة برمجة التطبيقات. لا يمكن تحديد هذه المَعلمة إلا لاتجاهات النقل العام. تتيح المَعلمة الوسيطات التالية:

• تشير السمة less_walking إلى أنّ المسار المحسوب يجب أن يفضّل المشي لمسافات محدودة.
• تشير السمة fewer_transfers إلى أنّ المسار المحسوب يجب أن يفضّل عددًا محدودًا من عمليات النقل.

وحدتان

يحدّد نظام الوحدات الذي سيتم استخدامه عند عرض النتائج.

تحتوي نتائج الاتجاهات على نص ضمن حقول المسافة التي قد يتم عرضها للمستخدم للإشارة إلى مسافة "خطوة" معيّنة من المسار. يستخدم هذا النص تلقائيًا نظام الوحدات في بلد أو منطقة نقطة الانطلاق.

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

• تحدّد السمة metric استخدام النظام المتري. يتم عرض المسافات النصية بالكيلومتر والمتر.
• تشير القيمة imperial إلى استخدام النظام الإمبراطوري (الإنجليزي). يتم عرض المسافات النصية باستخدام الأميال والأقدام.

نقاط الطريق

تحدّد مصفوفة من المواقع الجغرافية الوسيطة التي يجب تضمينها على طول المسار بين نقطتَي الانطلاق والوجهة كمواقع جغرافية للمرور أو التوقف. تغيّر نقاط المسار المسار من خلال توجيهه عبر المواقع الجغرافية المحدّدة. تتيح واجهة برمجة التطبيقات النقاط على المسار لوسائل النقل التالية: القيادة والمشي وركوب الدراجات، ولكن ليس النقل العام. يمكنك تقديم موقع جغرافي واحد أو أكثر مفصولاً بحرف الخط العمودي (| أو %7C)، على شكل رقم تعريف مكان أو عنوان أو إحداثيات خطوط العرض/الطول. تحسب خدمة الاتجاهات تلقائيًا مسارًا باستخدام النقاط على المسار بالترتيب الذي تم تقديمها به. تكون الأولوية لتحليل قيمة النقطة على المسار هي رقم تعريف المكان، ثم إحداثيات خطوط العرض/الطول، ثم العنوان.

• إذا مرّرت رقم تعريف مكان، يجب أن تسبقه بـ place_id:. يمكنك استرداد أرقام تعريف الأماكن من Geocoding API وPlaces API (بما في ذلك ميزة "الإكمال التلقائي للأماكن"). للاطّلاع على مثال يستخدم أرقام تعريف الأماكن من ميزة "الإكمال التلقائي للأماكن"، يُرجى مراجعة ميزة الإكمال التلقائي للأماكن والاتجاهات. لمزيد من المعلومات عن أرقام تعريف الأماكن، يُرجى الاطّلاع على نظرة عامة على رقم تعريف المكان.
  لتحقيق الكفاءة والدقة، استخدِم أرقام تعريف الأماكن عندما يكون ذلك ممكنًا. تكون أرقام التعريف هذه واضحة بشكل فريد مثل زوج قيم خطوط العرض/الطول وتوفّر مزايا الترميز الجغرافي للتوجيه، مثل نقاط الوصول ومتغيّرات حركة المرور. على عكس العنوان، لا تتطلّب أرقام التعريف من الخدمة إجراء عملية بحث أو طلب وسيط للحصول على تفاصيل المكان، وبالتالي يكون الأداء أفضل.
• إذا مرّرت إحداثيات خطوط العرض/الطول، تنتقل القيم مباشرةً إلى خادم الواجهة الأمامية لحساب الاتجاهات بدون ترميز جغرافي. يتم تثبيت النقاط على الطرق وقد لا توفّر الدقة التي يحتاجها تطبيقك. استخدِم الإحداثيات عندما تكون واثقًا من أنّ القيم تحدّد بدقة النقاط التي يحتاجها تطبيقك للتوجيه بغض النظر عن نقاط الوصول المحتملة أو تفاصيل الترميز الجغرافي الإضافية. تأكَّد من استخدام فاصلة (%2C) وليس مسافة (%20) للفصل بين قيم خطوط العرض والطول.
• إذا مرّرت عنوانًا، ستعمل خدمة "الاتجاهات" على الترميز الجغرافي للسلسلة وتحويلها إلى إحداثيات خطوط العرض/خطوط الطول لاحتساب الاتجاهات. إذا كانت قيمة العنوان غامضة، قد تؤدي القيمة إلى إجراء بحث لإزالة الغموض عن العناوين المشابهة. على سبيل المثال، قد يكون "شارع 1" قيمة كاملة أو قيمة جزئية لـ "شارع 1 شمال شرق" أو "شارع 1 جنوب شرق". قد تختلف هذه النتيجة عن تلك التي تعرضها Geocoding API. يمكنك تجنُّب التفسيرات الخاطئة المحتملة باستخدام أرقام تعريف الأماكن.
• بدلاً من ذلك، يمكنك تقديم مجموعة من النقاط المرمّزة باستخدام خوارزمية الخطوط المتعدّدة المرمّزة. ستجد أنّ المجموعة المرمّزة مفيدة لعدد كبير من النقاط على المسار، لأنّ عنوان URL يكون أقصر بكثير. يبلغ الحد الأقصى لعدد أحرف عنوان URL في جميع خدمات الويب 16,384 حرفًا.
  • يجب أن تبدأ الخطوط المتعدّدة المرمّزة بـ enc: وأن تتبعها نقطتان رأسيتان (:)، على سبيل المثال: waypoints=enc:gfo}EtohhU:.
  • يمكنك أيضًا تضمين عدة خطوط متعدّدة مرمّزة، مع الفصل بينها باستخدام حرف الخط العمودي (|). على سبيل المثال، waypoints=via:enc:wc~oAwquwMdlTxiKtqLyiK:|enc:c~vnAamswMvlTor@tjGi}L:| via:enc:udymA{~bxM:

التأثير في المسارات باستخدام نقاط توقُّف ونقاط مرور على المسار

لكل نقطة على المسار في الطلب، يُلحق ردّ الاتجاهات إدخالاً بمصفوفة legs لتقديم تفاصيل عن محطات التوقف في هذا الجزء من الرحلة.

إذا أردت التأثير في المسار باستخدام نقاط على المسار بدون إضافة محطة توقّف، أضِف البادئة via: إلى النقطة على المسار. لن تؤدي النقاط على المسار التي تبدأ بـ via: إلى إضافة إدخال إلى مصفوفة legs، ولكن سيتم توجيه الرحلة عبر النقطة على المسار.

يعدّل عنوان URL التالي الطلب السابق بحيث يتم توجيه الرحلة عبر ليكسينغتون بدون توقف:

https://maps.googleapis.com/maps/api/directions/json?
origin=Boston,MA&destination=Concord,MA
&waypoints=Charlestown,MA|via:Lexington,MA

تكون البادئة via: أكثر فعالية عند إنشاء المسارات استجابةً لسحب المستخدم للنقاط على المسار على الخريطة. يتيح ذلك للمستخدم الاطّلاع على المسار النهائي في الوقت الفعلي، ويساعد في ضمان وضع النقاط على المسار في أماكن يمكن الوصول إليها من خلال Directions API.

تحسين النقاط على المسار

تحسب خدمة الاتجاهات تلقائيًا مسارًا من خلال النقاط على المسار المقدَّمة بالترتيب المحدَّد. يمكنك اختياريًا تمرير optimize:true كوسيطة أولى ضمن مَعلمة نقاط المسار للسماح لخدمة "الاتجاهات" بتحسين المسار المقدَّم من خلال إعادة ترتيب نقاط المسار بترتيب أكثر كفاءة. (هذا التحسين هو تطبيق لمسألة البائع المتجول). مدة الرحلة هي العامل الأساسي الذي يتم تحسينه، ولكن قد يتم أخذ عوامل أخرى في الاعتبار عند تحديد المسار الأكثر كفاءة، مثل المسافة وعدد المنعطفات وغيرها الكثير. يجب أن تكون جميع النقاط على المسار محطات توقّف لخدمة "الاتجاهات" من أجل تحسين مسارها.

إذا طلبت من خدمة "الاتجاهات" تحسين ترتيب نقاط المسار، سيتم عرض ترتيبها في حقل waypoint_order ضمن عنصر المسارات. يعرض الحقل waypoint_order قيمًا تستند إلى الصفر.

يحتسب المثال التالي رحلة برية من أديلايد في جنوب أستراليا إلى كل منطقة من مناطق النبيذ الرئيسية في جنوب أستراليا باستخدام ميزة تحسين المسار.

https://maps.googleapis.com/maps/api/directions/json?
origin=Adelaide,SA&destination=Adelaide,SA
&waypoints=optimize:true|Barossa+Valley,SA|Clare,SA|Connawarra,SA|McLaren+Vale,SA

سيشير فحص المسار المحسوب إلى أنّ عملية الحساب تستخدم نقاط المسار بالترتيب التالي:

"waypoint_order": [ 3, 2, 0, 1 ]

الخطوات التالية

أمثلة على الاتجاهات

• أوضاع السفر
• معلومات عن حركة المرور
• النقاط على المسار وتحسينها
• قيود المسار
• أنظمة الوحدات
• تحديد المنطقة
• معدِّلات المواقع الجغرافية

الردود على طلبات الاتجاهات

• DirectionsResponse
• DirectionsRoute
• DirectionsLeg
• DirectionsStep وDirectionsPolyline
• DirectionsTransitDetails
• DirectionsStatus
• DirectionsGeocodedWaypoint