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

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

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

כדי להגדיר ציון דרך ביניים כציון דרך לצורך מעבר, מגדירים את המאפיין via של ציון הדרך כ-true באמצעות Waypoint (‏REST) או Waypoint (‏gRPC).

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

זהירות: שימוש בקידומת via: כדי להימנע מעצירות ביניים גורם לכך שהמערכת תפרוס מסלולים עם פרשנות מחמירה של נקודת הציון. הפרשנות הזו עשויה לגרום למסלולים עוקפים משמעותיים או לקוד סטטוס התגובה ZERO_RESULTS אם ל-Routes API אין אפשרות ליצור מסלול דרך הנקודה הזו.

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

{
  "location": {
    "latLng": {
      "latitude":37.419734,
      "longitude":-122.0827784
    }
  },
  "via": true
}

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

אם מציינים את המיקום של המקור, היעד או נקודת הציון הדרך הממוצעת בתור מחרוזת כתובת או Plus Code, ה-API מנסה למצוא את המיקום הרלוונטי ביותר שיש לו מזהה מקום תואם. המערך geocodingResults.intermediates בתוצאות מכיל את מזהה המקום שתואם למיקום של נקודות הדרך, יחד עם נתונים נוספים על המיקום.

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

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

לדוגמה:

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

• כדי לציין שהמערך geocodingResults יופיע בתוצאות, צריך לכלול את geocodingResults במסכת שדה התגובה.

curl -X POST -d '{
  "origin":{
    "address": "1600 Amphitheatre Parkway, Mountain View, CA"
  },
  "destination":{
    "address": "24 Willie Mays Plaza, San Francisco, CA 94107"
  },
  "intermediates": [
    {
      "address": "450 Serra Mall, Stanford, CA 94305, USA"
    },
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      }
    },
    {
      "address": "1836 El Camino Real, Redwood City, CA 94063"
    }
  ],
  "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,geocodingResults'
'https://routes.googleapis.com/directions/v2:computeRoutes'

התשובה כוללת את המערך geocodingResults שמכיל את מזהה המיקום של נקודת המוצא, היעד ושני מתוך שלושת נקודות הציון. אלה נקודות הציון באינדיקטורים 0 ו-2 בבקשה. מכיוון שנקודה דרך במדד 1 של הבקשה צוינה באמצעות קואורדינטות של קו אורך וקו רוחב, היא לא נכללת במערך geocodingResults בתגובה.

{
  "routes": [{...}],
  "geocodingResults": {
    "origin": {
      "geocoderStatus": {},
      "type": [
        "premise"
      ],
      "placeId": "ChIJj38IfwK6j4ARNcyPDnEGa9g"
    },
    "destination": {
     "geocoderStatus": {},
      "type": [
        "premise"
      ],
      "placeId": "ChIJI7ES6tl_j4ARVpDZoXbWAiY"
    },
    "intermediates": [
      {
        "geocoderStatus": {},
        "intermediateWaypointRequestIndex": 0,
        "type": [
            "street_address"
        ],
        "placeId": "ChIJvdLMGyq7j4ARScE5tWX_C0Y"
      },
      {
        "geocoderStatus": {},
        "intermediateWaypointRequestIndex": 2,
        "type": [
          "premise"
        ],
        "placeId": "ChIJkTc0GKajj4AR9UMsOSHwGD0"
      }
    ]
  }
}