הגדרת עצירה לאורך מסלול

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

• הוספת ציון דרך ביניים: זו אפשרות ברירת המחדל. מוסיפים נקודת ביניים בין נקודת המוצא ליעד במערך intermediates. מנוע ניתוב הדרכים מצמיד את נקודת הביניים לכביש הקרוב ביותר שאפשר לנווט בו, ומחלק את המסלול ל-RouteLeg קטעים שמחוברים על ידי התחנה הזו.
• מציינים vehicleStopover: אם רוצים שמנוע ניהול המסלולים יבצע ניתוח נוסף כדי להימנע מקטעי דרך שלא מתאימים לעצירה – כמו כבישים מהירים, מנהרות או גשרים – מגדירים את vehicleStopover: true בנקודת ציון.

הוספת ציון דרך ביניים

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

להוספת ציון דרך ביניים יש את ההשפעות הבאות:

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

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

דוגמה: הוספת ציון דרך ביניים

בדוגמה הבאה מוצג איך להגדיר עצירה לאורך מסלול על ידי הוספת נקודת ציון ביניים בבקשת POST‏ computeRoutes:

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
  "intermediates": [
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      }
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

מידע נוסף על נקודות ציון ביניים וקטעי מסלול זמין במאמר בנושא הגדרת נקודות ציון ביניים.

ציון עצירה של כלי רכב לצורך התאמה לאיסוף ולהחזרה

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

כשמגדירים את vehicleStopover: true, מנוע ניתוב התנועה בודק קטעי כביש פוטנציאליים ומנסה להימנע מכבישים שלא מתאימים לעצירה, כמו כבישים מהירים, מנהרות ומעברים עיליים.

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

דוגמה: ציון של vehicleStopover בנקודת ביניים

בדוגמה הבאה מוצג אופן ההגדרה של vehicleStopover: true בנקודת ביניים בבקשת POST מלאה:

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
  "intermediates": [
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      },
      "vehicleStopover": true
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

מידע נוסף על סוגים ואפשרויות של נקודות ציון זמין במאמר סוגים ואפשרויות של נקודות ציון.