מדריך מקוצר ל-Directions API

‫Directions API (הגרסה הקודמת) הוא שירות אינטרנט שמחשב מסלולים בין מיקומים לנסיעה ברכב, להליכה, לרכיבה על אופניים ולנסיעה בתחבורה ציבורית, כולל מסלולים מרובי חלקים עם נקודות דרך, ומחזיר מסלולים, מקטעים ושלבים בפורמט JSON או XML. הוא בסטטוס "מדור קודם": החל מאוקטובר 2026 לא ניתן להפעיל אותו בפרויקטים חדשים ב-Google Cloud, וצריך לעבור ל-Routes API.

‫Directions API: עובדות חשובות

  • המוצר: Directions API
  • נקרא גם: Directions API (הגרסה הקודמת)
  • קטגוריה: מסלולים
  • פלטפורמה: שירות אינטרנט (REST)
  • פועל ב: שרת (קוד לקצה העורפי)
  • שלב ההשקה: GA
  • מחזור חיים: מדור קודם
  • הוחלף על ידי: Routes API
  • סקירה כללית: סקירה כללית על Directions API
  • זמינות אזורית: גלובלית. הכיסוי משתנה בהתאם לאזור ולאמצעי התחבורה (התחבורה הציבורית תלויה בנתונים מספקי התחבורה הציבורית). (פרטי הכיסוי)

‫Directions API: מתי כדאי להשתמש בו

מתי כדאי להשתמש ב-Directions API:

  • יש לכם פרויקט בענן קיים ב-Google Cloud שכבר מופעל בו Directions API (מדור קודם) ומתבצעות בו קריאות ל-maps/api/directions.
  • אתם צריכים מסלולים בצד השרת לנהיגה, להליכה, לרכיבה על אופניים או לתחבורה ציבורית (נקודות ציון למצבים שאינם תחבורה ציבורית בלבד), ב-JSON או ב-XML, בפרויקט קיים.

מתי לא כדאי להשתמש ב-Directions API:

  • אתם מתחילים פרויקט חדש ב-Google Cloud. החל מאוקטובר 2026, אי אפשר להפעיל את Directions API (דור קודם) בפרויקטים חדשים. במקום זאת, אתם צריכים להשתמש ב-Routes API.
  • אתם צריכים תכונות ניתוב חדשות וביצועים משופרים. במקום זאת, אתם צריכים להשתמש ב-Routes API.
  • אתם צריכים זמני נסיעה ומרחקים להרבה נקודות מוצא ויעדים בבקשה אחת. במקום זאת, אתם צריכים להשתמש ב-Routes API.

‫Directions API: הגדרה

‫Directions API: טעויות נפוצות

  • הבעיה: בקשות ל-Directions API (הדור הקודם) מפרויקט שבו ה-API מהדור הקודם לא מופעל נכשלות עם השגיאה LegacyApiNotActivatedMapError. פתרון: אם אתם הבעלים של האפליקציה, עברו ל-Routes API. כפתרון לטווח קצר בזמן המיגרציה או ההמתנה לעדכון לאפליקציה, אתם יכולים להפעיל את ה-API המדור קודם על ידי מילוי טופס ההפעלה של ה-API המדור קודם. מידע נוסף זמין בכתובת ‎/maps/legacy.
  • הבעיה: שימוש בקידומת via: בנקודות ציון הופך אותן לנקודות מעבר קשיחות, מה שעלול לגרום לעיקופים משמעותיים או לסטטוס ZERO_RESULTS. התיקון: משתמשים בנקודות עצירה (בלי הקידומת via:), אלא אם נדרשת נקודת מעבר קשיחה. מידע נוסף זמין בכתובת /maps/documentation/directions/get-directions.
  • הבעיה: בקשות עם 11 עד 25 נקודות ציון, optimize:true, משכי זמן שמבוססים על נתוני תנועה (duration_in_traffic) או משתני המיקום side_of_road או heading מחויבים לפי המק"ט Directions Advanced (Pro)‎ היקר יותר. הפתרון: השתמשו בתכונות האלה רק כשאתם צריכים אותן. כדי להישאר במק"ט Essentials, אל תשתמשו ביותר מ-10 נקודות ציון ואל תשתמשו בפרמטרים optimize:true,‏ departure_time (לנהיגה), side_of_road ו-heading. מידע נוסף זמין בכתובת /maps/billing-and-pricing/sku-details/legacy#directions-advanced-pro-sku.
  • הבעיה: כשמדובר בנסיעה, הערך של departure_time לא יכול להיות בעבר (הבקשה נכשלת עם INVALID_REQUEST). בלי departure_time, המסלול ומשך הזמן מבוססים על תנועה ממוצעת שלא תלויה בזמן, ולא מוחזר ערך של duration_in_traffic. הפתרון: מגדירים את departure_time לערך now או לזמן עתידי באמצעות mode=driving כדי לקבל duration_in_traffic. בקשות שמחזירות את הערך duration_in_traffic מחויבות לפי המק"ט Directions Advanced (Pro). מידע נוסף זמין בכתובת /maps/documentation/directions/get-directions.