נקודות ניווט

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

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

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

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

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

בנוסף, צריך לעבור לשדות location.lat ו-location.lng במקום לשדות location.latitude ו-location.longitude. במהדורה עתידית, בקשות שלא מכילות את הפרמטר NAVIGATION_POINTS לחישוב נוסף לא יכללו נקודות ניווט בתגובה, והשדות 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.