נקודות ניווט

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

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

  • ‫location מכיל את ערכי קו הרוחב וקו האורך של נקודת הניווט. המיקום הזה תמיד יהיה קרוב מאוד לרשת הכבישים, והוא מייצג נקודת עצירה או נקודת התחלה אידיאלית לניווט אל מקום מסוים וממנו. הנקודה מוסטת בכוונה מעט מקו האמצע של הכביש כדי לסמן בבירור את הצד של הכביש שבו המקום ממוקם.
  • ‫restricted_travel_modes היא רשימה של אמצעי תחבורה שאי אפשר להגיע באמצעותם לנקודת הניווט:
    • ‫"DRIVE" הוא אמצעי התחבורה שמתאים להוראות נסיעה.
    • ‫"WALK" הוא אמצעי התחבורה שמתאים להוראות הגעה בהליכה.
  • ‫road_name מכיל את שם הכביש שממנו נקודת הניווט מוסטת.

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

הודעה על העברה

החל מ-17 באפריל, כדי לקבל נקודות ניווט, צריך לספק את הפרמטר NAVIGATION_POINTS extra computations בבקשה. לקוחות יכולים לבדוק את זה על ידי אישור שהשדה road_name בתוך כמה נקודות ניווט מוחזר, ושהשדה location בתוך כל נקודת ניווט כולל את ארבעת שדות המשנה הבאים (lat,‏ lng,‏ latitude,‏ longitude).

בנוסף, צריך לעבור לשדות location.lat ו-location.lng במקום לשדות location.latitude ו-location.longitude. בגרסה עתידית, בקשות שלא יכללו את הפרמטר NAVIGATION_POINTS extra computations לא יכללו נקודות ניווט בתשובה, והשדות location.latitude ו-location.longitude לא יוחזרו יותר.

פרטי הבקשה

אפשר לקבל נקודות ניווט בסוגי הבקשות הבאים:

לכל אחת מהבקשות האלה, צריך לציין את הפרמטר הבא: extra_computations=NAVIGATION_POINTS.

דוגמה לבקשה

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

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJZ54APTS3j4ARBYZD956MHq8&extra_computations=NAVIGATION_POINTS&key=YOUR_API_KEY

דוגמה לתשובה

התגובה לשאילתה שלמעלה מציגה מערך של נקודות ניווט:

{
  "navigation_points": [
    {
      "location": {
        "lat": 37.3940894,
        "lng": -122.0788389,
      },
      "restricted_travel_modes": ["WALK"],
      "road_name": "Castro Street"
    },
    {
      "location": {
        "lat": 37.394273,
        "lng": -122.0793078,
      },
      "restricted_travel_modes": ["WALK"],
      "road_name": "Wild Cherry Lane"
    },
    {
      "location": {
        "lat": 37.3941202,
        "lng": -122.0789189,
      },
      "restricted_travel_modes": ["DRIVE"]
    }
  ]
}

משוב

זוהי תכונה ניסיונית. נשמח לקבל משוב בכתובת geocoding-feedback-channel@google.com.