التوجيه إلى نقاط التنقّل

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

سيستمر تنفيذ ميزة "تمييز الوجهة" إذا كان ذلك منطبقًا.

الخلفية

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

تساعد خيارات نقاط الطريق المحسّنة في حلّ هذه المشكلة من خلال السماح لك بتقديم المزيد من السياق.

استخدام رمز مميّز لنقطة التنقّل

للحصول على توجيه أكثر دقة إلى نقاط وصول معيّنة، مثل المداخل أو أرصفة التحميل أو مناطق الاستلام المحدّدة، يمكنك استخدام navigationPointToken.

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

لتحديد رمز مميّز لنقطة التنقّل، اتّبِع الخطوات التالية:

  1. احصل على navigationPointToken من الردّ الذي يقدّمه الإجراء Destinations في Geocoding API.

  2. حدِّد navigationPointToken عند إنشاء GMSNavigationWaypoint.

ملاحظة: لا يمكنك تحديد رمز مميّز لنقطة التنقّل وموقع جغرافي وPlaceID في الوقت نفسه.

Swift

// Create a waypoint using a navigation endpoint token
let waypointTwo = GMSNavigationWaypoint(
  navigationPointToken: "ChIJALijSXPhQkARHmIozCCbXsASEgkFVjYHGH6PgBFrbM7wl3.."
  title: "Sydney Opera House")

// Route to the waypoint
navigator.setDestinations([waypointTwo]) { [weak self] routeStatus in
   self?.handleRouteCallback(status: routeStatus)
}

Objective-C

GMSNavigationWaypoint *waypointTwo = [[GMSNavigationWaypoint alloc] initWithNavigationPointToek:@"sampleNavigationPointToken"

الجمع بين رقم تعريف المكان والموقع الجغرافي

بدءًا من الإصدار 10.10، يمكنك تقديم كل من معرّف مكان وإحداثيات الموقع الجغرافي عند إنشاء نقطة طريق. تكون هذه الطريقة مفيدة عندما تريد تحديد نقطة دقيقة (الموقع الجغرافي) مع الاستمرار في توفير سياق المكان العام (معرّف المكان). يتيح ذلك لـ Navigation SDK تقديم تجربة وصول أكثر ثراءً من خلال تمييز مبنى الوجهة أو عرض نقاط الاهتمام القريبة ذات الصلة بمعرّف المكان.

Swift

// Create a waypoint using both the latlng and placeID
let waypoint = GMSNavigationWaypoint(
  location: CLLocationCoordinate2DMake(-33.85657945261524, 151.21535034203333),  
  placeID: "ChIJ3S-JXmauEmsRUcIaWtf4MzE",
  title: "Sydney Opera House")

// Route to the waypoint
navigator.setDestinations([waypoint]) { [weak self] routeStatus in
   self?.handleRouteCallback(status: routeStatus)
}

Objective-C

CLLocationCoordinate2D location = CLLocationCoordinate2DMake(47.67, -122.20);
GMSNavigationWaypoint *waypoint = [[GMSNavigationWaypoint alloc] initWithLocation:placeID:coordinate title:@"waypoint from location and placeiD"];

الاعتبارات:

عند تقديم كل من placeID وlocation:

  • يستهدف المسار بشكل أساسي location المحدّد.
  • يتم استخدام placeId كسياق لتحسين تجربة الوصول.
  • الخيار الاحتياطي: إذا رصدت حزمة تطوير البرامج (SDK) أنّ placeId المقدَّمة تتوافق مع ميزة بعيدة جدًا عن location المحدَّدة، سيتم تجاهل placeId. في هذا السيناريو، سيتم التوجيه إلى location فقط، ولن تتوفّر تحسينات تجربة الوصول الخاصة بالمكان.

ملخّص لإعدادات نقاط الطريق الصالحة

المواصفات location placeID navigationPointToken أسلوب التوجيه تمييز الوجهة
إحداثيات الموقع الجغرافي فقط محدّدة غياب غياب المسارات إلى جزء الطريق الأقرب إلى الإحداثيات المحدّدة يتم عرضها إذا كان من الممكن استنتاج الوجهة بدقة عالية
رقم تعريف المكان فقط غياب محدّدة غياب المسارات إلى نقطة التنقّل التلقائية لمعرّف المكان رقم تعريف مكان الانطلاق
رمز مميّز لنقطة التنقّل فقط غياب غياب محدّدة المسارات المؤدية إلى نقطة التنقّل الدقيقة الممثّلة بالرمز المميّز من الوجهة المحدّدة في طلب طريقة الوجهات الأصلية في Geocoding API
إحداثيات الموقع الجغرافي ورقم تعريف المكان معًا se محدّدة غياب المسارات إلى جزء الطريق الأقرب إلى الإحداثيات المحدّدة من رقم تعريف المكان، على الرغم من أنّه لا يظهر إذا كان رقم تعريف المكان بعيدًا جدًا عن إحداثيات خطوط الطول والعرض