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

מפתחים באזור הכלכלי האירופי (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, ספריית המסלולים מנסה למצוא את המיקום הרלוונטי ביותר שיש לו מזהה מקום תואם. המערך geocodingResults.intermediates בתוצאות מכיל את מזהה המקום שתואם למיקום של נקודות הדרך, וגם נתונים נוספים על המיקום.

דוגמה לתגובה עם תוצאות של המרת כתובות לקואורדינטות (geocoding)

{
  "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
    }
  ]
}