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

مطوّرو المنطقة الاقتصادية الأوروبية

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

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

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

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

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

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

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);

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

إذا حدّدت موقع نقطة البداية أو الوجهة أو نقطة الطريق الوسيطة على شكل سلسلة عنوان أو رمز موقع مفتوح، ستحاول حزمة SDK للخرائط العثور على الموقع الجغرافي الأكثر صلة الذي يتضمّن معرّف مكان مطابقًا. تحتوي مصفوفة 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
    }
  ]
}