المفاهيم الرئيسية

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

الأفق الزمني

القيد الأساسي الذي تقدّمه إلى الخدمة هو travel_duration. يحدّد هذا القيد الأفق الزمني للحساب.

• الحد الأقصى للمدة: تتيح واجهة برمجة التطبيقات حدًا أقصى لمدة الرحلة يبلغ 3600 ثانية (ساعة واحدة) لوضع DRIVE، و7200 ثانية (ساعتان) لوضعَي WALK وBICYCLE.
• الأداء: يتناسب وقت الحساب مع المدة المطلوبة ووضع السفر الذي تم اختياره. يغطّي المنحنى الزمني المتساوي للقيادة لمدة ساعة واحدة منطقة جغرافية وشبكة طرق أكبر بكثير من المنحنى الزمني المتساوي للمشي لمدة ساعة واحدة، ما يؤدي إلى زيادة زمن الاستجابة لطلب القيادة.
• التنسيق: بما أنّ واجهة برمجة التطبيقات تستخدم google.protobuf.Duration، يجب تنسيق المدة كسلسلة تنتهي بالحرف "s" (على سبيل المثال، "3600s")، بدلاً من عدد صحيح.

نقاط المصدر وتثبيت الطرق

يمكنك تحديد نقطة البداية للمنحنى الزمني المتساوي بطريقتَين:

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

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

• التثبيت الذكي: تحاول الخدمة تثبيت نقطة المصدر على أقرب جزء من الطريق يمكن اجتيازه.
• التعرّف على الوضع: تأخذ منطق التثبيت في الاعتبار travel_mode. إذا طلبت DRIVE، تتجاهل واجهة برمجة التطبيقات المسارات المخصّصة للمشاة فقط وتبحث عن أقرب شارع يمكن القيادة فيه. إذا طلبت WALK، تعطي واجهة برمجة التطبيقات الأولوية للمسارات والأرصفة التي يمكن المشي فيها.
• حالات تعذُّر التنفيذ: إذا لم تتمكّن واجهة برمجة التطبيقات من العثور على جزء مناسب من الطريق على بُعد 100 متر تقريبًا من نقطة المصدر، ستعرض واجهة برمجة التطبيقات الخطأ 404 NOT_FOUND يشير ذلك عادةً إلى أنّ النقطة بعيدة جدًا عن شبكة الطرق أو في منطقة لا تتيح فيها بيانات الخريطة وضع السفر المطلوب.

اتجاه السفر (الوصول مقابل المغادرة)

يمكنك حساب مدى الوصول إلى الوجهة ومدى الوصول من الوجهة باستخدام المَعلمة travelDirection:

• ‫FROM (المغادرة): يتم حساب المنطقة التي يمكن الوصول إليها من نقطة المصدر خلال الحد الزمني المحدّد. هذا الخيار مناسب لحالات الاستخدام، مثل مناطق التسليم أو نطاق تغطية الخدمة.
• ‫TO (الوصول): يتم حساب المنطقة التي يمكنك السفر منها إلى نقطة المصدر خلال الحد الزمني المحدّد. هذا الخيار مناسب لتحديد مناطق التجميع، مثل الأماكن التي يمكن للموظفين الانتقال منها للوصول إلى مكتب مركزي.

التعرّف على حركة المرور

يمكنك التحكّم في كيفية تأثير بيانات حركة المرور في المضلّع الذي تم إنشاؤه باستخدام المَعلمة routing_preference:

• ‫TRAFFIC_UNAWARE (تلقائي): يتم استخدام حدود السرعة والتسلسل الهرمي للطرق لإنشاء مضلّع المنحنى الزمني المتساوي. ينتج عن ذلك شكل محدّد لا يتقلب استنادًا إلى الوقت من اليوم. هذه المَعلمة مثالية للتحليل العام أو التخطيط للسيناريو الأساسي.
• ‫TRAFFIC_AWARE: يتم حساب المنحنيات الزمنية المتساوية باستخدام ظروف حركة المرور الحالية أو المتوقّعة في وقت الطلب، ما يؤدي إلى تقلّص المنطقة التي يمكن الوصول إليها أثناء الازدحام وتوسّعها خلال ساعات خارج الذروة. ملاحظة: لا يتوفّر التوجيه الذي يأخذ حركة المرور في الاعتبار إلا عندما يتم ضبط travelMode على DRIVE.

ملاحظة: تكون المنحنيات الزمنية المتساوية التي تأخذ حركة المرور في الاعتبار أكثر حساسية لزمن الاستجابة من المنحنيات الزمنية المتساوية التي لا تأخذ حركة المرور في الاعتبار.

التنعيم والدقة

يمكنك تخصيص مظهر المضلّعات الناتجة ودقتها باستخدام المَعلمتَين polygon_fidelity وenable_smoothing. على الرغم من أنّ هذين الخيارَين مستقلّان، إلا أنّهما يعملان معًا لتحديد الشكل النهائي.

• ‫polygon_fidelity: يتحكّم في حجم خلايا الشبكة الأساسية المستخدَمة لحساب المنطقة التي يمكن الوصول إليها.

  • ‫LOW: يتم استخدام خلايا شبكة أكبر. هذا الخيار هو الأفضل لتغطية مناطق كبيرة بدون فجوات، ما يؤدي إلى شكل عام.
  • ‫MEDIUM: دقة متوازنة.
  • ‫HIGH: يتم استخدام خلايا شبكة أصغر. يؤدي ذلك إلى ملاءمة أفضل لشبكة الطرق، ولكن يمكن أن يؤدي إلى ظهور مناطق فارغة أو ثقوب إذا كانت شبكة الطرق قليلة.
  • ‫POLYGON_FIDELITY_UNSPECIFIED: إذا لم يتم تحديد الدقة، تختار الخدمة الدقة ديناميكيًا استنادًا إلى مدة السفر المطلوبة.

    

    دقة المضلّع العالية والمتوسطة والمنخفضة

• ‫enable_smoothing: يتحكّم في ما إذا كانت الحواف الحادة لخلايا الشبكة المحدّدة حسب الدقة يتم تقريبها.

  • ‫false (غير معدَّل): هذا هو الخيار التلقائي. يتم عرض الحساب الهندسي الدقيق. تبدو الحواف خشنة أو متدرّجة. هذا الخيار هو الأفضل للدقة التحليلية، مثل الاختبارات الصارمة للنقطة داخل المضلّع. زمن استجابة أقل من المنحنيات الزمنية المتساوية التي تم تنعيمها.
  • ‫true (تم تنعيمه): يتم تطبيق خوارزمية ما بعد المعالجة لتقريب الزوايا. هذا الخيار هو الأفضل للعرض المرئي على الخرائط.

    

    منحنى زمني متساوي مع التنعيم وبدونه