لإنشاء منحنى تساوي الزمن، يجب تزويد واجهة برمجة التطبيقات بنقطة الانطلاق ووسيلة النقل، مثل القيادة أو ركوب الدرّاجة أو المشي، وحد زمني. ويمكنك أيضًا تعديل الإعدادات المفضَّلة لتحديد أفضل مسار والمظهر المرئي للمضلّع الناتج.
الأفق الزمني
القيد الأساسي الذي تقدّمه للخدمة هو travel_duration، وهو يحدّد الأفق الزمني للحساب.
- الحدّ الأقصى للمدة: تتيح واجهة برمجة التطبيقات مدة رحلة تبلغ 3,600 ثانية كحدّ أقصى (ساعة واحدة) للوضع
DRIVE، و7,200 ثانية (ساعتان) للوضعَينWALKوBICYCLE. - الأداء: يتناسب وقت الاحتساب مع المدة المطلوبة ووسيلة النقل المحدّدة. تغطّي منطقة متساوية الوقت لمدة ساعة بالسيارة مساحة جغرافية وشبكة طرق أكبر بكثير من منطقة متساوية الوقت لمدة ساعة سيرًا على الأقدام، ما يؤدي إلى زيادة وقت الاستجابة لطلب القيادة.
نقاط البداية ومحاذاة الطرق
يمكنك تحديد نقطة البداية للمنطقة المتساوية الوقت بطريقتَين:
- الإحداثيات: زوج من خط العرض وخط الطول (
location). - أرقام تعريف الأماكن: هي معرّف فريد لمكان معيّن على "خرائط Google" (
place). عند تقديم رقم تعريف مكان، تستخدم الخدمة نقطة مركز المكان كنقطة أصل. يُرجى العِلم أنّ واجهة برمجة التطبيقات تتوقّع تنسيق اسم المورد، مثلplaces/ChIJ.... لمزيد من المعلومات عن معرّفات الأماكن، يُرجى الاطّلاع على معرّفات الأماكن.
بغض النظر عن طريقة الإدخال، لا تحتسب واجهة برمجة التطبيقات أوقات التنقّل من النقطة المادية الدقيقة إذا لم تكن هذه النقطة على طريق، مثل داخل حديقة أو مبنى. وللتعامل مع هذه الحالة، تستخدم الخدمة ميزة "محاذاة مع الطريق" التي تتضمّن الميزات التالية:
- المحاذاة الذكية: تحاول الخدمة محاذاة نقطة البداية مع أقرب جزء من الطريق يمكن اجتيازه.
- التعرّف على وضع التنقّل: يأخذ منطق المحاذاة
travel_modeفي الاعتبار. إذا طلبتDRIVE، تتجاهل واجهة برمجة التطبيقات المسارات المخصّصة للمشاة فقط وتبحث عن أقرب شارع يمكن القيادة فيه. إذا طلبتWALK، تعطي واجهة برمجة التطبيقات الأولوية للمسارات والأرصفة التي يمكن المشي فيها. - حالات عدم النجاح: إذا لم تتمكّن واجهة برمجة التطبيقات من العثور على جزء مناسب من الطريق على مسافة 100 متر تقريبًا من نقطة البداية، ستعرض واجهة برمجة التطبيقات الخطأ
404 NOT_FOUND. يشير ذلك عادةً إلى أنّ النقطة بعيدة جدًا عن شبكة الطرق أو تقع في منطقة لا تتوافق فيها بيانات الخريطة مع وسيلة النقل المطلوبة.
الوعي بحركة المرور
يمكنك التحكّم في كيفية تأثير بيانات الزيارات في المضلّع الذي تم إنشاؤه باستخدام المَعلمة routing_preference:
TRAFFIC_UNAWARE(الإعداد التلقائي): يتم استخدام حدود السرعة والتسلسل الهرمي للطرق لإنشاء مضلّع المنحنى المتساوي الزمن. ويؤدي ذلك إلى إنشاء شكل ثابت لا يختلف باختلاف الوقت من اليوم. تُعدّ هذه المَعلمة مثالية لإجراء تحليل عام أو تخطيط سيناريو أساسي.TRAFFIC_AWARE: يتم احتساب منحنيات تساوي الوقت باستخدام بيانات حركة المرور الحالية أو التوقعية في وقت الطلب، ما يؤدي إلى تقلّص المساحة التي يمكن الوصول إليها خلال الازدحام وتوسّعها خلال ساعات عدم الذروة.
التنعيم والدقة
يمكنك تخصيص مظهر المضلّعات الناتجة ودقتها باستخدام المَعلمتَين polygon_fidelity وenable_smoothing. على الرغم من أنّ هذه الخيارات مستقلة، إلا أنّها تعمل معًا لتحديد الشكل النهائي.
polygon_fidelity: تتحكّم هذه السمة في حجم خلايا الشبكة الأساسية المستخدَمة لاحتساب المساحة التي يمكن الوصول إليها.LOW: تستخدم خلايا شبكة أكبر، وهي الأفضل لتغطية مساحات كبيرة بدون فجوات، ما يؤدي إلى شكل عام.MEDIUM: دقة متوازنةHIGH: تستخدم خلايا شبكة أصغر، ما يؤدي إلى تطابق أفضل مع شبكة الطرق، ولكن قد ينتج عنها مناطق فارغة أو ثغرات إذا كانت شبكة الطرق متفرقة.POLYGON_FIDELITY_UNSPECIFIED: في حال عدم تحديدها، تختار الخدمة الدقة بشكل ديناميكي استنادًا إلى مدة الرحلة المطلوبة.
دقة المضلّعات العالية والمتوسطة والمنخفضة
enable_smoothing: تتحكّم هذه السمة في ما إذا كان سيتم تقريب الحواف الحادة لخلايا الشبكة المحدّدة حسب الدقة.false(الأصلية): هي الإعداد التلقائي، وتعرض الحساب الهندسي الدقيق، وتظهر الحواف بشكل متعرّج أو متدرّج، وهي الأفضل للدقة التحليلية، مثل اختبارات النقطة داخل المضلّع الصارمة، وتكون مدة الاستجابة أقل من مدة الاستجابة في حالة التنعيم.true(تمّت تسويته): يتم تطبيق خوارزمية معالجة لاحقة لتقريب الزوايا. الأفضل للعرض المرئي على الخرائط
منطقة تساوي الوقت مع التنعيم وبدونه