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-backend.googleapis.com - אימות: מפתח API
- תחילת העבודה: הגדרת Directions API
- מאמרי העזרה של ה-API: מאמרי העזרה של ה-API בנושא Directions API
- תמחור: שימוש ב-Directions API וחיוב
- כללי מדיניות: כללי המדיניות של Directions 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.