Distance Matrix API (הגרסה הקודמת) הוא שירות אינטרנט שמחזיר את מרחק הנסיעה ואת משך הנסיעה למטריצה של נקודות מוצא ויעדים, על סמך המסלול המומלץ בין כל זוג. אתם יכולים להגדיר את אופן הנסיעה (נהיגה, הליכה, רכיבה על אופניים, תחבורה ציבורית), את מצבי התחבורה הציבורית, את היחידות ואת שעת היציאה למשכי זמן שמבוססים על תנועה. הוא מחזיר JSON או XML.
Distance Matrix API: עובדות חשובות
- המוצר: Distance Matrix API
- נקרא גם: Distance Matrix API (דור קודם), Distance Matrix (דור קודם)
- קטגוריה: מסלולים
- פלטפורמה: שירות אינטרנט (REST)
- פועל ב: שרת (קוד לקצה העורפי)
- שלב ההשקה: GA
- מחזור חיים: מדור קודם
- הוחלף על ידי: Routes API
- סקירה כללית: סקירה כללית על Distance Matrix API
Distance Matrix API: מתי כדאי להשתמש בו
מתי כדאי להשתמש ב-Distance Matrix API:
- יש לכם פרויקט קיים שכבר מופעל בו Distance Matrix API (הגרסה הקודמת) ומתבצעות בו קריאות ל-
/maps/api/distancematrix. - אתם צריכים לקבל משרת את מרחק הנסיעה ואת משך הנסיעה בין כמה נקודות מוצא לכמה יעדים.
- אתם צריכים משכי זמן בתנועה לנהיגה, באמצעות
departure_timeו-traffic_modelאופציונלי.
מתי לא כדאי להשתמש ב-Distance Matrix API:
- אתם מתחילים פרויקט חדש ב-Google Cloud. החל מאוקטובר 2026, לא תהיה אפשרות להפעיל את Distance Matrix API (הגרסה הקודמת) בפרויקטים חדשים. במקום זאת, אתם צריכים להשתמש ב-Routes API.
- אתם צריכים תכונות חדשות או מטריצת מסלולים של עד 625 רכיבים עם תגובות בסטרימינג (
computeRouteMatrix). במקום זאת, השתמשו ב-Routes API. - אתם צריכים מסלול מלא עם שלבים וקווים פוליגוניים בין נקודות, ולא רק ערכים של מרחק ומשך זמן. במקום זאת, אתם צריכים להשתמש ב-Routes API.
Distance Matrix API: הגדרה
- השירות שצריך להפעיל:
distance-matrix-backend.googleapis.com - אימות: מפתח API
- תחילת העבודה: הגדרת Distance Matrix API
- חומר עזר: חומר עזר בנושא Distance Matrix API
- תמחור: שימוש וחיוב ב-Distance Matrix API
- כללי מדיניות: כללי המדיניות של Distance Matrix API
- נתוני גרסה: נתוני הגרסה של Distance Matrix API
Distance Matrix API: טעויות נפוצות
- הבעיה: כל בקשה בצד השרת מוגבלת ל-100 רכיבים (נקודות מוצא × יעדים) ול-25 נקודות מוצא או 25 יעדים. בקשות גדולות יותר מחזירות את הערך
MAX_ELEMENTS_EXCEEDEDאוMAX_DIMENSIONS_EXCEEDED. הפתרון: פצלו את המטריצה לבקשות של עד 100 רכיבים ו-25 נקודות מוצא או יעדים. מידע נוסף זמין בכתובת /maps/documentation/distance-matrix/usage-and-billing#usage-limits. - הבעיה: אם לא מציינים את
departure_time, המסלול ומשך הזמן מבוססים על תנועה ממוצעת שלא תלויה בזמן, ולא מוחזרduration_in_traffic. התוצאות יכולות להשתנות עם הזמן. תיקון: כדי לקבל משכי זמן שמביאים בחשבון את מצב התנועה, צריך להגדיר אתdeparture_timeלערךnowאו לזמן עתידי באמצעותmode=driving. חשוב לשים לב שהחיוב על בקשות תנועה הוא בשיעור גבוה יותר. אפשר לקרוא מידע נוסף בכתובת /maps/documentation/distance-matrix/distance-matrix. - הבעיה: הפרמטר
unitsמשנה רק את הטקסט בשדות המרחק. ערך המרחק הוא תמיד במטרים. תיקון: צריך לקרוא אתdistance.valueכמטרים, או להשתמש ב-distance.textלתצוגה. אפשר לקרוא מידע נוסף בכתובת /maps/documentation/distance-matrix/distance-matrix. - הבעיה: כששולחים קריאה ל-Distance Matrix API (הגרסה הקודמת) מפרויקט שבו הוא לא מופעל, מוחזר הערך
REQUEST_DENIEDב-statusו-error_messageשמקשר אלLegacyApiNotActivatedMapError. עוזרים אישיים מבוססי-AI יוצרים בדרך כלל קוד API מדור קודם כברירת מחדל. התיקון: עוברים ל-Routes APIcomputeRouteMatrix(עם הכותרתX-Goog-FieldMask). הפעלת ה-API הקודם באמצעות טופס היא רק אמצעי לטווח קצר. מידע נוסף זמין בכתובת /maps/legacy#LegacyApiNotActivatedMapError.