הגדרת נקודה להעברת מסלול

מפתחים באזור הכלכלי האירופי (EEA)

כברירת מחדל, נקודות ציון לביניים משמשות לעצירה לצורך איסוף והורדה, אבל אפשר גם לציין שנקודת ציון לביניים נועדה רק למעבר.

מסלול שמכיל נקודת מוצא, נקודת ביניים למעבר ונקודת יעד, מכיל רק קטע מסלול אחד שמקשר בין נקודת המוצא לנקודת היעד, ועובר דרך נקודת הביניים (שנקראת via).

כדי להגדיר ציון דרך ביניים כציון דרך למעבר, צריך להגדיר את המאפיין via של ציון הדרך לערך true באמצעות הממשק Waypoint.

המאפיין via הכי יעיל כשיוצרים מסלולים בתגובה לגרירת נקודות הציון על המפה על ידי המשתמש. כך המשתמש יכול לראות בזמן אמת איך המסלול הסופי ייראה, ולוודא שנקודות הציון ממוקמות במקומות שאפשר לגשת אליהם מספריית המסלולים.

דוגמה לבקשה

בדוגמה הבאה של בקשה אפשר לראות איך מסמנים נקודת ביניים כנקודת מעבר.

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 Code, ספריית המסלולים מנסה למצוא את המיקום הרלוונטי ביותר שיש לו מזהה מקום תואם. מערך 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
    }
  ]
}