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