مرجع فئة GMSNavigator

إضافة مستمع.

يتم وضع إشارة ضعيفة على المستمع.

المَعلمات:

أداة معالجة الحدث

تمثّل هذه السمة كائنًا متوافقًا مع بروتوكول GMSNavigatorListener.

إزالة مستمع.

المَعلمات:

أداة معالجة الحدث

تمثّل هذه السمة كائنًا متوافقًا مع بروتوكول GMSNavigatorListener.

المرتجعات:

يعرض "نعم" إذا تمت إزالة المستمع. يعرض "لا" إذا لم يكن الكائن مستمعًا.

تضبط وجهات متعددة للتنقل، وتُلغي أي وجهات سبق إعدادها.

سيتم طلب رد الاتصال المقدَّم من خلال GMSRouteStatusOKK في حال العثور على مسار من موقع الجهاز إلى الوجهة المحدّدة. في حال ضبط وجهة جديدة قبل العثور على المسار، سيتم إلغاء الطلب، وسيتم طلب معاودة الاتصال باستخدام GMSRouteStatusCanceled. إذا تعذر العثور على مسار لأي سبب آخر، فسيتم استدعاء حالة الخطأ المناسبة.

سيتم دائمًا إرسال طلب رد الاتصال بشكل غير متزامن إلى قائمة الانتظار الرئيسية.

تضبط وجهات متعددة للتنقل، وتُلغي أي وجهات سبق إعدادها.

يتم احتساب المسارات التي تم إرجاعها باستخدام خيارات التوجيه.

المَعلمات:

الوجهات	يشير ذلك المصطلح إلى مصفوفة من نقاط الطريق الوجهة.
routingOptions	الخيارات التي تؤثر على منطق التوجيه (استراتيجية التوجيه).
رد الاتصال	يتم استدعاء هذه الدالة عند العثور على مسار من الموقع الجغرافي للمستهلك إلى الوجهات المقدَّمة، أو عند تعذّر العثور عليه لسبب يُشار إليه في RouteStatus.

تضبط وجهات متعددة للتنقل، باستخدام رمز مميز للمسار للتنقل في مسار محسوب مسبقًا.

ستكون المسارات هي نفسها، ويتم تغيير باقي القسمة على موقع بدء السائق وعلى ظروف الطرق/حركة المرور. ستظل عمليات إعادة التوجيه تحدث استنادًا إلى خيارات التوجيه التي تم ترميزها في الرمز المميز.

يمكن فقط استخدام GMSNavigationTravelModeDriving وGMSNavigationTravelModeTwoWheeler عند استخدام الرمز المميّز للمسار لبدء جلسة تنقُّل. ضبط وضع السفر من خلال ضبط travelMode. سيتعذّر الاتصال إذا كان وضع السفر الحالي غير متوافق، وسيتم إرجاع GMSRouteStatusTravelModeUnsupported في معاودة الاتصال.

المَعلمات:

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

تعرض معلومات المسار استنادًا إلى استراتيجية التوجيه: المسار التلقائي الأفضل أو الأقصر.

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

المَعلمات:

الوجهة	نقطة الطريق الوجهة.
routingOptions	الخيارات المستخدَمة لاسترجاع معلومات المسار يتم تجاهل استراتيجية التوجيه واستراتيجية المسارات البديلة، لأنّ هذه الطريقة تعرض معلومات المسارات لجميع استراتيجيات التوجيه.
رد الاتصال	معاودة الاتصال التي يتم الاتصال بها عند تلقّي معلومات المسارات.

تمّ الإيقاف.

يمكنك طلب إحدى الطرق -setDestinations:... باستخدام قائمة الوجهات الجديدة بدلاً من ذلك.

يتم عرض الوجهة الأولى من قائمة الوجهات الحالية. بعد هذه المكالمة، سيتم توجيه الإرشادات إلى الوجهة التالية، إن وجدت.

المرتجعات:

لقد وصلنا إلى إرشادات حول نقطة الطريق، أو لا شيء إذا لم تكن هناك نقاط طريق أخرى متبقية.

ملاحظة:

تم إيقاف هذا نهائيًا. استخدم إحدى الطرق -setDestinations:... بدلاً من ذلك.

يؤدي هذا الإجراء إلى محو كل الوجهات التي تم ضبطها سابقًا وإزالة أي مسارات محسوبة من الخريطة.

إذا كانت الإرشادات نشطة، سيتم إيقافها تلقائيًا.

لعرض الوقت المقدر إلى نقطة الطريق المحددة، أو CLTimeIntervalMax إذا لم تكن النقطة الوسيطة جزءًا من المسار الحالي.

ويتم تعديل هذا الإعداد استنادًا إلى الموضع الحالي للجهاز عندما يكون التوجيه نشطًا.

