تحديد نقطة لمسار مرور

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

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

يمكنك ضبط نقطة على المسار لتكون نقطة عبور من خلال ضبط السمة via للنقطة على المسار على true باستخدام واجهة Waypoint.

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

مثال على الطلب

يوضّح المثال التالي للطلب كيفية وضع علامة على نقطة وسيطة على المسار كنقطة عبور.

const routeRequestWithVia = {
  origin: '100 Moffett Blvd, Mountain View, CA 94043',
  destination: '1199 9th Ave, San Francisco, CA 94122',
  travelMode: 'DRIVING',
  intermediates: [
    {location: 'Half Moon Bay, CA', via: true} // Set the via property to true
  ],
  fields: ['path', 'legs'],
};

// Make the request.
const {routes, fallbackInfo, geocodingResults} = await Route.computeRoutes(routeRequestWithIntermediates);
  

الوصول إلى أرقام تعريف الأماكن للنقاط على المسار المتوسطة

إذا حدّدت الموقع الجغرافي لنقطة انطلاق أو وجهة أو نقطة على المسار وسيطة على شكل سلسلة عنوان أو رمز Plus Codes، ستحاول مكتبة "المسارات" العثور على الموقع الجغرافي الأكثر صلة الذي يتضمّن رقم تعريف مكان مطابقًا. تحتوي مصفوفة geocodingResults.intermediates في النتائج على رقم تعريف المكان الذي يتوافق مع الموقع الجغرافي للنقاط على المسار، بالإضافة إلى بيانات إضافية حول الموقع الجغرافي.

مثال على ردّ يتضمّن نتائج الترميز الجغرافي

{
  "origin": {
    "geocoderStatus": "OK",
    "types": [
      "premise",
      "street_address"
    ],
    "partialMatch": false,
    "placeId": "ChIJb5NgcTa3j4ARrfF4Oc_f6q8",
    "intermediateWaypointRequestIndex": null
  },
  "destination": {
    "geocoderStatus": "OK",
    "types": [
      "premise",
      "street_address"
    ],
    "partialMatch": false,
    "placeId": "ChIJAbIPLl2HhYARQ0SSdDFxU-s",
    "intermediateWaypointRequestIndex": null
  },
  "intermediates": [
    {
      "geocoderStatus": "OK",
      "types": [
        "locality",
        "political"
      ],
      "partialMatch": false,
      "placeId": "ChIJC8sZCqULj4ARVJvnNcic_V4",
      "intermediateWaypointRequestIndex": 0
    }
  ]
}