لعرض CLTimeIntervalMax إذا لم تكن النقطة الوسيطة المقدمة وجهة في المسار الحالي.

لعرض المسافة المقدرة إلى نقطة الطريق المحددة، أو CLLocationDimensionMax إذا لم تكن النقطة الوسيطة جزءًا من المسار الحالي.

سيتم تعديل هذا الخيار استنادًا إلى الموضع الحالي للجهاز عندما يكون الإرشادات نشطة.

تعرض CLLocationAmountMax إذا كانت النقطة الوسيطة المقدمة ليست وجهة في المسار الحالي.

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

سيتمّ محو معرِّفات المعاملات في نهاية جلسة التنقّل. لا تتوفر هذه الطريقة إلا لعملاء "خدمات الجوّال" الذين تحصّل Google الرسوم منهم على أساس كل معاملة. تعرض القيمة "nil" إذا كان المشروع لا يحتوي على إذن لاستدعاء واجهة برمجة التطبيقات هذه.

المَعلمات:

transactionIDs	معرّفات المعاملات التي تنطبق على جلسة التنقّل الحالية. يجب أن يكون معرِّف المعاملة فريدًا لكل معاملة قابلة للفوترة. يجب أن يحتوي معرِّف المعاملة الفردي على حرف واحد على الأقل ولا يزيد عن 64 حرفًا. يمكن أن تكون القائمة فارغة عند انتهاء المعاملة (ولكنّ الجلسة لا تزال مستمرة).
errorHandler	يشير ذلك المصطلح إلى حظر سيتم استدعاءه بشكل غير متزامن في سلسلة المحادثات الرئيسية إذا حدث خطأ عندما تكون معرّفات المعاملات غير صالحة.

يتم استدعاء هذه الدالة عند العثور على مسار من موقع الجهاز إلى الوجهات المقدمة، أو تعذُّر العثور عليها لسبب يُشار إليه في RouteStatus.

يتم استدعاء هذه الدالة عند حساب معلومات المسار (الوقت المقدّر للوصول والمسافة) إلى النقطة الوسيطة المقدّمة.

المَعلمات:

routeInfo

معلومات المسار إلى الوجهة المحدّدة. ستكون صفرًا إذا لم تنجح العملية الحسابية.

يتم استدعاء هذا الإجراء في حال تعذّر ضبط معرِّفات المعاملات من خلال settransactionIDs.

لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات واجهة برمجة التطبيقات.

لتحديد ما إذا كان يجب تجنّب الطرق السريعة عند إنشاء مسارات إلى الوجهات.

يتم ضبط القيم التلقائية على "لا".

لتحديد ما إذا كان يجب تجنب الطرق ذات رسوم العبور عند إنشاء المسارات إلى الوجهات.

يتم ضبط القيم التلقائية على "لا".

تحديد ما إذا كان يجب تجنّب العبّارات عند إنشاء مسارات إلى الوجهات

يتم ضبط الإعدادات التلقائية على "نعم".

تتيح لك هذه السياسة ضبط قيود لوحة الترخيص باستخدام الرقم الأخير الخاص بالسائق الحالي من لوحة تسجيل المركبة ورمز البلد.

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

يتم ضبط القيمة على "صفر" في حال عدم فرض قيود على لوحة تسجيل المركبة. القيمة التلقائية هي صفر.

ما إذا كانت الإرشادات خطوة بخطوة مفعّلة حاليًا أم لا.

إذا كانت قيمة GuidelinesActive (نعم) هي "نعم"، ولكن لا يتوفّر مسار حاليًا، سيبدأ التوجيه عندما يتوفّر مسار. سيتم ضبط هذه السمة على "لا" في حال استدعاء clearDestinations، أو إذا وصلنا إلى نقطة طريق.

ما إذا كان يجب إيقاف الإرشادات تلقائيًا عند استدعاء -navigator:didhandlingAtWaypoint:

عند اختيار "لا"، سيستمر عرض رأس التنقّل وتذييله بعد الوصول. سيستمر عنوان التنقّل في عرض الخطوة الإرشادية الأخيرة، وسيستمرّ تذييل التنقّل في تعديل الوقت والمسافة المتبقية حتى يتم الوصول إلى وقت أو مسافة 0. بالإضافة إلى ذلك، سيستمر التعديلان -navigator:didUpdateRemainingTime و-navigator:didUpdateRemainingSpace. يمكنك ضبط guidanceActive صراحةً على "لا" لإيقاف إرشادات الوقت/المسافة المتبقية.

عندما تكون "نعم"، سيتم ضبط "guidanceActive" تلقائيًا على "لا" عند الوصول.

يتم ضبط الإعدادات التلقائية على "نعم".

أقل تغيير في الوقت المقدَّر للوصول إلى الوجهة التالية، ما سيؤدي إلى طلب طريقة navigator:didUpdateRemainingTime:.

وفي حال ضبط السياسة على NSTimeIntervalMax، سيتم إيقاف هذه العمليات. في حال ضبط هذه القيمة على قيمة سالبة، سيتم استخدام الحدّ التلقائي البالغ ثانية واحدة. الإعدادات التلقائية هي ثانية واحدة.

ملاحظة:

يتم تجاهل هذه القيمة في حال عدم تنفيذ أي أدوات استماع للرمز navigator:didUpdateRemainingTime:.

التغيير الأدنى في المسافة المقدَّرة للوصول إلى الوجهة التالية، والذي سيؤدي إلى طلب إجراء طريقة navigator:didUpdateRemainingDistance:

وفي حال ضبط السياسة على CLLocationScopeMax، سيتم إيقاف تلك العمليات. في حال ضبط هذه القيمة على قيمة سالبة، سيتم استخدام الحد التلقائي البالغ متر واحد. الإعداد التلقائي هو متر واحد.

ملاحظة:

يتم تجاهل هذه القيمة في حال عدم تنفيذ أي أدوات استماع للرمز navigator:didUpdateRemainingDistance:.

لعرض الوقت المقدر إلى الوجهة التالية.

سيتم تعديل هذا الخيار استنادًا إلى الموضع الحالي للجهاز عندما يكون الإرشادات نشطة.

تعرض CLTimeIntervalMax في حال عدم توفر مسار.

لعرض المسافة المقدرة إلى الوجهة التالية.

سيتم تعديل هذا الخيار استنادًا إلى الموضع الحالي للجهاز عندما يكون الإرشادات نشطة.

تعرض CLLocationDISTANCEMax في حال عدم توفّر مسار.

عرض فئة التأخير إلى الوجهة التالية

سيتم تعديل هذا الخيار استنادًا إلى الموضع الحالي للجهاز عندما يكون الإرشادات نشطة.

تعرض GMS NavigationDelayCategoryNoData في حال عدم توفّر مسار أو إذا كانت بيانات حركة المرور غير متوفّرة.

المرحلة الحالية من الرحلة.

سيكون لجهاز GMSRouteLeg آخر موضع معروف له (تم قطعه على الطريق) في الجهاز.

مصفوفة من أرجل المسار حيث يتوافق كل ساق مع الوجهة التي تم تحديدها.

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

يتكون المسار من مواقع مقطوعة على الطريق تعرضها GMSRoadSnappedLocationProvider ويتم تبسيطها لإنتاج أجزاء خطية.

ملاحظة:

يفحص النظام العميل بحثًا عن إشارات نظام تحديد المواقع العالمي (GPS) للحصول على بيانات الموقع الجغرافي. يمكن أن يؤدي ضعف إشارة نظام تحديد المواقع العالمي (GPS) إلى مزيد من الاستيفاء، ما قد ينتج عنه مسارات أقل دقة. ويكون هذا المسار فارغًا إذا لم تبدأ الإرشادات من قبل.

يحدد هذا الإعداد ما إذا كان يجب تفعيل الإرشاد الصوتي لحركة المرور والتنبيهات المفصّلة.

يتم ضبط الإعدادات التلقائية على GMS NavigationVoiceGuidanceAlertsAndGuidance.

تحدد الأجهزة الصوتية التي يمكن تشغيل الإرشاد الصوتي من خلالها.

يتم ضبط الإعدادات التلقائية على GMSVoiceGuidanceAudioDeviceTypeBluetooth.

يحدد هذا الإعداد ما إذا كان يجب أن يهتز الجهاز أيضًا عند تشغيل تنبيهات صوتية.

تحدِّد هذه السياسة ما إذا كان سيتم عرض واجهة UILocalNotifications التي تحتوي على معلومات إرشادية عندما يكون التطبيق في الخلفية.

يتم ضبط الإعدادات التلقائية على "نعم".

وضع الإضاءة المقترَح استنادًا إلى الوقت والموقع الجغرافي للجهاز

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

يتم ضبط الإعدادات التلقائية على "نعم".

GMSNavigationSpeedAlertOptions لتخصيص حدود تشغيل GMS NavigationSpeedAlertSeverity.

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

في حال ضبط القيمة "nil"، لن تتلقّى أي بيانات خلاصة "سرعة"، وسيتم عرض تنبيه السرعة التلقائي في NavSDK: يعرض "تنبيه السرعة" نصًا باللون الأحمر عندما تزيد السرعة عن 5 ميل في الساعة أو 10 كيلومتر في الساعة، كما أنّه يعرض نصًا أبيض وخلفية حمراء عند زيادة السرعة عن 10 ميل في الساعة أو 20 كيلومتر في الساعة.